@cursor/july 0.1.102 → 0.1.104

package/dist/internal/distribution.js

@@ -2,26 +2,15 @@
  * Distribution facts for the running copy of the framework.
  *
  * The package publishes to npm as `@cursor/july` (the pre-launch codename
- * for Agent SDK; bins: `july` for `npx @cursor/july`, `agent-sdk`, the
- * older `agentkit`, and the legacy `agent-serve` alias) but
- * the monorepo keeps its historical `@anysphere/agent-serve` import name
- * working via tsconfig paths (source runs) and the runtime alias hooks
- * (compiled runs). Everything that needs to print a package name, print a
- * CLI command, or locate the package root goes through this module.
+ * for Agent SDK) with one bin, `agent-sdk`. Everything that needs to print
+ * a package name, print a CLI command, locate the package root, or pin
+ * `@cursor/july[/x]` to this copy goes through this module.
  */
 import { readFileSync } from "node:fs";
-import { basename } from "node:path";
-import { fileURLToPath } from "node:url";
+import { join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 /** Published npm package name (pre-launch codename for Agent SDK). */
 export const PACKAGE_NAME = "@cursor/july";
-/** Historical monorepo package name; never published, aliased at runtime. */
-export const LEGACY_PACKAGE_NAME = "@anysphere/agent-serve";
-/**
- * Future public package name; aliased with the same direct-to-running-dist
- * semantics as PACKAGE_NAME so the eventual rename keeps authored imports
- * on the CLI's module identity.
- */
-export const AGENTKIT_PACKAGE_NAME = "@cursor/agentkit";
 /**
  * Bracketed product tag for stderr / ServeOptions.logger lines
  * (`[agent-sdk] …`, `[agent-sdk/slack] …`).
@@ -29,22 +18,8 @@ export const AGENTKIT_PACKAGE_NAME = "@cursor/agentkit";
 export const LOG_PRODUCT = "agent-sdk";
 export const LOG_PREFIX = `[${LOG_PRODUCT}]`;
 export const SLACK_LOG_PREFIX = `[${LOG_PRODUCT}/slack]`;
-/**
- * Command name this CLI was invoked as. Both bins point at the same entry;
- * keep help text and hints copy-pasteable for whichever the user typed.
- */
-export const CLI_COMMAND_NAME = detectCliCommandName();
-function detectCliCommandName() {
-    // Only an extensionless `agent-serve` entry (the npm .bin symlink) proves
-    // the user typed the legacy alias. Shims that re-exec the real dist script
-    // (pnpm/Windows) hand us `agent-serve.js` for both bins, so anything else
-    // brands as the primary name.
-    const entry = process.argv[1];
-    if (entry !== undefined && basename(entry) === "agent-serve") {
-        return "agent-serve";
-    }
-    return "agent-sdk";
-}
+/** The bin name, for help text and copy-pasteable hints. */
+export const CLI_COMMAND_NAME = "agent-sdk";
 /**
  * True when this module runs from compiled `dist/` output (a published
  * install, or `node dist/bin/agent-serve.js`). False when running from
@@ -62,17 +37,18 @@ export function isCompiledDistribution() {
 export function packageRootDir() {
     return fileURLToPath(new URL("../..", import.meta.url));
 }
+function packageManifest() {
+    const raw = readFileSync(join(packageRootDir(), "package.json"), "utf8");
+    return JSON.parse(raw);
+}
 /** Version of the running package (from its own package.json). */
 export function packageVersion() {
-    const raw = readFileSync(new URL("../../package.json", import.meta.url), "utf8");
-    const parsed = JSON.parse(raw);
-    return typeof parsed.version === "string" ? parsed.version : "0.0.0";
+    return packageManifest().version;
 }
 export function cliVersionInfo() {
     return {
         name: PACKAGE_NAME,
         version: packageVersion(),
-        cli: CLI_COMMAND_NAME,
     };
 }
 /**
@@ -88,41 +64,17 @@ export function formatCliVersion(options) {
     return `${info.version}\n`;
 }
 /**
- * Authoring entry subpaths and their dist-relative output files — the
- * runtime mirror of the package `exports` map (the source of truth;
- * `authored-loaders.test.ts` asserts they stay identical). The alias hooks
- * derive `@anysphere/agent-serve[/x]`, `@cursor/july[/x]`, and
- * `@cursor/agentkit[/x]` direct targets from this list.
+ * `@cursor/july[/subpath]` → `file:` URL of this copy's `import` target,
+ * for every subpath in the package `exports` map. The published manifest
+ * points at `dist/`; Bazel's staged copy points at the in-place `src/`
+ * emit, and the aliases follow whichever the manifest says.
  */
-export const AUTHORING_ENTRY_FILES = [
-    ["", "index.js"],
-    ["tools", "tools.js"],
-    ["channels", "channels.js"],
-    ["channels/slack", "channels/slack/index.js"],
-    ["channels/github", "channels/github/index.js"],
-    ["channels/origin", "channels/origin/index.js"],
-    ["channels/deployments", "channels/deployments/index.js"],
-    ["skills", "skills.js"],
-    ["extensions", "extensions.js"],
-    [
-        "extensions/cursor-cloud-agents",
-        "extensions/cursor-cloud-agents/extension.js",
-    ],
-    ["schedules", "schedules.js"],
-    ["reminders", "reminders.js"],
-    ["connections", "connections.js"],
-    ["hooks", "hooks.js"],
-    ["memory", "memory.js"],
-    ["prompt", "prompt.js"],
-    ["evals", "evals.js"],
-    ["evals/reporters", "evals/reporters.js"],
-    ["evals/loaders", "evals/loaders.js"],
-    ["ab", "ab.js"],
-    ["artifacts", "artifacts.js"],
-    ["kv", "kv.js"],
-    ["kv/memory", "kv/memory-kv.js"],
-    ["storage", "storage.js"],
-    ["storage/file-kv", "storage-backends/file-kv.js"],
-    ["storage/cursor-hosted", "storage-backends/cursor-hosted.js"],
-    ["otel", "otel.js"],
-];
+export function frameworkAliases() {
+    const root = packageRootDir();
+    return Object.fromEntries(Object.entries(packageManifest().exports).map(([exportPath, { import: file }]) => [
+        exportPath === "."
+            ? PACKAGE_NAME
+            : `${PACKAGE_NAME}/${exportPath.slice(2)}`,
+        pathToFileURL(join(root, file)).href,
+    ]));
+}

package/dist/internal/docs-site.js

@@ -212,7 +212,7 @@ function fallbackHtml() {
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>agent-serve docs</title>
+    <title>agent-sdk docs</title>
     <style>
       body { margin: 0; background: #0e1116; color: #e6edf3; font: 14px/1.6 ui-sans-serif, system-ui, sans-serif; }
       .box { max-width: 640px; margin: 64px auto; padding: 0 24px; }

package/dist/internal/eval-run-store.d.ts

@@ -8,7 +8,6 @@
  * the playground session list.
  */
 import { type EvalRunSnapshot } from "../evals.js";
-export type { EvalBatchStatus, EvalCaseRunStatus as EvalCaseStatus, EvalCaseSnapshot, EvalRunSnapshot, } from "../evals.js";
 /**
  * Durable mirror for playground eval batches — the `StorageCoordinator`
  * adapter over the `defineStorage` `evals` table. Writes are

package/dist/internal/eval-run-store.d.ts.map

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

package/dist/internal/eval-runner.d.ts.map

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

package/dist/internal/factory-resource-channel.d.ts

@@ -0,0 +1,33 @@
+import type { z } from "zod";
+import type { ChannelDefinition, ChannelHandlerArgs } from "../types.js";
+import type { ContinuationIdentity } from "./continuation-identity.js";
+type FactoryResourceChannelOptions<TEvent> = {
+    onEvent: (event: TEvent, args: ChannelHandlerArgs) => Promise<unknown> | unknown;
+    continuation?: ContinuationIdentity;
+    path?: string;
+    auth?: ChannelDefinition["auth"];
+    onStart?: ChannelDefinition["onStart"];
+    onStop?: ChannelDefinition["onStop"];
+};
+type FactoryResourceChannelSpec<TEvent extends {
+    eventType: string;
+}> = {
+    kind: string;
+    eventTypes: readonly string[];
+    eventSchema: z.ZodType<TEvent>;
+    replayDescription: string;
+    invalidError: string;
+};
+type FactoryResourceChannelPack<TEvent> = {
+    channel: (options: FactoryResourceChannelOptions<TEvent>) => ChannelDefinition;
+    getOptions: (definition: object) => FactoryResourceChannelOptions<TEvent> | undefined;
+};
+/**
+ * Shared pack for Factory resource channels that have one event type, no
+ * subscription filter, and the same local-replay / hosted-admission path.
+ */
+export declare function createFactoryResourceChannel<TEvent extends {
+    eventType: string;
+}>(spec: FactoryResourceChannelSpec<TEvent>): FactoryResourceChannelPack<TEvent>;
+export {};
+//# sourceMappingURL=factory-resource-channel.d.ts.map

package/dist/internal/factory-resource-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-resource-channel.d.ts","sourceRoot":"","sources":["../../src/internal/factory-resource-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAIvE,KAAK,6BAA6B,CAAC,MAAM,IAAI;IAC3C,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,kBAAkB,KACrB,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;CACtC,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,IAAI;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,0BAA0B,CAAC,MAAM,IAAI;IACxC,OAAO,EAAE,CACP,OAAO,EAAE,6BAA6B,CAAC,MAAM,CAAC,KAC3C,iBAAiB,CAAC;IACvB,UAAU,EAAE,CACV,UAAU,EAAE,MAAM,KACf,6BAA6B,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,SAAS;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAEpC,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,GACvC,0BAA0B,CAAC,MAAM,CAAC,CA4EpC"}

package/dist/internal/factory-resource-channel.js

@@ -0,0 +1,77 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { defineChannel, localDevStrict, POST } from "../channels.js";
+import { tagOutcome } from "./channel-dispatch.js";
+import { attachHostedAdmissionAdapter } from "./hosted-admission-adapter.js";
+import { bindLocalIngressSend } from "./local-ingress.js";
+/**
+ * Shared pack for Factory resource channels that have one event type, no
+ * subscription filter, and the same local-replay / hosted-admission path.
+ */
+export function createFactoryResourceChannel(spec) {
+    const optionsByDefinition = new WeakMap();
+    function dispatchEvent(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield input.options.onEvent(input.event, bindLocalIngressSend(input.args, {
+                identity: input.options.continuation,
+                kind: spec.kind,
+                eventType: input.event.eventType,
+                payload: input.event,
+            }));
+            return tagOutcome(Response.json({ ok: true }), "task");
+        });
+    }
+    function channel(options) {
+        var _a, _b;
+        const routePath = (_a = options.path) !== null && _a !== void 0 ? _a : "/";
+        const definition = defineChannel({
+            auth: (_b = options.auth) !== null && _b !== void 0 ? _b : [localDevStrict()],
+            meta: {
+                kind: spec.kind,
+                factoryEventTypes: spec.eventTypes,
+            },
+            onStart: options.onStart,
+            onStop: options.onStop,
+            routes: [
+                POST(routePath, {
+                    description: spec.replayDescription,
+                    bodySchema: spec.eventSchema,
+                    handler: (_request, args) => __awaiter(this, void 0, void 0, function* () {
+                        return dispatchEvent({
+                            options,
+                            event: args.body,
+                            args,
+                        });
+                    }),
+                }),
+            ],
+        });
+        optionsByDefinition.set(definition, options);
+        attachHostedAdmissionAdapter(definition, {
+            kind: spec.kind,
+            dispatch: (_a) => __awaiter(this, [_a], void 0, function* ({ payload, args }) {
+                const parsed = spec.eventSchema.safeParse(payload);
+                if (!parsed.success) {
+                    return Response.json({ ok: false, error: spec.invalidError }, { status: 400 });
+                }
+                return dispatchEvent({
+                    options,
+                    event: parsed.data,
+                    args,
+                });
+            }),
+        });
+        return definition;
+    }
+    function getOptions(definition) {
+        return optionsByDefinition.get(definition);
+    }
+    return { channel, getOptions };
+}

package/dist/internal/filesystem/errors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Typed FileSystem throws. Every method error is a {@link PathError}
+ * so composers (`unionFs`) can rewrite `path` without scraping
+ * `error.message`.
+ *
+ * Messages stay the FileSystem contract strings. `path` is the
+ * absolute posix path the error is about (child-root on a mount,
+ * namespace path after `unionFs` remaps it).
+ */
+/**
+ * Base of every FileSystem method throw. Config / factory errors
+ * (`FileSystemConfigError`, empty `overlayFs`) are not PathErrors.
+ */
+export declare class PathError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+    /**
+     * Same error at a rewritten path. `unionFs` prepends the mount
+     * prefix this way. Subclass identity and extra fields stay.
+     */
+    withPath(path: string): this;
+    protected recreate(path: string, message: string): this;
+}
+export declare class FileNotFoundError extends PathError {
+    constructor(path: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+export declare class ReadOnlyMountError extends PathError {
+    constructor(path: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+export declare class NoMountError extends PathError {
+    constructor(path: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+export declare class WriteFailedError extends PathError {
+    constructor(path: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+export declare class DeleteNotSupportedError extends PathError {
+    constructor(path: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+/**
+ * Exact-edit contract failures (`oldText is empty`, uniqueness).
+ * `message` is the contract string; it does not embed `path`.
+ */
+export declare class EditError extends PathError {
+    protected recreate(path: string, message: string): this;
+}
+export declare class InvalidGrepPatternError extends PathError {
+    readonly pattern: string;
+    constructor(pattern: string, path?: string, message?: string);
+    protected recreate(path: string, message: string): this;
+}
+export declare function isFileNotFoundError(error: unknown): boolean;
+export declare function isInvalidGrepPatternError(error: unknown): boolean;
+/**
+ * Remap a child throw onto a mount prefix. Typed {@link PathError}
+ * keeps its class and rewrites `path`. Untyped `Error` still gets
+ * a best-effort message rewrite so older custom trees keep working.
+ */
+export declare function remapPathError(error: unknown, prefix: string): Error;
+//# sourceMappingURL=errors.d.ts.map

package/dist/internal/filesystem/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoCH;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAS3B;IAED,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;CACF;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAEzC;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAEzC;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,qBAAa,YAAa,SAAQ,SAAS;IACzC,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAEzC;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAEzC;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAKzC;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,qBAAa,uBAAwB,SAAQ,SAAS;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,SAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAGxD;IAED,UAAmB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE/D;CACF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK3D;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMjE;AAWD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAQpE"}

package/dist/internal/filesystem/errors.js

@@ -0,0 +1,175 @@
+/**
+ * Typed FileSystem throws. Every method error is a {@link PathError}
+ * so composers (`unionFs`) can rewrite `path` without scraping
+ * `error.message`.
+ *
+ * Messages stay the FileSystem contract strings. `path` is the
+ * absolute posix path the error is about (child-root on a mount,
+ * namespace path after `unionFs` remaps it).
+ */
+import path from "node:path";
+function normalizeErrorPath(input) {
+    const slashes = input.replace(/\\/g, "/");
+    if (slashes === "") {
+        return "/";
+    }
+    const withSlash = slashes.startsWith("/") ? slashes : `/${slashes}`;
+    const resolved = path.posix.normalize(withSlash);
+    if (resolved.length > 1 && resolved.endsWith("/")) {
+        return resolved.slice(0, -1);
+    }
+    return resolved === "." || resolved === "" ? "/" : resolved;
+}
+const ROOT_MESSAGE_PREFIX = /^(not found|read-only mount|write failed|edit failed|no mount for path|delete is not supported): \/$/;
+function rewritePathInMessage(message, from, to) {
+    if (from === to) {
+        return message;
+    }
+    if (from === "/") {
+        return ROOT_MESSAGE_PREFIX.test(message)
+            ? message.replace(/\/$/, to)
+            : message;
+    }
+    return message.includes(from) ? message.split(from).join(to) : message;
+}
+/**
+ * Base of every FileSystem method throw. Config / factory errors
+ * (`FileSystemConfigError`, empty `overlayFs`) are not PathErrors.
+ */
+export class PathError extends Error {
+    constructor(path, message) {
+        super(message);
+        this.name = new.target.name;
+        this.path = normalizeErrorPath(path);
+    }
+    /**
+     * Same error at a rewritten path. `unionFs` prepends the mount
+     * prefix this way. Subclass identity and extra fields stay.
+     */
+    withPath(path) {
+        const next = normalizeErrorPath(path);
+        if (next === this.path) {
+            return this;
+        }
+        return this.recreate(next, rewritePathInMessage(this.message, this.path, next));
+    }
+    recreate(path, message) {
+        return new PathError(path, message);
+    }
+}
+export class FileNotFoundError extends PathError {
+    constructor(path, message) {
+        super(path, message !== null && message !== void 0 ? message : `not found: ${normalizeErrorPath(path)}`);
+    }
+    recreate(path, message) {
+        return new FileNotFoundError(path, message);
+    }
+}
+export class ReadOnlyMountError extends PathError {
+    constructor(path, message) {
+        super(path, message !== null && message !== void 0 ? message : `read-only mount: ${normalizeErrorPath(path)}`);
+    }
+    recreate(path, message) {
+        return new ReadOnlyMountError(path, message);
+    }
+}
+export class NoMountError extends PathError {
+    constructor(path, message) {
+        super(path, message !== null && message !== void 0 ? message : `no mount for path: ${normalizeErrorPath(path)}`);
+    }
+    recreate(path, message) {
+        return new NoMountError(path, message);
+    }
+}
+export class WriteFailedError extends PathError {
+    constructor(path, message) {
+        super(path, message !== null && message !== void 0 ? message : `write failed: ${normalizeErrorPath(path)}`);
+    }
+    recreate(path, message) {
+        return new WriteFailedError(path, message);
+    }
+}
+export class DeleteNotSupportedError extends PathError {
+    constructor(path, message) {
+        super(path, message !== null && message !== void 0 ? message : `delete is not supported: ${normalizeErrorPath(path)}`);
+    }
+    recreate(path, message) {
+        return new DeleteNotSupportedError(path, message);
+    }
+}
+/**
+ * Exact-edit contract failures (`oldText is empty`, uniqueness).
+ * `message` is the contract string; it does not embed `path`.
+ */
+export class EditError extends PathError {
+    recreate(path, message) {
+        return new EditError(path, message);
+    }
+}
+export class InvalidGrepPatternError extends PathError {
+    constructor(pattern, path = "/", message) {
+        super(path, message !== null && message !== void 0 ? message : `invalid grep pattern: ${pattern}`);
+        this.pattern = pattern;
+    }
+    recreate(path, message) {
+        return new InvalidGrepPatternError(this.pattern, path, message);
+    }
+}
+export function isFileNotFoundError(error) {
+    return (error instanceof FileNotFoundError ||
+        (error instanceof Error && error.message.startsWith("not found:")));
+}
+export function isInvalidGrepPatternError(error) {
+    return (error instanceof InvalidGrepPatternError ||
+        (error instanceof Error &&
+            error.message.startsWith("invalid grep pattern:")));
+}
+const CONTRACT_PATH_LABELS = [
+    "not found: ",
+    "read-only mount: ",
+    "write failed: ",
+    "edit failed: ",
+    "no mount for path: ",
+    "delete is not supported: ",
+];
+/**
+ * Remap a child throw onto a mount prefix. Typed {@link PathError}
+ * keeps its class and rewrites `path`. Untyped `Error` still gets
+ * a best-effort message rewrite so older custom trees keep working.
+ */
+export function remapPathError(error, prefix) {
+    if (error instanceof PathError) {
+        return error.withPath(joinMountPath(error.path, prefix));
+    }
+    if (!(error instanceof Error)) {
+        return new PathError(prefix, String(error));
+    }
+    return rewriteUntypedMountError(error, prefix);
+}
+function joinMountPath(childPath, prefix) {
+    const mount = normalizeErrorPath(prefix);
+    const child = normalizeErrorPath(childPath);
+    if (mount === "/") {
+        return child;
+    }
+    if (child === "/") {
+        return mount;
+    }
+    return `${mount}${child}`;
+}
+function rewriteUntypedMountError(error, prefix) {
+    for (const label of CONTRACT_PATH_LABELS) {
+        if (!error.message.startsWith(label)) {
+            continue;
+        }
+        const childPath = error.message.slice(label.length);
+        const next = `${label}${joinMountPath(childPath, prefix)}`;
+        if (next === error.message) {
+            return error;
+        }
+        const rewritten = new Error(next);
+        rewritten.name = error.name;
+        return rewritten;
+    }
+    return error;
+}

package/dist/internal/filesystem/format.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Model-facing strings that match Cursor SDK native tool output
+ * (LocalLsExecutor / read / grep / glob formatters).
+ */
+import type { GrepUnionResult } from "../../filesystem.js";
+import type { LsDirectoryTreeNode } from "./walk.js";
+/**
+ * Number already-sliced Read content. `FileSystem.read` applies offset/
+ * limit; do not window again or line numbers restart at 1.
+ */
+export declare function slicedReadStartLine(totalLines: number, offset?: number): number;
+export declare function formatNumberedLines(content: string, options?: {
+    offset?: number;
+    limit?: number;
+    /** When set, `content` is already the window; number from this line. */
+    startLine?: number;
+    totalLines?: number;
+}): string;
+export declare function formatLsTree(result: LsDirectoryTreeNode): string;
+export declare function formatGlobOutput(dir: string, files: readonly string[]): string;
+export declare function formatGrepOutput(union: GrepUnionResult | undefined): string;
+export declare function formatWriteOutput(path: string): string;
+export declare function formatStrReplaceOutput(args: {
+    path: string;
+    replaceAll: boolean;
+    occurrencesModified: number;
+}): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/internal/filesystem/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAKrD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CAChB,GACL,MAAM,CAuBR;AAqBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAsChE;AAsED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,MAAM,CAmBR;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,CA0C3E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,MAAM,CAQT"}