@agent-native/core 0.59.0 → 0.60.0

package/dist/cli/agent.js

@@ -0,0 +1,300 @@
+import fs from "node:fs";
+import path from "node:path";
+import { autoDiscoverActions } from "../server/action-discovery.js";
+import { createGitHubRepoToolEntries } from "../provider-api/github-repo.js";
+import { getRequestOrgId, getRequestUserEmail, runWithRequestContext, } from "../server/request-context.js";
+import { resolveDevUserEmail } from "../scripts/dev-session.js";
+import { loadEnv } from "../scripts/utils.js";
+import { actionsToEngineTools, } from "../agent/production-agent.js";
+import { runAgentLoopDirectWithSoftTimeout } from "../agent/run-loop-with-resume.js";
+import { registerBuiltinEngines, resolveEngine, } from "../agent/engine/index.js";
+import { DEFAULT_MODEL } from "../agent/default-model.js";
+import { captureCliOutput } from "../server/cli-capture.js";
+const VALUE_FLAGS = new Set([
+    "message",
+    "prompt",
+    "engine",
+    "model",
+    "user",
+    "user-email",
+    "org",
+    "org-id",
+    "soft-timeout-ms",
+    "max-iterations",
+]);
+export function parseAgentArgs(args) {
+    const parsed = {
+        json: false,
+        help: false,
+        errors: [],
+    };
+    const positional = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--") {
+            positional.push(...args.slice(i + 1));
+            break;
+        }
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const eqIndex = arg.indexOf("=");
+        const rawName = eqIndex === -1 ? arg.slice("--".length) : arg.slice("--".length, eqIndex);
+        const inlineValue = eqIndex === -1 ? undefined : arg.slice(eqIndex + 1);
+        const name = rawName.trim();
+        if (name === "help" || name === "h") {
+            parsed.help = true;
+            continue;
+        }
+        if (name === "json") {
+            parsed.json = true;
+            continue;
+        }
+        if (name === "no-soft-timeout") {
+            parsed.softTimeoutMs = 0;
+            continue;
+        }
+        if (!VALUE_FLAGS.has(name)) {
+            parsed.errors.push(`Unknown option: --${name}`);
+            continue;
+        }
+        const value = inlineValue ??
+            (args[i + 1] !== undefined && !args[i + 1].startsWith("--")
+                ? args[++i]
+                : undefined);
+        if (value === undefined) {
+            parsed.errors.push(`Missing value for --${name}`);
+            continue;
+        }
+        switch (name) {
+            case "message":
+            case "prompt":
+                parsed.prompt = value;
+                break;
+            case "engine":
+                parsed.engine = value;
+                break;
+            case "model":
+                parsed.model = value;
+                break;
+            case "user":
+            case "user-email":
+                parsed.userEmail = value;
+                break;
+            case "org":
+            case "org-id":
+                parsed.orgId = value;
+                break;
+            case "soft-timeout-ms":
+                parsed.softTimeoutMs = parsePositiveInteger("--soft-timeout-ms", value, parsed);
+                break;
+            case "max-iterations":
+                parsed.maxIterations = parsePositiveInteger("--max-iterations", value, parsed);
+                break;
+        }
+    }
+    if (!parsed.prompt && positional.length > 0) {
+        parsed.prompt = positional.join(" ");
+    }
+    return parsed;
+}
+export async function runAgent(args, io = {}) {
+    loadEnv();
+    registerBuiltinEngines();
+    const stdout = io.stdout ?? console.log;
+    const stderr = io.stderr ?? console.error;
+    const env = io.env ?? process.env;
+    const parsed = parseAgentArgs(args);
+    if (parsed.help) {
+        stdout(formatAgentUsage());
+        return 0;
+    }
+    if (!parsed.prompt?.trim()) {
+        parsed.errors.push('Missing "prompt"');
+    }
+    if (parsed.errors.length > 0) {
+        stderr(parsed.errors.join("\n"));
+        stderr("");
+        stderr(formatAgentUsage());
+        return 1;
+    }
+    const ownerEmail = parsed.userEmail ?? env.AGENT_USER_EMAIL ?? (await resolveDevUserEmail());
+    const orgId = parsed.orgId ?? env.AGENT_ORG_ID ?? undefined;
+    try {
+        const result = await runWithRequestContext({ userEmail: ownerEmail, orgId }, () => runLocalAgentLoop(parsed));
+        if (parsed.json) {
+            stdout(JSON.stringify(result, null, 2));
+        }
+        else {
+            stdout(result.responseText.trimEnd());
+            if (result.responseText && !result.responseText.endsWith("\n")) {
+                stdout("");
+            }
+        }
+        return 0;
+    }
+    catch (err) {
+        stderr(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}
+async function runLocalAgentLoop(parsed) {
+    const localActions = await autoDiscoverActions("auto");
+    const builtinActions = await createHeadlessBuiltinActions();
+    const repoActions = createGitHubRepoToolEntries({
+        appId: process.env.AGENT_NATIVE_APP_ID ?? process.env.APP_ID ?? "app",
+    });
+    const actions = { ...builtinActions, ...localActions, ...repoActions };
+    const tools = actionsToEngineTools(actions);
+    if (tools.length === 0) {
+        throw new Error("No agent-callable actions were found. Add actions/*.ts with defineAction() first.");
+    }
+    const engine = await resolveEngine({
+        engineOption: parsed.engine,
+        model: parsed.model,
+    });
+    const model = parsed.model ?? engine.defaultModel ?? DEFAULT_MODEL;
+    const messages = [
+        {
+            role: "user",
+            content: [{ type: "text", text: parsed.prompt.trim() }],
+        },
+    ];
+    const events = [];
+    let responseText = "";
+    const controller = new AbortController();
+    const ownerEmail = getRequestUserEmail();
+    const orgId = getRequestOrgId();
+    const usage = await runAgentLoopDirectWithSoftTimeout({
+        engine,
+        model,
+        systemPrompt: buildHeadlessSystemPrompt(tools.map((tool) => tool.name)),
+        tools,
+        actions,
+        messages,
+        signal: controller.signal,
+        ownerEmail,
+        orgId,
+        maxIterations: parsed.maxIterations,
+        send(event) {
+            events.push(event);
+            if (event.type === "text") {
+                responseText += event.text ?? "";
+            }
+        },
+    }, parsed.softTimeoutMs);
+    return {
+        responseText,
+        usage,
+        events,
+        tools: tools.map((tool) => tool.name).sort(),
+    };
+}
+function buildHeadlessSystemPrompt(actionNames) {
+    const instructions = readLocalInstructions();
+    const actionList = actionNames.length > 0
+        ? `Available local actions: ${actionNames.join(", ")}.`
+        : "No local actions were discovered.";
+    return [
+        "You are the app agent for this Agent-Native project.",
+        "Use the registered app actions as your source of truth for doing work.",
+        "Use docs-search before implementing or answering advanced Agent Native framework questions; it reads the version-matched docs bundled with @agent-native/core.",
+        "Use connected GitHub repository tools for repo context when a repository is configured; do not assume a local clone or sandbox exists.",
+        "You are running headlessly from the command line, so reply with the final useful result in plain text.",
+        actionList,
+        instructions ? `Project instructions:\n${instructions}` : "",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+function cliArgsFromToolArgs(args) {
+    const cliArgs = [];
+    for (const [key, value] of Object.entries(args)) {
+        if (value === undefined)
+            continue;
+        const normalized = value != null && typeof value === "object"
+            ? JSON.stringify(value)
+            : String(value);
+        cliArgs.push(`--${key}`, normalized);
+    }
+    return cliArgs;
+}
+export async function createHeadlessBuiltinActions() {
+    const docsSearch = await import("../scripts/docs/search.js");
+    return {
+        "docs-search": {
+            readOnly: true,
+            tool: {
+                description: "Search and read version-matched Agent Native framework documentation bundled in @agent-native/core, plus bundled AGENTS.md and codebase skills. Use --list to see pages, --query to search, and --slug to read a page.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: {
+                            type: "string",
+                            description: "Search term to find relevant docs, for example actions, automations, a2a, database, sharing, or pure-agent apps.",
+                        },
+                        slug: {
+                            type: "string",
+                            description: "Read a specific doc page by slug, for example actions, agent-native-docs, automations, a2a-protocol, or external-agents.",
+                        },
+                        list: {
+                            type: "string",
+                            description: 'Set to "true" to list all available doc pages.',
+                            enum: ["true"],
+                        },
+                    },
+                },
+            },
+            run: async (args) => {
+                return captureCliOutput(() => docsSearch.default(cliArgsFromToolArgs(args)));
+            },
+        },
+    };
+}
+function readLocalInstructions() {
+    const candidates = ["AGENTS.md", "CLAUDE.md", "README.md"];
+    const chunks = [];
+    for (const name of candidates) {
+        const file = path.resolve(process.cwd(), name);
+        try {
+            if (!fs.existsSync(file))
+                continue;
+            const content = fs.readFileSync(file, "utf8").trim();
+            if (!content)
+                continue;
+            chunks.push(`# ${name}\n${content.slice(0, 12_000)}`);
+        }
+        catch {
+            // Ignore unreadable local instruction files.
+        }
+    }
+    return chunks.join("\n\n");
+}
+function parsePositiveInteger(flag, value, parsed) {
+    const n = Number(value);
+    if (!Number.isInteger(n) || n <= 0) {
+        parsed.errors.push(`${flag} must be a positive integer`);
+        return undefined;
+    }
+    return n;
+}
+export function formatAgentUsage() {
+    return [
+        'Usage: agent-native agent "prompt" [options]',
+        "",
+        "Runs the production app-agent loop once against this folder's actions/ directory.",
+        "",
+        "Options:",
+        "  --message <text>            Prompt (alias for positional prompt)",
+        "  --engine <name>             Agent engine name (defaults to env/settings)",
+        "  --model <name>              Model override",
+        "  --user-email <email>        Owner identity for scoped actions",
+        "  --org-id <id>               Organization id for scoped credentials",
+        "  --soft-timeout-ms <n>       Soft timeout before continuation recovery",
+        "  --no-soft-timeout           Disable continuation soft timeout wrapper",
+        "  --max-iterations <n>        Maximum tool/LLM loop iterations",
+        "  --json                      Print response, events, usage, and tools",
+    ].join("\n");
+}
+//# sourceMappingURL=agent.js.map

package/dist/cli/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/cli/agent.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { autoDiscoverActions } from \"../server/action-discovery.js\";\nimport { createGitHubRepoToolEntries } from \"../provider-api/github-repo.js\";\nimport {\n  getRequestOrgId,\n  getRequestUserEmail,\n  runWithRequestContext,\n} from \"../server/request-context.js\";\nimport { resolveDevUserEmail } from \"../scripts/dev-session.js\";\nimport { loadEnv } from \"../scripts/utils.js\";\nimport {\n  actionsToEngineTools,\n  type AgentLoopUsage,\n  type ActionEntry,\n} from \"../agent/production-agent.js\";\nimport { runAgentLoopDirectWithSoftTimeout } from \"../agent/run-loop-with-resume.js\";\nimport {\n  registerBuiltinEngines,\n  resolveEngine,\n} from \"../agent/engine/index.js\";\nimport { DEFAULT_MODEL } from \"../agent/default-model.js\";\nimport type { AgentChatEvent } from \"../agent/types.js\";\nimport type { EngineMessage } from \"../agent/engine/types.js\";\nimport { captureCliOutput } from \"../server/cli-capture.js\";\n\nexport interface ParsedAgentArgs {\n  prompt?: string;\n  engine?: string;\n  model?: string;\n  userEmail?: string;\n  orgId?: string;\n  softTimeoutMs?: number;\n  maxIterations?: number;\n  json: boolean;\n  help: boolean;\n  errors: string[];\n}\n\nexport interface AgentCliIo {\n  stdout?: (text: string) => void;\n  stderr?: (text: string) => void;\n  env?: NodeJS.ProcessEnv;\n}\n\nconst VALUE_FLAGS = new Set([\n  \"message\",\n  \"prompt\",\n  \"engine\",\n  \"model\",\n  \"user\",\n  \"user-email\",\n  \"org\",\n  \"org-id\",\n  \"soft-timeout-ms\",\n  \"max-iterations\",\n]);\n\nexport function parseAgentArgs(args: string[]): ParsedAgentArgs {\n  const parsed: ParsedAgentArgs = {\n    json: false,\n    help: false,\n    errors: [],\n  };\n  const positional: string[] = [];\n\n  for (let i = 0; i < args.length; i += 1) {\n    const arg = args[i];\n    if (arg === \"--\") {\n      positional.push(...args.slice(i + 1));\n      break;\n    }\n    if (!arg.startsWith(\"--\")) {\n      positional.push(arg);\n      continue;\n    }\n\n    const eqIndex = arg.indexOf(\"=\");\n    const rawName =\n      eqIndex === -1 ? arg.slice(\"--\".length) : arg.slice(\"--\".length, eqIndex);\n    const inlineValue = eqIndex === -1 ? undefined : arg.slice(eqIndex + 1);\n    const name = rawName.trim();\n\n    if (name === \"help\" || name === \"h\") {\n      parsed.help = true;\n      continue;\n    }\n    if (name === \"json\") {\n      parsed.json = true;\n      continue;\n    }\n    if (name === \"no-soft-timeout\") {\n      parsed.softTimeoutMs = 0;\n      continue;\n    }\n    if (!VALUE_FLAGS.has(name)) {\n      parsed.errors.push(`Unknown option: --${name}`);\n      continue;\n    }\n\n    const value =\n      inlineValue ??\n      (args[i + 1] !== undefined && !args[i + 1].startsWith(\"--\")\n        ? args[++i]\n        : undefined);\n    if (value === undefined) {\n      parsed.errors.push(`Missing value for --${name}`);\n      continue;\n    }\n\n    switch (name) {\n      case \"message\":\n      case \"prompt\":\n        parsed.prompt = value;\n        break;\n      case \"engine\":\n        parsed.engine = value;\n        break;\n      case \"model\":\n        parsed.model = value;\n        break;\n      case \"user\":\n      case \"user-email\":\n        parsed.userEmail = value;\n        break;\n      case \"org\":\n      case \"org-id\":\n        parsed.orgId = value;\n        break;\n      case \"soft-timeout-ms\":\n        parsed.softTimeoutMs = parsePositiveInteger(\n          \"--soft-timeout-ms\",\n          value,\n          parsed,\n        );\n        break;\n      case \"max-iterations\":\n        parsed.maxIterations = parsePositiveInteger(\n          \"--max-iterations\",\n          value,\n          parsed,\n        );\n        break;\n    }\n  }\n\n  if (!parsed.prompt && positional.length > 0) {\n    parsed.prompt = positional.join(\" \");\n  }\n\n  return parsed;\n}\n\nexport async function runAgent(\n  args: string[],\n  io: AgentCliIo = {},\n): Promise<number> {\n  loadEnv();\n  registerBuiltinEngines();\n\n  const stdout = io.stdout ?? console.log;\n  const stderr = io.stderr ?? console.error;\n  const env = io.env ?? process.env;\n  const parsed = parseAgentArgs(args);\n\n  if (parsed.help) {\n    stdout(formatAgentUsage());\n    return 0;\n  }\n  if (!parsed.prompt?.trim()) {\n    parsed.errors.push('Missing \"prompt\"');\n  }\n  if (parsed.errors.length > 0) {\n    stderr(parsed.errors.join(\"\\n\"));\n    stderr(\"\");\n    stderr(formatAgentUsage());\n    return 1;\n  }\n\n  const ownerEmail =\n    parsed.userEmail ?? env.AGENT_USER_EMAIL ?? (await resolveDevUserEmail());\n  const orgId = parsed.orgId ?? env.AGENT_ORG_ID ?? undefined;\n\n  try {\n    const result = await runWithRequestContext(\n      { userEmail: ownerEmail, orgId },\n      () => runLocalAgentLoop(parsed),\n    );\n    if (parsed.json) {\n      stdout(JSON.stringify(result, null, 2));\n    } else {\n      stdout(result.responseText.trimEnd());\n      if (result.responseText && !result.responseText.endsWith(\"\\n\")) {\n        stdout(\"\");\n      }\n    }\n    return 0;\n  } catch (err) {\n    stderr(err instanceof Error ? err.message : String(err));\n    return 1;\n  }\n}\n\nasync function runLocalAgentLoop(parsed: ParsedAgentArgs): Promise<{\n  responseText: string;\n  usage: AgentLoopUsage;\n  events: AgentChatEvent[];\n  tools: string[];\n}> {\n  const localActions = await autoDiscoverActions(\"auto\");\n  const builtinActions = await createHeadlessBuiltinActions();\n  const repoActions = createGitHubRepoToolEntries({\n    appId: process.env.AGENT_NATIVE_APP_ID ?? process.env.APP_ID ?? \"app\",\n  });\n  const actions = { ...builtinActions, ...localActions, ...repoActions };\n  const tools = actionsToEngineTools(actions);\n  if (tools.length === 0) {\n    throw new Error(\n      \"No agent-callable actions were found. Add actions/*.ts with defineAction() first.\",\n    );\n  }\n\n  const engine = await resolveEngine({\n    engineOption: parsed.engine,\n    model: parsed.model,\n  });\n  const model = parsed.model ?? engine.defaultModel ?? DEFAULT_MODEL;\n  const messages: EngineMessage[] = [\n    {\n      role: \"user\",\n      content: [{ type: \"text\", text: parsed.prompt!.trim() }],\n    },\n  ];\n  const events: AgentChatEvent[] = [];\n  let responseText = \"\";\n  const controller = new AbortController();\n  const ownerEmail = getRequestUserEmail();\n  const orgId = getRequestOrgId();\n\n  const usage = await runAgentLoopDirectWithSoftTimeout(\n    {\n      engine,\n      model,\n      systemPrompt: buildHeadlessSystemPrompt(tools.map((tool) => tool.name)),\n      tools,\n      actions,\n      messages,\n      signal: controller.signal,\n      ownerEmail,\n      orgId,\n      maxIterations: parsed.maxIterations,\n      send(event) {\n        events.push(event);\n        if (event.type === \"text\") {\n          responseText += event.text ?? \"\";\n        }\n      },\n    },\n    parsed.softTimeoutMs,\n  );\n\n  return {\n    responseText,\n    usage,\n    events,\n    tools: tools.map((tool) => tool.name).sort(),\n  };\n}\n\nfunction buildHeadlessSystemPrompt(actionNames: string[]): string {\n  const instructions = readLocalInstructions();\n  const actionList =\n    actionNames.length > 0\n      ? `Available local actions: ${actionNames.join(\", \")}.`\n      : \"No local actions were discovered.\";\n  return [\n    \"You are the app agent for this Agent-Native project.\",\n    \"Use the registered app actions as your source of truth for doing work.\",\n    \"Use docs-search before implementing or answering advanced Agent Native framework questions; it reads the version-matched docs bundled with @agent-native/core.\",\n    \"Use connected GitHub repository tools for repo context when a repository is configured; do not assume a local clone or sandbox exists.\",\n    \"You are running headlessly from the command line, so reply with the final useful result in plain text.\",\n    actionList,\n    instructions ? `Project instructions:\\n${instructions}` : \"\",\n  ]\n    .filter(Boolean)\n    .join(\"\\n\\n\");\n}\n\nfunction cliArgsFromToolArgs(args: Record<string, unknown>): string[] {\n  const cliArgs: string[] = [];\n  for (const [key, value] of Object.entries(args)) {\n    if (value === undefined) continue;\n    const normalized =\n      value != null && typeof value === \"object\"\n        ? JSON.stringify(value)\n        : String(value);\n    cliArgs.push(`--${key}`, normalized);\n  }\n  return cliArgs;\n}\n\nexport async function createHeadlessBuiltinActions(): Promise<\n  Record<string, ActionEntry>\n> {\n  const docsSearch = await import(\"../scripts/docs/search.js\");\n  return {\n    \"docs-search\": {\n      readOnly: true,\n      tool: {\n        description:\n          \"Search and read version-matched Agent Native framework documentation bundled in @agent-native/core, plus bundled AGENTS.md and codebase skills. Use --list to see pages, --query to search, and --slug to read a page.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            query: {\n              type: \"string\",\n              description:\n                \"Search term to find relevant docs, for example actions, automations, a2a, database, sharing, or pure-agent apps.\",\n            },\n            slug: {\n              type: \"string\",\n              description:\n                \"Read a specific doc page by slug, for example actions, agent-native-docs, automations, a2a-protocol, or external-agents.\",\n            },\n            list: {\n              type: \"string\",\n              description: 'Set to \"true\" to list all available doc pages.',\n              enum: [\"true\"],\n            },\n          },\n        },\n      },\n      run: async (args: Record<string, unknown>): Promise<string> => {\n        return captureCliOutput(() =>\n          docsSearch.default(cliArgsFromToolArgs(args)),\n        );\n      },\n    },\n  };\n}\n\nfunction readLocalInstructions(): string {\n  const candidates = [\"AGENTS.md\", \"CLAUDE.md\", \"README.md\"];\n  const chunks: string[] = [];\n  for (const name of candidates) {\n    const file = path.resolve(process.cwd(), name);\n    try {\n      if (!fs.existsSync(file)) continue;\n      const content = fs.readFileSync(file, \"utf8\").trim();\n      if (!content) continue;\n      chunks.push(`# ${name}\\n${content.slice(0, 12_000)}`);\n    } catch {\n      // Ignore unreadable local instruction files.\n    }\n  }\n  return chunks.join(\"\\n\\n\");\n}\n\nfunction parsePositiveInteger(\n  flag: string,\n  value: string,\n  parsed: ParsedAgentArgs,\n): number | undefined {\n  const n = Number(value);\n  if (!Number.isInteger(n) || n <= 0) {\n    parsed.errors.push(`${flag} must be a positive integer`);\n    return undefined;\n  }\n  return n;\n}\n\nexport function formatAgentUsage(): string {\n  return [\n    'Usage: agent-native agent \"prompt\" [options]',\n    \"\",\n    \"Runs the production app-agent loop once against this folder's actions/ directory.\",\n    \"\",\n    \"Options:\",\n    \"  --message <text>            Prompt (alias for positional prompt)\",\n    \"  --engine <name>             Agent engine name (defaults to env/settings)\",\n    \"  --model <name>              Model override\",\n    \"  --user-email <email>        Owner identity for scoped actions\",\n    \"  --org-id <id>               Organization id for scoped credentials\",\n    \"  --soft-timeout-ms <n>       Soft timeout before continuation recovery\",\n    \"  --no-soft-timeout           Disable continuation soft timeout wrapper\",\n    \"  --max-iterations <n>        Maximum tool/LLM loop iterations\",\n    \"  --json                      Print response, events, usage, and tools\",\n  ].join(\"\\n\");\n}\n"]}

