arcie 0.1.3 → 0.1.5

package/README.md

@@ -1,11 +1,11 @@
-# Eline
+# Arcie
 
 The electronic line — build agents at the speed of light.
 
-> Site: [cencori.com/eline](https://cencori.com/eline) · Docs: [cencori.com/eline/docs](https://cencori.com/eline/docs)
+> Site: [cencori.com/arcie](https://cencori.com/arcie) · Docs: [cencori.com/arcie/docs](https://cencori.com/arcie/docs)
 
 ```
-npx eline@latest init my-agent
+npx arcie@latest init my-agent
 ```
 
 ```
@@ -27,7 +27,7 @@ my-agent/
 ## Quick Start
 
 ```bash
-npx eline@latest init my-agent
+npx arcie@latest init my-agent
 cd my-agent
 npm run dev
 ```
@@ -36,7 +36,7 @@ npm run dev
 
 ```ts
 // agent/agent.ts
-import { defineAgent } from "eline";
+import { defineAgent } from "arcie";
 
 export default defineAgent({
   model: "claude-sonnet-4-5",
@@ -49,7 +49,7 @@ export default defineAgent({
 
 ```ts
 // agent/tools/get_weather.ts
-import { defineTool } from "eline/tools";
+import { defineTool } from "arcie/tools";
 import { z } from "zod";
 
 export default defineTool({
@@ -61,6 +61,34 @@ export default defineTool({
 });
 ```
 
+## Subagents
+
+Drop a specialist under `agent/subagents/<id>/` and the orchestrator can delegate
+a focused subtask to it. Each subagent is a full agent with its own instructions
+and tools, and **must declare a `description`** so the model knows when to use it.
+
+```
+agent/subagents/researcher/
+├── agent.ts          # defineAgent({ model, description })  ← description required
+├── instructions.md   # optional
+└── tools/            # optional — the subagent's own tools
+```
+
+```ts
+// agent/subagents/researcher/agent.ts
+import { defineAgent } from "arcie";
+
+export default defineAgent({
+  model: "claude-sonnet-4-5",
+  description: "Investigate ambiguous questions before the parent agent responds.",
+});
+```
+
+The orchestrator sees each subagent as a tool it can call with a `message` (plus an
+optional `outputSchema` for structured results). Every call runs in a **fresh,
+isolated session** — the subagent never inherits the parent's history, so the main
+agent's context stays lean. See [docs/subagents.md](docs/subagents.md).
+
 ## License
 
 MIT

package/dist/agent/index.d.ts

@@ -1,3 +1,6 @@
-import type { AgentConfig } from "../types.js";
-export declare function defineAgent(config: AgentConfig): AgentConfig;
-//# sourceMappingURL=index.d.ts.map
+import { a as AgentConfig } from '../types-DwxwdSa2.js';
+import 'zod';
+
+declare function defineAgent(config: AgentConfig): AgentConfig;
+
+export { defineAgent };

package/dist/agent/index.js

@@ -1,7 +1,7 @@
-export function defineAgent(config) {
-    if (!config.model) {
-        throw new Error("Agent must specify a model");
-    }
-    return config;
-}
+import {
+  defineAgent
+} from "../chunk-FQ7KDNV5.js";
+export {
+  defineAgent
+};
 //# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,MAAmB;IAC7C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/auth/index.d.ts

@@ -1,10 +1,11 @@
-export type TokenValue = string | (() => string | Promise<string>);
-export type OutboundAuthFn = () => Promise<{
+type TokenValue = string | (() => string | Promise<string>);
+type OutboundAuthFn = () => Promise<{
     readonly headers: Readonly<Record<string, string>>;
 }>;
-export declare function bearer(token: TokenValue): OutboundAuthFn;
-export declare function basic(input: {
+declare function bearer(token: TokenValue): OutboundAuthFn;
+declare function basic(input: {
     username: string;
     password: TokenValue;
 }): OutboundAuthFn;
-//# sourceMappingURL=index.d.ts.map
+
+export { type OutboundAuthFn, type TokenValue, basic, bearer };

package/dist/auth/index.js

@@ -1,18 +1,9 @@
-export function bearer(token) {
-    return async () => ({
-        headers: {
-            authorization: `Bearer ${await resolveToken(token)}`,
-        },
-    });
-}
-export function basic(input) {
-    return async () => ({
-        headers: {
-            authorization: `Basic ${btoa(`${input.username}:${await resolveToken(input.password)}`)}`,
-        },
-    });
-}
-async function resolveToken(value) {
-    return typeof value === "function" ? await value() : value;
-}
+import {
+  basic,
+  bearer
+} from "../chunk-CKHBEZCT.js";
+export {
+  basic,
+  bearer
+};
 //# sourceMappingURL=index.js.map

package/dist/auth/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auth/index.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QAClB,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,YAAY,CAAC,KAAK,CAAC,EAAE;SACrD;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAGrB;IACC,OAAO,KAAK,IAAI,EAAE,CAAC,CAAC;QAClB,OAAO,EAAE;YACP,aAAa,EAAE,SAAS,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;SAC1F;KACF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAiB;IAC3C,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/build-TWNCPXBU.js

@@ -0,0 +1,82 @@
+import {
+  dimmed,
+  grey
+} from "./chunk-N5R3TEEZ.js";
+import {
+  loadAgent
+} from "./chunk-KVSX4MLK.js";
+import {
+  discoverAgent
+} from "./chunk-6XETPLIF.js";
+
+// src/cli/build.ts
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { resolve, join } from "path";
+async function buildCommand(options) {
+  const agentDirPath = resolve(process.cwd(), options.agentDir);
+  const outDir = resolve(process.cwd(), options.outDir);
+  console.log(`
+  Building agent...
+`);
+  if (!existsSync(agentDirPath)) {
+    console.error(`  Agent directory not found: ${agentDirPath}`);
+    process.exit(1);
+  }
+  const { agent: discovered, diagnostics } = discoverAgent(agentDirPath);
+  if (diagnostics.some((d) => d.severity === "error")) {
+    for (const d of diagnostics) {
+      console.error(`  ${grey("\u2716")} ${d.code}: ${d.message}`);
+    }
+    process.exit(1);
+  }
+  try {
+    const agent = await loadAgent(agentDirPath);
+    mkdirSync(outDir, { recursive: true });
+    const manifest = {
+      config: agent.manifest.config,
+      instructions: agent.manifest.instructions,
+      tools: Object.keys(agent.manifest.tools),
+      skills: Object.keys(agent.manifest.skills),
+      hooks: Object.keys(agent.manifest.hooks),
+      channels: Object.keys(agent.manifest.channels),
+      connections: Object.keys(agent.manifest.connections),
+      schedules: Object.keys(agent.manifest.schedules),
+      subagents: Object.fromEntries(
+        Object.entries(agent.manifest.subagents).map(([id, sub]) => [
+          id,
+          { description: sub.config.description, tools: Object.keys(sub.tools) }
+        ])
+      ),
+      discovered: {
+        tools: discovered.tools.map((t) => t.name),
+        skills: discovered.skills.map((s) => s.name),
+        hooks: discovered.hooks.map((h) => h.name),
+        channels: discovered.channels.map((c) => c.name),
+        connections: discovered.connections.map((c) => c.name),
+        schedules: discovered.schedules.map((s) => s.name),
+        subagents: discovered.subagents.map((s) => s.id)
+      },
+      session: agent.manifest.session,
+      policy: agent.manifest.policy
+    };
+    writeFileSync(join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2));
+    console.log(`  Written to ${dimmed(`${outDir}/manifest.json`)}`);
+    console.log(`  ${grey(`\xB7 ${manifest.tools.length} tools`)}`);
+    console.log(`  ${grey(`\xB7 ${manifest.skills.length} skills`)}`);
+    console.log(`  ${grey(`\xB7 ${manifest.channels.length} channels`)}`);
+    console.log(`  ${grey(`\xB7 ${manifest.connections.length} connections`)}`);
+    console.log(`  ${grey(`\xB7 ${manifest.schedules.length} schedules`)}`);
+    console.log(`  ${grey(`\xB7 ${Object.keys(manifest.subagents).length} subagents`)}`);
+    console.log();
+    console.log(`  ${grey("\u2500".repeat(50))}`);
+    console.log(`  ${grey("Build complete.")}`);
+    console.log();
+  } catch (err) {
+    console.error(`  Build failed:`, err);
+    process.exit(1);
+  }
+}
+export {
+  buildCommand
+};
+//# sourceMappingURL=build-TWNCPXBU.js.map

package/dist/build-TWNCPXBU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/build.ts"],"sourcesContent":["import { mkdirSync, writeFileSync, existsSync } from \"node:fs\";\nimport { resolve, join } from \"node:path\";\nimport { loadAgent } from \"../loader\";\nimport { discoverAgent } from \"../discover/index\";\nimport { grey, dimmed } from \"./style\";\n\nexport async function buildCommand(options: {\n  agentDir: string;\n  outDir: string;\n}): Promise<void> {\n  const agentDirPath = resolve(process.cwd(), options.agentDir);\n  const outDir = resolve(process.cwd(), options.outDir);\n\n  console.log(`\\n  Building agent...\\n`);\n\n  if (!existsSync(agentDirPath)) {\n    console.error(`  Agent directory not found: ${agentDirPath}`);\n    process.exit(1);\n  }\n\n  const { agent: discovered, diagnostics } = discoverAgent(agentDirPath);\n\n  if (diagnostics.some((d) => d.severity === \"error\")) {\n    for (const d of diagnostics) {\n      console.error(`  ${grey(\"\\u2716\")} ${d.code}: ${d.message}`);\n    }\n    process.exit(1);\n  }\n\n  try {\n    const agent = await loadAgent(agentDirPath);\n\n    mkdirSync(outDir, { recursive: true });\n\n    const manifest = {\n      config: agent.manifest.config,\n      instructions: agent.manifest.instructions,\n      tools: Object.keys(agent.manifest.tools),\n      skills: Object.keys(agent.manifest.skills),\n      hooks: Object.keys(agent.manifest.hooks),\n      channels: Object.keys(agent.manifest.channels),\n      connections: Object.keys(agent.manifest.connections),\n      schedules: Object.keys(agent.manifest.schedules),\n      subagents: Object.fromEntries(\n        Object.entries(agent.manifest.subagents).map(([id, sub]) => [\n          id,\n          { description: sub.config.description, tools: Object.keys(sub.tools) },\n        ]),\n      ),\n      discovered: {\n        tools: discovered.tools.map((t) => t.name),\n        skills: discovered.skills.map((s) => s.name),\n        hooks: discovered.hooks.map((h) => h.name),\n        channels: discovered.channels.map((c) => c.name),\n        connections: discovered.connections.map((c) => c.name),\n        schedules: discovered.schedules.map((s) => s.name),\n        subagents: discovered.subagents.map((s) => s.id),\n      },\n      session: agent.manifest.session,\n      policy: agent.manifest.policy,\n    };\n\n    writeFileSync(join(outDir, \"manifest.json\"), JSON.stringify(manifest, null, 2));\n\n    console.log(`  Written to ${dimmed(`${outDir}/manifest.json`)}`);\n    console.log(`  ${grey(`\\xB7 ${manifest.tools.length} tools`)}`);\n    console.log(`  ${grey(`\\xB7 ${manifest.skills.length} skills`)}`);\n    console.log(`  ${grey(`\\xB7 ${manifest.channels.length} channels`)}`);\n    console.log(`  ${grey(`\\xB7 ${manifest.connections.length} connections`)}`);\n    console.log(`  ${grey(`\\xB7 ${manifest.schedules.length} schedules`)}`);\n    console.log(`  ${grey(`\\xB7 ${Object.keys(manifest.subagents).length} subagents`)}`);\n    console.log();\n    console.log(`  ${grey(\"\\u2500\".repeat(50))}`);\n    console.log(`  ${grey(\"Build complete.\")}`);\n    console.log();\n  } catch (err) {\n    console.error(`  Build failed:`, err);\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/channels/index.d.ts

@@ -1,5 +1,8 @@
-import type { ChannelConfig } from "../types.js";
-export declare function defineChannel(config: ChannelConfig): ChannelConfig;
-export declare function POST(handler: ChannelConfig["handler"]): ChannelConfig["handler"];
-export declare function GET(handler: ChannelConfig["handler"]): ChannelConfig["handler"];
-//# sourceMappingURL=index.d.ts.map
+import { d as ChannelConfig } from '../types-DwxwdSa2.js';
+import 'zod';
+
+declare function defineChannel(config: ChannelConfig): ChannelConfig;
+declare function POST(handler: ChannelConfig["handler"]): ChannelConfig["handler"];
+declare function GET(handler: ChannelConfig["handler"]): ChannelConfig["handler"];
+
+export { GET, POST, defineChannel };

package/dist/channels/index.js

@@ -1,13 +1,11 @@
-export function defineChannel(config) {
-    if (!config.name || !config.handler) {
-        throw new Error("Channel must have name and handler");
-    }
-    return config;
-}
-export function POST(handler) {
-    return handler;
-}
-export function GET(handler) {
-    return handler;
-}
+import {
+  GET,
+  POST,
+  defineChannel
+} from "../chunk-ZJNHQXMO.js";
+export {
+  GET,
+  POST,
+  defineChannel
+};
 //# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,OAAiC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAiC;IACnD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-3CNQ6HQV.js

@@ -0,0 +1,12 @@
+// src/hooks/index.ts
+function defineHook(config) {
+  if (!config.name || !config.event || !config.handler) {
+    throw new Error("Hook must have name, event, and handler");
+  }
+  return config;
+}
+
+export {
+  defineHook
+};
+//# sourceMappingURL=chunk-3CNQ6HQV.js.map

package/dist/chunk-3CNQ6HQV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/index.ts"],"sourcesContent":["import type { HookConfig } from \"../types\";\n\nexport function defineHook(config: HookConfig): HookConfig {\n  if (!config.name || !config.event || !config.handler) {\n    throw new Error(\"Hook must have name, event, and handler\");\n  }\n  return config;\n}\n"],"mappings":";AAEO,SAAS,WAAW,QAAgC;AACzD,MAAI,CAAC,OAAO,QAAQ,CAAC,OAAO,SAAS,CAAC,OAAO,SAAS;AACpD,UAAM,IAAI,MAAM,yCAAyC;AAAA,EAC3D;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-4L7WVCTU.js

@@ -0,0 +1,12 @@
+// src/schedules/index.ts
+function defineSchedule(config) {
+  if (!config.name || !config.cron || !config.handler) {
+    throw new Error("Schedule must have name, cron, and handler");
+  }
+  return config;
+}
+
+export {
+  defineSchedule
+};
+//# sourceMappingURL=chunk-4L7WVCTU.js.map

package/dist/chunk-4L7WVCTU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schedules/index.ts"],"sourcesContent":["import type { ScheduleConfig } from \"../types\";\n\nexport function defineSchedule(config: ScheduleConfig): ScheduleConfig {\n  if (!config.name || !config.cron || !config.handler) {\n    throw new Error(\"Schedule must have name, cron, and handler\");\n  }\n  return config;\n}\n"],"mappings":";AAEO,SAAS,eAAe,QAAwC;AACrE,MAAI,CAAC,OAAO,QAAQ,CAAC,OAAO,QAAQ,CAAC,OAAO,SAAS;AACnD,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AACA,SAAO;AACT;","names":[]}