@kmlckj/aios-agent-server-sdk 0.0.0-stage → 0.0.2

package/examples/business-assistant.mjs

@@ -0,0 +1,19 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { platformClient, observe, required } from './common.mjs';
+const workspace = path.resolve(required('AIOS_WORKSPACE'));
+const client = await platformClient('sdk-business-example', { tools: false, skills: false });
+try {
+  const agent = await client.defineAgent({ id: 'orders', version: '1', name: '订单助手', model: required('AIOS_MODEL'),
+    instructions: '通过业务工具查询订单，按月份统计金额，然后调用保存工具发起写入审批。保存工具本身会请求用户审批，无需在普通文本中重复询问；未获批准不得宣称保存成功。只能依据查询结果作答。',
+    tools: [{ name: 'query_orders', description: '查询示例订单', readOnly: true,
+      inputSchema: { type: 'object', properties: { month: { type: 'string', pattern: '^2026-10$' } }, required: ['month'], additionalProperties: false },
+      execute: () => ({ orders: [{ id: 'A1', amount: 120 }, { id: 'A2', amount: 80 }], currency: 'CNY' }) },
+    { name: 'save_summary', description: '保存经过用户确认的订单摘要', readOnly: false,
+      inputSchema: { type: 'object', properties: { count: { type: 'integer' }, total: { type: 'number' } }, required: ['count', 'total'], additionalProperties: false },
+      execute: async (input, { signal }) => { signal.throwIfAborted(); await fs.writeFile(path.join(workspace, 'order-summary.json'), JSON.stringify(input, null, 2), { flag: 'wx', signal }); return { saved: true }; } }],
+  });
+  const session = await agent.createSession({ workspacePath: workspace, name: 'SDK 业务工具示例' });
+  console.log(JSON.stringify({ taskId: session.id }));
+  await observe(await session.send('查询 2026-10 的订单，汇总条数和金额，然后调用保存工具发起摘要写入审批。'));
+} finally { await client.close(); }

package/examples/common.mjs

@@ -0,0 +1,51 @@
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { createClient } from '@kmlckj/aios-agent-server-sdk';
+
+export function required(name) {
+  const value = process.env[name];
+  if (!value) throw new Error(`Missing environment variable: ${name}`);
+  return value;
+}
+export function runtime() {
+  return { ...(process.env.AIOS_RUNTIME_DIRECTORY ? { directory: path.resolve(process.env.AIOS_RUNTIME_DIRECTORY) } : {}), dataDirectory: path.resolve(required('AIOS_DATA_DIRECTORY')),
+    ...(process.env.AIOS_NODE_EXECUTABLE ? { nodeExecutable: process.env.AIOS_NODE_EXECUTABLE } : {}),
+    ...(process.env.AIOS_CHROMIUM ? { chromiumExecutable: process.env.AIOS_CHROMIUM } : {}) };
+}
+export async function platformClient(appId, builtins) {
+  const client = await createClient({ mode: 'platform', appId, userScope: required('AIOS_USER_SCOPE'), appName: 'AIOS SDK 示例',
+    platformBaseUrl: required('AIOS_PLATFORM_URL'), runtime: runtime(), builtins });
+  try {
+    if (process.env.AIOS_BROWSER_LOGIN === '1') {
+      const login = await client.auth.startBrowserLogin(); console.log(await login.getAuthorizationUrl()); await login.wait();
+    } else {
+      const login = await client.auth.login({ loginType: 'USERNAME', account: required('AIOS_ACCOUNT'), password: required('AIOS_PASSWORD') });
+      if (login.status !== 'authenticated') throw new Error('Platform requires a password change. Complete it with auth.completePasswordChange first.');
+    }
+    return client;
+  } catch (error) { await client.close(); throw error; }
+}
+export async function observe(run) {
+  const handled = new Set();
+  for await (const event of run.events()) {
+    if (event.type === 'approval_required' || event.type === 'user_input_required') {
+      const state = await run.state();
+      for (const interaction of state.interactions) {
+        if (handled.has(interaction.id)) continue;
+        handled.add(interaction.id);
+        if (interaction.kind === 'approval') {
+          const terminal = process.env.AIOS_APPROVE_WRITES === '1' ? undefined : createInterface({ input: process.stdin, output: process.stdout });
+          let approve;
+          try { approve = !terminal || (await terminal.question('Approve this tool operation? [y/N] ')).toLowerCase() === 'y'; }
+          finally { terminal?.close(); }
+          await run.approve(String(interaction.payload.tool_call_id), approve ? 'approve' : 'deny');
+        } else throw new Error(`Input required: ${interaction.requestId}. Respond with run.answer using the supplied interaction schema.`);
+      }
+    }
+    console.log(JSON.stringify({ type: event.type, id: event.id, runId: event.runId }));
+  }
+  const state = await run.state();
+  console.log(JSON.stringify({ runId: run.id, status: state.status, messages: state.messages.filter(message => message.role === 'assistant').map(message => message.content) }));
+  if (state.status !== 'completed') throw new Error(`Run finished with status: ${state.status}`);
+  return state;
+}

