@inhuman.tools/turn 0.0.0-stage → 0.2.0

package/dist/session/side-channel-reminder.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Nags for side-channel tools the model skips.
+ *
+ * Title (`update_metadata`) and context_need keep separate clocks. A call
+ * of one does not reset the other. Each nag is attached to the completion
+ * being armed, as `systemNote`. The TUI paints tape cells and does not
+ * paint that field, so the nag stays off the
+ * transcript. A user message or a tape cell would show it.
+ *
+ * Only a sealed successful session completion on the visible tape counts.
+ * The count starts after the latest cutoff, same as `spine()`:
+ * rounds behind the summary are off the wire, and a call buried there
+ * must not keep the nag dark. An uncommitted compact is not a boundary.
+ * Representation cells and the isolated summarizer child are not rounds.
+ * A failure, an isolated intern, and the round still being armed are not
+ * rounds the model spent skipping the tool. A scheme inner call counts:
+ * display already reads that job.
+ *
+ * `offered === null` means the wire is still the live catalog, which lists
+ * both tools. A frozen tool set is the wire list — omit a nag whose tool
+ * is absent from it.
+ *
+ * Due on the armed round when (quiet + 1) is a multiple of the period.
+ * `quiet % period` fires one round late.
+ */
+import { type SystemPrompt } from "@inhuman.tools/harness-commons";
+import { SessionTurn } from "@inhuman.tools/harness-model";
+/** Quiet sealed session rounds before the armed round carries the nag. */
+export declare const SIDE_CHANNEL_REMINDER_EVERY = 5;
+export declare const TITLE_UPDATE_REMINDER: SystemPrompt;
+export declare const CONTEXT_NEED_REMINDER: SystemPrompt;
+export type SideChannelRound = {
+    readonly calls: readonly string[];
+};
+export declare function quietRoundsSince(rounds: readonly SideChannelRound[], tool: string): number;
+export declare function sideChannelReminderDue(quietRounds: number, every?: number): boolean;
+export declare function joinSystemNotes(notes: readonly SystemPrompt[]): SystemPrompt;
+export declare function sideChannelReminderNote(rounds: readonly SideChannelRound[], every?: number, offered?: readonly string[] | null): SystemPrompt;
+/** Oldest first. The armed completion is not sealed yet, so it is absent. */
+export declare function sealedActorRounds(turn: SessionTurn): readonly SideChannelRound[];
+//# sourceMappingURL=side-channel-reminder.d.ts.map

package/dist/session/side-channel-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-channel-reminder.d.ts","sourceRoot":"","sources":["../../src/session/side-channel-reminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAIL,WAAW,EAMZ,MAAM,8BAA8B,CAAC;AAEtC,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,eAAO,MAAM,qBAAqB,cAA2Q,CAAC;AAE9S,eAAO,MAAM,qBAAqB,cAAmU,CAAC;AAEtW,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1F;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAoC,GAAG,OAAO,CAIhH;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,CAM5E;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,KAAK,GAAE,MAAoC,EAC3C,OAAO,GAAE,SAAS,MAAM,EAAE,GAAG,IAAW,GACvC,YAAY,CAYd;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,gBAAgB,EAAE,CAwChF"}

package/dist/session/side-channel-reminder.js

