@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/server/daemon/session/ambient-compact.js

@@ -0,0 +1,121 @@
+/**
+ * Ambient compact is a parallel isolated completion, not a tail splice.
+ * The turn does not wait.
+ *
+ * Who reads the summary: nothing in the product. `runCompactJob` and the
+ * compaction program build their own card from the full prefix and never
+ * consult it; the only thing read back is `ambientCompactKey` on the cutoff
+ * round, which stops the same prefix from starting a second summarizer. The
+ * summary is kept as the isolated completion's `responseText` so that a reader
+ * (a future cheap-cutoff path) has something to find. Until one exists the run
+ * is deliberately minimal: it holds the prefix text only while the request is
+ * in flight, then keeps the result and a reference, and completes.
+ */
+import { fail } from "@inhuman.tools/harness-diagnostics";
+import { CompletionExpectation, CompletionJob, PromptMessage } from "@inhuman.tools/harness-model";
+import { textOfCell } from "../../../context/index.js";
+import { promptMessageOf } from "./prompt-message-of.js";
+const SNAPSHOT_SYSTEM = `Fold this conversation prefix into a reference snapshot. Keep decisions, constraints, errors, and unresolved work. Drop tool chatter the snapshot does not need. Do not address the reader. Do not list next steps.`;
+function kvTrim(kvs, key) {
+    if (!Object.hasOwn(kvs, key))
+        return "";
+    return kvs[key].trim();
+}
+export function ambientModel(kvs, fallback) {
+    const named = kvTrim(kvs, "models.summarizer") || kvTrim(kvs, ":models.summarizer");
+    return named !== "" ? named : fallback.trim();
+}
+/** First kept round. The summary of everything older hangs here. */
+export function ambientCutoff(keep) {
+    for (const cell of keep.cells) {
+        if (cell instanceof CompletionJob)
+            return cell;
+        if (cell instanceof CompletionExpectation && cell.parent instanceof CompletionJob)
+            return cell.parent;
+    }
+    return null;
+}
+export function ambientKey(prefix, focus) {
+    const head = textOfCell(prefix.cells[0]).slice(0, 80);
+    const tail = textOfCell(prefix.cells.at(-1)).slice(0, 80);
+    return `${prefix.cells.length}\0${prefix.tokensUsed()}\0${head}\0${tail}\0${focus}`;
+}
+/**
+ * Fire a summarizer beside the turn. Returns the settlement promise so a test
+ * can observe it; the turn loop must not await it.
+ */
+export function startAmbientCompact(opts) {
+    const key = ambientKey(opts.prefix, opts.focus);
+    if (opts.cutoff.ambientCompactKey === key)
+        return Promise.resolve();
+    if (opts.inflight.get(opts.cutoff) === key)
+        return Promise.resolve();
+    const transcript = opts.prefix.cells
+        .map((cell) => textOfCell(cell))
+        .filter((line) => line !== "")
+        .join("\n\n");
+    if (transcript === "" || opts.connectionId === "" || opts.model === "")
+        return Promise.resolve();
+    opts.inflight.set(opts.cutoff, key);
+    return runAmbientCompact(opts, key, transcript);
+}
+async function runAmbientCompact(opts, key, transcript) {
+    const user = opts.focus === "" ? transcript : `${transcript}\n\nEmphasize:\n${opts.focus}`;
+    let job = null;
+    try {
+        const round = new CompletionExpectation({
+            connectionId: opts.connectionId,
+            model: opts.model,
+            completionMode: "isolated",
+            reasoningEffort: "none",
+            // The transcript prefix is the whole conversation again: past the inline limit it lives in the blob
+            // bucket and the document keeps its head.
+            promptMessages: [promptMessageOf("system", SNAPSHOT_SYSTEM), promptMessageOf("user", user)],
+        });
+        job = new CompletionJob({ expectation: round });
+        opts.home.pushChild(job);
+        await opts.complete({
+            connectionId: opts.connectionId,
+            model: opts.model,
+            promptText: round.userPrompt,
+            round,
+        });
+        if (opts.inflight.get(opts.cutoff) !== key)
+            return;
+        const text = round.responseText.trim();
+        if (round.outcome !== "successful" || text === "")
+            return;
+        // The summary stays on the isolated completion (the result). The key is what
+        // stops the next round with this prefix from starting another summarizer.
+        opts.cutoff.ambientCompactKey = key;
+    }
+    catch (error) {
+        if (opts.inflight.get(opts.cutoff) === key)
+            fail("ambient compact", error);
+    }
+    finally {
+        if (job != null)
+            settleAmbientJob(job, key, opts.focus);
+        if (opts.inflight.get(opts.cutoff) === key)
+            opts.inflight.delete(opts.cutoff);
+    }
+}
+/**
+ * A settled ambient run keeps its result and a reference to what it summarized,
+ * not the copy of the prefix it was asked about: that copy is the whole
+ * conversation again and nothing reads it. The job is then complete, however
+ * the run ended (a newer prefix winning counts), so it is not left open.
+ */
+function settleAmbientJob(job, key, focus) {
+    const round = job.expectation;
+    if (!round.isDone)
+        return;
+    const [cells = "?", tokens = "?"] = key.split("\0");
+    const ref = [`ambient compact of a prefix of ${cells} cells, ${tokens} tokens`];
+    if (focus !== "")
+        ref.push(`focus: ${focus}`);
+    round.promptMessages = [new PromptMessage({ role: "user", content: ref.join("\n") })];
+    if (!job.completed)
+        job.markComplete();
+}
+//# sourceMappingURL=ambient-compact.js.map

