@sema-agent/core 1.279.0

package/dist/core/runner/prepare-task.d.ts

@@ -0,0 +1,219 @@
+import { AgentHarness, type ThinkingLevel } from "../../internal/harness.js";
+import type { Model } from "../../internal/llm.js";
+import { type MaterializedMcp } from "../mcp.js";
+import { MemoryEngine } from "../memory-engine/engine.js";
+import type { HarvestReport, MemorySessionHandle } from "../memory-engine/types.js";
+import { Session } from "../session.js";
+import type { SessionStore } from "../session.js";
+import { SubagentRetainLedger } from "../../agents/subagent.js";
+import type { ToolPolicy } from "../tool-policy.js";
+import { type ActiveSkillFrame } from "./active-skill-scope.js";
+import { CacheBreakDetector, type ToolFingerprintInput } from "../cache-break-detector.js";
+import { type OutputRef, type BlockedRef } from "./synthetic-tools.js";
+import { type ConsolidationNote } from "./memory-consolidation.js";
+import type { TaskNotificationPayload } from "../task-notification.js";
+import { type CwdRef } from "../../tools/fs/index.js";
+import type { Runner } from "./runtask.js";
+import { type CheckpointGate, type CheckpointState, type CheckpointToken, type ResourceLedger, type ResourceLimitReason } from "../checkpoint-store.js";
+import type { AgentTool, ExecutionEnv } from "../../internal/harness.js";
+import type { ModelRole, RunnerDeps, TaskEvent, TaskSpec, ToolActivity, ToolEffect } from "../types.js";
+import type { RepairBundle } from "../../agents/repair-loop.js";
+export interface PreparedConsolidation {
+    scope: string;
+    notes: ConsolidationNote[];
+    settings: {
+        role: ModelRole;
+        band: {
+            lo: number;
+            hi: number;
+        };
+        searchLimit: number;
+        maxNotes: number;
+        timeoutSec: number;
+    };
+}
+export declare const DEFAULT_IRREVERSIBLE_SCOPE = "irreversible";
+export interface Prepared {
+    harness: AgentHarness;
+    session: Session;
+    sessionId: string;
+    taskRootPath: string;
+    model: Model;
+    thinking?: ThinkingLevel;
+    compModel?: Model;
+    mcp: MaterializedMcp;
+    blockedRef: BlockedRef;
+    outputRef: OutputRef;
+    abortController: AbortController;
+    conflictRef: {
+        hit: boolean;
+    };
+    blockedToolCalls: Set<string>;
+    nestedStats: {
+        tokens: number;
+        turns: number;
+        tasks: number;
+        costUsd: number;
+        costMicroUsd: number;
+    };
+    cwdRef?: CwdRef;
+    denyNarrowingPolicy?: ToolPolicy;
+    releaseSignal: () => void;
+    cacheBreakDetector?: CacheBreakDetector;
+    cacheFingerprint?: {
+        systemPrompt: string;
+        tools: ToolFingerprintInput[];
+    };
+    promptManifest: {
+        constitution: "core" | "replaced" | "provider-assembled" | "legacy";
+        blocks: Array<{
+            id: string;
+            chars: number;
+            hash: string;
+        }>;
+    };
+    activeTools: Set<string>;
+    consolidation?: PreparedConsolidation;
+    memoryEngineSession?: {
+        engine: MemoryEngine;
+        handle: MemorySessionHandle;
+        inject: () => import("../memory-engine/engine.js").MemoryInjection;
+        harvest: (phase?: "checkpoint" | "terminal") => Promise<HarvestReport | undefined>;
+    };
+    ownedEnv?: ExecutionEnv;
+    suspendRef: {
+        token?: CheckpointToken;
+        gate?: CheckpointGate;
+        scope?: string;
+    };
+    reviewRef: {
+        token?: CheckpointToken;
+        gate?: CheckpointGate;
+        scope?: string;
+    };
+    suspendLoopRef: {
+        hit: boolean;
+    };
+    suspendForResource?: (reason: ResourceLimitReason, sliceSpend: {
+        costMicroUsd: number;
+        tokens: number;
+        turns: number;
+    }) => Promise<boolean>;
+    callCapRef?: import("./call-cap.js").CallCapRef;
+    reviewRequestRef: {
+        pending?: {
+            reason?: string;
+        };
+    };
+    suspendForReview?: (reason?: string) => Promise<boolean>;
+    resourceLedger?: ResourceLedger;
+    liveSpendRef: {
+        get?: () => {
+            costMicroUsd: number;
+            tokens: number;
+            turns: number;
+        };
+    };
+    humanReviewRef: {
+        count: number;
+        totalWaitMs: number;
+        gates: Array<{
+            kind: string;
+            waitMs: number;
+            decision?: string;
+            toolName?: string;
+            toolArg?: string;
+        }>;
+    };
+    now: () => number;
+    tools: AgentTool[];
+    toolEffects: Map<string, ToolEffect>;
+    promptOverheadTokens: number;
+    readTaskFile?: (path: string) => Promise<string | null>;
+    recentlyReadFiles?: () => string[];
+    lspDiagnostics?: {
+        registry: import("../lsp-diagnostics.js").LspDiagnosticsRegistry;
+        nudge: (rawPath: string) => void;
+    };
+    planModeRef: {
+        active: boolean;
+    };
+    detectExternalChanges?: (maxFiles: number) => Promise<{
+        changed: Array<{
+            path: string;
+            mtimeMs: number;
+        }>;
+        evicted: string[];
+    }>;
+    toolsDeltaRef?: {
+        pending: string[];
+    };
+    agentListing?: {
+        entries: ReadonlyArray<{
+            name: string;
+            description: string;
+        }>;
+        toolName: string;
+        seedAnnounced: boolean;
+    };
+    listBackgroundTasks: () => Array<{
+        id: string;
+        description?: string;
+        status: string;
+    }>;
+    subagentRetain?: SubagentRetainLedger;
+    compactionReuseRef: {
+        consecutive: number;
+    };
+    trimPressureRef: {
+        droppedMessages: boolean;
+    };
+    dynamicRecall?: {
+        selector: import("../memory-recall.js").MemorySelector;
+        scopes: string[];
+        recentTools: string[];
+        surfacedIds: Set<string>;
+        surfacedKeys: Set<string>;
+    };
+}
+export interface PrepareResume {
+    leafId: string;
+    suspendedBatch: ReadonlySet<string>;
+    seed: CheckpointState;
+    priorSuspendCount?: number;
+    priorLedger?: ResourceLedger;
+    priorHumanReview?: {
+        count: number;
+        totalWaitMs: number;
+        gates: Array<{
+            kind: string;
+            waitMs: number;
+            decision?: string;
+            toolName?: string;
+            toolArg?: string;
+        }>;
+    };
+    workspaceHandle?: import("../remote-env.js").WorkspaceHandle;
+}
+export interface RunInternals {
+    repairBundle?: RepairBundle;
+    workflowDepth?: number;
+    insideFork?: boolean;
+    defaultSystemPrompt?: string;
+    goalMode?: boolean;
+    inheritedManifestScope?: readonly ActiveSkillFrame[];
+    parentToolCallId?: string;
+    agentName?: string;
+    parentTaskId?: string;
+    onForwardEvent?: (event: TaskEvent) => void;
+    detachHub?: import("../tool-detach.js").ToolDetachHub;
+    onTaskNotification?: (notification: TaskNotificationPayload, opts?: {
+        priority?: import("../task-notification.js").SystemInjectionPriority;
+    }) => void;
+    isolation?: "worktree";
+    parentCwd?: string;
+    onSubagentSpawn?: (handle: import("../../agents/subagent.js").SubagentSteerHandle) => void;
+    onActivity?: (activity: ToolActivity) => void;
+}
+export declare function prepareTask(spec: TaskSpec, deps: RunnerDeps, sessions: SessionStore, resume?: PrepareResume, _memorySelector?: import("../memory-recall.js").MemorySelector, internals?: RunInternals, runnerSelf?: Runner): Promise<Prepared>;
+//# sourceMappingURL=prepare-task.d.ts.map

