@sema-agent/server 1.314.0 → 1.316.0

package/dist/http/send.d.ts

@@ -0,0 +1,6 @@
+import type { ServerResponse } from "node:http";
+export declare function sseHeaders(res: ServerResponse, extra?: Record<string, string>): void;
+export declare function sendJson(res: ServerResponse, status: number, body: unknown): void;
+export declare function sendError(res: ServerResponse, status: number, errorCode: string, message: string, extra?: Record<string, unknown>): void;
+export declare function msg(e: unknown): string;
+//# sourceMappingURL=send.d.ts.map

package/dist/http/send.js

@@ -0,0 +1,19 @@
+export function sseHeaders(res, extra) {
+    res.writeHead(200, {
+        "content-type": "text/event-stream",
+        "cache-control": "no-cache",
+        connection: "keep-alive",
+        ...extra,
+    });
+}
+export function sendJson(res, status, body) {
+    res.writeHead(status, { "content-type": "application/json" });
+    res.end(JSON.stringify(body));
+}
+export function sendError(res, status, errorCode, message, extra) {
+    sendJson(res, status, { error: message, errorCode, ...extra });
+}
+export function msg(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+//# sourceMappingURL=send.js.map

package/dist/http/server.d.ts

@@ -5,7 +5,6 @@ import type { TaskRequestBody } from "./wire-types.js";
 import type { ServiceConfig } from "../config-types.js";
 import { type RestartSignal, type SessionMirrorRuling } from "../sema-registry.js";
 import { type OwnerAwareSessionStore } from "../security.js";
-import type { BakeState, BakeErrorCode } from "../plugins/store-contracts.js";
 import type { RunStore, ApprovalStore, ImageIndex, ImageBake, CheckpointStoreFull, ResumeAnchorStore, ApprovalExemptionStore, ServiceSessionPolicyStore, ServiceFileSnapshotStore, StoreBackend } from "../plugins/store-backend.js";
 import { type MemorySyncRequest, type MemorySyncResponse } from "../memory-sync.js";
 import type { TaskAttachmentStore } from "../plugins/task-attachment-store.js";
@@ -24,64 +23,71 @@ import type { Metrics } from "../observability/metrics.js";
 import { type RateGate } from "../observability/rate-limit.js";
 import type { QuotaTracker } from "../observability/cost-quota.js";
 import type { ModelUsageTracker, PromptManifestTracker } from "../budget.js";
+import { scopedIdempotencyKey } from "./idempotency.js";
+export { scopedIdempotencyKey };
+import { coarseStatusForState, errorCodeForExit } from "./routes/images.js";
+export { coarseStatusForState, errorCodeForExit };
+import { explicitOperatorOk, isOperator, explicitOperator } from "./principal-gate.js";
+export { explicitOperatorOk, isOperator, explicitOperator };
 export interface RequestAuth {
     principal?: string;
     sessionId: string;
     memoryScope?: string;
     resolvedProjectId?: string;
 }
-export interface ServiceDeps {
+export interface ServiceCoreDeps {
     runner: Runner;
     config: ServiceConfig;
-    registryJwtVerifier?: {
-        verify: (bearer: string) => Promise<import("../auth-bridge.js").VerifyOutcome>;
-    };
-    hookWakeBus?: {
-        deliver?: (sessionId: string, text: string) => Promise<boolean>;
-    };
-    drainState?: {
-        draining: boolean;
-        since?: number;
-        inflight?: () => number;
-        lastActivityAt?: () => number;
-    };
-    storeDegraded?: boolean;
-    sessionStoreLabel?: string;
-    modelReady?: () => boolean;
-    scenarioDetails?: Record<string, import("../capabilities/scenarios.js").ScenarioDetail>;
-    authorize?: (ctx: {
-        req: IncomingMessage;
-        body: TaskRequestBody;
-    }) => Promise<RequestAuth>;
     resolveSpec: (body: TaskRequestBody, req: IncomingMessage | undefined, auth?: RequestAuth, opts?: {
         leg?: "fresh" | "resume";
     }) => TaskSpec | Promise<TaskSpec>;
+}
+export interface ServiceStoreDeps {
     runStore?: RunStore;
     resumeAnchorStore?: ResumeAnchorStore;
-    sessionTitler?: {
-        maybeTitle(sessionId: string, objective: string): void;
-    };
+    approvalStore?: ApprovalStore;
     approvalExemptionStore?: ApprovalExemptionStore;
+    checkpointStore?: CheckpointStoreFull;
     sessionPolicyStore?: ServiceSessionPolicyStore;
     fileSnapshotStore?: ServiceFileSnapshotStore;
-    snapshotBlobSqlCapBytes?: number;
-    backend?: StoreBackend;
-    sessionMirrorRuling?: (principal: string | undefined) => Promise<SessionMirrorRuling | undefined>;
-    approvalStore?: ApprovalStore;
-    checkpointStore?: CheckpointStoreFull;
-    backgroundAgentStore?: import("@sema-agent/core").BackgroundAgentStore;
-    parkedReviveTool?: import("@sema-agent/core").ToolSpec;
-    parkedKnownAgentTypes?: ReadonlySet<string>;
-    parkedReviveInheritedGate?: (row: import("@sema-agent/core").BackgroundAgentRecord) => unknown;
     taskAttachmentStore?: TaskAttachmentStore;
-    imageIndex?: ImageIndex;
-    imageBakes?: ImageBake;
-    leaderEndpoint?: LeaderEndpoint;
+    backgroundAgentStore?: import("@sema-agent/core").BackgroundAgentStore;
+    sessionStorage?: OwnerAwareSessionStore;
     workflowRunStore?: WorkflowRunStore;
     workflowJournalStore?: import("@sema-agent/core").WorkflowJournalStore;
-    workflowsCapable?: boolean;
+    imageIndex?: ImageIndex;
+    imageBakes?: ImageBake;
+    outcomeSink?: import("../plugins/file-outcome-sink.js").OutcomeSink;
+    sendFileLedger?: import("../plugins/send-file-ledger.js").SendFileLedger;
+    backend?: StoreBackend;
+}
+export interface ServiceCoordinatorDeps {
+    elicitation?: ElicitationCoordinator;
+    question?: QuestionCoordinator;
+    toolApproval?: ToolApprovalCoordinator;
     workflowAgentRegistry?: WorkflowAgentRegistry;
     subagentSteerRegistry?: SubagentSteerRegistry;
+    workflowCompletionInbox?: WorkflowCompletionInbox;
+    fleetBus?: FleetEventBus;
+    sessionWatch?: import("../session-watch.js").SessionWatchRegistry;
+    hookWakeBus?: {
+        deliver?: (sessionId: string, text: string) => Promise<boolean>;
+    };
+    sendUserFile?: import("../capabilities/send-user-file-tool.js").SendUserFileEmitter;
+    leaderEndpoint?: LeaderEndpoint;
+    sessionTitler?: {
+        maybeTitle(sessionId: string, objective: string): void;
+    };
+}
+export interface ServiceSeamDeps {
+    sessionAudit?: (sessionId: string) => Promise<({
+        owner: string | null;
+    } & Record<string, unknown>) | undefined>;
+    purgeSession?: (sessionId: string, owner: string | null) => Promise<{
+        deleted: boolean;
+    } | {
+        active: string;
+    }>;
     subagentTaskOutput?: (handle: string, access: {
         owner: string;
         scope: string;
@@ -106,23 +112,10 @@ export interface ServiceDeps {
         content: string;
         details: unknown;
     }>;
-    workflowCompletionInbox?: WorkflowCompletionInbox;
-    fleetBus?: FleetEventBus;
-    sessionAudit?: (sessionId: string) => Promise<({
-        owner: string | null;
-    } & Record<string, unknown>) | undefined>;
-    sessionStorage?: OwnerAwareSessionStore;
-    purgeSession?: (sessionId: string, owner: string | null) => Promise<{
-        deleted: boolean;
-    } | {
-        active: string;
-    }>;
-    instanceId?: string;
-    logger?: Logger;
-    metrics?: Metrics;
-    rateLimiter?: RateGate;
-    costQuota?: QuotaTracker;
-    fleetLease?: FleetLeaseManager;
+    memoryExport?: (scope: string) => Promise<MemoryEntry[]>;
+    memorySync?: (scope: string, syncReq: MemorySyncRequest) => Promise<MemorySyncResponse>;
+    sessionMirrorRuling?: (principal: string | undefined) => Promise<SessionMirrorRuling | undefined>;
+    instrumentDegenerate?: (result: TaskResult) => void;
     sideQueryAccounting?: (principal: string | undefined, r: {
         model: string;
         family?: "input-includes-cached" | "input-excludes-cached";
@@ -136,46 +129,78 @@ export interface ServiceDeps {
             };
         };
     }) => void;
-    outcomeSink?: import("../plugins/file-outcome-sink.js").OutcomeSink;
-    memoryExport?: (scope: string) => Promise<MemoryEntry[]>;
-    memorySync?: (scope: string, syncReq: MemorySyncRequest) => Promise<MemorySyncResponse>;
-    instrumentDegenerate?: (result: TaskResult) => void;
-    planCacheProbe?: PlanCacheProbe;
+    parkedReviveTool?: import("@sema-agent/core").ToolSpec;
+    parkedKnownAgentTypes?: ReadonlySet<string>;
+    parkedReviveInheritedGate?: (row: import("@sema-agent/core").BackgroundAgentRecord) => unknown;
+}
+export interface ServiceObservabilityDeps {
+    logger?: Logger;
+    metrics?: Metrics;
     modelUsage?: ModelUsageTracker;
     promptManifests?: PromptManifestTracker;
-    elicitation?: ElicitationCoordinator;
-    question?: QuestionCoordinator;
-    toolApproval?: ToolApprovalCoordinator;
-    sendUserFile?: import("../capabilities/send-user-file-tool.js").SendUserFileEmitter;
-    sendFileLedger?: import("../plugins/send-file-ledger.js").SendFileLedger;
-    sessionWatch?: import("../session-watch.js").SessionWatchRegistry;
-    sessionEventsMaxConnections?: number;
-    sessionEventsHeartbeatMs?: number;
-    sessionEventsStallMs?: number;
+    planCacheProbe?: PlanCacheProbe;
+}
+export interface ServiceGovernanceDeps {
+    authorize?: (ctx: {
+        req: IncomingMessage;
+        body: TaskRequestBody;
+    }) => Promise<RequestAuth>;
+    registryJwtVerifier?: {
+        verify: (bearer: string) => Promise<import("../auth-bridge.js").VerifyOutcome>;
+    };
+    rateLimiter?: RateGate;
+    costQuota?: QuotaTracker;
+    fleetLease?: FleetLeaseManager;
+}
+export interface ServiceDeploymentDeps {
+    instanceId?: string;
     capabilities?: Record<string, unknown>;
+    scenarioDetails?: Record<string, import("../capabilities/scenarios.js").ScenarioDetail>;
+    sessionStoreLabel?: string;
+    storeDegraded?: boolean;
+    drainState?: {
+        draining: boolean;
+        since?: number;
+        inflight?: () => number;
+        lastActivityAt?: () => number;
+    };
+    modelReady?: () => boolean;
     restartState?: () => RestartSignal | undefined;
     planeDeferredState?: () => {
         version: number;
         since: number;
         blocked?: string[];
     } | undefined;
+    workflowsCapable?: boolean;
+}
+export interface ServiceKnobDeps {
+    snapshotBlobSqlCapBytes?: number;
+    sessionEventsMaxConnections?: number;
+    sessionEventsHeartbeatMs?: number;
+    sessionEventsStallMs?: number;
+}
+export interface ServiceDepGroups {
+    stores?: ServiceStoreDeps;
+    coordinators?: ServiceCoordinatorDeps;
+    seams?: ServiceSeamDeps;
+    observability?: ServiceObservabilityDeps;
+    governance?: ServiceGovernanceDeps;
+    deployment?: ServiceDeploymentDeps;
+    knobs?: ServiceKnobDeps;
 }
+export type FlatServiceDeps = ServiceCoreDeps & Partial<ServiceStoreDeps & ServiceCoordinatorDeps & ServiceSeamDeps & ServiceObservabilityDeps & ServiceGovernanceDeps & ServiceDeploymentDeps & ServiceKnobDeps>;
+export type ServiceDeps = FlatServiceDeps & ServiceDepGroups;
+export declare function flattenServiceDeps(deps: ServiceDeps): FlatServiceDeps;
 export type { TaskRequestBody } from "./wire-types.js";
 export declare const MAX_USER_SKILLS = 10;
 export declare const MAX_SKILL_CONTENT_CHARS = 1048576;
 export declare const MAX_SYSTEM_PROMPT_CHARS = 16384;
 export declare const MAX_OUTPUT_SCHEMA_CHARS = 32768;
 export declare function validateUserSkills(skills: unknown): string | null;
-export declare function explicitOperatorOk(principal: string | undefined, operatorPrincipals: readonly string[]): boolean;
-export declare function coarseStatusForState(state: BakeState): "running" | "done" | "failed";
-export declare function errorCodeForExit(exitCode: number | null | undefined, cancelled: boolean): BakeErrorCode;
-export declare function isOperator(principal: string | undefined, operatorPrincipals: readonly string[]): boolean;
-export declare function explicitOperator(principal: string | undefined, operatorPrincipals: readonly string[]): boolean;
 export declare function cascadeConfig(ladder: readonly string[], maxCostUsd?: number): CascadeConfig;
 export declare function clampVerifyRounds(v: unknown): number;
-export declare function scopedIdempotencyKey(raw: string | undefined, source: string | null, principal: string | undefined): string | undefined;
 export declare function isQuestionAnswer(v: unknown): v is QuestionAnswer;
-export declare function createHttpServer(deps: ServiceDeps): http.Server & {
+export declare function createHttpServer(rawDeps: ServiceDeps): http.Server & {
     denyExpiredApprovals: (now: number) => Promise<void>;
 };
 export declare function streamApprovals(req: IncomingMessage, res: ServerResponse, cs: Pick<CheckpointStoreFull, "listPending">, scope: string | undefined, pollMs?: number): Promise<void>;