@fungi.computer/forage 0.1.0 → 0.2.1

package/docs/api/index.md

@@ -342,12 +342,14 @@ Narrow convenience namespace for the package's public seams.
 ### forageSearchInput
 
 ```ts
-const forageSearchInput: ZodObject<
-  {
-    query: ZodString;
-    maxResults: ZodDefault<ZodNumber>;
-  },
-  $strip
+const forageSearchInput: ZodLazy<
+  ZodObject<
+    {
+      query: ZodString;
+      maxResults: ZodDefault<ZodNumber>;
+    },
+    $strip
+  >
 >;
 ```
 
@@ -358,18 +360,20 @@ Input accepted by the pure catalog search seam.
 ### forageDescribeInput
 
 ```ts
-const forageDescribeInput: ZodObject<
-  {
-    path: ZodString;
-    detail: ZodDefault<
-      ZodEnum<{
-        index: "index";
-        full: "full";
-      }>
-    >;
-    methods: ZodOptional<ZodArray<ZodString>>;
-  },
-  $strip
+const forageDescribeInput: ZodLazy<
+  ZodObject<
+    {
+      path: ZodString;
+      detail: ZodDefault<
+        ZodEnum<{
+          index: "index";
+          full: "full";
+        }>
+      >;
+      methods: ZodOptional<ZodArray<ZodString>>;
+    },
+    $strip
+  >
 >;
 ```
 
@@ -404,16 +408,18 @@ const searchResultSchema: ZodObject<
     description: ZodOptional<ZodString>;
     score: ZodNumber;
     matchReason: ZodOptional<ZodString>;
-    sample: ZodOptional<ZodRecord<ZodString, ZodJSONSchema>>;
+    sample: ZodOptional<ZodLazy<ZodRecord<ZodString, ZodJSONSchema>>>;
     capabilityNotes: ZodOptional<ZodString>;
     peers: ZodOptional<
       ZodArray<
-        ZodObject<
-          {
-            path: ZodString;
-            capabilityNotes: ZodOptional<ZodString>;
-          },
-          $strip
+        ZodLazy<
+          ZodObject<
+            {
+              path: ZodString;
+              capabilityNotes: ZodOptional<ZodString>;
+            },
+            $strip
+          >
         >
       >
     >;
@@ -429,40 +435,25 @@ One ranked operation in a search response.
 ### searchOutputSchema
 
 ```ts
-const searchOutputSchema: ZodObject<
-  {
-    results: ZodArray<
-      ZodObject<
-        {
-          path: ZodString;
-          description: ZodOptional<ZodString>;
-          score: ZodNumber;
-          matchReason: ZodOptional<ZodString>;
-          sample: ZodOptional<ZodRecord<ZodString, ZodJSONSchema>>;
-          capabilityNotes: ZodOptional<ZodString>;
-          peers: ZodOptional<
-            ZodArray<
-              ZodObject<
-                {
-                  path: ZodString;
-                  capabilityNotes: ZodOptional<ZodString>;
-                },
-                $strip
-              >
-            >
-          >;
-        },
-        $strip
-      >
-    >;
-    total: ZodNumber;
-    truncated: ZodBoolean;
-    topScore: ZodNumber;
-    margin: ZodNumber;
-    catalogStamp: ZodString;
-  },
-  $strip
->;
+const searchOutputSchema: ZodLazy<ZodObject<{
+  results: ZodArray<ZodObject<{
+     path: ZodString;
+     description: ZodOptional<ZodString>;
+     score: ZodNumber;
+     matchReason: ZodOptional<ZodString>;
+     sample: ZodOptional<ZodLazy<ZodRecord<ZodString, ZodJSONSchema>>>;
+     capabilityNotes: ZodOptional<ZodString>;
+     peers: ZodOptional<ZodArray<ZodLazy<ZodObject<{
+        path: ...;
+        capabilityNotes: ...;
+     }, $strip>>>>;
+  }, $strip>>;
+  total: ZodNumber;
+  truncated: ZodBoolean;
+  topScore: ZodNumber;
+  margin: ZodNumber;
+  catalogStamp: ZodString;
+}, $strip>>;
 ```
 
 Bounded search response envelope.
@@ -472,38 +463,23 @@ Bounded search response envelope.
 ### listOutputSchema
 
 ```ts
-const listOutputSchema: ZodObject<
-  {
-    results: ZodArray<
-      ZodObject<
-        {
-          path: ZodString;
-          description: ZodOptional<ZodString>;
-          score: ZodNumber;
-          matchReason: ZodOptional<ZodString>;
-          sample: ZodOptional<ZodRecord<ZodString, ZodJSONSchema>>;
-          capabilityNotes: ZodOptional<ZodString>;
-          peers: ZodOptional<
-            ZodArray<
-              ZodObject<
-                {
-                  path: ZodString;
-                  capabilityNotes: ZodOptional<ZodString>;
-                },
-                $strip
-              >
-            >
-          >;
-        },
-        $strip
-      >
-    >;
-    total: ZodNumber;
-    nextCursor: ZodNullable<ZodString>;
-    catalogStamp: ZodString;
-  },
-  $strip
->;
+const listOutputSchema: ZodObject<{
+  results: ZodArray<ZodObject<{
+     path: ZodString;
+     description: ZodOptional<ZodString>;
+     score: ZodNumber;
+     matchReason: ZodOptional<ZodString>;
+     sample: ZodOptional<ZodLazy<ZodRecord<ZodString, ZodJSONSchema>>>;
+     capabilityNotes: ZodOptional<ZodString>;
+     peers: ZodOptional<ZodArray<ZodLazy<ZodObject<{
+        path: ZodString;
+        capabilityNotes: ZodOptional<...>;
+     }, $strip>>>>;
+  }, $strip>>;
+  total: ZodNumber;
+  nextCursor: ZodNullable<ZodString>;
+  catalogStamp: ZodString;
+}, $strip>;
 ```
 
 One exhaustive page, using the exact search operation summary schema.
