@inhuman.tools/harness-sdk 0.0.0-stage → 0.2.0

package/dist/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const HARNESS_DIR = ".harness";
+export declare function daemonSocketPath(systemRoot: string): string;
+/** One append-only log for host, worker, and daemon. */
+export declare function daemonLogPath(systemRoot: string): string;
+export declare function projectHarnessDir(workspacePath: string): string;
+export declare function projectSessionsDir(workspacePath: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/paths.js

@@ -0,0 +1,16 @@
+import { join } from "node:path";
+export const HARNESS_DIR = ".harness";
+export function daemonSocketPath(systemRoot) {
+    return join(systemRoot, "daemon.sock");
+}
+/** One append-only log for host, worker, and daemon. */
+export function daemonLogPath(systemRoot) {
+    return join(systemRoot, "harness.log");
+}
+export function projectHarnessDir(workspacePath) {
+    return join(workspacePath, HARNESS_DIR);
+}
+export function projectSessionsDir(workspacePath) {
+    return join(projectHarnessDir(workspacePath), "sessions");
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAEtC,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,OAAO,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,OAAO,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,UAAU,CAAC,CAAC;AAC5D,CAAC"}

package/dist/text/agent-cover.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Ask-cover copy for agent send/ask/message. Rim is dim verb + bright
+ * `{model} {Spec} agent`. Prompt (and spec one-liner) ride the composer
+ * stack — same T-join as MCP options / shell command. Not a pin.
+ *
+ * Stdlib one-liners match the named-agent bot table
+ * (`packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts`). User recipes
+ * in `KernelRoot.bots` win on the same name.
+ */
+import { CallJob, AgentMessageJob } from "@inhuman.tools/harness-model";
+/** CHANGE ONLY with packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts one-liners. */
+export declare const STDLIB_AGENT_DESCRIPTIONS: Readonly<Record<string, string>>;
+export type AgentCoverVerb = "ask" | "send" | "message";
+export type CoverAskContext = {
+    /** Session `kvs.model` — the worker inherits this at mint. */
+    readonly model?: string;
+};
+export declare function agentCoverVerb(work: CallJob | AgentMessageJob): AgentCoverVerb;
+export declare function agentSpecKey(work: object | null | undefined): string;
+/** `quick-search` → `Quick Search`. Sentinel `agent` is anonymous, not a spec. */
+export declare function titleAgentSpec(spec: string): string;
+export declare function formatAskAgentWho(spec: string): string;
+/**
+ * Occupancy pin list. Oxford comma comes from `Intl.ListFormat` (`en-US`).
+ * Noun is English v1 — one `agent` / many `agents` on the whole list.
+ */
+export declare function formatWaitingForAgents(specs: readonly string[], locale?: string): string;
+/**
+ * Isolated-cover rim. Markdown: furniture verb + `**bright**` who.
+ * Message does not spawn — no model. Empty spec is still `… agent`.
+ */
+export declare function formatAgentCoverAnnotation(opts: {
+    readonly verb: AgentCoverVerb;
+    readonly model: string;
+    readonly spec: string;
+}): string;
+export declare function agentCoverPrompt(work: CallJob | AgentMessageJob): string;
+export declare function agentAskStackedBody(prompt: string, description: string): string;
+export declare function agentExpandBlock(prompt: string, model: string): string;
+export declare function agentRecipeDescription(bots: Readonly<Record<string, {
+    readonly description?: string;
+}>>, spec: string): string;
+//# sourceMappingURL=agent-cover.d.ts.map

package/dist/text/agent-cover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-cover.d.ts","sourceRoot":"","sources":["../../src/text/agent-cover.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAgB,OAAO,EAAE,eAAe,EAAc,MAAM,8BAA8B,CAAC;AAKlG,2GAA2G;AAC3G,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,cAAc,CAG9E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAcpE;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,SAAU,GAAG,MAAM,CASzF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAKT;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,GAAG,MAAM,CAExE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAK/E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EACjE,IAAI,EAAE,MAAM,GACX,MAAM,CAMR"}

package/dist/text/agent-cover.js

@@ -0,0 +1,123 @@
+/**
+ * Ask-cover copy for agent send/ask/message. Rim is dim verb + bright
+ * `{model} {Spec} agent`. Prompt (and spec one-liner) ride the composer
+ * stack — same T-join as MCP options / shell command. Not a pin.
+ *
+ * Stdlib one-liners match the named-agent bot table
+ * (`packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts`). User recipes
+ * in `KernelRoot.bots` win on the same name.
+ */
+import { AgentCallJob, CallJob, AgentMessageJob, BotCallJob } from "@inhuman.tools/harness-model";
+/** Wire name. Ask stamps `voidLegal` false; send and bot-call stay send. */
+const AGENT_ASK_NAME = "agent__ask";
+/** CHANGE ONLY with packages/harness/src/server/system-plugins/named-agents/agent-stdlib.ts one-liners. */
+export const STDLIB_AGENT_DESCRIPTIONS = {
+    "quick-search": "cite matching paths; agent/ask for map",
+    explore: "thorough read-only repo investigation",
+    "web-research": "search and extract the public web; cite sources",
+    implementer: "isolated change from a brief; agent/ask for no history",
+    "test-writer": "write and run tests for a named surface",
+    "security-auditor": "find exploitable issues; do not patch",
+    "design-writer": "write a design doc from a brief",
+    "design-reviewer": "stress-test a design; do not rewrite it",
+    reviewer: "persistent reviewer for this session; later requests continue the same conversation",
+};
+export function agentCoverVerb(work) {
+    if (work instanceof AgentMessageJob)
+        return "message";
+    return !work.voidLegal || work.name === AGENT_ASK_NAME || work.name === "bot__ask" ? "ask" : "send";
+}
+export function agentSpecKey(work) {
+    if (work instanceof CallJob) {
+        const spec = stringArg(work.args, "spec")?.trim() ?? "";
+        if (spec !== "")
+            return spec;
+        const bot = work instanceof BotCallJob ? work.botName.trim() || work.contributionBotName.trim() : "";
+        if (bot !== "")
+            return bot;
+        const face = work instanceof AgentCallJob ? (work.faceName ?? "").trim() : "";
+        if (face !== "" && face !== "anonymous")
+            return face;
+        return "";
+    }
+    if (work instanceof AgentMessageJob) {
+        return stringArg(work.args, "targetName")?.trim() ?? "";
+    }
+    return "";
+}
+/** `quick-search` → `Quick Search`. Sentinel `agent` is anonymous, not a spec. */
+export function titleAgentSpec(spec) {
+    const raw = (typeof spec === "string" ? spec : "").trim();
+    if (raw === "" || raw === "agent")
+        return "";
+    return raw
+        .split(/[-_]+/)
+        .filter((part) => part !== "")
+        .map((part) => (part.length <= 3 ? part.toUpperCase() : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase()))
+        .join(" ");
+}
+export function formatAskAgentWho(spec) {
+    const titled = titleAgentSpec(spec);
+    return titled === "" ? "agent" : `${titled} agent`;
+}
+/**
+ * Occupancy pin list. Oxford comma comes from `Intl.ListFormat` (`en-US`).
+ * Noun is English v1 — one `agent` / many `agents` on the whole list.
+ */
+export function formatWaitingForAgents(specs, locale = "en-US") {
+    const names = [...specs].map((spec) => titleAgentSpec(spec)).filter((name) => name !== "");
+    if (names.length === 0) {
+        if (specs.length === 0)
+            return "";
+        return specs.length === 1 ? "waiting for an agent" : "waiting for agents";
+    }
+    const who = new Intl.ListFormat(locale, { style: "long", type: "conjunction" }).format(names);
+    const noun = names.length === 1 ? "agent" : "agents";
+    return `waiting for ${who} ${noun}`;
+}
+/**
+ * Isolated-cover rim. Markdown: furniture verb + `**bright**` who.
+ * Message does not spawn — no model. Empty spec is still `… agent`.
+ */
+export function formatAgentCoverAnnotation(opts) {
+    const model = opts.verb === "message" ? "" : opts.model.trim();
+    const spec = titleAgentSpec(opts.spec);
+    const who = [model, spec, "agent"].filter((part) => part !== "").join(" ");
+    return `${opts.verb} **${who}**`;
+}
+export function agentCoverPrompt(work) {
+    return stringArg(work.args, "message") ?? "";
+}
+export function agentAskStackedBody(prompt, description) {
+    const desc = description.trim();
+    if (desc === "")
+        return prompt;
+    if (prompt === "")
+        return desc;
+    return `${desc}\n\n${prompt}`;
+}
+export function agentExpandBlock(prompt, model) {
+    const body = prompt.trim();
+    const who = model.trim();
+    if (who === "")
+        return body;
+    if (body === "")
+        return who;
+    return `${body}\n${who}`;
+}
+export function agentRecipeDescription(bots, spec) {
+    const key = spec.trim();
+    if (key === "")
+        return "";
+    const fromFile = (bots[key]?.description ?? "").trim();
+    if (fromFile !== "")
+        return fromFile;
+    return STDLIB_AGENT_DESCRIPTIONS[key] ?? "";
+}
+function stringArg(args, key) {
+    if (args === null)
+        return undefined;
+    const value = args[key];
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+//# sourceMappingURL=agent-cover.js.map

package/dist/text/agent-cover.js.map

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

package/dist/text/format-shell.d.ts

@@ -0,0 +1,5 @@
+export declare function shellFormatGeneration(): number;
+/** Cached reprint, or `src` until WASM print settles / if parse fails. */
+export declare function formatShellCommand(src: string): string;
+export declare function formatShellCommandReady(src: string): Promise<string>;
+//# sourceMappingURL=format-shell.d.ts.map

package/dist/text/format-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-shell.d.ts","sourceRoot":"","sources":["../../src/text/format-shell.ts"],"names":[],"mappings":"AAYA,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM1E"}

package/dist/text/format-shell.js

@@ -0,0 +1,53 @@
+/**
+ * Display-only shfmt reprint of a shell command. Never rewrite argsJson.
+ * sh-syntax instantiates WASM per print and is async — cache the result;
+ * parse failure is identity. File print's trailing newline is stripped.
+ */
+import { observable, runInAction } from "mobx";
+import { print } from "sh-syntax";
+const generation = observable.box(0);
+const cache = new Map();
+const pending = new Map();
+export function shellFormatGeneration() {
+    return generation.get();
+}
+/** Cached reprint, or `src` until WASM print settles / if parse fails. */
+export function formatShellCommand(src) {
+    const hit = cache.get(src);
+    if (hit !== undefined)
+        return hit;
+    generation.get(); // MobX subscribe — WASM settle increments this so reprint rerenders. Not a dead call.
+    schedule(src);
+    return src;
+}
+export async function formatShellCommandReady(src) {
+    const hit = cache.get(src);
+    if (hit !== undefined)
+        return hit;
+    schedule(src);
+    await pending.get(src);
+    return cache.get(src) ?? src;
+}
+function schedule(src) {
+    if (src === "" || pending.has(src) || cache.has(src))
+        return;
+    const work = (async () => {
+        try {
+            const out = await print(src);
+            const formatted = out.replaceAll(/\n+$/g, "");
+            const next = formatted === "" ? src : formatted;
+            cache.set(src, next);
+            if (next !== src) {
+                runInAction(() => generation.set(generation.get() + 1));
+            }
+        }
+        catch {
+            cache.set(src, src);
+        }
+        finally {
+            pending.delete(src);
+        }
+    })();
+    pending.set(src, work);
+}
+//# sourceMappingURL=format-shell.js.map

package/dist/text/format-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-shell.js","sourceRoot":"","sources":["../../src/text/format-shell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;AACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEjD,MAAM,UAAU,qBAAqB;IACnC,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC;AAC1B,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,sFAAsF;IACxG,QAAQ,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,GAAW;IACvD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACd,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,GAAG,KAAK,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO;IAC7D,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,GAAG,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;YAChD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACrB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/text/identity.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Identity line from argsJson. Never a file count. No duration.
+ * Scheme outer is sugarcoat of expr(); tools use .name + args.
+ * Shell tape skips pretty-mcp `run`/`ran` — gutter `$`, bash command
+ * (or optional `description` on the collapsed row). A cwd other than `.`
+ * is the line after that call, not a right column. No `exit N` — fail
+ * is the gutter. Command display is an shfmt reprint; argsJson is what runs.
+ */
+import { CallJob, type KernelRoot, ProgrammaticJob, ToolCallJob, TurnNotificationChunk } from "@inhuman.tools/harness-model";
+import { type CoverAskContext as AgentCoverAskContext } from "./agent-cover.js";
+export type CoverAskContext = AgentCoverAskContext & {
+    readonly kernel?: KernelRoot | null;
+    /** Recipe name when a worker tool (not the spawn) sits on the host cover. */
+    readonly agentSpec?: string;
+};
+/** Wire name of the scheme-repl bag. Same string as SCHEME_REPL_TOOL_NAME. */
+export declare const SCHEME_REPL_NAME = "scheme_repl";
+/** Wire name of the scheme-watch bag. Same string as SCHEME_WATCH_TOOL_NAME. */
+export declare const SCHEME_WATCH_NAME = "scheme_watch";
+/** Collapsed caption XOR the program. Both bags, not only the repl. */
+export declare function isSchemeBagName(name: string): boolean;
+export type IdentityLine = {
+    readonly name: string;
+    readonly object: string;
+    readonly status: string;
+    /** Collapsed tape token. Command / expr (`object`) is on expand. */
+    readonly caption?: string;
+    /** pretty-mcp telegram is the whole row; `name` stays the wire name. */
+    readonly pretty?: boolean;
+    readonly block?: string;
+    readonly agent?: boolean;
+};
+export declare const CAPTION_MAX_CODE_POINTS = 80;
+/** TUI emits `…`. sdk glance `clampChars` does not — sharing the helper drops the ellipsis. */
+export declare function captionFromArgs(args: Record<string, unknown> | null): string | undefined;
+export declare function tailEllipsis(path: string, width: number): string;
+export declare function isPathShapedName(name: string): boolean;
+/** File mutations paint as open Diff blocks; identity is the path, not a telegram. */
+export declare function isMutateName(name: string): boolean;
+/**
+ * True when edit/create args would paint a Diff (pin or sealed).
+ * `write_file` that existed without stored prior text is not a create Diff —
+ * same cut as `writeFileDiff` in work-cells. A prior held in a blob is stored:
+ * its text arrives after the document names it.
+ */
+export declare function mutateArgsHaveDiff(work: ToolCallJob): boolean;
+export declare function pluginFaceIdentity(work: ToolCallJob | ProgrammaticJob, kernel?: KernelRoot | null): IdentityLine | null;
+/** Path + optional status. No wire name — the gutter already marks the row. */
+export declare function formatMutateIdentity(line: Pick<IdentityLine, "object" | "status">, width: number): string;
+export declare function identityLine(work: ToolCallJob | ProgrammaticJob, kernel?: KernelRoot | null): IdentityLine;
+export declare function formatIdentity(line: IdentityLine, width: number, pathShaped: boolean): string;
+export declare function agentCallName(work: CallJob): string;
+export declare function agentSpawnPrompt(work: CallJob): string;
+export declare function notificationPaintText(chunk: TurnNotificationChunk): string;
+/** Successful cutoff, or the human notice on a failed CompactJob. */
+export declare function compactJobPaintText(notice: string, focus: string, failed: boolean): string;
+/**
+ * Isolated-cover rim (omnibox top-right). Markdown: furniture + `**bright**`
+ * (chrome lifts emphasis to primary). MCP is server + action. Shell is
+ * `run command` plus the cwd token when set — the command itself is the
+ * composer stack, not this slot. Agent send/ask is dim `ask`/`send` + bright
+ * `{model} {Spec} agent`; the prompt rides the stack. A worker tool on the
+ * host cover prefixes `**{Spec} agent** ·` so the who is not the host.
+ */
+export declare function coverAskAnnotation(work: object | null | undefined, ctx?: CoverAskContext): string | undefined;
+export declare function shellAskCommand(work: object | null | undefined): string | undefined;
+//# sourceMappingURL=identity.d.ts.map

package/dist/text/identity.d.ts.map

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