@namzu/sdk 1.4.0 → 3.0.0

package/dist/types/tool/index.d.ts

@@ -12,7 +12,7 @@ export interface ToolRegistryRef {
 /**
  * Tracks which files the agent has read in the current run.
  * Write tool consults this to enforce the "read before overwrite" invariant
- * (Claude Code parity): an existing file must be read first or the write fails.
+ * an existing file must be read first or the write fails.
  * Keys are the resolved path used by the tool — sandbox-relative when a sandbox
  * is active, absolute (`workingDirectory`-resolved) otherwise.
  */
@@ -20,6 +20,50 @@ export interface FileReadTracker {
     recordRead(key: string): void;
     hasRead(key: string): boolean;
 }
+export interface ToolPauseOption {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+}
+export interface ToolPauseRequest {
+    /**
+     * Names this pause within the call.
+     *
+     * A tool call may pause more than once — "which environment", then
+     * "are you sure" — and the answers have to be told apart. The name is
+     * what a resume payload is routed by, so it is the author's to choose
+     * and should describe the decision, not the tool.
+     */
+    readonly name: string;
+    /** The question, in the words the human will read. */
+    readonly prompt: string;
+    /** Short topic label, when the surface showing this has room for one. */
+    readonly header?: string;
+    readonly options?: readonly ToolPauseOption[];
+    readonly multiSelect?: boolean;
+    /** Defaults to true: a human who disagrees with every option can say so. */
+    readonly allowFreeText?: boolean;
+}
+/**
+ * How a pause ended.
+ *
+ * `unanswered` is deliberately not a variant of `answered` with an empty
+ * selection. A tool that pauses to ask "may I charge this card" and reads
+ * silence as yes is worse than one that never asked, so the absence of an
+ * answer has its own shape and cannot be destructured into consent by
+ * accident.
+ */
+export type ToolPauseOutcome = {
+    readonly status: 'answered';
+    readonly selectedOptionIds: readonly string[];
+    readonly text?: string;
+} | {
+    readonly status: 'unanswered';
+    readonly reason: string;
+} | {
+    readonly status: 'aborted';
+};
+export type RequestToolPause = (request: ToolPauseRequest) => Promise<ToolPauseOutcome>;
 export interface ToolContext {
     runId: RunId;
     workingDirectory: string;
@@ -45,27 +89,188 @@ export interface ToolContext {
      * Optional because not every executor path provides it yet.
      */
     toolUseId?: string;
+    /**
+     * Raise a durable pause and wait for a human to resolve it.
+     *
+     * The pause machinery is excellent and was reachable from exactly four
+     * kernel-owned points — the plan gate, the tool-review gate, the
+     * iteration cadence, and one built-in question tool. A host-authored
+     * tool had no seam to it, so the operations that most want their own
+     * confirmation with their own wording (a spend, an outbound post, a
+     * destructive migration) had to settle for the generic tool-review
+     * gate or hand-thread a recorder and a resume callback into a private
+     * builder, which nothing in this type suggested was possible.
+     *
+     * The park is a real checkpoint, so a host can see the pause on every
+     * surface a tool-review park appears on, and the answer routes back by
+     * name on resume — several tools pausing in one batch each get their
+     * own, and one tool may pause more than once.
+     *
+     * Absent when whatever is driving the tool provides no route to a
+     * human — a host calling a tool directly, outside a run. A tool must
+     * treat it as optional and decide what to do without one, and must
+     * never read an unanswered pause as consent; the outcome says which it
+     * was, in its own shape, so silence cannot be destructured into a yes.
+     */
+    requestPause?: RequestToolPause;
+    /**
+     * Span to parent this tool's `execute_tool` span to.
+     *
+     * OTel's GenAI conventions define a strict hierarchy —
+     * `invoke_agent` → `chat {model}` → `execute_tool` — and vendor
+     * dashboards rely on it. `startActiveSpan` cannot supply the parent
+     * here: the span-owning bodies upstream are async GENERATORS, and a
+     * generator resumes on its consumer's async context, so the ambient
+     * context is already gone by the time a tool runs. Passing the parent
+     * explicitly is the only approach that actually works, and
+     * `ToolContext` is already threaded to exactly the right place.
+     */
+    parentSpan?: import('@opentelemetry/api').Span;
+    /**
+     * Say how far along you are, for a host rendering a live view.
+     *
+     * A tool may run for the full per-tool deadline — two minutes by
+     * default — and before this it was silent for all of it: a host could
+     * show that a build had started and then nothing until it finished or
+     * timed out.
+     *
+     * Fire-and-forget and never throws, so a tool can call it freely
+     * without wrapping it. The model never sees these: progress answers
+     * "is it still working?", which is a question only a human asks, and
+     * putting it in the conversation would spend tokens telling the model
+     * something it cannot act on.
+     *
+     * Absent when the executing surface has no event stream to write to.
+     */
+    report?: (message: string, fraction?: number) => void;
 }
 export interface ToolResult {
     success: boolean;
     output: string;
     data?: unknown;
     error?: string;
+    /**
+     * Rich content for the MODEL, when a string cannot carry it — a
+     * screenshot, a chart, a PDF. `output` stays the text the host and the
+     * transcript see; when this is set it is what reaches the provider.
+     *
+     * Keeping the two separate is deliberate: a host UI wants "screenshot
+     * (1280x800)", the model wants the pixels, and forcing one channel to
+     * serve both is what made `computer-use` send megabytes of base64 as
+     * text.
+     */
+    content?: import('../message/index.js').ToolResultContent;
+    /**
+     * This failure might succeed if tried again — a network blip, a lock
+     * contention, a rate limit — as opposed to one that never will, like a
+     * missing file or a rejected argument.
+     *
+     * Nothing distinguished the two before, so a transient failure cost a
+     * full model round trip to retry: the error went back as a
+     * `tool_result`, the model read it, and decided (or didn't) to call
+     * again. Only meaningful alongside {@link ToolDefinition.maxRetries};
+     * a tool that has not opted into retries is never retried no matter
+     * what it sets here.
+     */
+    retryable?: boolean;
 }
 export interface ToolDefinition<TInput = unknown> {
     name: string;
     description: string;
     inputSchema: z.ZodType<TInput, z.ZodTypeDef, unknown>;
+    /**
+     * Optional canonical JSON Schema shown to models instead of the runtime
+     * Zod schema. Use this when runtime compatibility accepts aliases or
+     * constraints that should not be advertised to a model.
+     *
+     * This is intentionally independent of TInput: the model-facing contract
+     * may be narrower than the execution decoder.
+     */
+    modelInputSchema?: Record<string, unknown>;
+    /**
+     * Ask capable providers to constrain generated input to modelInputSchema.
+     * ToolRegistry rejects this flag unless modelInputSchema is also present.
+     */
+    enforceModelInput?: boolean;
     /**
      * Concise, model-readable recovery guidance appended when inputSchema
      * rejects a call. Use for conditional schemas whose required shapes
      * cannot be reconstructed from JSON Schema's top-level `required` list.
      */
     validationErrorHint?: string;
+    /**
+     * The shape this tool returns, as JSON Schema, appended to the
+     * description the model sees.
+     *
+     * JSON Schema rather than Zod because it is **shown, never validated**:
+     * namzu does not check a tool's return value against it, so converting
+     * through Zod would only cost fidelity. Native tools that want one can
+     * render their Zod type with `renderToolSchema`.
+     *
+     * Optional and omitted by default — a tool whose return shape is
+     * obvious from its description gains nothing from spending prompt on
+     * it, and every tool schema rides in the cached prefix of every
+     * request.
+     */
+    outputSchema?: Record<string, unknown>;
     execute(input: TInput, context: ToolContext): Promise<ToolResult>;
     tier?: string;
     permissions?: ToolPermission[];
     category?: 'filesystem' | 'shell' | 'network' | 'analysis' | 'custom';
+    /**
+     * Deadline for a single execution, overriding the run-level default.
+     *
+     * On expiry the executor stops waiting and returns a model-visible
+     * error result, so a slow dependency becomes something the agent can
+     * route around instead of a turn that never comes back. The tool's
+     * `context.abortSignal` fires at the same moment; a tool that honours
+     * it also stops doing work, and one that ignores it merely becomes
+     * detached.
+     *
+     * Omit to inherit the executor's default.
+     */
+    timeoutMs?: number;
+    /**
+     * How many times a FAILED execution may be retried in-loop before the
+     * error is handed to the model.
+     *
+     * **Defaults to 0, and that default is load-bearing.** Retrying is only
+     * safe if the tool is idempotent, and the SDK cannot know that: silently
+     * re-running a `write_file`, a `git push` or a payment call is worse
+     * than never retrying at all. The tool author opts in, per tool.
+     *
+     * Even then, only failures the tool marked
+     * {@link ToolResult.retryable} are retried — a missing file is not
+     * going to appear on the second attempt, and burning the budget on it
+     * just delays the error the model needs to see.
+     */
+    maxRetries?: number;
+    /**
+     * This tool's output IS the run's answer: settle with it instead of
+     * asking the model to restate it.
+     *
+     * Every delegation path is blocking and returns the worker's final
+     * text as the dispatching call's result, after which the loop went
+     * round again — so a router agent, whose entire job is to pick a
+     * specialist, paid one extra model call per request at the parent's
+     * full context size, the most expensive call in the run. The relay is
+     * also LOSSY: the parent paraphrases the worker's answer through its
+     * own (compacted) context, so what the caller receives is not what the
+     * worker produced.
+     *
+     * Honoured only when the terminal call is the ONLY call in the turn
+     * and it did not fail. A model that asked for other work in the same
+     * turn meant to see those results, and ending the run would discard
+     * answers it requested; that turn takes the ordinary path and the
+     * reason is logged. A failed terminal call is not an answer either —
+     * the error goes back to the model, which is the point of returning
+     * errors to it at all.
+     *
+     * Off by default. The generic case is `structured_output`, which the
+     * runtime has always settled on; this is that rule made available to
+     * any tool.
+     */
+    terminal?: boolean;
     isReadOnly?(input: TInput): boolean;
     isDestructive?(input: TInput): boolean;
     isConcurrencySafe?(input: TInput): boolean;
@@ -130,4 +335,5 @@ export interface ToolRegistryContract {
     toTierGuidance(): string | null;
     assignTiers(mapping: Record<string, string>): void;
 }
+export * from './repair.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/tool/index.d.ts.map

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

package/dist/types/tool/index.js

@@ -1,2 +1,2 @@
-export {};
+export * from './repair.js';
 //# sourceMappingURL=index.js.map

package/dist/types/tool/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/tool/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/tool/index.ts"],"names":[],"mappings":"AAyXA,cAAc,aAAa,CAAA"}

package/dist/types/tool/repair.d.ts

@@ -0,0 +1,49 @@
+import type { ToolCall } from '../message/index.js';
+import type { ToolDefinition } from './index.js';
+/**
+ * Why a tool call could not be executed as issued.
+ *
+ * `invalid_json` — the arguments string is not parseable JSON at all,
+ *   typically a truncated stream or an unescaped quote.
+ * `schema_validation` — the JSON parsed but does not satisfy the tool's
+ *   schema: a missing required field, a string where a number belongs.
+ * `unknown_tool` — the model named a tool that is not registered, usually
+ *   a near-miss on a real name.
+ */
+export type ToolCallRepairReason = 'invalid_json' | 'schema_validation' | 'unknown_tool';
+export interface ToolCallRepairContext {
+    /** The call as the model issued it, arguments still raw. */
+    readonly toolCall: ToolCall;
+    readonly reason: ToolCallRepairReason;
+    /** The error the model would otherwise have been shown. */
+    readonly message: string;
+    /** The target tool. Absent for `unknown_tool`. */
+    readonly tool?: ToolDefinition;
+    /** The tool's JSON Schema, so a repair model has something to aim at. */
+    readonly jsonSchema?: Record<string, unknown>;
+    /** Every registered tool name — the useful context for `unknown_tool`. */
+    readonly availableTools: readonly string[];
+}
+/**
+ * Fix a tool call the model got wrong, before the error reaches it.
+ *
+ * A malformed call used to cost a full round trip: the error went back as
+ * a `tool_result`, the model read it, and tried again — a second inference
+ * on the entire context to fix a missing brace. A host that can repair the
+ * arguments locally (a cheap model with the schema, or plain string
+ * surgery) turns that into nothing.
+ *
+ * Return the corrected call, or `null` to decline — declining is not a
+ * failure, it just means the original error proceeds to the model as
+ * before. Deliberately narrow: a repair may rewrite the ARGUMENTS and the
+ * tool NAME, and nothing else. It cannot invent a call the model never
+ * made, and it cannot suppress one.
+ */
+export type RepairToolCall = (context: ToolCallRepairContext) => Promise<ToolCallRepair | null> | ToolCallRepair | null;
+export interface ToolCallRepair {
+    /** Corrected arguments, as a JSON string. */
+    readonly arguments: string;
+    /** Corrected tool name. Omit to keep the one the model used. */
+    readonly toolName?: string;
+}
+//# sourceMappingURL=repair.d.ts.map

package/dist/types/tool/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../../src/types/tool/repair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;GASG;AACH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,mBAAmB,GAAG,cAAc,CAAA;AAExF,MAAM,WAAW,qBAAqB;IACrC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAA;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7C,0EAA0E;IAC1E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG,CAC5B,OAAO,EAAE,qBAAqB,KAC1B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAAA;AAE3D,MAAM,WAAW,cAAc;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC1B"}

package/dist/types/tool/repair.js

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

package/dist/types/tool/repair.js.map

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

package/dist/types/toolset/index.d.ts

@@ -1,8 +1,7 @@
 import type { LLMToolSchema, ToolDefinition, ToolPermission } from '../tool/index.js';
-export type ToolCatalogSurface = 'chat' | 'cowork' | 'managed-agent' | 'worker' | 'code';
+export type ToolCatalogSurface = 'chat' | 'supervised' | 'managed-agent' | 'worker' | 'code';
 export type ToolSourceKind = 'host_tool' | 'provider_builtin' | 'mcp_server' | 'skill' | 'plugin' | 'connector';
 export type ToolLoadingMode = 'eager' | 'deferred' | 'disabled' | 'suspended';
-export type ToolPermissionPolicy = 'default' | 'always_allow' | 'always_ask' | 'deny';
 export interface ToolSource {
     readonly id: string;
     readonly kind: ToolSourceKind;
@@ -21,7 +20,7 @@ export interface ToolSource {
         readonly beta?: string;
     };
     readonly skill?: {
-        readonly type: 'anthropic' | 'custom';
+        readonly type: 'published' | 'custom';
         readonly skillId: string;
         readonly version?: string;
     };
@@ -31,7 +30,6 @@ export interface ToolsetPolicy {
     readonly enabled?: boolean;
     readonly loading?: ToolLoadingMode;
     readonly preferred?: boolean;
-    readonly permissionPolicy?: ToolPermissionPolicy;
     readonly surfaces?: readonly ToolCatalogSurface[];
     readonly providerConfig?: Record<string, unknown>;
 }
@@ -41,7 +39,6 @@ export interface ToolsetDefinition {
     readonly name: string;
     readonly description?: string;
     readonly defaultPolicy?: ToolsetPolicy;
-    readonly toolPolicies?: Record<string, ToolsetPolicy>;
     readonly metadata?: Record<string, unknown>;
 }
 export interface ToolCatalogEntry {

package/dist/types/toolset/index.d.ts.map

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

package/dist/utils/__tests__/atomic-write.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=atomic-write.test.d.ts.map

package/dist/utils/__tests__/atomic-write.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/atomic-write.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/atomic-write.test.js

@@ -0,0 +1,91 @@
+import { mkdtempSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { atomicWriteFile, temporaryPathFor } from '../atomic-write.js';
+/**
+ * The rename is what makes the write atomic — a reader sees the old file or
+ * the new one, never a half-written one. The sidecar it renames FROM has to
+ * be private to this write, and in seven places it was a fixed
+ * `${path}.tmp`.
+ *
+ * Two writers of the same record then shared one scratch file: both opened
+ * it, both wrote into it, and the first rename published whatever mixture
+ * had landed while the second renamed a file that was no longer there. That
+ * is the failure atomic writes exist to prevent, reached through the
+ * mechanism meant to prevent it.
+ *
+ * Not hypothetical here: the cross-process park and unpark handoff is a
+ * design where two processes legitimately touch the same records, and it is
+ * the feature these stores exist to serve.
+ */
+let dir;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), 'namzu-atomic-'));
+});
+afterEach(() => {
+    rmSync(dir, { recursive: true, force: true });
+});
+describe('the sidecar name', () => {
+    it('is different every time', () => {
+        const names = new Set(Array.from({ length: 1000 }, () => temporaryPathFor('/x/record.json')));
+        // A thousand writes in the same millisecond is a batch, not a stress
+        // test — a timestamp alone would collide here.
+        expect(names.size).toBe(1000);
+    });
+    it('stays beside the file it will become', () => {
+        expect(temporaryPathFor('/x/record.json').startsWith('/x/record.json.')).toBe(true);
+        // Same directory, so the rename is within one filesystem and stays
+        // atomic rather than degrading to a copy.
+        expect(temporaryPathFor('/x/record.json')).toMatch(/\.tmp$/);
+    });
+    it('carries the process id, so two processes cannot pick the same one', () => {
+        expect(temporaryPathFor('/x/record.json')).toContain(`.${process.pid}.`);
+    });
+});
+describe('writing', () => {
+    it('publishes the content', async () => {
+        const target = join(dir, 'record.json');
+        await atomicWriteFile(target, '{"a":1}');
+        expect(readFileSync(target, 'utf-8')).toBe('{"a":1}');
+    });
+    it('leaves no sidecar behind on success', async () => {
+        await atomicWriteFile(join(dir, 'record.json'), 'x');
+        expect(readdirSync(dir)).toEqual(['record.json']);
+    });
+    it('leaves no sidecar behind on failure', async () => {
+        // A directory that does not exist fails the write, not the rename.
+        await expect(atomicWriteFile(join(dir, 'missing', 'record.json'), 'x')).rejects.toThrow();
+        // A leftover sidecar looks like a record to anything scanning the
+        // directory, and the next attempt would not reuse it anyway.
+        expect(readdirSync(dir)).toEqual([]);
+    });
+    it('does not corrupt a record when two writes race', async () => {
+        const target = join(dir, 'record.json');
+        const first = 'a'.repeat(200_000);
+        const second = 'b'.repeat(200_000);
+        await Promise.all([atomicWriteFile(target, first), atomicWriteFile(target, second)]);
+        // One of them won; neither produced a mixture. With a shared sidecar
+        // this is exactly where the halves interleave.
+        const written = readFileSync(target, 'utf-8');
+        expect([first, second]).toContain(written);
+        expect(readdirSync(dir)).toEqual(['record.json']);
+    });
+    it('survives many concurrent writes to the same record', async () => {
+        const target = join(dir, 'record.json');
+        const bodies = Array.from({ length: 25 }, (_, i) => `${i}`.repeat(50_000));
+        await Promise.all(bodies.map((body) => atomicWriteFile(target, body)));
+        expect(bodies).toContain(readFileSync(target, 'utf-8'));
+        expect(readdirSync(dir)).toEqual(['record.json']);
+    });
+});
+describe('a contended rename', () => {
+    it('does not retry a failure that is not contention', async () => {
+        // A missing directory is a permanent condition; retrying it would
+        // turn a clear failure into a delay and then the same failure.
+        const started = Date.now();
+        await expect(atomicWriteFile(join(dir, 'nope', 'record.json'), 'x')).rejects.toThrow();
+        expect(Date.now() - started).toBeLessThan(50);
+    });
+});
+//# sourceMappingURL=atomic-write.test.js.map

package/dist/utils/__tests__/atomic-write.test.js.map

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

package/dist/utils/__tests__/shell-compress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=shell-compress.test.d.ts.map

package/dist/utils/__tests__/shell-compress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-compress.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/shell-compress.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/shell-compress.test.js

@@ -0,0 +1,41 @@
+import { describe, expect, it } from 'vitest';
+import { compressShellOutputFull } from '../shell-compress.js';
+/**
+ * `raw` here is bash stdout, and bash stdout is not something the run
+ * itself typed — a fetched page, a piped response, a file an agent was
+ * told to `cat`, all land in it verbatim. The pass-line detector's opening
+ * alternative used to hunt for a PASS/ok marker with an unbounded
+ * whitespace/bullet run in front of it. On a long line that never produces
+ * that marker, the engine restarts the hunt at every offset in the line,
+ * and this codebase's tool budgets cap payload bytes, not line length —
+ * one crafted line was enough to pin a core testing the regex, and would
+ * have done the same to the process compressing real output.
+ */
+describe('compressShellOutputFull', () => {
+    it('does not hang on a long marker-free line (js/polynomial-redos regression)', () => {
+        // 20 lines is `DEFAULT_MIN_LINES` — below it the function returns the
+        // input untouched and the vulnerable regex is never reached.
+        const poison = ' '.repeat(4000);
+        const raw = [poison, ...Array.from({ length: 19 }, (_, i) => `line ${i}`)].join('\n');
+        const start = Date.now();
+        compressShellOutputFull(raw);
+        const elapsedMs = Date.now() - start;
+        // The vulnerable regex takes ~20s on a line this size; a fixed one
+        // finishes in low single-digit milliseconds. 1s leaves headroom for a
+        // loaded CI box while still failing hard on a regression.
+        expect(elapsedMs).toBeLessThan(1000);
+    });
+    it('still recognizes and suppresses repeated PASS markers', () => {
+        // Distinct names, not indices: normalizeLine folds digits to `N`, so
+        // index-numbered lines would collapse into one another in the repeat
+        // pass and the assertion below would be measuring the wrong thing.
+        const names = ['alpha', 'bravo', 'charlie', 'delta', 'echo', 'foxtrot', 'golf', 'hotel'];
+        const passLines = names.map((name) => `  ✓ test ${name} PASS `);
+        const raw = [...passLines, ...Array.from({ length: 15 }, (_, i) => `other line ${i}`)].join('\n');
+        const { text } = compressShellOutputFull(raw, { maxPassLines: 3 });
+        expect(text).toContain('passing tests omitted');
+        // Only the configured cap of PASS lines survives verbatim.
+        expect(text.match(/✓ test \w+ PASS/g)?.length).toBe(3);
+    });
+});
+//# sourceMappingURL=shell-compress.test.js.map

package/dist/utils/__tests__/shell-compress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-compress.test.js","sourceRoot":"","sources":["../../../src/utils/__tests__/shell-compress.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;;;;;;;;GAUG;AACH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACpF,sEAAsE;QACtE,6DAA6D;QAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAErF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACxB,uBAAuB,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;QAEpC,mEAAmE;QACnE,sEAAsE;QACtE,0DAA0D;QAC1D,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAChE,qEAAqE;QACrE,qEAAqE;QACrE,mEAAmE;QACnE,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;QACxF,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,IAAI,QAAQ,CAAC,CAAA;QAC/D,MAAM,GAAG,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAC1F,IAAI,CACJ,CAAA;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,uBAAuB,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAA;QAElE,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;QAC/C,2DAA2D;QAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/utils/atomic-write.d.ts

@@ -0,0 +1,10 @@
+export declare function temporaryPathFor(filePath: string): string;
+/**
+ * Publish `content` atomically.
+ *
+ * A failed write removes its own sidecar. Leaving it behind would litter
+ * the store with files that look like records to anything scanning the
+ * directory, and the next attempt would not reuse it anyway.
+ */
+export declare function atomicWriteFile(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/utils/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/utils/atomic-write.ts"],"names":[],"mappings":"AA+BA,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAStF"}