npm install @aegis/sdk
# or
pnpm add @aegis/sdk

import { AegisClient } from '@aegis/sdk';

const client = new AegisClient(
  'https://your-aegis-node',
  process.env.AEGIS_API_KEY,   // Optional; Keycloak Bearer JWT
);

new AegisClient(baseUrl: string, apiKey?: string)

import { AegisClient, AgentManifest } from '@aegis/sdk';

const manifest: AgentManifest = {
  apiVersion: '100monkeys.ai/v1',
  kind: 'Agent',
  metadata: { name: 'code-reviewer', version: '1.0.0' },
  spec: {
    runtime: { language: 'python', version: '3.11', isolation: 'docker' },
    task: { instruction: 'Review pull requests and output structured feedback.' },
    security: {
      network: { mode: 'allow', allowlist: ['api.github.com'] },
      filesystem: { read: ['/workspace'], write: ['/workspace'] },
      resources: { cpu: 1000, memory: '1Gi', timeout: '300s' },
    },
  },
};

const { agentId } = await client.deployAgent(manifest);
console.log(agentId); // "agt-uuid"

interface DeploymentResponse {
  agentId: string;
}

const output = await client.executeTask('agt-uuid', {
  prompt: 'Write a primality check in TypeScript',
  context: {},
});
console.log(output.result);

interface TaskInput {
  prompt: string;
  context?: Record<string, unknown>;
}

interface TaskOutput {
  result: string;
  logs: string[];
}

const status = await client.getAgentStatus('agt-uuid');
console.log(status.state); // "deployed" | "paused" | "archived"

interface AgentStatus {
  agentId: string;
  state: 'deployed' | 'paused' | 'archived';
  updatedAt: string; // ISO 8601
}

await client.terminateAgent('agt-uuid');

import type { AgentManifest } from '@aegis/sdk';

const manifest: AgentManifest = {
  apiVersion: '100monkeys.ai/v1',
  kind: 'Agent',
  metadata: {
    name: 'my-agent',
    version: '1.0.0',
    labels: { team: 'platform' },
  },
  spec: {
    runtime: {
      language: 'typescript',
      version: '22',
      isolation: 'docker',
    },
    task: {
      instruction: 'Analyze TypeScript code for potential issues.',
    },
    security: {
      network: {
        mode: 'allow',
        allowlist: ['api.github.com', 'registry.npmjs.org'],
      },
      filesystem: {
        read: ['/workspace'],
        write: ['/workspace/output'],
      },
      resources: {
        cpu: 2000,
        memory: '2Gi',
        timeout: '180s',
      },
    },
    execution: {
      mode: 'iterative',
      max_iterations: 5,
    },
    volumes: [
      {
        name: 'workspace',
        storage_class: 'ephemeral',
        mount_path: '/workspace',
        access_mode: 'read-write',
        ttl_hours: 1,
      },
    ],
  },
};

const response = await fetch(
  `https://your-aegis-node/v1/executions/${executionId}/stream`,
  { headers: { Authorization: `Bearer ${token}` } }
);

const reader = response.body!.getReader();
const decoder = new TextDecoder();

while (true) {
  const { value, done } = await reader.read();
  if (done) break;

  const text = decoder.decode(value);
  for (const line of text.split('\n')) {
    if (!line.startsWith('data:')) continue;
    const event = JSON.parse(line.slice(5).trim());

    if (event.iteration_started) {
      console.log(`Iteration ${event.iteration_started.iteration_number}`);
    } else if (event.execution_completed) {
      console.log('Output:', event.execution_completed.final_output);
    } else if (event.execution_failed) {
      console.error('Failed:', event.execution_failed.reason);
    }
  }
}

import axios from 'axios';
import { AegisClient } from '@aegis/sdk';

try {
  const { agentId } = await client.deployAgent(manifest);
} catch (err) {
  if (axios.isAxiosError(err)) {
    console.error(err.response?.status, err.response?.data);
  } else {
    throw err;
  }
}