stitchkit 0.111.1 → 0.111.3

package/dist/entrypoints/tools.js

@@ -9,10 +9,10 @@ import {
 import {
   normalizeError2
 } from "../index-fynr93w4.js";
-import"../index-t5sjh517.js";
+import"../index-epmnrnth.js";
 import {
   coerceJsonArgs2
-} from "../index-cykxpxz5.js";
+} from "../index-jy9wq8tp.js";
 import"../index-ct75c3at.js";
 import {
   assertToolName,
@@ -21,19 +21,19 @@ import {
   findNonPortableFormats2,
   flattenToolJsonSchema2,
   findUntypedProperties2
-} from "../index-q6crhe1n.js";
+} from "../index-h7accrrv.js";
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "../index-mha6b4vk.js";
+} from "../index-02h0dfpr.js";
 import {
   collectTools2
-} from "../index-ghwntn9n.js";
+} from "../index-vqdjym30.js";
 import {
   mountAgent2,
   describeToolCatalog2,
   buildToolManifest2
-} from "../index-7c046kxr.js";
+} from "../index-c7h371gr.js";
 import"../index-m38ej7e5.js";
 import {
   ALL_TRANSPORTS2,
@@ -60,7 +60,7 @@ import {
   createMcpHttpRoute2,
   createStdioMcpServer2,
   bindStdioProcessSignals2
-} from "../index-c5374vpt.js";
+} from "../index-651xsm48.js";
 import {
   AsyncOperationCancelResultSchema2,
   createAsyncOperationSnapshotSchema2,
@@ -74,7 +74,7 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-v2eyj2ws.js";
+} from "../index-jprxv2an.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -89,7 +89,7 @@ import {
 } from "../index-pzw0fpek.js";
 import {
   createToolInvoker2
-} from "../index-dd1z5kxb.js";
+} from "../index-jfk93gja.js";
 import {
   ManagedFileError2
 } from "../index-2f9r0jgr.js";
@@ -111,14 +111,14 @@ import {
 } from "../index-yk4g8805.js";
 import {
   collectToolSurface
-} from "../index-0d8m0kee.js";
+} from "../index-hvg9hctd.js";
 import {
   getTraceId2
 } from "../index-r6v4mc67.js";
 import {
   defineRuntimeTool2,
   createRuntimeToolFactory2
-} from "../index-636mggad.js";
+} from "../index-ff3agzaf.js";
 import {
   formatZodError2
 } from "../index-1eeqpadm.js";

package/dist/{index-mha6b4vk.js → index-02h0dfpr.js}

@@ -2,14 +2,17 @@ import {
   normalizeError2,
   validateDeclaredOutput
 } from "./index-fynr93w4.js";
+import {
+  localVerdict
+} from "./index-epmnrnth.js";
 import {
   coerceJsonArgs2
-} from "./index-cykxpxz5.js";
+} from "./index-jy9wq8tp.js";
 import {
   applyToolViewDefaults,
   projectToolView,
   objectShapeKeys
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   runWithRequestContext2,
   getRequestContext2
@@ -91,10 +94,14 @@ function parseToolCallArguments(method, callArgs, {
     } catch (err) {
       return { ok: false, message: "Invalid input", thrown: err };
     }
-    if (!result.success) {
-      return { ok: false, message: `Invalid input: ${formatZodError2(result.error)}` };
+    if (result.success)
+      input = result.data;
+    else {
+      const refused = localVerdict(method.inputSchema, result.error);
+      if (refused)
+        return { ok: false, message: `Invalid input: ${formatZodError2(refused)}` };
+      input = inputArgs;
     }
-    input = result.data;
   }
   return { ok: true, params, input };
 }

package/dist/{index-0z3kfphz.js → index-38gvr73z.js}

@@ -4,7 +4,7 @@ import {
   AgentSandboxRestrictionSchema2,
   AgentSandboxGradeSchema2,
   AGENT_CODING_TOOL_NAMES
-} from "./index-ey15wx6j.js";
+} from "./index-n0adphfg.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,

package/dist/{index-8jv0trhg.js → index-5as18gs2.js}