package/dist/cli/agents.d.ts

@@ -0,0 +1,14 @@
+export interface ParsedAgentsArgs {
+    command: "list" | "help";
+    selfAppId?: string;
+    json: boolean;
+    errors: string[];
+}
+export interface AgentsCliIo {
+    stdout?: (text: string) => void;
+    stderr?: (text: string) => void;
+}
+export declare function parseAgentsArgs(args: string[]): ParsedAgentsArgs;
+export declare function runAgents(args: string[], io?: AgentsCliIo): Promise<number>;
+export declare function formatAgentsUsage(): string;
+//# sourceMappingURL=agents.d.ts.map

package/dist/cli/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/cli/agents.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAiDhE;AAED,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,WAAgB,GACnB,OAAO,CAAC,MAAM,CAAC,CAyCjB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C"}

package/dist/cli/agents.js

@@ -0,0 +1,95 @@
+import { discoverAgents } from "../server/agent-discovery.js";
+export function parseAgentsArgs(args) {
+    const parsed = {
+        command: "list",
+        json: false,
+        errors: [],
+    };
+    const positional = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const eqIndex = arg.indexOf("=");
+        const name = eqIndex === -1 ? arg.slice("--".length) : arg.slice("--".length, eqIndex);
+        const inlineValue = eqIndex === -1 ? undefined : arg.slice(eqIndex + 1);
+        if (name === "help" || name === "h") {
+            parsed.command = "help";
+            continue;
+        }
+        if (name === "json") {
+            parsed.json = true;
+            continue;
+        }
+        if (name === "self" || name === "self-app-id") {
+            const value = inlineValue ??
+                (args[i + 1] !== undefined && !args[i + 1].startsWith("--")
+                    ? args[++i]
+                    : undefined);
+            if (!value) {
+                parsed.errors.push(`Missing value for --${name}`);
+            }
+            else {
+                parsed.selfAppId = value;
+            }
+            continue;
+        }
+        parsed.errors.push(`Unknown option: --${name}`);
+    }
+    if (positional[0] === "help")
+        parsed.command = "help";
+    if (positional[0] && positional[0] !== "list" && positional[0] !== "help") {
+        parsed.errors.push(`Unknown agents command: ${positional[0]}`);
+    }
+    return parsed;
+}
+export async function runAgents(args, io = {}) {
+    const stdout = io.stdout ?? console.log;
+    const stderr = io.stderr ?? console.error;
+    const parsed = parseAgentsArgs(args);
+    if (parsed.command === "help") {
+        stdout(formatAgentsUsage());
+        return 0;
+    }
+    if (parsed.errors.length > 0) {
+        stderr(parsed.errors.join("\n"));
+        stderr("");
+        stderr(formatAgentsUsage());
+        return 1;
+    }
+    const agents = await discoverAgents(parsed.selfAppId);
+    if (parsed.json) {
+        stdout(JSON.stringify({ agents }, null, 2));
+        return 0;
+    }
+    if (agents.length === 0) {
+        stdout("No connected agents found.");
+        return 0;
+    }
+    const rows = agents.map((agent) => ({
+        id: agent.id,
+        name: agent.name,
+        url: agent.url,
+    }));
+    const idWidth = Math.max(2, ...rows.map((row) => row.id.length));
+    const nameWidth = Math.max(4, ...rows.map((row) => row.name.length));
+    stdout(`${"ID".padEnd(idWidth)}  ${"Name".padEnd(nameWidth)}  URL`);
+    for (const row of rows) {
+        stdout(`${row.id.padEnd(idWidth)}  ${row.name.padEnd(nameWidth)}  ${row.url}`);
+    }
+    return 0;
+}
+export function formatAgentsUsage() {
+    return [
+        "Usage: agent-native agents list [options]",
+        "",
+        "Lists discoverable agent-native apps from the same registry used by chat and A2A.",
+        "",
+        "Options:",
+        "  --self-app-id <id>          Exclude the current app from results",
+        "  --json                      Print machine-readable output",
+    ].join("\n");
+}
+//# sourceMappingURL=agents.js.map

