TypeScript SDK

import { OpenAgent } from '@openagent/sdk';

const agent = await OpenAgent.createAgent({
  parent: 'did:oas:l1fe:hmr:alice',
  name: 'support-triage',
  scopes: ['openai:chat:invoke', 'github:issues:read'],
});

console.log(agent.did);

import { OpenAgent, assertScopes, OpenAgentError } from '@openagent/sdk';

export async function POST(request: Request) {
  try {
    const ctx = await OpenAgent.authenticate(request, {
      requiredScopes: ['openai:chat:invoke'],
      requirePrivilegedAuthority: true,
      requiredAuthorityPath: 'human_to_agent',
    });

    assertScopes(ctx, ['openai:chat:invoke']);

    return Response.json({
      did: ctx.did,
      root: ctx.root,
      scopes: ctx.scopes,
      authority: ctx.lineageAuthority?.source,
    });
  } catch (error) {
    if (error instanceof OpenAgentError) {
      return Response.json(
        { code: error.code, message: error.message },
        { status: error.httpStatus ?? 401 },
      );
    }
    throw error;
  }
}

const openai = await agent.credentialsFor('openai', ['openai:chat:invoke']);

const response = await openai.fetch('https://api.openai.com/v1/chat/completions', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    model: 'gpt-4.1-mini',
    messages: [{ role: 'user', content: 'Summarize this ticket.' }],
  }),
});

const skills = agent.skillsPolicy();

if (skills.canInvoke('frontend-design')) {
  await runFrontendDesign();
}

skills.assertCanInvoke?.('deploy-production');

const runtime = OpenAgent.runtime();

runtime.identity();      // OAS identity provider
runtime.arsenal();       // Arsenal credential client
runtime.verification();  // AEGIS verifier client

import { OpenAgentError, ErrorCode } from '@openagent/sdk';

try {
  await agent.credentialsFor('openai');
} catch (error) {
  if (
    error instanceof OpenAgentError &&
    error.code === ErrorCode.CREDENTIAL_SCOPE_DENIED
  ) {
    // Ask for a narrower scope or update policy.
  }
}