@stackbone/sdk 0.1.0-alpha.7 → 0.1.0

package/{workflow-scheduler-DXCNKDOS.d.cts → agent-registry-BNXuj88Q.d.cts}

@@ -1,35 +1,31 @@
-/**
- * Augmentable registry of the workspace's eve agent NAMES. By default it is
- * empty, so `eveAgent(name)` accepts any `string` (today's behavior, validated
- * only at runtime against the injected `AGENT_URLS` map). `stackbone dev`
- * generates an ambient `.stackbone/agents.d.ts` from the project's
- * `stackbone.config.ts` agent list and augments this interface so the names
- * become a closed set:
- *
- *   declare module '@stackbone/sdk/workflow' {
- *     interface AgentRegistry {
- *       support: true;
- *       'lead-qualifier': true;
- *     }
- *   }
- *
- * Once augmented, `eveAgent('lead-qualifier')` is fine and `eveAgent('typo')` is
- * a compile error — the editor also autocompletes the declared names. Mirrors the
- * `ConfigRegistry` augmentable-interface pattern used for `client.config`.
- */
-interface AgentRegistry {
+/** One active scheduled trigger, as `listSchedules()` reports it. */
+interface ScheduledWorkflow {
+    /** The workflow this trigger starts on each tick. */
+    readonly name: string;
+    /** The cron expression driving the cadence. */
+    readonly cron: string;
+    /** The input each tick passes to the workflow. */
+    readonly input: unknown;
+    /** `'declarative'` (harvested from the workflow, reconciled on boot) or
+     *  `'dynamic'` (registered at run time via `scheduleWorkflow`). */
+    readonly source: 'declarative' | 'dynamic';
 }
-/**
- * The set of agent names `eveAgent` accepts, derived from the augmentable
- * `AgentRegistry`. The tuple wrap (`[X] extends [never]`) defeats the
- * conditional-type distributivity a bare `keyof AgentRegistry extends never`
- * would trigger:
- *
- * - empty registry  -> `string` (today's loose behavior: any name, checked at
- *   runtime when the workflow resolves it against `AGENT_URLS`);
- * - augmented registry -> the union of declared agent names (typo = compile error).
- */
-type AgentName = [keyof AgentRegistry] extends [never] ? string : keyof AgentRegistry;
+/** The runtime-injected bridge the imperative cron helpers reach. */
+interface WorkflowScheduler {
+    /** Register (or upsert) a DYNAMIC repeatable trigger that starts `name` with
+     *  `input` on the `cron` cadence. Idempotent by `name`. */
+    schedule(name: string, input: unknown, cron: string): Promise<void>;
+    /** Cancel a dynamic trigger by `name`. Resolves whether or not one existed. */
+    unschedule(name: string): Promise<void>;
+    /** List the active triggers — declarative + dynamic. */
+    listSchedules(): Promise<ScheduledWorkflow[]>;
+}
+/** Plant (or clear, with `undefined`) the ambient scheduler. The runtime calls
+ *  this on first dispatch; tests pass a fake. Last write wins. */
+declare function setWorkflowScheduler(scheduler: WorkflowScheduler | undefined): void;
+/** Return the bound ambient scheduler, or throw a clear error when none is bound
+ *  (the imperative cron API was reached outside a running workflow runtime). */
+declare function getWorkflowScheduler(): WorkflowScheduler;
 
 /**
  * Queue-level options for a workflow trigger.
@@ -87,33 +83,116 @@ declare function setWorkflowStarter(starter: WorkflowStarter | undefined): void;
  */
 declare function getWorkflowStarter(): WorkflowStarter;
 
-/** One active scheduled trigger, as `listSchedules()` reports it. */
-interface ScheduledWorkflow {
-    /** The workflow this trigger starts on each tick. */
-    readonly name: string;
-    /** The cron expression driving the cadence. */
-    readonly cron: string;
-    /** The input each tick passes to the workflow. */
-    readonly input: unknown;
-    /** `'declarative'` (harvested from the workflow, reconciled on boot) or
-     *  `'dynamic'` (registered at run time via `scheduleWorkflow`). */
-    readonly source: 'declarative' | 'dynamic';
+/**
+ * Augmentable registry of the workspace's WORKFLOW names. By default it is empty,
+ * so `startWorkflow(name, ...)` / `startWorkflowAndWait(name, ...)` accept any
+ * `string` (today's behavior, validated only at runtime against the injected
+ * name→ref registry). `stackbone dev` generates an ambient
+ * `.stackbone/workflows.d.ts` from the project's `stackbone.config.ts` workflow
+ * list and augments this interface so the names become a closed set:
+ *
+ *   declare module '@stackbone/sdk/workflow' {
+ *     interface WorkflowRegistry {
+ *       onboarding: true;
+ *       qualifyLead: true;
+ *     }
+ *   }
+ *
+ * Once augmented, `startWorkflow('qualifyLead', ...)` is fine and
+ * `startWorkflow('typo', ...)` is a compile error — the editor also autocompletes
+ * the declared names. Mirrors the `AgentRegistry` augmentable-interface pattern
+ * used for `eveAgent`.
+ */
+interface WorkflowRegistry {
 }
-/** The runtime-injected bridge the imperative cron helpers reach. */
-interface WorkflowScheduler {
-    /** Register (or upsert) a DYNAMIC repeatable trigger that starts `name` with
-     *  `input` on the `cron` cadence. Idempotent by `name`. */
-    schedule(name: string, input: unknown, cron: string): Promise<void>;
-    /** Cancel a dynamic trigger by `name`. Resolves whether or not one existed. */
-    unschedule(name: string): Promise<void>;
-    /** List the active triggers — declarative + dynamic. */
-    listSchedules(): Promise<ScheduledWorkflow[]>;
+/**
+ * The set of workflow names the trigger helpers accept, derived from the
+ * augmentable `WorkflowRegistry`. The tuple wrap (`[X] extends [never]`) defeats
+ * the conditional-type distributivity a bare `keyof WorkflowRegistry extends
+ * never` would trigger:
+ *
+ * - empty registry  -> `string` (today's loose behavior: any name, checked at
+ *   runtime when the workflow resolves it against the manifest);
+ * - augmented registry -> the union of declared workflow names (typo = compile error).
+ */
+type WorkflowName = [keyof WorkflowRegistry] extends [never] ? string : keyof WorkflowRegistry;
+
+/** Options for {@link startWorkflow}. See {@link WorkflowTriggerOptions}. */
+type StartWorkflowOptions = WorkflowTriggerOptions;
+
+/**
+ * Start the workflow named `name` with its own independent run and return its
+ * `{ runId }` immediately — fire-and-forget. The input is validated against the
+ * target's declared input schema BEFORE the run is enqueued; a name that does
+ * not resolve, or input that violates the schema, rejects without starting
+ * anything.
+ *
+ * `name` is typed `WorkflowName` — a loose `string` by default, narrowed to the
+ * workspace's declared workflow names once `stackbone dev` has generated
+ * `.stackbone/workflows.d.ts` (see `workflow-registry.ts`), so a typo becomes a
+ * compile error.
+ *
+ * MUST be called from inside a running workflow (the runtime binds the starter on
+ * first dispatch); calling it elsewhere throws.
+ *
+ * DURABILITY: the enqueue runs in a `"use step"`, so once it completes a parent
+ * restart resumes with the memoized `{ runId }` and does NOT re-enqueue. A crash
+ * WHILE the step is mid-flight re-runs it (at-least-once) — the same shape the
+ * eve-agent-from-step path has; for fire-and-forget fan-out this is acceptable.
+ * Use {@link startWorkflowAndWait} when you need the child's result.
+ */
+declare function startWorkflow(name: WorkflowName, input: unknown, opts?: StartWorkflowOptions): Promise<WorkflowStartHandle>;
+
+/** Options for {@link startWorkflowAndWait}. See {@link WorkflowTriggerOptions}. */
+type StartWorkflowAndWaitOptions = WorkflowTriggerOptions;
+/**
+ * Start the workflow named `name` with its own independent run and durably wait
+ * for it to finish, returning its terminal output (validated against the
+ * target's declared output schema). Use this when one workflow needs another's
+ * result to continue.
+ *
+ * The input is validated against the target's declared input schema BEFORE the
+ * run is enqueued; a name that does not resolve, or input that violates the
+ * schema, rejects without starting anything. `TOutput` lets the caller name the
+ * expected output shape (defaults to `unknown`).
+ *
+ * `name` is typed `WorkflowName` — narrowed to the workspace's declared workflow
+ * names once `stackbone dev` has generated `.stackbone/workflows.d.ts`. MUST be
+ * called from inside a running workflow.
+ */
+declare function startWorkflowAndWait<TOutput = unknown>(name: WorkflowName, input: unknown, opts?: StartWorkflowAndWaitOptions): Promise<TOutput>;
+
+/**
+ * Augmentable registry of the workspace's eve agent NAMES. By default it is
+ * empty, so `eveAgent(name)` accepts any `string` (today's behavior, validated
+ * only at runtime against the injected `AGENT_URLS` map). `stackbone dev`
+ * generates an ambient `.stackbone/agents.d.ts` from the project's
+ * `stackbone.config.ts` agent list and augments this interface so the names
+ * become a closed set:
+ *
+ *   declare module '@stackbone/sdk/workflow' {
+ *     interface AgentRegistry {
+ *       support: true;
+ *       'lead-qualifier': true;
+ *     }
+ *   }
+ *
+ * Once augmented, `eveAgent('lead-qualifier')` is fine and `eveAgent('typo')` is
+ * a compile error — the editor also autocompletes the declared names. Mirrors the
+ * `ConfigRegistry` augmentable-interface pattern used for `client.config`.
+ */
+interface AgentRegistry {
 }
-/** Plant (or clear, with `undefined`) the ambient scheduler. The runtime calls
- *  this on first dispatch; tests pass a fake. Last write wins. */
-declare function setWorkflowScheduler(scheduler: WorkflowScheduler | undefined): void;
-/** Return the bound ambient scheduler, or throw a clear error when none is bound
- *  (the imperative cron API was reached outside a running workflow runtime). */
-declare function getWorkflowScheduler(): WorkflowScheduler;
+/**
+ * The set of agent names `eveAgent` accepts, derived from the augmentable
+ * `AgentRegistry`. The tuple wrap (`[X] extends [never]`) defeats the
+ * conditional-type distributivity a bare `keyof AgentRegistry extends never`
+ * would trigger:
+ *
+ * - empty registry  -> `string` (today's loose behavior: any name, checked at
+ *   runtime when the workflow resolves it against `AGENT_URLS`);
+ * - augmented registry -> the union of declared agent names (typo = compile error).
+ */
+type AgentName = [keyof AgentRegistry] extends [never] ? string : keyof AgentRegistry;
 
-export { type AgentName as A, type ScheduledWorkflow as S, type WorkflowTriggerOptions as W, type WorkflowStartHandle as a, type AgentRegistry as b, type WorkflowScheduler as c, type WorkflowStarter as d, getWorkflowStarter as e, setWorkflowStarter as f, getWorkflowScheduler as g, setWorkflowScheduler as s };
+export { type AgentName as A, type ScheduledWorkflow as S, type WorkflowName as W, type AgentRegistry as a, type StartWorkflowAndWaitOptions as b, type StartWorkflowOptions as c, type WorkflowRegistry as d, type WorkflowStartHandle as e, startWorkflowAndWait as f, type WorkflowScheduler as g, type WorkflowStarter as h, type WorkflowTriggerOptions as i, getWorkflowScheduler as j, getWorkflowStarter as k, setWorkflowScheduler as l, setWorkflowStarter as m, startWorkflow as s };

package/{workflow-scheduler-DXCNKDOS.d.ts → agent-registry-BNXuj88Q.d.ts}

@@ -1,35 +1,31 @@
-/**
- * Augmentable registry of the workspace's eve agent NAMES. By default it is
- * empty, so `eveAgent(name)` accepts any `string` (today's behavior, validated
- * only at runtime against the injected `AGENT_URLS` map). `stackbone dev`
- * generates an ambient `.stackbone/agents.d.ts` from the project's
- * `stackbone.config.ts` agent list and augments this interface so the names
- * become a closed set:
- *
- *   declare module '@stackbone/sdk/workflow' {
- *     interface AgentRegistry {
- *       support: true;
- *       'lead-qualifier': true;
- *     }
- *   }
- *
- * Once augmented, `eveAgent('lead-qualifier')` is fine and `eveAgent('typo')` is
- * a compile error — the editor also autocompletes the declared names. Mirrors the
- * `ConfigRegistry` augmentable-interface pattern used for `client.config`.
- */
-interface AgentRegistry {
+/** One active scheduled trigger, as `listSchedules()` reports it. */
+interface ScheduledWorkflow {
+    /** The workflow this trigger starts on each tick. */
+    readonly name: string;
+    /** The cron expression driving the cadence. */
+    readonly cron: string;
+    /** The input each tick passes to the workflow. */
+    readonly input: unknown;
+    /** `'declarative'` (harvested from the workflow, reconciled on boot) or
+     *  `'dynamic'` (registered at run time via `scheduleWorkflow`). */
+    readonly source: 'declarative' | 'dynamic';
 }
-/**
- * The set of agent names `eveAgent` accepts, derived from the augmentable
- * `AgentRegistry`. The tuple wrap (`[X] extends [never]`) defeats the
- * conditional-type distributivity a bare `keyof AgentRegistry extends never`
- * would trigger:
- *
- * - empty registry  -> `string` (today's loose behavior: any name, checked at
- *   runtime when the workflow resolves it against `AGENT_URLS`);
- * - augmented registry -> the union of declared agent names (typo = compile error).
- */
-type AgentName = [keyof AgentRegistry] extends [never] ? string : keyof AgentRegistry;
+/** The runtime-injected bridge the imperative cron helpers reach. */
+interface WorkflowScheduler {
+    /** Register (or upsert) a DYNAMIC repeatable trigger that starts `name` with
+     *  `input` on the `cron` cadence. Idempotent by `name`. */
+    schedule(name: string, input: unknown, cron: string): Promise<void>;
+    /** Cancel a dynamic trigger by `name`. Resolves whether or not one existed. */
+    unschedule(name: string): Promise<void>;
+    /** List the active triggers — declarative + dynamic. */
+    listSchedules(): Promise<ScheduledWorkflow[]>;
+}
+/** Plant (or clear, with `undefined`) the ambient scheduler. The runtime calls
+ *  this on first dispatch; tests pass a fake. Last write wins. */
+declare function setWorkflowScheduler(scheduler: WorkflowScheduler | undefined): void;
+/** Return the bound ambient scheduler, or throw a clear error when none is bound
+ *  (the imperative cron API was reached outside a running workflow runtime). */
+declare function getWorkflowScheduler(): WorkflowScheduler;
 
 /**
  * Queue-level options for a workflow trigger.
@@ -87,33 +83,116 @@ declare function setWorkflowStarter(starter: WorkflowStarter | undefined): void;
  */
 declare function getWorkflowStarter(): WorkflowStarter;
 
-/** One active scheduled trigger, as `listSchedules()` reports it. */
-interface ScheduledWorkflow {
-    /** The workflow this trigger starts on each tick. */
-    readonly name: string;
-    /** The cron expression driving the cadence. */
-    readonly cron: string;
-    /** The input each tick passes to the workflow. */
-    readonly input: unknown;
-    /** `'declarative'` (harvested from the workflow, reconciled on boot) or
-     *  `'dynamic'` (registered at run time via `scheduleWorkflow`). */
-    readonly source: 'declarative' | 'dynamic';
+/**
+ * Augmentable registry of the workspace's WORKFLOW names. By default it is empty,
+ * so `startWorkflow(name, ...)` / `startWorkflowAndWait(name, ...)` accept any
+ * `string` (today's behavior, validated only at runtime against the injected
+ * name→ref registry). `stackbone dev` generates an ambient
+ * `.stackbone/workflows.d.ts` from the project's `stackbone.config.ts` workflow
+ * list and augments this interface so the names become a closed set:
+ *
+ *   declare module '@stackbone/sdk/workflow' {
+ *     interface WorkflowRegistry {
+ *       onboarding: true;
+ *       qualifyLead: true;
+ *     }
+ *   }
+ *
+ * Once augmented, `startWorkflow('qualifyLead', ...)` is fine and
+ * `startWorkflow('typo', ...)` is a compile error — the editor also autocompletes
+ * the declared names. Mirrors the `AgentRegistry` augmentable-interface pattern
+ * used for `eveAgent`.
+ */
+interface WorkflowRegistry {
 }
-/** The runtime-injected bridge the imperative cron helpers reach. */
-interface WorkflowScheduler {
-    /** Register (or upsert) a DYNAMIC repeatable trigger that starts `name` with
-     *  `input` on the `cron` cadence. Idempotent by `name`. */
-    schedule(name: string, input: unknown, cron: string): Promise<void>;
-    /** Cancel a dynamic trigger by `name`. Resolves whether or not one existed. */
-    unschedule(name: string): Promise<void>;
-    /** List the active triggers — declarative + dynamic. */
-    listSchedules(): Promise<ScheduledWorkflow[]>;
+/**
+ * The set of workflow names the trigger helpers accept, derived from the
+ * augmentable `WorkflowRegistry`. The tuple wrap (`[X] extends [never]`) defeats
+ * the conditional-type distributivity a bare `keyof WorkflowRegistry extends
+ * never` would trigger:
+ *
+ * - empty registry  -> `string` (today's loose behavior: any name, checked at
+ *   runtime when the workflow resolves it against the manifest);
+ * - augmented registry -> the union of declared workflow names (typo = compile error).
+ */
+type WorkflowName = [keyof WorkflowRegistry] extends [never] ? string : keyof WorkflowRegistry;
+
+/** Options for {@link startWorkflow}. See {@link WorkflowTriggerOptions}. */
+type StartWorkflowOptions = WorkflowTriggerOptions;
+
+/**
+ * Start the workflow named `name` with its own independent run and return its
+ * `{ runId }` immediately — fire-and-forget. The input is validated against the
+ * target's declared input schema BEFORE the run is enqueued; a name that does
+ * not resolve, or input that violates the schema, rejects without starting
+ * anything.
+ *
+ * `name` is typed `WorkflowName` — a loose `string` by default, narrowed to the
+ * workspace's declared workflow names once `stackbone dev` has generated
+ * `.stackbone/workflows.d.ts` (see `workflow-registry.ts`), so a typo becomes a
+ * compile error.
+ *
+ * MUST be called from inside a running workflow (the runtime binds the starter on
+ * first dispatch); calling it elsewhere throws.
+ *
+ * DURABILITY: the enqueue runs in a `"use step"`, so once it completes a parent
+ * restart resumes with the memoized `{ runId }` and does NOT re-enqueue. A crash
+ * WHILE the step is mid-flight re-runs it (at-least-once) — the same shape the
+ * eve-agent-from-step path has; for fire-and-forget fan-out this is acceptable.
+ * Use {@link startWorkflowAndWait} when you need the child's result.
+ */
+declare function startWorkflow(name: WorkflowName, input: unknown, opts?: StartWorkflowOptions): Promise<WorkflowStartHandle>;
+
+/** Options for {@link startWorkflowAndWait}. See {@link WorkflowTriggerOptions}. */
+type StartWorkflowAndWaitOptions = WorkflowTriggerOptions;
+/**
+ * Start the workflow named `name` with its own independent run and durably wait
+ * for it to finish, returning its terminal output (validated against the
+ * target's declared output schema). Use this when one workflow needs another's
+ * result to continue.
+ *
+ * The input is validated against the target's declared input schema BEFORE the
+ * run is enqueued; a name that does not resolve, or input that violates the
+ * schema, rejects without starting anything. `TOutput` lets the caller name the
+ * expected output shape (defaults to `unknown`).
+ *
+ * `name` is typed `WorkflowName` — narrowed to the workspace's declared workflow
+ * names once `stackbone dev` has generated `.stackbone/workflows.d.ts`. MUST be
+ * called from inside a running workflow.
+ */
+declare function startWorkflowAndWait<TOutput = unknown>(name: WorkflowName, input: unknown, opts?: StartWorkflowAndWaitOptions): Promise<TOutput>;
+
+/**
+ * Augmentable registry of the workspace's eve agent NAMES. By default it is
+ * empty, so `eveAgent(name)` accepts any `string` (today's behavior, validated
+ * only at runtime against the injected `AGENT_URLS` map). `stackbone dev`
+ * generates an ambient `.stackbone/agents.d.ts` from the project's
+ * `stackbone.config.ts` agent list and augments this interface so the names
+ * become a closed set:
+ *
+ *   declare module '@stackbone/sdk/workflow' {
+ *     interface AgentRegistry {
+ *       support: true;
+ *       'lead-qualifier': true;
+ *     }
+ *   }
+ *
+ * Once augmented, `eveAgent('lead-qualifier')` is fine and `eveAgent('typo')` is
+ * a compile error — the editor also autocompletes the declared names. Mirrors the
+ * `ConfigRegistry` augmentable-interface pattern used for `client.config`.
+ */
+interface AgentRegistry {
 }
-/** Plant (or clear, with `undefined`) the ambient scheduler. The runtime calls
- *  this on first dispatch; tests pass a fake. Last write wins. */
-declare function setWorkflowScheduler(scheduler: WorkflowScheduler | undefined): void;
-/** Return the bound ambient scheduler, or throw a clear error when none is bound
- *  (the imperative cron API was reached outside a running workflow runtime). */
-declare function getWorkflowScheduler(): WorkflowScheduler;
+/**
+ * The set of agent names `eveAgent` accepts, derived from the augmentable
+ * `AgentRegistry`. The tuple wrap (`[X] extends [never]`) defeats the
+ * conditional-type distributivity a bare `keyof AgentRegistry extends never`
+ * would trigger:
+ *
+ * - empty registry  -> `string` (today's loose behavior: any name, checked at
+ *   runtime when the workflow resolves it against `AGENT_URLS`);
+ * - augmented registry -> the union of declared agent names (typo = compile error).
+ */
+type AgentName = [keyof AgentRegistry] extends [never] ? string : keyof AgentRegistry;
 
-export { type AgentName as A, type ScheduledWorkflow as S, type WorkflowTriggerOptions as W, type WorkflowStartHandle as a, type AgentRegistry as b, type WorkflowScheduler as c, type WorkflowStarter as d, getWorkflowStarter as e, setWorkflowStarter as f, getWorkflowScheduler as g, setWorkflowScheduler as s };
+export { type AgentName as A, type ScheduledWorkflow as S, type WorkflowName as W, type AgentRegistry as a, type StartWorkflowAndWaitOptions as b, type StartWorkflowOptions as c, type WorkflowRegistry as d, type WorkflowStartHandle as e, startWorkflowAndWait as f, type WorkflowScheduler as g, type WorkflowStarter as h, type WorkflowTriggerOptions as i, getWorkflowScheduler as j, getWorkflowStarter as k, setWorkflowScheduler as l, setWorkflowStarter as m, startWorkflow as s };

package/eve.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+var openaiCompatible = require('@ai-sdk/openai-compatible');
+var eve = require('eve');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = 2e5;
+var STACKBONE_EXTERNAL_DEPENDENCIES = [
+  "@stackbone/sdk",
+  "eve*"
+];
+var openrouter = openaiCompatible.createOpenAICompatible({
+  name: "openrouter",
+  baseURL: process.env["OPENROUTER_BASE_URL"] ?? "https://openrouter.ai/api/v1",
+  apiKey: process.env["OPENROUTER_API_KEY"]
+});
+function openrouterModel(modelId) {
+  return openrouter(modelId);
+}
+__name(openrouterModel, "openrouterModel");
+function defineStackboneAgent(config) {
+  const { model, modelContextWindowTokens, build, ...rest } = config;
+  return eve.defineAgent({
+    ...rest,
+    model: typeof model === "string" ? openrouterModel(model) : model,
+    modelContextWindowTokens: modelContextWindowTokens ?? DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS,
+    build: mergeExternalDependencies(build)
+  });
+}
+__name(defineStackboneAgent, "defineStackboneAgent");
+function mergeExternalDependencies(build) {
+  const extra = build?.externalDependencies ?? [];
+  const externalDependencies = [
+    .../* @__PURE__ */ new Set([
+      ...STACKBONE_EXTERNAL_DEPENDENCIES,
+      ...extra
+    ])
+  ];
+  return {
+    ...build,
+    externalDependencies
+  };
+}
+__name(mergeExternalDependencies, "mergeExternalDependencies");
+
+exports.DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS;
+exports.STACKBONE_EXTERNAL_DEPENDENCIES = STACKBONE_EXTERNAL_DEPENDENCIES;
+exports.defineStackboneAgent = defineStackboneAgent;
+exports.openrouterModel = openrouterModel;
+//# sourceMappingURL=eve.cjs.map
+//# sourceMappingURL=eve.cjs.map

package/eve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../libs/sdk/src/eve.ts"],"names":["DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS","STACKBONE_EXTERNAL_DEPENDENCIES","openrouter","createOpenAICompatible","name","baseURL","process","env","apiKey","openrouterModel","modelId","defineStackboneAgent","config","model","modelContextWindowTokens","build","rest","defineAgent","mergeExternalDependencies","extra","externalDependencies","Set"],"mappings":";;;;;;;AA2CO,IAAMA,mCAAAA,GAAsC;AAS5C,IAAMC,+BAAAA,GAAqD;AAAC,EAAA,gBAAA;AAAkB,EAAA;;AAMrF,IAAMC,aAAaC,uCAAAA,CAAuB;EACxCC,IAAAA,EAAM,YAAA;EACNC,OAAAA,EAASC,OAAAA,CAAQC,GAAAA,CAAI,qBAAA,CAAA,IAA0B,8BAAA;EAC/CC,MAAAA,EAAQF,OAAAA,CAAQC,IAAI,oBAAA;AACtB,CAAA,CAAA;AAOO,SAASE,gBAAgBC,OAAAA,EAAe;AAC7C,EAAA,OAAOR,WAAWQ,OAAAA,CAAAA;AACpB;AAFgBD,MAAAA,CAAAA,eAAAA,EAAAA,iBAAAA,CAAAA;AAoBT,SAASE,qBAAqBC,MAAAA,EAA4B;AAC/D,EAAA,MAAM,EAAEC,KAAAA,EAAOC,wBAAAA,EAA0BC,KAAAA,EAAO,GAAGC,MAAAA,GAASJ,MAAAA;AAC5D,EAAA,OAAOK,eAAAA,CAAY;IACjB,GAAGD,IAAAA;AACHH,IAAAA,KAAAA,EAAO,OAAOA,KAAAA,KAAU,QAAA,GAAWJ,eAAAA,CAAgBI,KAAAA,CAAAA,GAASA,KAAAA;AAC5DC,IAAAA,wBAAAA,EAA0BA,wBAAAA,IAA4Bd,mCAAAA;AACtDe,IAAAA,KAAAA,EAAOG,0BAA0BH,KAAAA;GACnC,CAAA;AACF;AARgBJ,MAAAA,CAAAA,oBAAAA,EAAAA,sBAAAA,CAAAA;AAchB,SAASO,0BAA0BH,KAAAA,EAAuC;AACxE,EAAA,MAAMI,KAAAA,GAAQJ,KAAAA,EAAOK,oBAAAA,IAAwB,EAAA;AAC7C,EAAA,MAAMA,oBAAAA,GAAuB;AAAI,IAAA,mBAAA,IAAIC,GAAAA,CAAI;AAAIpB,MAAAA,GAAAA,+BAAAA;AAAoCkB,MAAAA,GAAAA;AAAM,KAAA;;AACvF,EAAA,OAAO;IAAE,GAAGJ,KAAAA;AAAOK,IAAAA;AAAqB,GAAA;AAC1C;AAJSF,MAAAA,CAAAA,yBAAAA,EAAAA,2BAAAA,CAAAA","file":"eve.cjs","sourcesContent":["// `@stackbone/sdk/eve` — the eve-agent authoring subpath entrypoint.\n//\n// Wraps eve's `defineAgent` with the Stackbone defaults every published eve\n// agent otherwise hand-copies, so an `agent.ts` collapses to:\n//\n//   import { defineStackboneAgent } from '@stackbone/sdk/eve';\n//\n//   export default defineStackboneAgent({ model: 'anthropic/claude-haiku-4.5' });\n//\n// The helper injects three things:\n//\n//   1. The OpenRouter model bridge. eve routes a BARE model string through the\n//      Vercel AI Gateway — it does NOT speak OpenRouter. Stackbone injects the\n//      org's managed OpenRouter sub-key as `OPENROUTER_API_KEY`, so we pass a\n//      provider INSTANCE (eve routes those directly). Pass `model` as a string id\n//      and the helper wraps it with the OpenRouter provider; pass a built\n//      `LanguageModel` and it is used verbatim (escape hatch for another provider).\n//   2. `modelContextWindowTokens`. A custom provider carries no AI-Gateway\n//      context-window metadata, so eve cannot size the compaction threshold.\n//      Defaults to 200_000 (Claude's window); override per agent.\n//   3. `build.externalDependencies`. `@stackbone/sdk` + `eve*` stay external so\n//      the published build traces them fully — one SDK AsyncLocalStorage (per-run\n//      logs keep their run id) and a complete eve `#`-subpath trace (no\n//      ERR_MODULE_NOT_FOUND at boot). `stackbone publish` ENFORCES both; the\n//      helper guarantees they are always present and merges in any extra entries.\n//\n// Like `@stackbone/sdk/workflow`, this subpath statically imports the `eve` and\n// `@ai-sdk/openai-compatible` peer dependencies, so it is kept OFF the main\n// `@stackbone/sdk` barrel: a classic tool-only agent imports `@stackbone/sdk`\n// without eager-loading peers it never installed. The build keeps both external\n// (their types come from the sibling `eve-peer.d.ts` /\n// `ai-sdk-openai-compatible-peer.d.ts` shims).\n\nimport { createOpenAICompatible } from '@ai-sdk/openai-compatible';\nimport { defineAgent } from 'eve';\nimport type { AgentBuildDefinition, AgentDefinition, AgentModelDefinition } from 'eve';\n\n/**\n * Default context window (tokens) for the OpenRouter Claude models Stackbone\n * provisions. A custom provider carries no AI-Gateway metadata, so eve needs\n * this to size the conversation-compaction threshold. Override per agent via\n * `modelContextWindowTokens` when targeting a model with a different window.\n */\nexport const DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = 200_000;\n\n/**\n * External dependencies every published eve agent keeps out of its bundle.\n * `@stackbone/sdk` stays external so the agent shares ONE invocation-context\n * AsyncLocalStorage (per-run logs keep their run id); `eve*` forces a full trace\n * of eve's `#`-subpath imports (no ERR_MODULE_NOT_FOUND at boot). `stackbone\n * publish` enforces both, so the helper always injects them.\n */\nexport const STACKBONE_EXTERNAL_DEPENDENCIES: readonly string[] = ['@stackbone/sdk', 'eve*'];\n\n// The OpenRouter provider bridge, constructed once per module load. Stackbone\n// injects the org's managed sub-key as `OPENROUTER_API_KEY`; OpenRouter exposes\n// an OpenAI-compatible API, so the AI SDK's openai-compatible provider talks to\n// it directly.\nconst openrouter = createOpenAICompatible({\n  name: 'openrouter',\n  baseURL: process.env['OPENROUTER_BASE_URL'] ?? 'https://openrouter.ai/api/v1',\n  apiKey: process.env['OPENROUTER_API_KEY'],\n});\n\n/**\n * Resolve an OpenRouter model INSTANCE by id — the same bridge\n * `defineStackboneAgent` applies to a string `model`, exposed for workflow steps\n * that call an LLM directly (e.g. `generateText({ model: openrouterModel(id) })`).\n */\nexport function openrouterModel(modelId: string): AgentModelDefinition {\n  return openrouter(modelId);\n}\n\n/**\n * Config accepted by {@link defineStackboneAgent}: every eve `AgentDefinition`\n * field, except `model` also accepts a bare OpenRouter model id (string) the\n * helper wraps with the provider bridge. `modelContextWindowTokens` and `build`\n * are optional — the helper fills sensible defaults.\n */\nexport type StackboneAgentConfig = Omit<AgentDefinition, 'model'> & {\n  readonly model: string | AgentModelDefinition;\n};\n\n/**\n * Define an eve agent with Stackbone's defaults pre-applied: the OpenRouter\n * model bridge, the default context window, and the required external\n * dependencies. Returns the same object shape eve's `defineAgent` produces, so\n * the agent file `export default`s it unchanged.\n */\nexport function defineStackboneAgent(config: StackboneAgentConfig): AgentDefinition {\n  const { model, modelContextWindowTokens, build, ...rest } = config;\n  return defineAgent({\n    ...rest,\n    model: typeof model === 'string' ? openrouterModel(model) : model,\n    modelContextWindowTokens: modelContextWindowTokens ?? DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS,\n    build: mergeExternalDependencies(build),\n  });\n}\n\n/**\n * Merge the always-required Stackbone external dependencies with any extra ones\n * a creator declares, de-duplicated and order-stable (Stackbone's first).\n */\nfunction mergeExternalDependencies(build: AgentBuildDefinition | undefined): AgentBuildDefinition {\n  const extra = build?.externalDependencies ?? [];\n  const externalDependencies = [...new Set([...STACKBONE_EXTERNAL_DEPENDENCIES, ...extra])];\n  return { ...build, externalDependencies };\n}\n"]}

package/eve.d.cts

@@ -0,0 +1,41 @@
+import { AgentDefinition, AgentModelDefinition } from 'eve';
+
+/**
+ * Default context window (tokens) for the OpenRouter Claude models Stackbone
+ * provisions. A custom provider carries no AI-Gateway metadata, so eve needs
+ * this to size the conversation-compaction threshold. Override per agent via
+ * `modelContextWindowTokens` when targeting a model with a different window.
+ */
+declare const DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = 200000;
+/**
+ * External dependencies every published eve agent keeps out of its bundle.
+ * `@stackbone/sdk` stays external so the agent shares ONE invocation-context
+ * AsyncLocalStorage (per-run logs keep their run id); `eve*` forces a full trace
+ * of eve's `#`-subpath imports (no ERR_MODULE_NOT_FOUND at boot). `stackbone
+ * publish` enforces both, so the helper always injects them.
+ */
+declare const STACKBONE_EXTERNAL_DEPENDENCIES: readonly string[];
+/**
+ * Resolve an OpenRouter model INSTANCE by id — the same bridge
+ * `defineStackboneAgent` applies to a string `model`, exposed for workflow steps
+ * that call an LLM directly (e.g. `generateText({ model: openrouterModel(id) })`).
+ */
+declare function openrouterModel(modelId: string): AgentModelDefinition;
+/**
+ * Config accepted by {@link defineStackboneAgent}: every eve `AgentDefinition`
+ * field, except `model` also accepts a bare OpenRouter model id (string) the
+ * helper wraps with the provider bridge. `modelContextWindowTokens` and `build`
+ * are optional — the helper fills sensible defaults.
+ */
+type StackboneAgentConfig = Omit<AgentDefinition, 'model'> & {
+    readonly model: string | AgentModelDefinition;
+};
+/**
+ * Define an eve agent with Stackbone's defaults pre-applied: the OpenRouter
+ * model bridge, the default context window, and the required external
+ * dependencies. Returns the same object shape eve's `defineAgent` produces, so
+ * the agent file `export default`s it unchanged.
+ */
+declare function defineStackboneAgent(config: StackboneAgentConfig): AgentDefinition;
+
+export { DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS, STACKBONE_EXTERNAL_DEPENDENCIES, type StackboneAgentConfig, defineStackboneAgent, openrouterModel };

package/eve.d.ts

@@ -0,0 +1,41 @@
+import { AgentDefinition, AgentModelDefinition } from 'eve';
+
+/**
+ * Default context window (tokens) for the OpenRouter Claude models Stackbone
+ * provisions. A custom provider carries no AI-Gateway metadata, so eve needs
+ * this to size the conversation-compaction threshold. Override per agent via
+ * `modelContextWindowTokens` when targeting a model with a different window.
+ */
+declare const DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = 200000;
+/**
+ * External dependencies every published eve agent keeps out of its bundle.
+ * `@stackbone/sdk` stays external so the agent shares ONE invocation-context
+ * AsyncLocalStorage (per-run logs keep their run id); `eve*` forces a full trace
+ * of eve's `#`-subpath imports (no ERR_MODULE_NOT_FOUND at boot). `stackbone
+ * publish` enforces both, so the helper always injects them.
+ */
+declare const STACKBONE_EXTERNAL_DEPENDENCIES: readonly string[];
+/**
+ * Resolve an OpenRouter model INSTANCE by id — the same bridge
+ * `defineStackboneAgent` applies to a string `model`, exposed for workflow steps
+ * that call an LLM directly (e.g. `generateText({ model: openrouterModel(id) })`).
+ */
+declare function openrouterModel(modelId: string): AgentModelDefinition;
+/**
+ * Config accepted by {@link defineStackboneAgent}: every eve `AgentDefinition`
+ * field, except `model` also accepts a bare OpenRouter model id (string) the
+ * helper wraps with the provider bridge. `modelContextWindowTokens` and `build`
+ * are optional — the helper fills sensible defaults.
+ */
+type StackboneAgentConfig = Omit<AgentDefinition, 'model'> & {
+    readonly model: string | AgentModelDefinition;
+};
+/**
+ * Define an eve agent with Stackbone's defaults pre-applied: the OpenRouter
+ * model bridge, the default context window, and the required external
+ * dependencies. Returns the same object shape eve's `defineAgent` produces, so
+ * the agent file `export default`s it unchanged.
+ */
+declare function defineStackboneAgent(config: StackboneAgentConfig): AgentDefinition;
+
+export { DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS, STACKBONE_EXTERNAL_DEPENDENCIES, type StackboneAgentConfig, defineStackboneAgent, openrouterModel };

package/eve.js

@@ -0,0 +1,47 @@
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { defineAgent } from 'eve';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS = 2e5;
+var STACKBONE_EXTERNAL_DEPENDENCIES = [
+  "@stackbone/sdk",
+  "eve*"
+];
+var openrouter = createOpenAICompatible({
+  name: "openrouter",
+  baseURL: process.env["OPENROUTER_BASE_URL"] ?? "https://openrouter.ai/api/v1",
+  apiKey: process.env["OPENROUTER_API_KEY"]
+});
+function openrouterModel(modelId) {
+  return openrouter(modelId);
+}
+__name(openrouterModel, "openrouterModel");
+function defineStackboneAgent(config) {
+  const { model, modelContextWindowTokens, build, ...rest } = config;
+  return defineAgent({
+    ...rest,
+    model: typeof model === "string" ? openrouterModel(model) : model,
+    modelContextWindowTokens: modelContextWindowTokens ?? DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS,
+    build: mergeExternalDependencies(build)
+  });
+}
+__name(defineStackboneAgent, "defineStackboneAgent");
+function mergeExternalDependencies(build) {
+  const extra = build?.externalDependencies ?? [];
+  const externalDependencies = [
+    .../* @__PURE__ */ new Set([
+      ...STACKBONE_EXTERNAL_DEPENDENCIES,
+      ...extra
+    ])
+  ];
+  return {
+    ...build,
+    externalDependencies
+  };
+}
+__name(mergeExternalDependencies, "mergeExternalDependencies");
+
+export { DEFAULT_MODEL_CONTEXT_WINDOW_TOKENS, STACKBONE_EXTERNAL_DEPENDENCIES, defineStackboneAgent, openrouterModel };
+//# sourceMappingURL=eve.js.map
+//# sourceMappingURL=eve.js.map