@@ -0,0 +1,132 @@
+/**
+ * Nags for side-channel tools the model skips.
+ *
+ * Title (`update_metadata`) and context_need keep separate clocks. A call
+ * of one does not reset the other. Each nag is attached to the completion
+ * being armed, as `systemNote`. The TUI paints tape cells and does not
+ * paint that field, so the nag stays off the
+ * transcript. A user message or a tape cell would show it.
+ *
+ * Only a sealed successful session completion on the visible tape counts.
+ * The count starts after the latest cutoff, same as `spine()`:
+ * rounds behind the summary are off the wire, and a call buried there
+ * must not keep the nag dark. An uncommitted compact is not a boundary.
+ * Representation cells and the isolated summarizer child are not rounds.
+ * A failure, an isolated intern, and the round still being armed are not
+ * rounds the model spent skipping the tool. A scheme inner call counts:
+ * display already reads that job.
+ *
+ * `offered === null` means the wire is still the live catalog, which lists
+ * both tools. A frozen tool set is the wire list — omit a nag whose tool
+ * is absent from it.
+ *
+ * Due on the armed round when (quiet + 1) is a multiple of the period.
+ * `quiet % period` fires one round late.
+ */
+import { prompt } from "@inhuman.tools/harness-commons";
+import { CompactJob, CONTEXT_NEED_TOOL_NAME, ProgrammaticJob, SessionTurn, tapeCompletion, ToolCallJob, UPDATE_METADATA_TOOL_NAME, } from "@inhuman.tools/harness-model";
+/** Quiet sealed session rounds before the armed round carries the nag. */
+export const SIDE_CHANNEL_REMINDER_EVERY = 5;
+export const TITLE_UPDATE_REMINDER = prompt.system `Call update_metadata in this completion, last among your other tool calls — not as its own round. Record this turn's title and a short description. This is bookkeeping: do not mention this note or the call in your reply, and do not address the user.`;
+export const CONTEXT_NEED_REMINDER = prompt.system `Call context_need in this completion, last among your other tool calls — not as its own round. Put what to keep in the call's arguments only. This is bookkeeping: do not mention this note or the call in your reply, do not describe what you will keep, and do not address the user. Do not wait for a result.`;
+export function quietRoundsSince(rounds, tool) {
+    let quiet = 0;
+    for (let index = rounds.length - 1; index >= 0; index -= 1) {
+        const round = rounds[index];
+        if (round.calls.includes(tool))
+            return quiet;
+        quiet += 1;
+    }
+    return quiet;
+}
+export function sideChannelReminderDue(quietRounds, every = SIDE_CHANNEL_REMINDER_EVERY) {
+    if (!Number.isInteger(every) || every < 1)
+        return false;
+    if (!Number.isInteger(quietRounds) || quietRounds < 0)
+        return false;
+    return (quietRounds + 1) % every === 0;
+}
+export function joinSystemNotes(notes) {
+    const text = notes
+        .map((note) => note.trim())
+        .filter((note) => note !== "")
+        .join("\n\n");
+    return prompt.system `${text}`;
+}
+export function sideChannelReminderNote(rounds, every = SIDE_CHANNEL_REMINDER_EVERY, offered = null) {
+    const allow = offered == null ? null : new Set(offered);
+    return joinSystemNotes([
+        allow?.has(UPDATE_METADATA_TOOL_NAME) !== false &&
+            sideChannelReminderDue(quietRoundsSince(rounds, UPDATE_METADATA_TOOL_NAME), every)
+            ? TITLE_UPDATE_REMINDER
+            : prompt.system ``,
+        allow?.has(CONTEXT_NEED_TOOL_NAME) !== false &&
+            sideChannelReminderDue(quietRoundsSince(rounds, CONTEXT_NEED_TOOL_NAME), every)
+            ? CONTEXT_NEED_REMINDER
+            : prompt.system ``,
+    ]);
+}
+/** Oldest first. The armed completion is not sealed yet, so it is absent. */
+export function sealedActorRounds(turn) {
+    const newestFirst = [];
+    const seen = new Set();
+    let cell = turn;
+    while (cell instanceof SessionTurn && !seen.has(cell)) {
+        seen.add(cell);
+        newestFirst.push(cell);
+        cell = cell.turnTail;
+    }
+    const oldestFirst = newestFirst.toReversed();
+    const cutoff = latestCutoff(oldestFirst);
+    const rounds = [];
+    const start = cutoff == null ? 0 : Math.max(0, oldestFirst.indexOf(cutoff.turn));
+    for (const head of oldestFirst.slice(start)) {
+        let chunks = head.doneWork;
+        if (cutoff?.turn === head) {
+            const at = chunks.indexOf(cutoff.compact);
+            if (at !== -1)
+                chunks = chunks.slice(at + 1);
+        }
+        let round = null;
+        for (const chunk of chunks) {
+            const pew = tapeCompletion(chunk);
+            if (pew != null) {
+                if (pew.completionMode === "isolated" || pew.outcome !== "successful") {
+                    round = null;
+                    continue;
+                }
+                round = { calls: [] };
+                for (const call of pew.responseCalls)
+                    noteMetaCall(round, call.name);
+                rounds.push(round);
+                continue;
+            }
+            if (round == null)
+                continue;
+            if (chunk instanceof ToolCallJob)
+                noteMetaCall(round, chunk.name);
+            if (chunk instanceof ProgrammaticJob) {
+                for (const inner of chunk.toolCalls)
+                    noteMetaCall(round, inner.name);
+            }
+        }
+    }
+    return rounds;
+}
+function noteMetaCall(round, name) {
+    if (name !== UPDATE_METADATA_TOOL_NAME && name !== CONTEXT_NEED_TOOL_NAME)
+        return;
+    if (round.calls.includes(name))
+        return;
+    round.calls.push(name);
+}
+function latestCutoff(turns) {
+    for (const head of turns.toReversed()) {
+        for (const chunk of head.doneWork.toReversed()) {
+            if (chunk instanceof CompactJob && chunk.cutoff)
+                return { turn: head, compact: chunk };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=side-channel-reminder.js.map

package/dist/session/side-channel-reminder.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Host surfaces this package observes. Kernel/project/harness daemons stay
+ * outside; composition supplies commands and park abort through these.
+ */
+import type { UserPrompt } from "@inhuman.tools/harness-commons";
+import type { CompletionExpectation, RegisteredToolsSet, SessionRoot, SessionSystemPrompt, SessionTurn, SkillSpec } from "@inhuman.tools/harness-model";
+import type { Job, WorkExpectation } from "@inhuman.tools/plexus-expectations";
+export type SessionCommandHost = {
+    readonly session: SessionRoot;
+    readonly constitution: string;
+    env(): Record<string, string>;
+    toolsFor(tail: SessionSystemPrompt | SessionTurn | null): RegisteredToolsSet | null;
+    queuedVerbs(): ReadonlySet<string>;
+    /** R1: the resolved context-retention policy JSON a new turn is stamped with. Omit = unstamped (legacy). */
+    retentionJson?(): string;
+    /**
+     * Skill slash split. `prompt` stays what was typed. `derived` is the model
+     * injection when it differs, otherwise null.
+     */
+    expandSkill?(prompt: UserPrompt, skills: readonly SkillSpec[], verbs: ReadonlySet<string>): {
+        readonly prompt: UserPrompt;
+        readonly derived: UserPrompt | null;
+    };
+    syncSkills?(): void;
+    applyBotNotice?(turn: SessionTurn): void;
+    restorePluginState?(): void;
+    cancelOwned(turn: SessionTurn): void;
+    skipBackoff?(completion: CompletionExpectation): void;
+    loadTurn?(id: string): SessionTurn | undefined;
+    rename?(title: string): {
+        readonly ok: true;
+        readonly title: string;
+    };
+    log?(message: string): void;
+    /** `compactKeepTurns` dial, recorded on a `/compact` job when it is minted (F8). */
+    compactKeepTurns?(): number;
+    readonly closed?: boolean;
+};
+export type ParkWork = {
+    abortJob(job: Job, reason?: unknown): void;
+    inFlightJobs(): Iterable<Job>;
+    abortExpectation?(expectation: WorkExpectation, reason?: unknown): void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,SAAS,EACV,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACpF,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,4GAA4G;IAC5G,aAAa,CAAC,IAAI,MAAM,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB;QAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAA;KAAE,CAAC;IACxE,UAAU,CAAC,IAAI,IAAI,CAAC;IACpB,cAAc,CAAC,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACzC,kBAAkB,CAAC,IAAI,IAAI,CAAC;IAC5B,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,WAAW,CAAC,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACtD,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC/C,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,IAAI,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,YAAY,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,gBAAgB,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACzE,CAAC"}

package/dist/session/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":""}

package/dist/tool-catalog/catalog.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Per-instance tool catalog.
+ *
+ * catalog = registered ∪ expand(connection)
+ * Registered entries and recipes are contributions from outside this package.
+ * Connection entries come from a host attached as `connectionHost`.
+ *
+ * wireName — model tools[] projection (regenerate freely).
+ * connection source — kernel ConnectionSpec map key + server tool; never re-parse wireName.
+ */
+import { DisposableClass, type SystemPrompt } from "@inhuman.tools/harness-commons";
+import { type CatalogRecipe } from "./recipes.js";
+import { type CatalogEntry, type WorkerToolHost } from "./types.js";
+export type CompiledPluginContribution = {
+    readonly compiledRecipes: readonly CatalogRecipe[];
+};
+export declare class KernelToolCatalog extends DisposableClass {
+    #private;
+    private readonly source?;
+    private readonly permits?;
+    constructor(source?: KernelToolCatalog | undefined, permits?: ((name: string) => boolean) | undefined);
+    /**
+     * Product composition may replace this. Empty until a roster is registered —
+     * this package does not name host tools.
+     */
+    TOOLS_SYSTEM_ADDENDUM: SystemPrompt;
+    /** Set by the host. Views inherit it from their source. */
+    workerHost: WorkerToolHost;
+    accessor packEntries: CatalogEntry[];
+    /** Named-agent recipes authored on KernelRoot.bots / ProjectRoot.bots. */
+    accessor recipes: CatalogRecipe[];
+    /** Plugin-compiled bot recipes. Not written to KernelRoot.bots. */
+    accessor compiledRecipes: CatalogRecipe[];
+    /** Installed plugins' `.prompt` bots. An authored or compiled recipe of the same name wins. */
+    accessor surfaceRecipes: CatalogRecipe[];
+    /**
+     * Program revision of each enabled plugin bot, keyed by bot name. A behavior
+     * plugin has no compiled install, so this is the revision `isCallPaused`
+     * compares a call against. Empty while no behavior has been pinned.
+     */
+    accessor botRevisions: ReadonlyMap<string, string>;
+    /** Project-dir overlay copied onto session views. Kernel catalog field stays empty. */
+    accessor projectRecipes: CatalogRecipe[];
+    accessor connectionHost: {
+        readonly connectionEntries: readonly CatalogEntry[];
+    } | undefined;
+    /** Worker-only private bundled MCP tools (not in foreground catalog). */
+    accessor privateWorkerEntries: CatalogEntry[];
+    /** Tools declared by this agent's pinned behavior. The behavior is their grant. */
+    accessor behaviorEntries: CatalogEntry[];
+    get connectionEntries(): readonly CatalogEntry[];
+    recipe(name: string): CatalogRecipe | undefined;
+    allRecipes(): readonly CatalogRecipe[];
+    replaceCompiledPlugins(state: CompiledPluginContribution): void;
+    /** Returns the bots skipped because another recipe already owns the name. */
+    replaceSurfaceRecipes(recipes: readonly CatalogRecipe[]): string[];
+    replaceRecipes(recipes: readonly CatalogRecipe[]): void;
+    catalogEntry(wireName: string): CatalogEntry | undefined;
+    catalogEntries(): readonly CatalogEntry[];
+    catalogWireNames(): readonly string[];
+    replacePack(entries: readonly CatalogEntry[]): void;
+    bindProjectRecipes(workspacePath: string, recipes: readonly CatalogRecipe[]): void;
+    unbindProjectRecipes(workspacePath: string): void;
+    projectRecipesOf(workspacePath: string | undefined): readonly CatalogRecipe[];
+    /** Filtered view of this catalog. Recipe fields are shared; overlay fields stay on the caller. */
+    view(permits?: (name: string) => boolean): KernelToolCatalog;
+    protected dispose(): void;
+}
+export declare function catalogTriggersReactLoop(catalog: KernelToolCatalog, wire: string): boolean;
+export declare function requireCatalog<T extends KernelToolCatalog>(catalog: T | undefined, what: string): T;
+/** Tools the session's pinned behavior declares. Replaced whenever the pin reattaches. */
+export declare const bindBehaviorEntries: (root: object, entries: readonly CatalogEntry[]) => void;
+export declare function behaviorEntriesOf(root: object | undefined | null): readonly CatalogEntry[];
+/** Bind a session (or test) root to a kernel catalog. */
+export declare function bindSessionCatalog(root: object, catalog: KernelToolCatalog): void;
+export declare function catalogOf(root: object | undefined | null): KernelToolCatalog | undefined;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/tool-catalog/catalog.d.ts.map

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