package/examples/platform-assistant.mjs

@@ -0,0 +1,9 @@
+import { platformClient, observe, required } from './common.mjs';
+const client = await platformClient('sdk-platform-example', { tools: { categories: ['workspace', 'documents', 'data'] }, skills: { categories: ['documents'] } });
+try {
+  const agent = await client.defineAgent({ id: 'report', version: '1', name: '报告助手', model: required('AIOS_MODEL'),
+    instructions: '根据工作目录中的真实材料生成报告。不得编造数据，完成后给出产物路径。' });
+  const session = await agent.createSession({ workspacePath: required('AIOS_WORKSPACE'), name: 'SDK 平台报告示例' });
+  console.log(JSON.stringify({ taskId: session.id }));
+  await observe(await session.send(process.env.AIOS_PROMPT ?? '读取 orders.json，按部门汇总金额并生成 report.md，注明合计和数据条数。'));
+} finally { await client.close(); }

package/examples/standalone-assistant.mjs

@@ -0,0 +1,16 @@
+import { createClient } from '@kmlckj/aios-agent-server-sdk';
+import { runtime, required, observe } from './common.mjs';
+const client = await createClient({ mode: 'standalone', appId: 'sdk-inventory-example', userScope: required('AIOS_USER_SCOPE'), runtime: runtime(),
+  builtins: { tools: false, skills: false }, models: [{ id: 'external', endpoint: required('AIOS_MODEL_ENDPOINT'), model: required('AIOS_MODEL'),
+    protocol: process.env.AIOS_MODEL_PROTOCOL ?? 'chat_completions', apiKey: process.env.AIOS_MODEL_API_KEY,
+    contextWindow: Number(process.env.AIOS_CONTEXT_WINDOW ?? 32768), functionCalling: true }] });
+try {
+  const agent = await client.defineAgent({ id: 'inventory', version: '1', name: '库存助手', model: 'external',
+    instructions: '只使用应用提供的库存查询工具回答，不假定存在平台账号或内置工具。',
+    tools: [{ name: 'query_inventory', description: '查询产品当前库存', readOnly: true,
+      inputSchema: { type: 'object', properties: { product: { type: 'string' } }, required: ['product'], additionalProperties: false },
+      execute: ({ product }) => ({ product, stock: product === '示例产品' ? 35 : 0 }) }] });
+  const session = await agent.createSession({ workspacePath: required('AIOS_WORKSPACE'), name: 'SDK 独立应用示例' });
+  console.log(JSON.stringify({ taskId: session.id, mode: (await client.getConfiguration()).mode }));
+  if (process.env.AIOS_EXAMPLE_VALIDATE_ONLY !== '1') await observe(await session.send('查询示例产品还有多少库存。'));
+} finally { await client.close(); }

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@kmlckj/aios-agent-server-sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "AIOS agent application SDK for Node.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": "^22.23.2 || ^24.0.0"
+  },
+  "dependencies": {
+    "ajv": "8.20.0",
+    "tar": "7.5.22"
+  },
+  "optionalDependencies": {
+    "@kmlckj/aios-runtime-win32-x64": "0.0.2",
+    "@kmlckj/aios-runtime-darwin-x64": "0.0.2",
+    "@kmlckj/aios-runtime-darwin-arm64": "0.0.2",
+    "@kmlckj/aios-runtime-linux-x64": "0.0.2",
+    "@kmlckj/aios-runtime-linux-arm64": "0.0.2"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/sdk/src/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./events": {
+      "types": "./dist/sdk/src/events.d.ts",
+      "import": "./dist/events.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "EVENTS.md",
+    "examples",
+    "capabilities.json"
+  ],
+  "license": "UNLICENSED"
+}