package/dist/cli/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/cli/agents.ts"],"names":[],"mappings":"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","sourcesContent":["import { discoverAgents } from \"../server/agent-discovery.js\";\n\nexport interface ParsedAgentsArgs {\n  command: \"list\" | \"help\";\n  selfAppId?: string;\n  json: boolean;\n  errors: string[];\n}\n\nexport interface AgentsCliIo {\n  stdout?: (text: string) => void;\n  stderr?: (text: string) => void;\n}\n\nexport function parseAgentsArgs(args: string[]): ParsedAgentsArgs {\n  const parsed: ParsedAgentsArgs = {\n    command: \"list\",\n    json: false,\n    errors: [],\n  };\n  const positional: string[] = [];\n\n  for (let i = 0; i < args.length; i += 1) {\n    const arg = args[i];\n    if (!arg.startsWith(\"--\")) {\n      positional.push(arg);\n      continue;\n    }\n    const eqIndex = arg.indexOf(\"=\");\n    const name =\n      eqIndex === -1 ? arg.slice(\"--\".length) : arg.slice(\"--\".length, eqIndex);\n    const inlineValue = eqIndex === -1 ? undefined : arg.slice(eqIndex + 1);\n\n    if (name === \"help\" || name === \"h\") {\n      parsed.command = \"help\";\n      continue;\n    }\n    if (name === \"json\") {\n      parsed.json = true;\n      continue;\n    }\n    if (name === \"self\" || name === \"self-app-id\") {\n      const value =\n        inlineValue ??\n        (args[i + 1] !== undefined && !args[i + 1].startsWith(\"--\")\n          ? args[++i]\n          : undefined);\n      if (!value) {\n        parsed.errors.push(`Missing value for --${name}`);\n      } else {\n        parsed.selfAppId = value;\n      }\n      continue;\n    }\n    parsed.errors.push(`Unknown option: --${name}`);\n  }\n\n  if (positional[0] === \"help\") parsed.command = \"help\";\n  if (positional[0] && positional[0] !== \"list\" && positional[0] !== \"help\") {\n    parsed.errors.push(`Unknown agents command: ${positional[0]}`);\n  }\n\n  return parsed;\n}\n\nexport async function runAgents(\n  args: string[],\n  io: AgentsCliIo = {},\n): Promise<number> {\n  const stdout = io.stdout ?? console.log;\n  const stderr = io.stderr ?? console.error;\n  const parsed = parseAgentsArgs(args);\n\n  if (parsed.command === \"help\") {\n    stdout(formatAgentsUsage());\n    return 0;\n  }\n  if (parsed.errors.length > 0) {\n    stderr(parsed.errors.join(\"\\n\"));\n    stderr(\"\");\n    stderr(formatAgentsUsage());\n    return 1;\n  }\n\n  const agents = await discoverAgents(parsed.selfAppId);\n  if (parsed.json) {\n    stdout(JSON.stringify({ agents }, null, 2));\n    return 0;\n  }\n\n  if (agents.length === 0) {\n    stdout(\"No connected agents found.\");\n    return 0;\n  }\n\n  const rows = agents.map((agent) => ({\n    id: agent.id,\n    name: agent.name,\n    url: agent.url,\n  }));\n  const idWidth = Math.max(2, ...rows.map((row) => row.id.length));\n  const nameWidth = Math.max(4, ...rows.map((row) => row.name.length));\n  stdout(`${\"ID\".padEnd(idWidth)}  ${\"Name\".padEnd(nameWidth)}  URL`);\n  for (const row of rows) {\n    stdout(\n      `${row.id.padEnd(idWidth)}  ${row.name.padEnd(nameWidth)}  ${row.url}`,\n    );\n  }\n  return 0;\n}\n\nexport function formatAgentsUsage(): string {\n  return [\n    \"Usage: agent-native agents list [options]\",\n    \"\",\n    \"Lists discoverable agent-native apps from the same registry used by chat and A2A.\",\n    \"\",\n    \"Options:\",\n    \"  --self-app-id <id>          Exclude the current app from results\",\n    \"  --json                      Print machine-readable output\",\n  ].join(\"\\n\");\n}\n"]}