package/dist/server/daemon/session/ambient-compact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-compact.js","sourceRoot":"","sources":["../../../../src/server/daemon/session/ambient-compact.ts"],"names":[],"mappings":"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"}

package/dist/server/daemon/session/approval/approved.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Receipt stamps live in harness-tool-runtime.
+ */
+export { CLASSIFIER_DENIED, POLICY_PROHIBITS, USER_REFUSED, denyReceiptText, rejectTool, stampDenyReceipt, stampToolOutcome, } from "@tool-runtime";
+//# sourceMappingURL=approved.d.ts.map

package/dist/server/daemon/session/approval/approved.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approved.d.ts","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/approved.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/approved.js

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Receipt stamps live in harness-tool-runtime.
+ */
+export { CLASSIFIER_DENIED, POLICY_PROHIBITS, USER_REFUSED, denyReceiptText, rejectTool, stampDenyReceipt, stampToolOutcome, } from "../../../../tool-runtime/index.js";
+//# sourceMappingURL=approved.js.map

package/dist/server/daemon/session/approval/approved.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approved.js","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/approved.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/dist.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Dist policy load lives in harness-tool-runtime.
+ */
+export { distPolicySource, loadPolicySource } from "@tool-runtime";
+//# sourceMappingURL=dist.d.ts.map

package/dist/server/daemon/session/approval/dist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist.d.ts","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/dist.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/dist.js

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Dist policy load lives in harness-tool-runtime.
+ */
+export { distPolicySource, loadPolicySource } from "../../../../tool-runtime/index.js";
+//# sourceMappingURL=dist.js.map

package/dist/server/daemon/session/approval/dist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist.js","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/dist.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/guard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Inbound turn guard lives in harness-tool-runtime.
+ */
+export { inboundTurnGuard, publishPolicyError, stampLicenseDeny } from "@tool-runtime";
+//# sourceMappingURL=guard.d.ts.map

package/dist/server/daemon/session/approval/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/guard.js

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Inbound turn guard lives in harness-tool-runtime.
+ */
+export { inboundTurnGuard, publishPolicyError, stampLicenseDeny } from "../../../../tool-runtime/index.js";
+//# sourceMappingURL=guard.js.map

package/dist/server/daemon/session/approval/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/guard.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/index.d.ts

@@ -0,0 +1,4 @@
+export { rejectTool as rejectTool } from "@tool-runtime";
+export { distPolicySource as distPolicySource, loadPolicySource as loadPolicySource, } from "@tool-runtime";
+export { inboundTurnGuard as inboundTurnGuard, publishPolicyError as publishPolicyError, stampLicenseDeny as stampLicenseDeny, } from "@tool-runtime";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/daemon/session/approval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,gBAAgB,IAAI,gBAAgB,EACpC,gBAAgB,IAAI,gBAAgB,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,IAAI,gBAAgB,EACpC,kBAAkB,IAAI,kBAAkB,EACxC,gBAAgB,IAAI,gBAAgB,GACrC,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/index.js

@@ -0,0 +1,4 @@
+export { rejectTool as rejectTool } from "../../../../tool-runtime/index.js";
+export { distPolicySource as distPolicySource, loadPolicySource as loadPolicySource, } from "../../../../tool-runtime/index.js";
+export { inboundTurnGuard as inboundTurnGuard, publishPolicyError as publishPolicyError, stampLicenseDeny as stampLicenseDeny, } from "../../../../tool-runtime/index.js";
+//# sourceMappingURL=index.js.map

package/dist/server/daemon/session/approval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,gBAAgB,IAAI,gBAAgB,EACpC,gBAAgB,IAAI,gBAAgB,GACrC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,gBAAgB,IAAI,gBAAgB,EACpC,kBAAkB,IAAI,kBAAkB,EACxC,gBAAgB,IAAI,gBAAgB,GACrC,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/unattended.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Unattended receipts live in harness-tool-runtime.
+ */
+export { resolveEvalPolicyId, unattendedFailureText } from "@tool-runtime";
+//# sourceMappingURL=unattended.d.ts.map

