@tokenfactory/acc-runner 0.38.0 → 0.38.1

package/dist/engines/types.d.ts

@@ -70,4 +70,85 @@ export interface AgentEngine {
         detail: string;
     }>;
 }
+/**
+ * Capability tiers an engine can serve a turn at. `draft-only` is the pivotal
+ * new tier: the engine can compose + stream a reply but cannot push, open a PR,
+ * or otherwise mutate repo state. The scheduler may route a low-stakes drafting
+ * turn to a draft-only engine but never a repo-mutating one.
+ */
+export type EngineCapabilityTier = "full" | "draft-only" | "review-only" | "unavailable";
+/** Coarse host-capacity buckets the classifier reports for scheduler routing. */
+export type RunnerCapacityClass = "idle" | "light" | "saturated" | "overloaded";
+/** What an engine can do; reported at registration and re-probed on change. */
+export interface EngineCapabilityMatrix {
+    /** Supports a headless, incrementally-streamed turn (chat-lane requirement). */
+    headlessStreaming: boolean;
+    /** Tools are fenced to the acc-mcp bus only (no shell/file escape). */
+    accMcpToolBus: boolean;
+    /** Can serve chat-lane turns. */
+    chatLane: boolean;
+    /** Can serve task-lane (build) turns. */
+    taskLane: boolean;
+    /** Can serve review-lane turns. */
+    reviewLane: boolean;
+    /** Highest tier this engine can currently honour. */
+    tier: EngineCapabilityTier;
+}
+/** Result of probing the engine's credential channel + the tier it permits. */
+export interface EngineCredentialProbe {
+    /** Credentials present and usable for at least the draft tier. */
+    ok: boolean;
+    /** Which auth channel resolved (mirrors the engine's `authMode`). */
+    channel: EngineAuthMode;
+    /** The highest tier the resolved credentials authorise. */
+    tier: EngineCapabilityTier;
+    /** Non-secret human-readable detail (never echoes key material). */
+    detail: string;
+}
+/** Options for a single headless streaming chat-lane turn. */
+export interface EngineStreamTurnOptions extends EngineSpawnOptions {
+    /** The rendered operator prompt to run for this turn. */
+    prompt: string;
+    /** The conversation the turn belongs to (telemetry / MCP context). */
+    conversationId: string;
+    /** The turn id being served (telemetry / lease correlation). */
+    turnId: string;
+    /** Delegation Bearer token forwarded to the acc-mcp bus for this turn. */
+    delegationToken?: string;
+    /** Abort signal; the drive loop SIGTERMs the child on abort. */
+    signal?: AbortSignal;
+}
+/** One streamed delta of an engine turn's output. */
+export interface EngineStreamChunk {
+    /** Monotonic 0-based sequence; gaps signal a dropped delta. */
+    seq: number;
+    /** The text delta (may be empty on a keep-alive frame). */
+    delta: string;
+    /** True on the final delta. */
+    done: boolean;
+}
+/** The acc-mcp tool-bus fence an engine applies for a chat-lane turn. */
+export interface AccMcpToolBusFence {
+    /** True when the tool bus is restricted to the listed servers only. */
+    enforced: boolean;
+    /** MCP server ids the agent may reach (acc-mcp only when fenced). */
+    allowedServers: string[];
+}
+/**
+ * A chat-lane-capable engine. Extends `AgentEngine` with the streaming, tool-bus
+ * fencing, credential-tier probing, capacity classification, and capability
+ * matrix the Workspace Command Chat lane requires.
+ */
+export interface ConformantAgentEngine extends AgentEngine {
+    /** Static capability declaration for this engine build. */
+    readonly capabilities: EngineCapabilityMatrix;
+    /** Run one turn headlessly, yielding output deltas as they arrive. */
+    streamTurn(opts: EngineStreamTurnOptions): AsyncIterable<EngineStreamChunk>;
+    /** Fence the agent's tool bus to the acc-mcp server(s) only for a turn. */
+    accMcpToolBusOnly(): AccMcpToolBusFence;
+    /** Probe the credential channel and the tier it authorises. */
+    credentialProbe(): Promise<EngineCredentialProbe>;
+    /** Classify current host capacity for scheduler routing. */
+    classifyCapacity(): Promise<RunnerCapacityClass>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/engines/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engines/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,yBAAyB,GACzB,SAAS,GACT,OAAO,GACP,cAAc,GACd,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAEjD,iGAAiG;AACjG,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,0GAA0G;IAC1G,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,qFAAqF;IACrF,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC;IAE7C,uFAAuF;IACvF,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAEjD,sFAAsF;IACtF,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;IAEnD,sFAAsF;IACtF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAE1C;;;;OAIG;IACH,eAAe,CACb,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,CAAC;IAElB,+DAA+D;IAC/D,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engines/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenfactory/acc-runner",
-  "version": "0.38.0",
+  "version": "0.38.1",
   "description": "Agent Control Center local runner. Spawns Claude Code sessions assigned via ACC.",
   "license": "UNLICENSED",
   "private": false,