@@ -14,7 +14,7 @@ import {
 import {
   ToolExecutionControlError2,
   isToolExecutionControlError2
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   agentDurableEventId2
 } from "./index-mnkk1ffz.js";

package/dist/{index-t2bsd0hm.js → index-5v5a9k2n.js}

@@ -18,11 +18,93 @@ import {
 
 // src/internal/exclusive-lock.ts
 import { randomUUID } from "node:crypto";
-import { lstat, open, readdir, unlink } from "node:fs/promises";
-import { hostname } from "node:os";
+import { lstat, open as open2, readdir as readdir2, unlink } from "node:fs/promises";
+import { hostname as hostname2 } from "node:os";
 import { dirname, join } from "node:path";
+
+// src/internal/exclusive-lock-owner.ts
+import { hostname } from "node:os";
 import { z } from "zod";
 
+// src/internal/open-descriptors.ts
+import { constants, fstatSync } from "node:fs";
+import { open, readdir } from "node:fs/promises";
+var DESCRIPTOR_DIRECTORY = "/dev/fd";
+async function holdsOpenDescriptor(path, file, descriptorDirectory = DESCRIPTOR_DIRECTORY) {
+  const probe = await open(path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK).catch(() => null);
+  if (!probe)
+    return null;
+  try {
+    const opened = await probe.stat();
+    if (!opened.isFile() || opened.ino !== file.ino || opened.dev !== file.dev)
+      return null;
+    let names;
+    try {
+      names = await readdir(descriptorDirectory);
+    } catch {
+      return null;
+    }
+    let listedProbe = false;
+    for (const name of names) {
+      const descriptor = Number(name);
+      if (!Number.isInteger(descriptor) || descriptor < 0)
+        continue;
+      if (descriptor === probe.fd) {
+        listedProbe = true;
+        continue;
+      }
+      try {
+        const info = fstatSync(descriptor);
+        if (info.ino === file.ino && info.dev === file.dev)
+          return true;
+      } catch {}
+    }
+    return listedProbe ? false : null;
+  } finally {
+    await probe.close();
+  }
+}
+
+// src/internal/exclusive-lock-owner.ts
+var ExclusiveLockOwnerSchema = z.object({
+  pid: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
+  host: z.string().min(1),
+  acquiredAt: z.string(),
+  machine: z.string().min(1).optional().catch(undefined),
+  process: ProcessInstanceSchema2.nullable().optional().catch(null)
+});
+function readOwner(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return { owner: undefined, ownerless: true };
+  }
+  const owner = ExclusiveLockOwnerSchema.safeParse(parsed);
+  if (owner.success)
+    return { owner: owner.data, ownerless: false };
+  const ownerlike = isRecord(parsed) && ["pid", "token", "host", "machine", "process", "acquiredAt"].some((key) => Object.hasOwn(parsed, key));
+  return { owner: undefined, ownerless: !ownerlike };
+}
+function attribute(owner, identity) {
+  if (identity !== null && owner.machine !== undefined) {
+    return owner.machine === identity ? "this-machine" : "another-machine";
+  }
+  return owner.host === hostname() ? "this-machine" : "unattributable";
+}
+async function diagnose(lock, declaredIdentity) {
+  const owner = lock?.owner;
+  if (!lock || !owner)
+    return { attribution: "unattributable", liveness: "not-probed", owner: null };
+  const attribution = attribute(owner, await machineIdentity(declaredIdentity));
+  if (attribution !== "this-machine")
+    return { attribution, liveness: "not-probed", owner };
+  const evidence = await probeProcessOwner2(owner.pid, owner.process);
+  if (evidence.identity === "matched" && owner.pid === process.pid && await holdsOpenDescriptor(lock.path, lock) === false)
+    return { attribution, liveness: "gone", identity: "descriptor-closed", owner };
+  return { attribution, ...evidence, owner };
+}
+
 // src/internal/exclusive-lock-read.ts
 var OWNER_RECORD_BYTES = 16 * 1024;
 
@@ -60,49 +142,15 @@ async function readLockRecord(path, {
 }
 
 // src/internal/exclusive-lock.ts
-var ExclusiveLockOwnerSchema = z.object({
-  pid: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
-  host: z.string().min(1),
-  acquiredAt: z.string(),
-  machine: z.string().min(1).optional().catch(undefined),
-  process: ProcessInstanceSchema2.nullable().optional().catch(null)
-});
 function isCode(error, code) {
   return isRecord(error) && error.code === code;
 }
-function readOwner(text) {
-  let parsed;
-  try {
-    parsed = JSON.parse(text);
-  } catch {
-    return { owner: undefined, ownerless: true };
-  }
-  const owner = ExclusiveLockOwnerSchema.safeParse(parsed);
-  if (owner.success)
-    return { owner: owner.data, ownerless: false };
-  const ownerlike = isRecord(parsed) && ["pid", "token", "host", "machine", "process", "acquiredAt"].some((key) => Object.hasOwn(parsed, key));
-  return { owner: undefined, ownerless: !ownerlike };
-}
-function attribute(owner, identity) {
-  if (identity !== null && owner.machine !== undefined) {
-    return owner.machine === identity ? "this-machine" : "another-machine";
-  }
-  return owner.host === hostname() ? "this-machine" : "unattributable";
-}
-async function diagnose(owner, declaredIdentity) {
-  if (!owner)
-    return { attribution: "unattributable", liveness: "not-probed", owner: null };
-  const attribution = attribute(owner, await machineIdentity(declaredIdentity));
-  if (attribution !== "this-machine")
-    return { attribution, liveness: "not-probed", owner };
-  return { attribution, ...await probeProcessOwner2(owner.pid, owner.process), owner };
-}
 var MAX_RECLAIM_DEPTH = 16;
 var STALE_GUARD_GRACE_MS = 5000;
 var STAGED_NAME = /^\.lock-[0-9a-f-]{36}\.tmp$/;
 async function stagedSibling(path, ino, dev) {
   const directory = dirname(path);
-  for (const name of await readdir(directory)) {
+  for (const name of await readdir2(directory)) {
     if (!STAGED_NAME.test(name))
       continue;
     const candidate = join(directory, name);
@@ -130,6 +178,7 @@ async function readLockFile(path, onFailure, signal) {
       record = await readLockRecord(path, { signal, singleLink: false });
     }
     return {
+      path,
       ...readOwner(record.text),
       ino: record.info.ino,
       dev: record.info.dev,
@@ -143,14 +192,14 @@ async function readLockFile(path, onFailure, signal) {
   }
 }
 async function sweepStagedLocks(directory, machine, signal) {
-  for (const name of await readdir(directory).catch(() => [])) {
+  for (const name of await readdir2(directory).catch(() => [])) {
     if (!STAGED_NAME.test(name))
       continue;
     const candidate = join(directory, name);
     const state = await readLockFile(candidate, undefined, signal);
     if (!state?.owner)
       continue;
-    if ((await diagnose(state.owner, machine)).liveness !== "gone")
+    if ((await diagnose(state, machine)).liveness !== "gone")
       continue;
     await unlinkIfSame(candidate, state.ino, state.dev, state.stagedName === undefined ? 1 : 2);
   }
@@ -172,14 +221,14 @@ async function createOwned(path, options, reclaimed) {
   const owner = {
     pid: process.pid,
     process: instance,
-    host: hostname(),
+    host: hostname2(),
     acquiredAt: new Date().toISOString(),
     ...identity !== null && { machine: identity }
   };
   const ownedRecord = `${JSON.stringify(owner)}
 `;
   const staged = join(dirname(path), `.lock-${randomUUID()}.tmp`);
-  const handle = await open(staged, "wx", options.mode);
+  const handle = await open2(staged, "wx", options.mode);
   let ino;
   let dev;
   let published = false;
@@ -271,7 +320,7 @@ async function reclaimUnderGuard(path, options, depth) {
     if (readFailure !== undefined)
       return { refused: true, cause: readFailure };
     if (state) {
-      const diagnosis = await diagnose(state.owner, options.machineIdentity);
+      const diagnosis = await diagnose(state, options.machineIdentity);
       if (options.signal?.aborted)
         return { refused: true };
       if (!reclaimable(state, diagnosis, options.ownerlessGraceMs))
@@ -308,7 +357,7 @@ async function attemptExclusiveLock(path, options, depth = 0) {
       readFailure = cause;
     }, options.signal);
     const diagnosis = {
-      ...await diagnose(state?.owner, options.machineIdentity),
+      ...await diagnose(state, options.machineIdentity),
       ...readFailure !== undefined && { cause: readFailure }
     };
     if (options.signal?.aborted)

package/dist/{index-c5374vpt.js → index-651xsm48.js}

@@ -8,17 +8,17 @@ import {
   validateResolvedInputRounds,
   presentationMetadata,
   prepareProjectedMcpTools
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   parseToolCallArguments,
   toolResultFromError,
   observed
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   collectTools2,
   createToolRunner,
   formatToolError
-} from "./index-ghwntn9n.js";
+} from "./index-vqdjym30.js";
 import {
   DEFAULT_CORS_ALLOW_HEADERS2,
   DEFAULT_PROCESS_SIGNALS,
@@ -31,7 +31,7 @@ import {
 } from "./index-e6c2spsd.js";
 import {
   collectToolSurface
-} from "./index-0d8m0kee.js";
+} from "./index-hvg9hctd.js";
 import {
   runWithRequestContext2,
   getRequestContext2

package/dist/{index-w9mqgnz9.js → index-6b3pcq5z.js}

@@ -1,6 +1,6 @@
 import {
   attemptExclusiveLock
-} from "./index-t2bsd0hm.js";
+} from "./index-5v5a9k2n.js";
 import {
   sleep
 } from "./index-eemvahkc.js";

package/dist/{index-7c046kxr.js → index-c7h371gr.js}

@@ -2,21 +2,21 @@ import {
   toolResultFromError,
   toolCauseFromResult,
   isToolExecutionControlError2
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-ghwntn9n.js";
+} from "./index-vqdjym30.js";
 import {
   AgentToolError2,
   resolveToolDurability
 } from "./index-56yx8dxp.js";
 import {
   collectToolSurface
-} from "./index-0d8m0kee.js";
+} from "./index-hvg9hctd.js";
 import {
   agentPresenterOf
-} from "./index-636mggad.js";
+} from "./index-ff3agzaf.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-mnk5vgdr.js → index-d4cnhfdn.js}

@@ -17,7 +17,7 @@ import {
   replaceMessage,
   ArchiveSpillSchema,
   createAgentRuntimeStore2
-} from "./index-0z3kfphz.js";
+} from "./index-38gvr73z.js";
 
 // src/agent-runtime/store-memory.ts
 import { z as z2 } from "zod";

package/dist/{index-t5sjh517.js → index-epmnrnth.js}

@@ -82,6 +82,23 @@ function markJsonSchemaObjectGuards(schema) {
   };
   visit(schema);
 }
+var REMOTE_UNION_VERDICT = Symbol.for("stitchkit.tools.json-schema-remote-union-verdict.v1");
+function markRemoteUnionVerdict(schema) {
+  Reflect.defineProperty(schema, REMOTE_UNION_VERDICT, {
+    configurable: false,
+    enumerable: false,
+    value: true,
+    writable: false
+  });
+}
+function localVerdict(schema, error) {
+  if (Reflect.get(schema, REMOTE_UNION_VERDICT) !== true)
+    return error;
+  const local = error.issues.filter((issue) => issue.code !== "invalid_union");
+  if (local.length === 0)
+    return null;
+  return local.length === error.issues.length ? error : new z.ZodError(local);
+}
 function jsonSchemaObjectCoercionMembers(schema) {
   if (Reflect.get(schema, JSON_SCHEMA_OBJECT_GUARD) !== true)
     return;
@@ -97,4 +114,4 @@ function jsonSchemaObjectCoercionMembers(schema) {
   return;
 }
 
-export { markJsonSchemaObjectGuards, jsonSchemaObjectCoercionMembers };
+export { markJsonSchemaObjectGuards, markRemoteUnionVerdict, localVerdict, jsonSchemaObjectCoercionMembers };

package/dist/{index-636mggad.js → index-ff3agzaf.js}

@@ -1,6 +1,6 @@
 import {
   projectRuntimeTool
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   isRecord
 } from "./index-9jfdm5tg.js";

package/dist/{index-7c957abz.js → index-fh2ht88b.js}

@@ -19,7 +19,7 @@ import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-0z3kfphz.js";
+} from "./index-38gvr73z.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2

package/dist/{index-q6crhe1n.js → index-h7accrrv.js}

@@ -273,7 +273,8 @@ function typeNames(schema) {
 function typeSchema(type, nullable) {
   return { type: nullable ? [type, "null"] : type };
 }
-function commonBaseType(schemas) {
+function commonBaseType(variants, discriminator) {
+  const schemas = variants.map(({ schema }) => schema);
   const names = schemas.map(typeNames);
   if (names.some((value) => value === null))
     return {};
@@ -293,10 +294,19 @@ function commonBaseType(schemas) {
     return nullable ? { type: "null" } : {};
   if (bases.has("array") || bases.has("object")) {
     const alternatives = new Map;
-    for (const schema of schemas)
-      alternatives.set(serializeCanonicalJson(schema), schema);
-    const ordered = [...alternatives].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([, schema]) => schema);
-    return { anyOf: structuredClone(ordered) };
+    for (const { schema, labels } of variants) {
+      const key = serializeCanonicalJson(schema);
+      const known = alternatives.get(key);
+      if (known)
+        known.labels.push(...labels);
+      else
+        alternatives.set(key, { schema, labels: [...labels] });
+    }
+    const ordered = [...alternatives].sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0).map(([, { schema, labels }]) => ({
+      ...structuredClone(schema),
+      description: `When ${discriminator} = ${[...new Set(labels)].join(" | ")}.`
+    }));
+    return { anyOf: ordered };
   }
   if (bases.size === 1) {
     const [only] = bases;
@@ -337,7 +347,10 @@ function mergePropertySchemas(properties, discriminator) {
   } else {
     const values = schemas.map(stringValues);
     const allStrings = values.every((value) => value !== null);
-    merged = allStrings ? { type: "string", enum: [...new Set(values.flatMap((value) => value ?? []))] } : commonBaseType(structural);
+    merged = allStrings ? { type: "string", enum: [...new Set(values.flatMap((value) => value ?? []))] } : commonBaseType(structural.map((schema, index) => ({
+      schema,
+      labels: properties[index]?.labels ?? []
+    })), discriminator);
   }
   const description = describeVariants(properties.map((property, index) => ({
     ...property,

package/dist/{index-0d8m0kee.js → index-hvg9hctd.js}

@@ -1,12 +1,12 @@
 import {
   projectToolSurface
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   contractToolMountable
-} from "./index-ghwntn9n.js";
+} from "./index-vqdjym30.js";
 import {
   runtimeToolMountable
-} from "./index-636mggad.js";
+} from "./index-ff3agzaf.js";
 
 // src/tools/surface.ts
 function collectToolSurface({

package/dist/{index-nx49x0tw.js → index-hy802jnr.js}

@@ -1,6 +1,6 @@
 import {
   withExclusiveLock2
-} from "./index-w9mqgnz9.js";
+} from "./index-6b3pcq5z.js";
 import {
   readBoundedFile
 } from "./index-m616f0yz.js";

package/dist/{index-dd1z5kxb.js → index-jfk93gja.js}

@@ -1,13 +1,13 @@
 import {
   assertUniqueToolName
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   toolErrorFromResult
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   collectTools2,
   createToolRunner
-} from "./index-ghwntn9n.js";
+} from "./index-vqdjym30.js";
 import {
   AppError2
 } from "./index-j9gxbztg.js";

package/dist/{index-v2eyj2ws.js → index-jprxv2an.js}

@@ -3,10 +3,10 @@ import {
 } from "./index-fynr93w4.js";
 import {
   jsonSchemaObjectCoercionMembers
-} from "./index-t5sjh517.js";
+} from "./index-epmnrnth.js";
 import {
   coerceJsonArgs2
-} from "./index-cykxpxz5.js";
+} from "./index-jy9wq8tp.js";
 import {
   jsonSchemaFields
 } from "./index-ct75c3at.js";
@@ -14,15 +14,15 @@ import {
   objectShapeKeys,
   assertUniqueToolName,
   buildToolPresentationSchema
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   toolResultFromError,
   toolErrorFromResult
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-ghwntn9n.js";
+} from "./index-vqdjym30.js";
 import {
   fetchGuarded,
   readCapped
@@ -35,7 +35,7 @@ import {
 } from "./index-eemvahkc.js";
 import {
   collectToolSurface
-} from "./index-0d8m0kee.js";
+} from "./index-hvg9hctd.js";
 import {
   isUnsafeKey,
   safeJsonParse

package/dist/{index-cykxpxz5.js → index-jy9wq8tp.js}

@@ -1,6 +1,6 @@
 import {
   jsonSchemaObjectCoercionMembers
-} from "./index-t5sjh517.js";
+} from "./index-epmnrnth.js";
 import {
   safeJsonParse
 } from "./index-zsarb5xp.js";

package/dist/{index-ey15wx6j.js → index-n0adphfg.js}

@@ -27,7 +27,7 @@ import {
 } from "./index-j4zh647a.js";
 import {
   defineRuntimeTool2
-} from "./index-636mggad.js";
+} from "./index-ff3agzaf.js";
 import {
   AppError2,
   forbidden2,

package/dist/{index-ghwntn9n.js → index-vqdjym30.js}

@@ -3,11 +3,11 @@ import {
   mergeSchemas,
   assertToolExtensionCompatible,
   projectToolSurface
-} from "./index-q6crhe1n.js";
+} from "./index-h7accrrv.js";
 import {
   toolErrorFromResult,
   executeToolMethod
-} from "./index-mha6b4vk.js";
+} from "./index-02h0dfpr.js";
 import {
   isRetryableStatus2
 } from "./index-j9gxbztg.js";