@sema-agent/server 1.312.0 → 1.314.0

package/dist/auth-bridge.d.ts

@@ -23,7 +23,8 @@ export type VerifyOutcome = {
     ok: false;
     error: AuthBridgeErrorCode;
 };
-export declare function createRegistryJwtVerifier(opts: RegistryJwtVerifierOptions): {
+export interface RegistryJwtVerifier {
     verify: (bearer: string) => Promise<VerifyOutcome>;
-};
+}
+export declare function createRegistryJwtVerifier(opts: RegistryJwtVerifierOptions): RegistryJwtVerifier;
 //# sourceMappingURL=auth-bridge.d.ts.map

package/dist/bench/s1/live-deps.js

@@ -4,7 +4,7 @@ import { createBrain } from "../../brain.js";
 import { buildPricing } from "../../budget.js";
 import { RemoteContainerExecutionEnv } from "../../plugins/remote-env-e2b.js";
 import { createDurableAskPolicy } from "../../approval.js";
-import { buildLeaderRunner } from "../../leader/wire.js";
+import { createLeaderRunner } from "../../leader/wire.js";
 import { runOracle as runStandaloneOracle } from "./oracle.js";
 import { makeRepairOracle } from "./repair-oracle-adapter.js";
 import { assertDistinctEnvs } from "./runner-ctx.js";
