@fungi.computer/knapsack 0.2.1 → 0.3.0

package/dist/files.d.ts

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { readInputSchema, readGuestOutputSchema, readOutputSchema } from "./files-read.js";
 export { readGuestOutputSchema, readInputSchema, readOutputSchema };
 /** Typed refusal from a bounded or conditional Files edit. */
-export type FilesEditErrorReason = "not-found" | "ambiguous" | "file-too-large" | "partial-character" | "unchanged" | "not-text" | "conflict";
+export type FilesEditErrorReason = "not-found" | "ambiguous" | "file-too-large" | "partial-character" | "unchanged" | "not-text" | "conflict" | "read-only";
 /** Expected Files edit refusal, kept distinct from unexpected host failures. */
 export declare class FilesEditError extends Error {
     readonly reason: FilesEditErrorReason;
@@ -68,6 +68,7 @@ export declare const filesEditFailureSchema: z.ZodLazy<z.ZodObject<{
             unchanged: "unchanged";
             "not-text": "not-text";
             conflict: "conflict";
+            "read-only": "read-only";
         }>;
         path: z.ZodLazy<z.ZodString>;
         message: z.ZodString;
@@ -95,6 +96,7 @@ export declare const editOutputSchema: z.ZodUnion<readonly [z.ZodLazy<z.ZodObjec
             unchanged: "unchanged";
             "not-text": "not-text";
             conflict: "conflict";
+            "read-only": "read-only";
         }>;
         path: z.ZodLazy<z.ZodString>;
         message: z.ZodString;
@@ -104,6 +106,8 @@ export declare const editOutputSchema: z.ZodUnion<readonly [z.ZodLazy<z.ZodObjec
 export type FilesPatch = (input: z.output<typeof patchInputSchema>, context: InvocationContext) => Promise<z.output<typeof patchOutputSchema>>;
 /** Captured host file authority; the host owns path confinement and atomic replacement. */
 export type FilesPort = Readonly<{
+    /** Host-selected mode gate, before an edit reads or computes a replacement. */
+    assertEditable?: (path: string) => void;
     /** Omitted when this Files host has no qualified native patch engine. */
     patch?: FilesPatch;
     /** Read a bounded text page. */

package/dist/files.js

@@ -97,6 +97,7 @@ export const filesEditFailureSchema = z.lazy(() => z.strictObject({
             "not-text",
             "unchanged",
             "conflict",
+            "read-only",
         ]),
         path: pathSchema,
         message: z.string(),
@@ -255,6 +256,7 @@ function generateDiffString(oldContent, newContent, context = 4) {
     return { diff: output.join("\n"), firstChangedLine };
 }
 async function applyEdit(port, input, context) {
+    port.assertEditable?.(input.path);
     const current = readOutputSchema.parse(await port.read({
         path: input.path,
         offset: 0,
@@ -321,9 +323,16 @@ export async function edit(port, input, context) {
     }
 }
 /** Cancellation does not finish until the Files owner has acknowledged cleanup. */
-function runFileOperation(invoke) {
+function runFileOperation(invoke, toolCallId) {
     return Effect.callback((resume, signal) => {
-        const pending = invoke({ executionId: nanoid(), deadlineAt: null, signal });
+        const context = {
+            executionId: toolCallId ?? nanoid(),
+            deadlineAt: null,
+            signal,
+        };
+        if (toolCallId !== undefined)
+            Object.assign(context, { toolCallId });
+        const pending = invoke(context);
         void pending.then((result) => {
             resume(Effect.succeed(result));
         }, (cause) => {
@@ -336,8 +345,8 @@ function runFileOperation(invoke) {
         return Effect.promise(() => pending.then(() => undefined, () => undefined));
     });
 }
-function runPatch(invoke, input) {
-    return runFileOperation((context) => invoke(input, context));
+function runPatch(invoke, input, toolCallId) {
+    return runFileOperation((context) => invoke(input, context), toolCallId);
 }
 /** Keep model parameters while omitting the decoder's schema-document marker. */
 function toolParameters(schema) {
@@ -369,7 +378,7 @@ function patchTool(invokePatch) {
                 message: cause instanceof Error ? cause.message : "Invalid patch input",
             }),
         }).pipe(Effect.map((value) => ({
-            execute: () => Stream.fromEffect(runPatch(invokePatch, value).pipe(Effect.map((result) => ({
+            execute: () => Stream.fromEffect(runPatch(invokePatch, value, call.id).pipe(Effect.map((result) => ({
                 type: "result",
                 result: {
                     content: [
@@ -378,7 +387,7 @@ function patchTool(invokePatch) {
                             text: JSON.stringify(result),
                         },
                     ],
-                    isError: result.status !== "completed",
+                    isError: "status" in result && result.status !== "completed",
                 },
             })))),
         }))),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/knapsack",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Agent tool connections projected into Mycelium capability sources",
   "type": "module",
@@ -47,8 +47,8 @@
   "dependencies": {
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/forage": "0.2.0",
-    "@fungi.computer/mule": "0.1.1",
-    "@fungi.computer/mycelium": "0.2.1",
+    "@fungi.computer/mule": "0.2.0",
+    "@fungi.computer/mycelium": "0.2.2",
     "@fungi.computer/whistle": "0.1.0",
     "@modelcontextprotocol/client": "2.0.0",
     "diff": "8.0.4",