package/dist/cli/code-agent-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-agent-executor.d.ts","sourceRoot":"","sources":["../../src/cli/code-agent-executor.ts"],"names":[],"mappings":"AA8BA,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAQlC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAQL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AA6BD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA+YpC;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAM,GACtD,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAYpC;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA4FpC;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0CpC;AAyTD;;;;;;;;;;;;;;;;;GAiBG;AACH,wCAAwC;AACxC,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,OAAO,sBAAsB,EAAE,wBAAwB,EAAE,GACzE,aAAa,EAAE,CAmHjB;AAmED;;;;;;;;;GASG;AACH,wCAAwC;AACxC,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,uBAAuB,GACtC,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,uBAAuB,EACvC,qBAAqB,SAAK,EAC1B,WAAW,SAAK,GACf,MAAM,CA4DR;AA2DD,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,GACd,0BAA0B,CAuD5B"}
+{"version":3,"file":"code-agent-executor.d.ts","sourceRoot":"","sources":["../../src/cli/code-agent-executor.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EACV,WAAW,EAEX,aAAa,EAEd,MAAM,0BAA0B,CAAC;AAQlC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAQL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAsCD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA4ZpC;AA8RD,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAM,GACtD,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED;;;;GAIG;AACH,wBAAsB,qCAAqC,CACzD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAYpC;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA4FpC;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAAO,GAC/C,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA0CpC;AAyTD;;;;;;;;;;;;;;;;;GAiBG;AACH,wCAAwC;AACxC,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,SAAS,OAAO,sBAAsB,EAAE,wBAAwB,EAAE,GACzE,aAAa,EAAE,CAmHjB;AAmED;;;;;;;;;GASG;AACH,wCAAwC;AACxC,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,uBAAuB,GACtC,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wCAAwC;AACxC,wBAAgB,0BAA0B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,cAAc,EAAE,uBAAuB,EACvC,qBAAqB,SAAK,EAC1B,WAAW,SAAK,GACf,MAAM,CA4DR;AA2DD,MAAM,MAAM,0BAA0B,GAClC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,MAAM,GACd,0BAA0B,CAuD5B"}