Build on the
47Network stack.

import { Network47Client } from '@47network/sdk';

const client = new Network47Client({
  apiKey: process.env.NETWORK47_API_KEY,
  version: '2026-01',
});

// Fetch authenticated user
const me = await client.auth.me();
console.log(me.email);   // alex@yourorg.com

// List Sven missions
const missions = await client.sven.missions.list({ status: 'active' });
console.log(missions.data.length);  // 3

curl https://api.the47network.com/v1/me \
  -H "Authorization: Bearer $NETWORK47_API_KEY" \
  -H "X-47N-Version: 2026-01"

# Response:
# {
#   "id": "usr_abc123",
#   "email": "alex@yourorg.com",
#   "plan": "pro",
#   "products": ["sven","47mail","passvault"]
# }

import os
from network47 import Network47Client

client = Network47Client(
  api_key=os.environ["NETWORK47_API_KEY"],
  version="2026-01"
)

me = client.auth.me()
print(me.email)   # alex@yourorg.com

missions = client.sven.missions.list(status="active")
print(len(missions.data))  # 3

// All requests require both headers:
"Authorization: Bearer sk_live_..."
"X-47N-Version: 2026-01"

// API keys are prefixed by environment:
// sk_live_   → Production
// sk_test_   → Sandbox (no real data)
// sk_dev_    → Development / self-hosted

# 47ID OIDC configuration
OIDC_ISSUER=https://id.the47network.com/realms/47net
OIDC_CLIENT_ID=your-app-client-id
OIDC_CLIENT_SECRET=your-client-secret
OIDC_REDIRECT_URI=https://yourapp.com/auth/callback

# Available scopes:
# openid profile email            → Standard OIDC
# 47n:products                    → Product access
# 47n:sven:missions:write         → Submit missions
# 47n:vault:entries:read          → Read vault entries
# 47n:mail:send                   → Send email

# Add the 47Network Helm registry
helm registry login registry.the47network.com

# Install Sven Agent
helm install sven oci://registry.the47network.com/charts/sven-agent \
  --namespace sven \
  --create-namespace \
  --set auth.oidcIssuer="https://id.the47network.com/realms/47net" \
  --set auth.clientId="sven-self-hosted" \
  --set storage.s3.bucket="sven-evidence" \
  --set ingress.host="sven.yourorg.com"

# Verify deployment
kubectl get pods -n sven
# NAME                    READY   STATUS    RESTARTS   AGE
# sven-7d9f8b6c4-xk2jp    1/1     Running   0          42s

# Authentication
47n auth login              # OAuth device flow
47n auth logout
47n keys create --name my-key --scopes sven:missions:write
47n keys list
47n keys rotate <key-id>

# Sven Agent
47n sven missions list
47n sven missions create --goal "Summarise today's emails"
47n sven skills list
47n sven skills deploy ./my-skill.ts

# Self-hosting
47n deploy sven --namespace sven --cluster mycluster
47n deploy 47mail --namespace mail

# Diagnostics
47n status
47n logs --product sven --tail 100

import { SvenClient } from '@47network/sven-sdk';

const sven = new SvenClient({
  apiKey: process.env.SVEN_API_KEY,
  endpoint: 'https://sven.the47network.com',  // or self-hosted URL
});

// Register a custom skill with schema validation
await sven.skills.register({
  name: 'send-email',
  version: '1.0.0',
  description: 'Send an email via 47mail',
  inputSchema: {
    type: 'object',
    properties: {
      to:      { type: 'string', format: 'email' },
      subject: { type: 'string' },
      body:    { type: 'string' },
    },
    required: ['to', 'subject', 'body'],
  },
  requireApproval: true,  // human-in-the-loop for email sends
  handler: async ({ to, subject, body }) => {
    return await mailClient.send({ to, subject, body });
  },
});

console.log('✓ Skill registered');

// Submit a mission to Sven
const mission = await sven.missions.create({
  goal: 'Summarise all unread emails from today and reply to urgent ones',
  skills: ['47mail-fetch', 'summarise-email', 'send-email'],
  context: {
    mailbox: 'alex@ourorg.com',
    urgencyKeywords: ['urgent', 'ASAP', 'blocking'],
  },
  maxDurationMs: 300_000,   // 5 minute timeout
  requireApproval: true,   // pause before sending any reply
});

console.log(mission.id);  // msn_a1b2c3

// Stream live telemetry
for await (const event of sven.missions.stream(mission.id)) {
  console.log(event.type, event.data);
  // skill:start, skill:complete, approval:requested, mission:complete…
}

// Query the tamper-proof audit trail
const trail = await sven.audit.query({
  missionId: 'msn_a1b2c3',
  includeEvidence: true,
});

for (const entry of trail.entries) {
  console.log({
    ts:        entry.timestamp,
    action:    entry.action,       // skill:invoked, output:generated…
    signature: entry.signature,   // ed25519 — verifiable offline
    evidence:  entry.evidence,    // full input/output snapshot
  });
}

// app/api/auth/[...nextauth]/route.ts
import NextAuth from 'next-auth';
import KeycloakProvider from 'next-auth/providers/keycloak';

export const { handlers, signIn, signOut, auth } = NextAuth({
  providers: [
    KeycloakProvider({
      clientId:     process.env.OIDC_CLIENT_ID!,
      clientSecret: process.env.OIDC_CLIENT_SECRET!,
      issuer:       'https://id.the47network.com/realms/47net',
    }),
  ],
});

// Discovery document:
// GET https://id.the47network.com/realms/47net/.well-known/openid-configuration

// Token endpoint:
// POST https://id.the47network.com/realms/47net/protocol/openid-connect/token

// Keycloak realm: 47net
// Supported grant types:
//   authorization_code  → Web applications
//   device_code         → CLI / headless
//   client_credentials  → Server-to-server

import { createHmac } from 'node:crypto';

function verifyWebhook(payload: Buffer, signature: string, secret: string) {
  const expected = createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(`sha256=${expected}`)
  );
}

// Events fired by product:
// sven:mission:completed   sven:mission:failed   sven:approval:requested
// mail:message:received    mail:bounce:detected
// vault:entry:created      vault:sync:completed
// comms:sms:received       comms:optout:received

{
  "error": {
    "code":    "MISSION_NOT_FOUND",
    "message": "Mission msn_xyz not found or not accessible.",
    "status":  404,
    "request": "req_abc123"    // include in support reports
  }
}