@@ -513,19 +489,21 @@ One exhaustive page, using the exact search operation summary schema.
 ### describeOutputSchema
 
 ```ts
-const describeOutputSchema: ZodObject<
-  {
-    path: ZodString;
-    description: ZodOptional<ZodString>;
-    types: ZodString;
-    inputSchema: ZodOptional<ZodJSONSchema>;
-    kind: ZodEnum<{
-      module: "module";
-      operation: "operation";
-    }>;
-    usage: ZodOptional<ZodString>;
-  },
-  $strip
+const describeOutputSchema: ZodLazy<
+  ZodObject<
+    {
+      path: ZodString;
+      description: ZodOptional<ZodString>;
+      types: ZodString;
+      inputSchema: ZodOptional<ZodJSONSchema>;
+      kind: ZodEnum<{
+        module: "module";
+        operation: "operation";
+      }>;
+      usage: ZodOptional<ZodString>;
+    },
+    $strip
+  >
 >;
 ```
 
@@ -536,18 +514,20 @@ Deterministic description response.
 ### forageFailureSchema
 
 ```ts
-const forageFailureSchema: ZodObject<
-  {
-    code: ZodEnum<{
-      empty_query: "empty_query";
-      empty_catalog: "empty_catalog";
-      unknown_target: "unknown_target";
-      duplicate_operation: "duplicate_operation";
-      invalid_input: "invalid_input";
-    }>;
-    message: ZodString;
-  },
-  $strip
+const forageFailureSchema: ZodLazy<
+  ZodObject<
+    {
+      code: ZodEnum<{
+        empty_query: "empty_query";
+        empty_catalog: "empty_catalog";
+        unknown_target: "unknown_target";
+        duplicate_operation: "duplicate_operation";
+        invalid_input: "invalid_input";
+      }>;
+      message: ZodString;
+    },
+    $strip
+  >
 >;
 ```
 
@@ -558,42 +538,36 @@ Closed failure vocabulary for malformed or absent catalog requests.
 ### operationSchema
 
 ```ts
-const operationSchema: ZodObject<{
+const operationSchema: ZodLazy<ZodObject<{
   path: ZodString;
   description: ZodOptional<ZodString>;
-  input: ZodCustom<Readonly<{
+  input: ZodLazy<ZodCustom<Readonly<{
      ~standard: Readonly<{
         jsonSchema: Readonly<{
-           input: (options) => object;
-           output: (options) => object;
+           input: ...;
+           output: ...;
         }>;
      }>;
    }>, Readonly<{
      ~standard: Readonly<{
         jsonSchema: Readonly<{
-           input: (options) => object;
-           output: (options) => object;
+           input: ...;
+           output: ...;
         }>;
      }>;
-  }>>;
-  output: ZodOptional<ZodCustom<Readonly<{
+  }>>>;
+  output: ZodOptional<ZodLazy<ZodCustom<Readonly<{
      ~standard: Readonly<{
-        jsonSchema: Readonly<{
-           input: (options) => ...;
-           output: (options) => ...;
-        }>;
+        jsonSchema: Readonly<...>;
      }>;
    }>, Readonly<{
      ~standard: Readonly<{
-        jsonSchema: Readonly<{
-           input: (options) => ...;
-           output: (options) => ...;
-        }>;
+        jsonSchema: Readonly<...>;
      }>;
-  }>>>;
+  }>>>>;
   capabilityNotes: ZodOptional<ZodString>;
   instructions: ZodOptional<ZodString>;
-}, $strip>;
+}, $strip>>;
 ```
 
 A secret-free, callback-free operation descriptor.