package/dist/server/daemon/session/approval/unattended.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unattended.d.ts","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/unattended.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/approval/unattended.js

@@ -0,0 +1,5 @@
+/**
+ * Compatibility re-export. Unattended receipts live in harness-tool-runtime.
+ */
+export { resolveEvalPolicyId, unattendedFailureText } from "../../../../tool-runtime/index.js";
+//# sourceMappingURL=unattended.js.map

package/dist/server/daemon/session/approval/unattended.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unattended.js","sourceRoot":"","sources":["../../../../../src/server/daemon/session/approval/unattended.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/server/daemon/session/behavior-host.d.ts

@@ -0,0 +1,65 @@
+import { CallJob, type SessionRoot, SessionTurn, type ToolCallJob } from "@inhuman.tools/harness-model";
+import { type AgentBehavior, type BehaviorKernel, type BoundaryOutcome, type Opened, type Settle, type ToolOutcome } from "../../../extensions/index.js";
+import { type KernelToolCatalog } from "../../toolkit/tool-table.js";
+export declare function isForegroundAgent(session: SessionRoot): boolean;
+/** Live boundaries of one running turn. A resumed turn does not replay them. */
+export type TurnBehavior = {
+    readonly agent: AgentBehavior;
+    turn: Opened<BoundaryOutcome> | null;
+    round: Opened<BoundaryOutcome> | null;
+    rounds: number;
+};
+/** The daemon side of a session's behavior: its tool catalog and plugin state. */
+export type SessionBehaviorHooks = {
+    readonly syncTools: (turn: SessionTurn) => void;
+    /** How long a plugin boundary may hold a turn open before it is skipped. */
+    readonly hookTimeoutMs: () => number;
+};
+/** A park keeps the work for the next wrap; its hooks do not run. */
+export declare function isParkAbort(signal: AbortSignal): boolean;
+export declare class SessionBehavior implements Disposable {
+    #private;
+    private readonly kernel;
+    private readonly session;
+    private readonly projectId;
+    /** Host tools a declared tool may not shadow. */
+    private readonly hostCatalog;
+    private readonly hooks;
+    constructor(kernel: BehaviorKernel, session: SessionRoot, projectId: string, 
+    /** Host tools a declared tool may not shadow. */
+    hostCatalog: KernelToolCatalog, hooks: SessionBehaviorHooks);
+    /** The last attached behavior. Null until the first turn attaches one. */
+    get agent(): AgentBehavior | null;
+    /** Turn start: re-select the foreground's bots, then attach the pin. */
+    prepare(): Promise<AgentBehavior>;
+    /** Attach whatever the session's spec pins now. */
+    attach(): Promise<AgentBehavior>;
+    /** A hook or guard failure in this turn. Shown until the next turn starts. */
+    problem(what: string, error: unknown): void;
+    /** A parked turn is resumed by the next wrap, which opens its boundary again. */
+    dropTurn(turn: SessionTurn): void;
+    /**
+     * Attach the session's behavior and open the turn boundary the first time
+     * this orchestrator runs the turn. A turn picked up after a park or restart
+     * (`resumed`) opens it again, so its post hooks still run when it ends.
+     */
+    enterTurn(turn: SessionTurn, resumed: boolean): Promise<TurnBehavior | null>;
+    openRound(turn: SessionTurn, state: TurnBehavior): Promise<boolean>;
+    closeRound(turn: SessionTurn, settle: Settle): Promise<void>;
+    /** A round still open here did not finish. The turn fails only when cancelled or broken. */
+    leaveTurn(turn: SessionTurn, broke: string): Promise<void>;
+    /**
+     * The wrapper opened by the guards waits for the body's receipt. The job's
+     * ending releases it, whichever way the job ends: a job cancelled between
+     * guard and body never reaches `finishTool`, and without this its post
+     * hooks would never run and the closure would stay held.
+     */
+    holdTool(job: ToolCallJob, opened: Opened<ToolOutcome>): void;
+    /** Post hooks observe the worker's settled outcome. */
+    finishCall(job: CallJob, signal: AbortSignal): Promise<void>;
+    /** Post hooks and guard tails see the core's receipt, which they may replace or annotate. */
+    finishTool(job: ToolCallJob, signal: AbortSignal): Promise<void>;
+    toolReport(job: ToolCallJob, outcome: ToolOutcome): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=behavior-host.d.ts.map

package/dist/server/daemon/session/behavior-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior-host.d.ts","sourceRoot":"","sources":["../../../../src/server/daemon/session/behavior-host.ts"],"names":[],"mappings":"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"}