package/dist/core/runner/prepare-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-task.d.ts","sourceRoot":"","sources":["../../../src/core/runner/prepare-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAkD,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK7H,OAAO,KAAK,EAAW,KAAK,EAAe,MAAM,uBAAuB,CAAC;AAKzE,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAEtE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,OAAO,EAAqC,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAmC,YAAY,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAA4J,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC1N,OAAO,KAAK,EAA4C,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE9F,OAAO,EAAkD,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAOhH,OAAO,EAAE,kBAAkB,EAA4B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAerH,OAAO,EAA8H,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWnM,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAYnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAkG,KAAK,MAAM,EAA6C,MAAM,yBAAyB,CAAC;AAOjM,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAKL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,mBAAmB,EAKzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAgB,SAAS,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAe,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,WAAW,qBAAqB;IAGpC,KAAK,EAAE,MAAM,CAAC;IAEd,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAE3B,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AA+CD,eAAO,MAAM,0BAA0B,iBAAiB,CAAC;AAGzD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAKlB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IAEb,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,GAAG,EAAE,eAAe,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IAEvB,SAAS,EAAE,SAAS,CAAC;IAGrB,eAAe,EAAE,eAAe,CAAC;IAEjC,WAAW,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE9B,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAGrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,mBAAmB,CAAC,EAAE,UAAU,CAAC;IAEjC,aAAa,EAAE,MAAM,IAAI,CAAC;IAG1B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAGxC,gBAAgB,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,oBAAoB,EAAE,CAAA;KAAE,CAAC;IAS3E,cAAc,EAAE;QACd,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,oBAAoB,GAAG,QAAQ,CAAC;QACpE,MAAM,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5D,CAAC;IAGF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAIzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAatC,mBAAmB,CAAC,EAAE;QAGpB,MAAM,EAAE,YAAY,CAAC;QACrB,MAAM,EAAE,mBAAmB,CAAC;QAE5B,MAAM,EAAE,MAAM,OAAO,4BAA4B,EAAE,eAAe,CAAC;QACnE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,UAAU,KAAK,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;KACpF,CAAC;IAIF,QAAQ,CAAC,EAAE,YAAY,CAAC;IAIxB,UAAU,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAS/E,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,CAAC;QAAC,IAAI,CAAC,EAAE,cAAc,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9E,cAAc,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAC;IAQjC,kBAAkB,CAAC,EAAE,CACnB,MAAM,EAAE,mBAAmB,EAC3B,UAAU,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAChE,OAAO,CAAC,OAAO,CAAC,CAAC;IAKtB,UAAU,CAAC,EAAE,OAAO,eAAe,EAAE,UAAU,CAAC;IAKhD,gBAAgB,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAMpD,gBAAgB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAIzD,cAAc,CAAC,EAAE,cAAc,CAAC;IAMhC,YAAY,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAKtF,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAG/J,GAAG,EAAE,MAAM,MAAM,CAAC;IAIlB,KAAK,EAAE,SAAS,EAAE,CAAC;IAInB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAIrC,oBAAoB,EAAE,MAAM,CAAC;IAK7B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAKxD,iBAAiB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAInC,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,OAAO,uBAAuB,EAAE,sBAAsB,CAAC;QACjE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;KAClC,CAAC;IAIF,WAAW,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAQjC,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAMhI,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAStC,YAAY,CAAC,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAK3H,mBAAmB,EAAE,MAAM,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAMvF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAKtC,kBAAkB,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAS5C,eAAe,EAAE;QAAE,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC;IAK9C,aAAa,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,qBAAqB,EAAE,cAAc,CAAC;QACvD,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KAC3B,CAAC;CACH;AAQD,MAAM,WAAW,aAAa;IAG5B,MAAM,EAAE,MAAM,CAAC;IAGf,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAGpC,IAAI,EAAE,eAAe,CAAC;IAItB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAI3B,WAAW,CAAC,EAAE,cAAc,CAAC;IAK7B,gBAAgB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAMlK,eAAe,CAAC,EAAE,OAAO,kBAAkB,EAAE,eAAe,CAAC;CAC9D;AAiBD,MAAM,WAAW,YAAY;IAG3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAW5B,aAAa,CAAC,EAAE,MAAM,CAAC;IAQvB,UAAU,CAAC,EAAE,OAAO,CAAC;IAYrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAS7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAkBnB,sBAAsB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAUrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAW1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAOnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IAO5C,SAAS,CAAC,EAAE,OAAO,mBAAmB,EAAE,aAAa,CAAC;IACtD,kBAAkB,CAAC,EAAE,CACnB,YAAY,EAAE,uBAAuB,EAGrC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,yBAAyB,EAAE,uBAAuB,CAAA;KAAE,KAC5E,IAAI,CAAC;IAUV,SAAS,CAAC,EAAE,UAAU,CAAC;IAQvB,SAAS,CAAC,EAAE,MAAM,CAAC;IAanB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,0BAA0B,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAW3F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C;AAgGD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,YAAY,EACtB,MAAM,CAAC,EAAE,aAAa,EAGtB,eAAe,CAAC,EAAE,OAAO,qBAAqB,EAAE,cAAc,EAC9D,SAAS,CAAC,EAAE,YAAY,EAIxB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,CAAC,CA+9GnB"}