@@ -603,33 +577,21 @@ A secret-free, callback-free operation descriptor.
 ### catalogInputSchema
 
 ```ts
-const catalogInputSchema: ZodObject<{
+const catalogInputSchema: ZodLazy<ZodObject<{
   revision: ZodString;
-  operations: ZodArray<ZodObject<{
+  operations: ZodArray<ZodLazy<ZodObject<{
      path: ZodString;
      description: ZodOptional<ZodString>;
-     input: ZodCustom<Readonly<{
-        ~standard: Readonly<{
-           jsonSchema: Readonly<...>;
-        }>;
+     input: ZodLazy<ZodCustom<Readonly<{
+        ~standard: ...;
       }>, Readonly<{
-        ~standard: Readonly<{
-           jsonSchema: Readonly<...>;
-        }>;
-     }>>;
-     output: ZodOptional<ZodCustom<Readonly<{
-        ~standard: Readonly<{
-           jsonSchema: ...;
-        }>;
-      }>, Readonly<{
-        ~standard: Readonly<{
-           jsonSchema: ...;
-        }>;
+        ~standard: ...;
      }>>>;
+     output: ZodOptional<ZodLazy<ZodCustom<Readonly<...>, Readonly<...>>>>;
      capabilityNotes: ZodOptional<ZodString>;
      instructions: ZodOptional<ZodString>;
-  }, $strip>>;
-}, $strip>;
+  }, $strip>>>;
+}, $strip>>;
 ```
 
 Input used to construct one immutable catalog revision.
@@ -660,16 +622,47 @@ The shared JSON-Schema compiler for App methods and OpenAPI operations.
 
 ---
 
+### appJsonSchema()
+
+```ts
+function appJsonSchema(
+  declaration,
+): Pick<
+  z.ZodType<z.output<z.ZodJSONSchema>>,
+  "parse" | "safeParse" | "~standard"
+>;
+```
+
+One decoded, immutable App declaration as a JSON-only Standard Schema. Release
+and family-listing decoders own its JSON boundary. A catalog describes every
+installed method on each capture but a turn validates only the few it calls.
+Compiling every method eagerly exhausted an Agent Durable Object's isolate. A
+draft 2020-12 description is the declaration itself; validators compile for the
+call in hand and are never kept on the surface.
+
+#### Parameters
+
+| Parameter     | Type                                                                                                                                                                                        |
+| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `declaration` | \| `boolean` \| \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \} \| AppApiJsonObject; \} |
+
+#### Returns
+
+`Pick`\<`z.ZodType`\<`z.output`\<`z.ZodJSONSchema`\>\>, `"parse"` \|
+`"safeParse"` \| `"~standard"`\>
+
+---
+
 ### appMethodSchemas()
 
 ```ts
 function appMethodSchemas(api): object;
 ```
 
-Compile App validators and their Standard JSON Schema descriptions. Validation
-enforces both the declaration and JSON-only values; discovery describes the
-declaration without adding JSON guard nesting. Agar's emitted output already
-includes Pending for opted-in methods.
+Describe App methods with call-scoped JSON validators. Validation enforces both
+the declaration and JSON-only values; discovery describes the declaration
+without adding JSON guard nesting. Agar's emitted output already includes
+Pending for opted-in methods.
 
 #### Parameters
 
@@ -689,7 +682,7 @@ includes Pending for opted-in methods.
 function appToolSchemas(api): object;
 ```
 
-Compile discoverable App methods only; direct RPC validation uses
+Describe discoverable App methods only; direct RPC validation uses
 appMethodSchemas.
 
 #### Parameters
@@ -715,8 +708,12 @@ function appToolFamilySchemas(
   call: string;
   effect: "write" | "external" | "read";
   requires: readonly (
+    | "approvals"
     | "agent.list"
     | "agent.manage"
+    | "agent.rename"
+    | "agent.avatar"
+    | "agent.toolPolicy"
     | "agent.read"
     | "agent.send"
     | "computer.list"
@@ -760,15 +757,17 @@ arguments; this projection supplies neither defaults nor handlers.
 #### Returns
 
 \| \{ `name`: `string`; `call`: `string`; `effect`: `"write"` \| `"external"` \|
-`"read"`; `requires`: readonly ( \| `"agent.list"` \| `"agent.manage"` \|
-`"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"`
-\| `"computer.writeFile"` \| `"computer.execute"` \| `"llm.generation"` \|
-`"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
-\| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
-`"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
-`"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
-`"channels.read"` \| `"channels.personal.manage"`)[]; `kind`: `"ready"` \|
-`"unindexed"`; `tools`: `object`[]; \} \| `null`
+`"read"`; `requires`: readonly ( \| `"approvals"` \| `"agent.list"` \|
+`"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"`
+\| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \|
+`"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
+`"llm.generation"` \| `"media.generation"` \| `"games:servers"` \|
+`"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
+`"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
+`"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
+`"workflow.arm"` \| `"world"` \| `"channels.read"` \|
+`"channels.personal.manage"`)[]; `kind`: `"ready"` \| `"unindexed"`; `tools`:
+`object`[]; \} \| `null`
 
 ---
 

package/docs/api/openapi.md

@@ -197,7 +197,7 @@ const openApiOperationSchema: ZodObject<
     parameters: ZodArray<
       ZodObject<
         {
-          name: ZodString;
+          name: ZodLazy<ZodString>;
           in: ZodEnum<{
             header: "header";
             path: "path";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/forage",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Pure immutable Zod-typed capability discovery",
   "type": "module",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "16.0.3",
-    "@fungi.computer/puffball": "0.1.0",
+    "@fungi.computer/puffball": "0.3.0",
     "yaml": "2.9.0",
     "zod": "4.4.3"
   },