@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/connections/intern.js

@@ -0,0 +1,30 @@
+import { acquireConnection } from "@inhuman.tools/plexus-expectations/executor";
+import { action } from "mobx";
+export function requireFreeConnectionId(kernel, id) {
+    if (kernel.connections[id] !== undefined) {
+        throw new Error(`connections: connection "${id}" collides`);
+    }
+}
+export async function ensureRegisteredConnection(registry, kernel, owner, connectionId, options) {
+    const spec = kernel.connections[connectionId];
+    if (spec === undefined) {
+        throw new Error(`connections: unknown connection ${connectionId}`);
+    }
+    const instance = await acquireConnection(kernel, owner, connectionId, async () => {
+        const connectionClass = await registry.resolve(spec.driver, options);
+        const minted = new connectionClass(connectionId, spec.configuration, options.secrets);
+        bindAwareness(minted, options.awareness);
+        return minted;
+    });
+    bindAwareness(instance, options.awareness);
+    await instance.ensureBootstrapStarted();
+    return instance;
+}
+function bindAwareness(instance, awareness) {
+    if (awareness === undefined)
+        return;
+    action(() => {
+        instance.awareness = awareness;
+    })();
+}
+//# sourceMappingURL=intern.js.map

package/dist/connections/intern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intern.js","sourceRoot":"","sources":["../../src/connections/intern.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAc9B,MAAM,UAAU,uBAAuB,CAAC,MAAoB,EAAE,EAAU;IACtE,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAwB,EACxB,MAAoB,EACpB,KAAa,EACb,YAAoB,EACpB,OAAsB;IAEtB,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,YAAY,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACtF,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,QAAQ,CAAC,sBAAsB,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,QAAmB,EAAE,SAAiC;IAC3E,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO;IACpC,MAAM,CAAC,GAAG,EAAE;QACV,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;IACjC,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/dist/connections/registry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Registered driver classes for adopt, discovery, and execution.
+ * Duplicate names fail here — before intern or bootstrap.
+ */
+import { type RegisteredDriver, type RegisteredProvider } from "@inhuman.tools/harness-provider-sdk";
+import type { DriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+import { connectionsBrand } from "./identity.js";
+import { type DriverResolveSpec, type ResolveOptions } from "./resolve.js";
+export declare class DriverRegistry {
+    #private;
+    readonly [connectionsBrand.registry]: true;
+    private constructor();
+    static fromDrivers(drivers: readonly RegisteredDriver[]): DriverRegistry;
+    get(name: string): RegisteredDriver | undefined;
+    require(name: string): RegisteredDriver;
+    list(): readonly RegisteredDriver[];
+    connectionClass(name: string): DriverConnectionClass;
+    resolve(spec: DriverResolveSpec, options?: ResolveOptions): Promise<DriverConnectionClass>;
+}
+export declare function openDriverRegistry(providers: readonly RegisteredProvider[]): DriverRegistry;
+export declare function isDriverRegistry(value: unknown): value is DriverRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/connections/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/connections/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACrH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAc;;aAChB,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IAGpC,OAAO;IAYP,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,cAAc;IAIxE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAQvC,IAAI,IAAI,SAAS,gBAAgB,EAAE;IAInC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB;IAI9C,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAqBrG;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,cAAc,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE"}

package/dist/connections/registry.js

@@ -0,0 +1,69 @@
+/**
+ * Registered driver classes for adopt, discovery, and execution.
+ * Duplicate names fail here — before intern or bootstrap.
+ */
+import { flattenDrivers } from "@inhuman.tools/harness-provider-sdk";
+import { connectionsBrand } from "./identity.js";
+import { descriptorsMatch, incompatibleDescriptor, loadUnresolvedDriverClass, } from "./resolve.js";
+export class DriverRegistry {
+    [connectionsBrand.registry] = true;
+    #drivers;
+    constructor(drivers) {
+        const map = new Map();
+        for (const driver of drivers) {
+            const existing = map.get(driver.name);
+            if (existing !== undefined) {
+                throw new Error(`connections: driver "${driver.name}" collides`);
+            }
+            map.set(driver.name, driver);
+        }
+        this.#drivers = map;
+    }
+    static fromDrivers(drivers) {
+        return new DriverRegistry(drivers);
+    }
+    get(name) {
+        return this.#drivers.get(name);
+    }
+    require(name) {
+        const driver = this.#drivers.get(name);
+        if (driver === undefined) {
+            throw new Error(`connections: unknown driver ${name}`);
+        }
+        return driver;
+    }
+    list() {
+        return [...this.#drivers.values()];
+    }
+    connectionClass(name) {
+        return this.require(name).connection;
+    }
+    async resolve(spec, options = {}) {
+        const registered = this.#drivers.get(spec.name);
+        if (registered !== undefined) {
+            if (!descriptorsMatch(spec, {
+                name: registered.name,
+                importPath: registered.importPath,
+                abilityClaim: registered.abilityClaim,
+                multiplicity: registered.multiplicity,
+            })) {
+                throw incompatibleDescriptor(spec.name);
+            }
+            return registered.connection;
+        }
+        const importPath = spec.importPath.trim();
+        if (importPath === "") {
+            throw new Error(`connections: unknown driver ${spec.name}`);
+        }
+        return loadUnresolvedDriverClass(importPath, options);
+    }
+}
+export function openDriverRegistry(providers) {
+    return DriverRegistry.fromDrivers(flattenDrivers(providers));
+}
+export function isDriverRegistry(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[connectionsBrand.registry] === true);
+}
+//# sourceMappingURL=registry.js.map

package/dist/connections/registry.js.map

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

package/dist/connections/resolve.d.ts

@@ -0,0 +1,17 @@
+import { type DriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+export type ResolvePurpose = "adopt" | "discovery" | "execution";
+export type ExternalDriverLoader = (importPath: string) => Promise<unknown>;
+export type ResolveOptions = {
+    readonly purpose?: ResolvePurpose;
+    readonly loadExternal?: ExternalDriverLoader;
+};
+export type DriverResolveSpec = {
+    readonly name: string;
+    readonly importPath: string;
+    readonly abilityClaim?: readonly string[];
+    readonly multiplicity?: string;
+};
+export declare function loadUnresolvedDriverClass(importPath: string, options?: ResolveOptions): Promise<DriverConnectionClass>;
+export declare function descriptorsMatch(spec: DriverResolveSpec, registered: DriverResolveSpec): boolean;
+export declare function incompatibleDescriptor(name: string): Error;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/connections/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/connections/resolve.ts"],"names":[],"mappings":"AAKA,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAEhH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AA0CF,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,qBAAqB,CAAC,CAkBhC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAYhG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAE1D"}

package/dist/connections/resolve.js

@@ -0,0 +1,86 @@
+/**
+ * One driver-class resolver for adopt, discovery, and execution.
+ * Registered classes win; unregistered importPath uses the injected loader.
+ */
+import { fail, step } from "@inhuman.tools/harness-diagnostics";
+import { isDriverConnectionClass } from "@inhuman.tools/plexus-expectations/driver";
+function resolveFailed(purpose, importPath, error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    switch (purpose) {
+        case "adopt": {
+            fail("connect/adopt resolve", error);
+            throw new Error(`connect/adopt: ${importPath}: ${detail}`);
+        }
+        case "discovery": {
+            fail("connect/models resolve", error);
+            throw new Error(`connect/models: ${importPath}: ${detail}`);
+        }
+        case "execution": {
+            fail("loadDriverModule resolve", error);
+            throw new Error(`loadDriverModule: ${importPath}: ${detail}`);
+        }
+        default: {
+            throw new Error(`connections: ${importPath}: ${detail}`);
+        }
+    }
+}
+function notADriver(purpose, importPath) {
+    switch (purpose) {
+        case "adopt": {
+            throw new Error(`connect/adopt: not a driver: ${importPath}`);
+        }
+        case "discovery": {
+            fail(`connect/models not_a_driver ${importPath}`);
+            throw new Error(`connect/models: not_a_driver:${importPath}`);
+        }
+        case "execution": {
+            fail(`loadDriverModule not_a_driver ${importPath}`);
+            throw new Error(`loadDriverModule: not_a_driver:${importPath}`);
+        }
+        default: {
+            throw new Error(`connections: not_a_driver:${importPath}`);
+        }
+    }
+}
+export async function loadUnresolvedDriverClass(importPath, options = {}) {
+    const load = options.loadExternal;
+    if (load == null) {
+        throw new Error(`connections: unknown driver import ${importPath}`);
+    }
+    if (options.purpose === "discovery") {
+        step(`connect/models load ${importPath}`);
+    }
+    else if (options.purpose === "execution") {
+        step(`loadDriverModule ${importPath}`);
+    }
+    let exported;
+    try {
+        exported = await load(importPath);
+    }
+    catch (error) {
+        resolveFailed(options.purpose, importPath, error);
+    }
+    if (!isDriverConnectionClass(exported))
+        notADriver(options.purpose, importPath);
+    return exported;
+}
+export function descriptorsMatch(spec, registered) {
+    if (spec.name !== registered.name)
+        return false;
+    if (spec.importPath.trim() !== "" && spec.importPath !== registered.importPath) {
+        return false;
+    }
+    if (spec.multiplicity != null && spec.multiplicity !== registered.multiplicity) {
+        return false;
+    }
+    if (spec.abilityClaim == null || spec.abilityClaim.length === 0)
+        return true;
+    if (spec.abilityClaim.length !== registered.abilityClaim?.length)
+        return false;
+    const allowed = new Set(registered.abilityClaim);
+    return spec.abilityClaim.every((token) => allowed.has(token));
+}
+export function incompatibleDescriptor(name) {
+    return new Error(`connections: driver "${name}" descriptor is incompatible`);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/connections/resolve.js.map

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

package/dist/context/compact-floors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Keep floors. The dial is `compactKeepTurns`; a ContextNeed preserve and the
+ * session kv only raise it. Empty is never valid — 0 orphans the in-flight
+ * exchange — so the mode default stands in when nothing is set.
+ */
+import type { ContextNeed } from "@inhuman.tools/harness-model";
+/**
+ * Minimum recent rounds kept when the floors are otherwise empty. 0 replaces the
+ * whole eat — the in-flight exchange is orphaned and the model re-does work.
+ * Mid-turn keeps the current round; explicit `/compact` keeps a little more
+ * thread when the user opted in. A config dial >= 1 replaces both.
+ */
+export declare const DEFAULT_COMPACT_KEEP_TURNS: {
+    readonly midTurn: 1;
+    readonly explicit: 2;
+};
+export declare function keepFloors(need: ContextNeed | null, kv?: Readonly<Record<string, string>>, forced?: boolean, configFloor?: number): {
+    readonly userTurns: number;
+    readonly rounds: number;
+};
+//# sourceMappingURL=compact-floors.d.ts.map

package/dist/context/compact-floors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-floors.d.ts","sourceRoot":"","sources":["../../src/context/compact-floors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B;;;CAG7B,CAAC;AAEX,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,EAAE,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EACzC,MAAM,UAAQ,EACd,WAAW,SAAI,GACd;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAYzD"}

package/dist/context/compact-floors.js

@@ -0,0 +1,23 @@
+/**
+ * Minimum recent rounds kept when the floors are otherwise empty. 0 replaces the
+ * whole eat — the in-flight exchange is orphaned and the model re-does work.
+ * Mid-turn keeps the current round; explicit `/compact` keeps a little more
+ * thread when the user opted in. A config dial >= 1 replaces both.
+ */
+export const DEFAULT_COMPACT_KEEP_TURNS = {
+    midTurn: 1,
+    explicit: 2,
+};
+export function keepFloors(need, kv = {}, forced = false, configFloor = 0) {
+    const raw = kv["compact.keep-turns"] ?? kv[":compact.keep-turns"];
+    const parsed = raw == null ? Number.NaN : Number(raw);
+    const fromKv = Number.isInteger(parsed) && parsed >= 1 ? parsed : 0;
+    const fromConfig = Number.isInteger(configFloor) && configFloor >= 1 ? configFloor : 0;
+    const highest = Math.max(fromKv, fromConfig);
+    const floor = highest > 0 ? highest : forced ? DEFAULT_COMPACT_KEEP_TURNS.explicit : DEFAULT_COMPACT_KEEP_TURNS.midTurn;
+    return {
+        userTurns: Math.max(floor, need?.preserve?.user_turns ?? 0),
+        rounds: Math.max(floor, need?.preserve?.rounds ?? 0),
+    };
+}
+//# sourceMappingURL=compact-floors.js.map

package/dist/context/compact-floors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact-floors.js","sourceRoot":"","sources":["../../src/context/compact-floors.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;CACH,CAAC;AAEX,MAAM,UAAU,UAAU,CACxB,IAAwB,EACxB,KAAuC,EAAE,EACzC,MAAM,GAAG,KAAK,EACd,WAAW,GAAG,CAAC;IAEf,MAAM,GAAG,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,qBAAqB,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,KAAK,GACT,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,OAAO,CAAC;IAC5G,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,IAAI,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/context/compact.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Compact calculations. The Scheme program that writes the card is session-runtime.
+ *
+ * Occupancy that fires compact is config.json compactTriggers (hard / soft).
+ * Empty eat and compact-on-compact REJECT before a strategy runs.
+ * Keep-all (empty prefix, nonempty keep) skips auto compact, including hard overflow.
+ */
+import { SessionTurn, TurnCompactChunk, type ContextNeed, type SessionUnit } from "@inhuman.tools/harness-model";
+import { Transcript } from "./transcript.js";
+export declare function compactDue(head: SessionUnit | null, ratio: number | null): boolean;
+/** Unknown occupancy is not a deficit. */
+export declare function needDeficit(turn: SessionTurn, need: ContextNeed | null): boolean;
+/**
+ * Keep floors + requested runway cannot exceed the window.
+ * Card budget is not estimated — keep occupancy is the host retain.
+ */
+export declare function needFeasible(turn: SessionTurn, need: ContextNeed | null, keepTokens: number): boolean;
+/**
+ * Forced tail splice. Slash is `#mintCompactTurn`, not this.
+ * Keep-all (empty prefix, nonempty keep) vetoes hard overflow.
+ * Does not read `contextNeed` — a need is an ambient option, not a tail node.
+ * Null = do not enqueue `TurnCompactChunk`.
+ */
+export declare function tailCompactCandidate(turn: SessionTurn, hardRatio: number | null, sliced?: {
+    readonly prefix: Transcript;
+    readonly keep: Transcript;
+}): "overflow" | null;
+/**
+ * Ambient option, not a cutoff. A live need with a real prefix is worth a
+ * background completion when the runway is short, the need names a preserve
+ * cutoff, or the phase is settled. Hard overflow is `tailCompactCandidate`.
+ * Null = do not spend a summarizer. Infeasible retain does not block the option.
+ */
+export declare function compactDecision(turn: SessionTurn, sliced?: {
+    readonly prefix: Transcript;
+    readonly keep: Transcript;
+}): {
+    readonly focus: string;
+} | null;
+export type CompactReject = "empty" | "already-compacted";
+export declare function compactRejectReason(unit: SessionUnit | null, current?: TurnCompactChunk): CompactReject | null;
+//# sourceMappingURL=compact.d.ts.map

package/dist/context/compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../src/context/compact.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAKL,WAAW,EAGX,gBAAgB,EAIhB,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAkB,MAAM,iBAAiB,CAAC;AAE7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAOlF;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAOhF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAMrG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAClE,UAAU,GAAG,IAAI,CAInB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,EACjB,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQnC;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,mBAAmB,CAAC;AAE1D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAe9G"}

package/dist/context/compact.js

@@ -0,0 +1,156 @@
+/**
+ * Compact calculations. The Scheme program that writes the card is session-runtime.
+ *
+ * Occupancy that fires compact is config.json compactTriggers (hard / soft).
+ * Empty eat and compact-on-compact REJECT before a strategy runs.
+ * Keep-all (empty prefix, nonempty keep) skips auto compact, including hard overflow.
+ */
+import { isSideChannelTool, reactChunks, SessionTurn, } from "@inhuman.tools/harness-model";
+import { walkTranscript } from "./transcript.js";
+export function compactDue(head, ratio) {
+    if (head == null || ratio == null || !(ratio > 0))
+        return false;
+    if (!(head instanceof SessionTurn))
+        return false;
+    const used = head.contextUsed;
+    const limit = head.contextLimit;
+    if (!(used > 0 && limit > 0))
+        return false;
+    return used / limit >= ratio;
+}
+/** Unknown occupancy is not a deficit. */
+export function needDeficit(turn, need) {
+    if (need?.min_remaining_tokens == null)
+        return false;
+    const used = turn.contextUsed;
+    const limit = turn.contextLimit;
+    if (!(used > 0 && limit > 0))
+        return false;
+    const want = Math.min(Math.max(0, need.min_remaining_tokens), limit);
+    return limit - used < want;
+}
+/**
+ * Keep floors + requested runway cannot exceed the window.
+ * Card budget is not estimated — keep occupancy is the host retain.
+ */
+export function needFeasible(turn, need, keepTokens) {
+    if (need?.min_remaining_tokens == null)
+        return true;
+    const limit = turn.contextLimit;
+    if (!(limit > 0))
+        return false;
+    const runway = Math.min(Math.max(0, need.min_remaining_tokens), limit);
+    return keepTokens + runway <= limit;
+}
+/**
+ * Forced tail splice. Slash is `#mintCompactTurn`, not this.
+ * Keep-all (empty prefix, nonempty keep) vetoes hard overflow.
+ * Does not read `contextNeed` — a need is an ambient option, not a tail node.
+ * Null = do not enqueue `TurnCompactChunk`.
+ */
+export function tailCompactCandidate(turn, hardRatio, sliced) {
+    if (sliced != null && sliced.prefix.cells.length === 0 && sliced.keep.cells.length > 0)
+        return null;
+    if (!compactDue(turn, hardRatio))
+        return null;
+    return "overflow";
+}
+/**
+ * Ambient option, not a cutoff. A live need with a real prefix is worth a
+ * background completion when the runway is short, the need names a preserve
+ * cutoff, or the phase is settled. Hard overflow is `tailCompactCandidate`.
+ * Null = do not spend a summarizer. Infeasible retain does not block the option.
+ */
+export function compactDecision(turn, sliced) {
+    if (sliced == null || sliced.prefix.cells.length === 0)
+        return null;
+    const need = turn.contextNeed;
+    if (need == null)
+        return null;
+    if (compactRejectReason(turn) != null)
+        return null;
+    const named = needDeficit(turn, need) || need.preserve != null || need.current_phase_settled === true;
+    if (!named)
+        return null;
+    return { focus: need.focus ?? "" };
+}
+export function compactRejectReason(unit, current) {
+    if (unit == null)
+        return "empty";
+    const seen = new Set();
+    for (let cell = unit; cell != null && !seen.has(cell); cell = cell instanceof SessionTurn ? cell.turnTail : null) {
+        seen.add(cell);
+        if (!(cell instanceof SessionTurn))
+            continue;
+        const own = eatSinceCutoff(reactChunks(cell).filter((chunk) => chunk !== current));
+        if (Array.isArray(own))
+            return null;
+        if (own === "already-compacted")
+            return "already-compacted";
+    }
+    return "empty";
+}
+function eatSinceCutoff(chunks) {
+    let sawCutoff = false;
+    let last = null;
+    const tools = [];
+    const notifies = [];
+    const notes = [];
+    const steers = [];
+    for (const event of walkTranscript(chunks)) {
+        switch (event.kind) {
+            case "cutoff":
+            case "compact": {
+                sawCutoff = true;
+                last = null;
+                tools.length = 0;
+                notifies.length = 0;
+                notes.length = 0;
+                steers.length = 0;
+                break;
+            }
+            case "completion": {
+                last = event.chunk;
+                tools.length = 0;
+                notifies.length = 0;
+                notes.length = 0;
+                steers.length = 0;
+                break;
+            }
+            case "tool": {
+                if (!isSideChannelTool(event.chunk))
+                    tools.push(event.chunk);
+                break;
+            }
+            case "scheme": {
+                tools.push(event.chunk);
+                break;
+            }
+            case "notify": {
+                notifies.push(event.chunk);
+                break;
+            }
+            case "approval-note": {
+                notes.push(event.chunk);
+                break;
+            }
+            case "steer": {
+                steers.push(event.chunk);
+                break;
+            }
+            case "cell": {
+                break;
+            }
+            default: {
+                const _kind = event;
+                void _kind;
+            }
+        }
+    }
+    if (last != null)
+        return [...last.messages, last, ...tools, ...notifies, ...notes, ...steers];
+    if (notifies.length > 0 || notes.length > 0 || steers.length > 0)
+        return [...notifies, ...notes, ...steers];
+    return sawCutoff ? "already-compacted" : "empty";
+}
+//# sourceMappingURL=compact.js.map

package/dist/context/compact.js.map

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

package/dist/context/delivery.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Pure call-delivery projection for history.
+ * Acceptance, leases, and settlement stay in agent-calls.
+ */
+import type { CatalogEntry } from "@tool-catalog";
+export type DeliveryCatalog = {
+    catalogEntry(wireName: string): CatalogEntry | undefined;
+};
+/** Omit / turn catalog visibility. Not a lease or marker. */
+export declare function usesGenericSilentProjection(call: {
+    readonly name: string;
+}, catalog: DeliveryCatalog): boolean;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/context/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../src/context/delivery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,6DAA6D;AAC7D,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAG9G"}

package/dist/context/delivery.js

@@ -0,0 +1,6 @@
+/** Omit / turn catalog visibility. Not a lease or marker. */
+export function usesGenericSilentProjection(call, catalog) {
+    const meta = catalog.catalogEntry(call.name)?.packMeta;
+    return meta?.kind === "bot-call" && (meta.show === "omit" || meta.show === "turn");
+}
+//# sourceMappingURL=delivery.js.map

package/dist/context/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../src/context/delivery.ts"],"names":[],"mappings":"AAUA,6DAA6D;AAC7D,MAAM,UAAU,2BAA2B,CAAC,IAA+B,EAAE,OAAwB;IACnG,MAAM,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACvD,OAAO,IAAI,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;AACrF,CAAC"}

package/dist/context/history.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Completion input projection: history, compact lead, notifications, tool results.
+ * Vendor Chat Completions / Responses encoding stays in the protocol actor.
+ */
+import { CompletionExpectation, type ToolTextPart } from "@inhuman.tools/harness-model";
+import type { KernelToolCatalog } from "@tool-catalog";
+export type HistoryToolCall = {
+    readonly id: string;
+    readonly name: string;
+    readonly argsJson: string;
+};
+export type HistoryMessage = {
+    readonly role: "system" | "user" | "assistant" | "tool";
+    readonly content: string | null | readonly ToolTextPart[];
+    readonly toolCallId?: string;
+    readonly toolCalls?: readonly HistoryToolCall[];
+    readonly thought?: string;
+    readonly thoughtEncrypted?: string;
+};
+export type ProjectHistoryOptions = {
+    readonly catalog?: KernelToolCatalog;
+    /** Emit an empty assistant shell when the dialect echoes empty thought. */
+    readonly echoEmptyThought?: boolean;
+};
+export declare function notificationMessagesOf(expectation: CompletionExpectation): HistoryMessage[];
+export declare function approvalNoteMessagesOf(expectation: CompletionExpectation): HistoryMessage[];
+export declare function steerMessagesOf(expectation: CompletionExpectation): HistoryMessage[];
+/** History before vendor wire encoding. */
+export declare function projectHistory(tip: CompletionExpectation, options?: ProjectHistoryOptions): Generator<HistoryMessage>;
+//# sourceMappingURL=history.d.ts.map

package/dist/context/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/context/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAGL,qBAAqB,EAUrB,KAAK,YAAY,EAKlB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQvD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,YAAY,EAAE,CAAC;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAQ3F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAQ3F;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,qBAAqB,GAAG,cAAc,EAAE,CAQpF;AAyHD,2CAA2C;AAC3C,wBAAiB,cAAc,CAC7B,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,qBAA0B,GAClC,SAAS,CAAC,cAAc,CAAC,CAiE3B"}