@@ -358,7 +358,7 @@ async function runLeaderForTrap(rt, brain, models, roles, pricing, trap, cellId,
     process.env.LEADER_ENABLED = "true";
     process.env.LEADER_WORKER_BUDGET_USD = String((rt.maxCostUsd ?? 1.0) / 2);
     process.env.LEADER_CONFLICT_ROUNDS = process.env.LEADER_CONFLICT_ROUNDS ?? "2";
-    const run = buildLeaderRunner({
+    const run = createLeaderRunner({
         brain, models, roles, pricing, e2bApiKey: rt.e2bApiKey, workspace: W,
         ...(process.env.S1_DEBUG_GIT ? { logger: { warn: (m, x) => console.error(`[S1_DEBUG_LEADER warn] ${m}`, x ? JSON.stringify(x).slice(0, 300) : ""), info: (m, x) => console.error(`[S1_DEBUG_LEADER info] ${m}`, x ? JSON.stringify(x).slice(0, 200) : "") } } : {}),
     });

package/dist/budget.d.ts

@@ -3,6 +3,7 @@ import type { Metrics } from "./observability/metrics.js";
 import type { QuotaTracker } from "./observability/cost-quota.js";
 import type { FleetUsageAccumulator } from "./fleet-client.js";
 import type { FleetLeaseManager } from "./fleet-lease.js";
+import { type PromptManifestTracker } from "./observability/prompt-manifest.js";
 export declare function buildPricing(models: Record<string, Model>): Record<string, ModelPricing>;
 export declare function cardinalityGuard(cap: number, onOverflow: () => void): (value: string) => string;
 export interface ModelUsageDelta {
@@ -20,88 +21,15 @@ export declare class ModelUsageTracker {
     drain(taskId: string): Record<string, ModelUsageDelta> | undefined;
     clear(taskId: string): void;
 }
-export interface PromptManifestRecord {
-    constitution: string;
-    blocks: Array<{
-        id: string;
-        chars: number;
-        hash: string;
-    }>;
-    sections?: Array<{
-        id: string;
-        slot: string;
-        carrier: string;
-        cadence: string;
-        cacheClass: string;
-        chars: number;
-        hash: string;
-        contentHash?: string;
-    }>;
-    tools?: Array<{
-        wireName: string;
-        aliases: string[];
-        contractId: string;
-        implementationRevision: string;
-        cardId: string;
-        shapeDigest: string;
-        wireSchemaDigest: string;
-    }>;
-    totalChars: number;
-}
-export declare function promptManifestRecordOf(e: {
-    constitution: string;
-    blocks: Array<{
-        id: string;
-        chars: number;
-        hash: string;
-    }>;
-    sections?: Array<{
-        id: string;
-        slot: string;
-        carrier: string;
-        cadence: string;
-        cacheClass: string;
-        chars: number;
-        hash: string;
-        contentHash?: string;
-    }>;
-    tools?: Array<{
-        wireName: string;
-        aliases: string[];
-        contractId: string;
-        implementationRevision: string;
-        cardId: string;
-        shapeDigest: string;
-        wireSchemaDigest: string;
-    }>;
-    totalChars: number;
-}): PromptManifestRecord;
-export declare function configAssembledRecordOf(e: {
-    catalogVersion?: unknown;
-    fields?: unknown;
-    overrideReasons?: unknown;
-    ts?: unknown;
-}): Record<string, unknown> | undefined;
-export declare class PromptManifestTracker {
-    private readonly byTask;
-    private readonly configByTask;
-    private readonly active;
-    private leaseCounter;
-    register(taskId: string): number;
-    record(taskId: string, m: PromptManifestRecord): void;
-    recordConfig(taskId: string, rec: Record<string, unknown>): void;
-    drainConfig(taskId: string): Array<Record<string, unknown>> | undefined;
-    drain(taskId: string): PromptManifestRecord[] | undefined;
-    clear(taskId: string, lease: number): void;
-}
-export declare function buildTracer(metrics: Pick<Metrics, "inc" | "observe">, costQuota?: QuotaTracker, modelUsage?: ModelUsageTracker, fleetUsage?: FleetUsageAccumulator, fleetLease?: FleetLeaseManager, quotaWeightFor?: (model: string) => number, promptManifests?: PromptManifestTracker): TracerHook;
+export { type PromptManifestRecord, promptManifestRecordOf, configAssembledRecordOf, PromptManifestTracker, } from "./observability/prompt-manifest.js";
+export declare function createTracer(metrics: Pick<Metrics, "inc" | "observe">, costQuota?: QuotaTracker, modelUsage?: ModelUsageTracker, fleetUsage?: FleetUsageAccumulator, fleetLease?: FleetLeaseManager, quotaWeightFor?: (model: string) => number, promptManifests?: PromptManifestTracker): TracerHook;
 export declare function cacheFamilyOfMirror(model: {
     api?: string;
     params?: {
         promptCacheFamily?: string;
     };
 } | undefined): "input-includes-cached" | "input-excludes-cached" | undefined;
-export declare function buildSideQueryAccountant(metrics: Pick<Metrics, "inc">, costQuota?: QuotaTracker, fleetUsage?: FleetUsageAccumulator, fleetLease?: FleetLeaseManager, quotaWeightFor?: (model: string) => number): (principal: string | undefined, r: {
+export declare function createSideQueryAccountant(metrics: Pick<Metrics, "inc">, costQuota?: QuotaTracker, fleetUsage?: FleetUsageAccumulator, fleetLease?: FleetLeaseManager, quotaWeightFor?: (model: string) => number): (principal: string | undefined, r: {
     model: string;
     family?: "input-includes-cached" | "input-excludes-cached";
     usage?: {

package/dist/budget.js

@@ -1,5 +1,6 @@
 import { modelCostToPricing } from "@sema-agent/core";
 import { currentPrincipal } from "./observability/principal-context.js";
+import { promptManifestRecordOf, configAssembledRecordOf } from "./observability/prompt-manifest.js";
 export function buildPricing(models) {
     const pricing = {};
     for (const m of Object.values(models))
@@ -61,88 +62,8 @@ export class ModelUsageTracker {
     }
     clear(taskId) { this.byTask.delete(taskId); this.active.delete(taskId); }
 }
-export function promptManifestRecordOf(e) {
-    return {
-        constitution: String(e.constitution),
-        blocks: (Array.isArray(e.blocks) ? e.blocks : []).map((b) => ({ id: String(b.id), chars: b.chars, hash: String(b.hash) })),
-        ...(Array.isArray(e.sections)
-            ? { sections: e.sections.map((s) => ({ id: String(s.id), slot: String(s.slot), carrier: String(s.carrier), cadence: String(s.cadence), cacheClass: String(s.cacheClass), chars: s.chars, hash: String(s.hash), ...(typeof s.contentHash === "string" ? { contentHash: s.contentHash } : {}) })) }
-            : {}),
-        ...(Array.isArray(e.tools)
-            ? { tools: e.tools.map((t) => ({ wireName: String(t.wireName), aliases: (Array.isArray(t.aliases) ? t.aliases : []).map(String), contractId: String(t.contractId), implementationRevision: String(t.implementationRevision), cardId: String(t.cardId), shapeDigest: String(t.shapeDigest), wireSchemaDigest: String(t.wireSchemaDigest) })) }
-            : {}),
-        totalChars: e.totalChars,
-    };
-}
-export function configAssembledRecordOf(e) {
-    const rec = {
-        catalogVersion: e.catalogVersion,
-        fields: e.fields,
-        ...(e.overrideReasons !== undefined ? { overrideReasons: e.overrideReasons } : {}),
-        ts: e.ts,
-    };
-    try {
-        if (JSON.stringify(rec).length > 32_768)
-            return undefined;
-    }
-    catch {
-        return undefined;
-    }
-    return rec;
-}
-export class PromptManifestTracker {
-    byTask = new Map();
-    configByTask = new Map();
-    active = new Map();
-    leaseCounter = 0;
-    register(taskId) {
-        if (!taskId)
-            return 0;
-        const lease = ++this.leaseCounter;
-        this.active.set(taskId, lease);
-        return lease;
-    }
-    record(taskId, m) {
-        if (!taskId || !this.active.has(taskId))
-            return;
-        const q = this.byTask.get(taskId);
-        if (q)
-            q.push(m);
-        else
-            this.byTask.set(taskId, [m]);
-    }
-    recordConfig(taskId, rec) {
-        if (!taskId || !this.active.has(taskId))
-            return;
-        const q = this.configByTask.get(taskId);
-        if (q)
-            q.push(rec);
-        else
-            this.configByTask.set(taskId, [rec]);
-    }
-    drainConfig(taskId) {
-        const q = this.configByTask.get(taskId);
-        if (!q || q.length === 0)
-            return undefined;
-        this.configByTask.delete(taskId);
-        return q;
-    }
-    drain(taskId) {
-        const q = this.byTask.get(taskId);
-        if (!q || q.length === 0)
-            return undefined;
-        this.byTask.delete(taskId);
-        return q;
-    }
-    clear(taskId, lease) {
-        if (this.active.get(taskId) !== lease)
-            return;
-        this.byTask.delete(taskId);
-        this.active.delete(taskId);
-        this.configByTask.delete(taskId);
-    }
-}
-export function buildTracer(metrics, costQuota, modelUsage, fleetUsage, fleetLease, quotaWeightFor, promptManifests) {
+export { promptManifestRecordOf, configAssembledRecordOf, PromptManifestTracker, } from "./observability/prompt-manifest.js";
+export function createTracer(metrics, costQuota, modelUsage, fleetUsage, fleetLease, quotaWeightFor, promptManifests) {
     const toolName = cardinalityGuard(256, () => metrics.inc("metric_label_overflow_total", { label: "tool_name" }));
     const modelId = cardinalityGuard(256, () => metrics.inc("metric_label_overflow_total", { label: "model" }));
     const providerName = cardinalityGuard(64, () => metrics.inc("metric_label_overflow_total", { label: "provider" }));
@@ -200,7 +121,7 @@ export function cacheFamilyOfMirror(model) {
         return "input-includes-cached";
     return model.api === "anthropic-messages" || model.api === "bedrock-converse-stream" ? "input-excludes-cached" : "input-includes-cached";
 }
-export function buildSideQueryAccountant(metrics, costQuota, fleetUsage, fleetLease, quotaWeightFor) {
+export function createSideQueryAccountant(metrics, costQuota, fleetUsage, fleetLease, quotaWeightFor) {
     return (principal, r) => {
         const input = typeof r.usage?.input === "number" ? r.usage.input : 0;
         const output = typeof r.usage?.output === "number" ? r.usage.output : 0;

package/dist/capabilities/sandbox-file-send.d.ts

@@ -16,8 +16,9 @@ export interface SandboxFileSendDeps {
     prepare: (filename: string | undefined, scope?: string) => PreparedDirectUpload;
     maxBytes: number;
 }
-export declare function createSandboxFileSend(deps: SandboxFileSendDeps): (path: string, ctx: {
+export type SandboxFileSend = (path: string, ctx: {
     taskId?: string;
     principal?: string;
 }) => Promise<IssuedFileLink>;
+export declare function createSandboxFileSend(deps: SandboxFileSendDeps): SandboxFileSend;
 //# sourceMappingURL=sandbox-file-send.d.ts.map

package/dist/config-types.d.ts

@@ -2,7 +2,7 @@ import type { SealedKeyPoison } from "./sealed-key.js";
 import type { McpServerSpec, Model, ModelRoles } from "@sema-agent/core";
 import type { ApprovalHmacKey, PrincipalJwtKey } from "./auth-keys.js";
 import type { ElicitationThrottle } from "./elicitation.js";
-import type { InfraCostRates } from "./finance/cost-taxonomy.js";
+import type { InfraCostRates } from "./observability/cost-taxonomy.js";
 import type { Autonomy, CommandRule } from "./runtime-governance.js";
 export interface ScopedMcpServer {
     scenarios: string[];

package/dist/elicitation.d.ts

@@ -8,12 +8,13 @@ export interface ElicitationFrame {
     mode?: "form";
     action?: McpElicitResponse["action"];
 }
-export interface ElicitRunContext {
+export interface ElicitationRunContext {
     taskId: string;
     owner: string | null;
     emit: (frame: ElicitationFrame) => void | Promise<void>;
     abortSignal?: AbortSignal;
 }
+export type ElicitRunContext = ElicitationRunContext;
 export interface ElicitationThrottle {
     maxConcurrentPerRun: number;
     maxTotalPerRun: number;
@@ -21,13 +22,14 @@ export interface ElicitationThrottle {
     ttlMs: number;
 }
 export declare const DEFAULT_ELICITATION_THROTTLE: ElicitationThrottle;
-export declare function parseElicitResponse(body: unknown): {
+export declare function parseElicitationResponse(body: unknown): {
     ok: true;
     value: McpElicitResponse;
 } | {
     ok: false;
     error: string;
 };
+export declare const parseElicitResponse: typeof parseElicitationResponse;
 export declare class ElicitationCoordinator {
     private readonly als;
     private readonly pending;
@@ -35,7 +37,7 @@ export declare class ElicitationCoordinator {
     private readonly throttle;
     private readonly now;
     constructor(throttle?: ElicitationThrottle, now?: () => number);
-    runWithContext<T>(ctx: ElicitRunContext, fn: () => Promise<T>): Promise<T>;
+    runWithContext<T>(ctx: ElicitationRunContext, fn: () => Promise<T>): Promise<T>;
     elicit: (req: McpElicitRequest, signal?: AbortSignal) => Promise<McpElicitResponse>;
     respond(id: string, principal: string | undefined, body: unknown): {
         status: number;

package/dist/elicitation.js

@@ -9,7 +9,7 @@ export const DEFAULT_ELICITATION_THROTTLE = {
     minIntervalMsPerServer: 1_000,
     ttlMs: 5 * 60_000,
 };
-export function parseElicitResponse(body) {
+export function parseElicitationResponse(body) {
     if (body === null || typeof body !== "object" || Array.isArray(body))
         return { ok: false, error: "body must be an object" };
     const b = body;
@@ -32,6 +32,7 @@ export function parseElicitResponse(body) {
     }
     return { ok: true, value: { action: b.action } };
 }
+export const parseElicitResponse = parseElicitationResponse;
 function boundSchema(schema) {
     if (schema === undefined)
         return undefined;
@@ -126,7 +127,7 @@ export class ElicitationCoordinator {
         return answer;
     };
     respond(id, principal, body) {
-        const parsed = parseElicitResponse(body);
+        const parsed = parseElicitationResponse(body);
         if (!parsed.ok)
             return { status: 400, body: { error: parsed.error } };
         const entry = this.pending.get(id);

package/dist/fleet/fleet-bus.d.ts

@@ -118,6 +118,7 @@ export interface BgNotification {
         costMicroUsd?: number;
     };
     transcriptId?: string;
+    completionId?: string;
     rootSessionId?: string;
     ownerScope?: string;
     ownerSessionId?: string;

package/dist/fleet/fleet-bus.js

@@ -391,6 +391,7 @@ export function fleetBackgroundChildPublisher(bus, log) {
             ...(e.summary ? { summary: redactSecrets(e.summary) } : {}),
             scope: (m.sessionScoped || e.sessionScoped) ? "session" : "task",
             ...(m.parentTaskId ? { parentTaskId: m.parentTaskId } : m.resolvedParentId ? { parentTaskId: m.resolvedParentId } : {}),
+            ...(e.completionId ? { completionId: e.completionId } : {}),
             ...(e.stoppedBy ? { stoppedBy: e.stoppedBy } : {}),
             ...(e.resumable !== undefined ? { resumable: e.resumable } : {}),
             ...(e.recentSteps !== undefined

package/dist/fleet-lease.d.ts

@@ -65,7 +65,7 @@ export declare class FleetLeaseManager {
     private issueOrRenew;
     private issueOrRenewInner;
 }
-export declare function buildFleetLeaseFromEnv(cfg: {
+export declare function createFleetLeaseFromEnv(cfg: {
     configCenter?: {
         baseUrl: string;
         token: string;

package/dist/fleet-lease.js

@@ -115,7 +115,7 @@ export class FleetLeaseManager {
         }
     }
 }
-export function buildFleetLeaseFromEnv(cfg, opts) {
+export function createFleetLeaseFromEnv(cfg, opts) {
     const cc = cfg.configCenter;
     if (!cc?.baseUrl || !cc.token || !cc.worker)
         return undefined;

package/dist/hooks/hook-llm.d.ts

@@ -11,6 +11,10 @@ export type HookModelPick = {
     ok: false;
     error: string;
 };
+export interface HookLlm {
+    hookModelFor: (requested?: string) => HookModelPick;
+    hookLlm: HookLlmCall;
+}
 export declare function createHookLlm(deps: {
     config: ServiceConfig;
     getKeyResolver: () => ((model: Model) => Promise<{
@@ -20,8 +24,5 @@ export declare function createHookLlm(deps: {
         inc: (name: string, labels?: Record<string, string>) => void;
     };
     fetchImpl?: typeof fetch;
-}): {
-    hookModelFor: (requested?: string) => HookModelPick;
-    hookLlm: HookLlmCall;
-};
+}): HookLlm;
 //# sourceMappingURL=hook-llm.d.ts.map

package/dist/hooks/hook-runner.d.ts

@@ -49,6 +49,6 @@ export interface LlmHookExtra {
     system: string;
     transcript: string;
 }
-export declare function buildTaskHooks(config: HooksConfig, ctx: HookRunnerContext): Hooks | undefined;
+export declare function createTaskHooks(config: HooksConfig, ctx: HookRunnerContext): Hooks | undefined;
 export declare function composeHooks(deployment: Hooks | undefined, task: Hooks): Hooks;
 //# sourceMappingURL=hook-runner.d.ts.map

package/dist/hooks/hook-runner.js

@@ -494,7 +494,7 @@ async function runObserveOnlyEvent(event, groups, matchValue, payload, ctx, once
         }
     }
 }
-export function buildTaskHooks(config, ctx) {
+export function createTaskHooks(config, ctx) {
     const configured = Object.keys(config).filter((e) => (config[e]?.length ?? 0) > 0);
     const dark = configured.filter((e) => HOOK_EVENT_OWNER[e] === "engine" && !LIT_EVENTS.includes(e));
     if (dark.length > 0) {