@fungi.computer/agar 0.0.1 → 0.2.0

package/dist/read-copy.d.ts

@@ -52,7 +52,7 @@ export declare function countingGit(binding: GitBinding, options: {
         delete(name: string): Promise<boolean>;
         log(name: string, options: {
             ref: string;
-            limit?: number;
+            limit? /** Bind a namespace to its maintained App decoder. */: number;
             offset?: number;
         }): Promise<import("./git.js").GitCommit[]>;
         readCommit(name: string, hash: string): Promise<import("./git.js").GitCommit | null>;

package/dist/read-copy.js

@@ -44,18 +44,15 @@ export function countingGit(binding, options) {
         /** Dispatch counts by maintained Git operation. */ counts: () => Object.fromEntries(counts),
     };
 }
-const rowSchema = z.strictObject({
+const rowSchema = z.lazy(() => z.strictObject({
     head: gitSha1Schema.nullable(),
     version: z.number().int(),
     revision: z.number().int(),
     value: z.string().nullable(),
-});
+}));
 const name = z.string().min(1).max(1024);
 const zero = "0".repeat(40);
-const blobHash = z.union([
-    gitSha1Schema,
-    z.string().regex(/^sha256:[0-9a-f]{64}$/),
-]);
+const blobHash = z.lazy(() => z.union([gitSha1Schema, z.string().regex(/^sha256:[0-9a-f]{64}$/)]));
 /** Own bounded rows and content-addressed bytes in the App facet, not a host/provider cache. */
 export function createReadCopies(sql, limits) {
     z.strictObject({

package/dist/storage-wire.d.ts

@@ -44,7 +44,7 @@ export declare const resolvedAppStorageSchema: Schema.Struct<{
 export type ResolvedAppStorage = typeof resolvedAppStorageSchema.Type;
 /**
  * Validates a write request: the key, scope, value to store, and the
- * revision it's conditioned on (`null` to write unconditionally).
+ * expected revision of that layer (`null` requires the layer to be absent).
  */
 export declare const appStorageWriteSchema: Schema.Struct<{
     readonly value: Schema.Codec<Schema.Json, Schema.Json, never, never>;
@@ -54,7 +54,7 @@ export declare const appStorageWriteSchema: Schema.Struct<{
 }>;
 /**
  * Validates a reset request: the key, scope, and the revision it's
- * conditioned on (`null` to reset unconditionally).
+ * conditioned on (`null` requires the layer to be absent).
  */
 export declare const appStorageResetSchema: Schema.Struct<{
     key: Schema.String;

package/dist/storage-wire.js

@@ -51,7 +51,7 @@ const mutation = {
 };
 /**
  * Validates a write request: the key, scope, value to store, and the
- * revision it's conditioned on (`null` to write unconditionally).
+ * expected revision of that layer (`null` requires the layer to be absent).
  */
 export const appStorageWriteSchema = Schema.Struct({
     ...mutation,
@@ -59,7 +59,7 @@ export const appStorageWriteSchema = Schema.Struct({
 });
 /**
  * Validates a reset request: the key, scope, and the revision it's
- * conditioned on (`null` to reset unconditionally).
+ * conditioned on (`null` requires the layer to be absent).
  */
 export const appStorageResetSchema = Schema.Struct(mutation);
 /** Validates a bare revision number returned after a write or reset. */

package/dist/storage.js

@@ -140,4 +140,4 @@ function client(raw) {
     };
 }
 /** This App's own declared data. The host seals App and member identities. */
-export const appStorage = defineCapability("app.storage", 1, rawSchema.transform(client));
+export const appStorage = defineCapability("app.storage", 1, z.lazy(() => rawSchema.transform(client)));

package/dist/test-kit/git.js

@@ -1,6 +1,6 @@
 import { pathToFileURL } from "node:url";
 import { execFileSync, spawnSync } from "node:child_process";
-import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { existsSync, mkdtempSync, rmSync, statSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import * as z from "zod";
@@ -13,7 +13,21 @@ export function realGit() {
     const info = (name) => existsSync(join(root, `${name}.git`))
         ? { name, defaultBranch: "main", lastPushAt: null, source: null }
         : null;
+    // A full object id names an immutable commit, so one read serves every
+    // later ask; refs and abbreviations move and are never cached.
+    const commits = new Map();
+    const immutable = (hash) => /^[0-9a-f]{40,64}$/u.test(hash);
     const readCommit = (name, hash) => {
+        // The repository's directory identity keeps a deleted-and-recreated name
+        // from serving the old repository's commits, however it was removed.
+        const dir = statSync(join(root, `${name}.git`), {
+            bigint: true,
+            throwIfNoEntry: false,
+        });
+        const key = `${name}\0${String(dir?.ino)}\0${String(dir?.birthtimeNs)}\0${hash}`;
+        const cached = immutable(hash) ? commits.get(key) : undefined;
+        if (cached !== undefined)
+            return structuredClone(cached);
         const found = spawnSync("git", [`--git-dir=${join(root, `${name}.git`)}`, "cat-file", "-t", hash], { encoding: "utf8" });
         if (found.status !== 0 || found.stdout.trim() !== "commit")
             return null;
@@ -31,7 +45,7 @@ export function realGit() {
             z.string(),
         ])
             .parse(run(name, "show", "-s", "--format=%H%x00%T%x00%P%x00%an%x00%ae%x00%cn%x00%ce%x00%at%x00%ct%x00%B", hash).split("\0"));
-        return {
+        const commit = {
             hash: oid,
             treeHash,
             parents: parents ? parents.split(" ") : [],
@@ -41,6 +55,9 @@ export function realGit() {
             committedAt: Number(committedAt),
             message,
         };
+        if (immutable(hash))
+            commits.set(key, structuredClone(commit));
+        return commit;
     };
     const git = {
         cloneUrl: (name) => {

package/dist/window.d.ts

@@ -9,6 +9,54 @@ export type BeforeAppClose = () => boolean | Promise<boolean>;
 export declare const APP_NAVIGATION_CONTRACT_VERSION: 1;
 /** The longest page title a host shows beside the App's own name. */
 export declare const APP_NAVIGATION_TITLE_MAX = 80;
+/** The most crumbs one navigation report may carry. */
+export declare const APP_NAVIGATION_CRUMBS_MAX = 8;
+/** The most siblings one switcher crumb may offer. */
+export declare const APP_NAVIGATION_SIBLINGS_MAX = 16;
+/** The most primary header commands one report may carry. */
+export declare const APP_NAVIGATION_PRIMARY_MAX = 3;
+/** The most header status facts one report may carry. */
+export declare const APP_NAVIGATION_STATUS_MAX = 4;
+/** The most ⋯ menu commands one report may carry. */
+export declare const APP_NAVIGATION_MENU_MAX = 12;
+/** The longest crumb or command label a host shows. */
+export declare const APP_NAVIGATION_LABEL_MAX = 80;
+/** One place in the App's path; `siblings` makes it a switcher. */
+export type AppCrumb = Readonly<{
+    id: string;
+    label: string;
+    siblings?: readonly Readonly<{
+        id: string;
+        label: string;
+    }>[];
+}>;
+/** A command the App offers in its window header; the App owns its effect. */
+export type AppHeaderCommand = Readonly<{
+    id: string;
+    label: string;
+    /** The Caps button a primary command wears; default `outline`. */
+    variant?: "primary" | "outline" | "ghost";
+    /** A menu command that removes or discards something. */
+    tone?: "destructive";
+    disabled?: boolean;
+}>;
+/** A quiet fact about the view, shown as muted text with a status bead. */
+export type AppHeaderStatus = Readonly<{
+    id: string;
+    label: string;
+    tone?: "neutral" | "info" | "warning" | "success" | "error";
+}>;
+/** The person used a crumb (or a switcher's sibling) or a header command. */
+export type AppNavigationActivation = Readonly<{
+    kind: "crumb";
+    crumbId: string;
+    siblingId?: string;
+}> | Readonly<{
+    kind: "action";
+    actionId: string;
+}>;
+/** Handles one activation; `true` when the App acted on it. */
+export type AppNavigationActivationHandler = (activation: AppNavigationActivation) => boolean | Promise<boolean>;
 /**
  * What the App's own router can do right now. The App owns its history; the
  * host only offers a Back affordance and relays the person's request.
@@ -17,6 +65,14 @@ export type AppNavigationState = Readonly<{
     canGoBack: boolean;
     /** The current page's title, shown after the App name in window chrome. */
     title?: string;
+    /** The App's path; the host shows it in place of the App name and title. */
+    crumbs?: readonly AppCrumb[];
+    /** The view's main commands, as buttons in the header. */
+    primary?: readonly AppHeaderCommand[];
+    /** Less common commands, behind the header's overflow menu. */
+    menu?: readonly AppHeaderCommand[];
+    /** Facts about the view, such as "Valid" or "Saved". Data only. */
+    status?: readonly AppHeaderStatus[];
 }>;
 /** Go back one step in the App's own history; `true` when it moved. */
 export type AppBackHandler = () => boolean | Promise<boolean>;
@@ -26,6 +82,8 @@ export type HostNavigation = Readonly<{
     publish(state: AppNavigationState): Promise<void>;
     /** Own the host's Back requests; one owner at a time. */
     onBack(handler: AppBackHandler): Disposer;
+    /** Own the host's crumb and command activations; one owner at a time. */
+    onActivate(handler: AppNavigationActivationHandler): Disposer;
 }>;
 /** App-owned presentation policy consulted before a user closes its window. */
 export type AppWindow = Readonly<{
@@ -39,3 +97,9 @@ export type AppWindow = Readonly<{
  * accepts every report and never asks the App to go back.
  */
 export declare const inertHostNavigation: HostNavigation;
+/**
+ * Whether an activation names something the App published now: a crumb (and
+ * its sibling), or an enabled command. Every hop applies this rule against
+ * its own latest copy of the report, so a stale shell cannot reach the App.
+ */
+export declare function navigationActivationAllowed(state: AppNavigationState, activation: AppNavigationActivation): boolean;

package/dist/window.js

@@ -5,6 +5,18 @@
 export const APP_NAVIGATION_CONTRACT_VERSION = 1;
 /** The longest page title a host shows beside the App's own name. */
 export const APP_NAVIGATION_TITLE_MAX = 80;
+/** The most crumbs one navigation report may carry. */
+export const APP_NAVIGATION_CRUMBS_MAX = 8;
+/** The most siblings one switcher crumb may offer. */
+export const APP_NAVIGATION_SIBLINGS_MAX = 16;
+/** The most primary header commands one report may carry. */
+export const APP_NAVIGATION_PRIMARY_MAX = 3;
+/** The most header status facts one report may carry. */
+export const APP_NAVIGATION_STATUS_MAX = 4;
+/** The most ⋯ menu commands one report may carry. */
+export const APP_NAVIGATION_MENU_MAX = 12;
+/** The longest crumb or command label a host shows. */
+export const APP_NAVIGATION_LABEL_MAX = 80;
 /**
  * Navigation for a root with no host chrome, such as a workbench fixture: it
  * accepts every report and never asks the App to go back.
@@ -12,4 +24,23 @@ export const APP_NAVIGATION_TITLE_MAX = 80;
 export const inertHostNavigation = Object.freeze({
     publish: () => Promise.resolve(),
     onBack: () => () => undefined,
+    onActivate: () => () => undefined,
 });
+/**
+ * Whether an activation names something the App published now: a crumb (and
+ * its sibling), or an enabled command. Every hop applies this rule against
+ * its own latest copy of the report, so a stale shell cannot reach the App.
+ */
+export function navigationActivationAllowed(state, activation) {
+    if (activation.kind === "action") {
+        const command = [...(state.primary ?? []), ...(state.menu ?? [])].find((candidate) => candidate.id === activation.actionId);
+        return command !== undefined && command.disabled !== true;
+    }
+    const crumb = state.crumbs?.find((candidate) => candidate.id === activation.crumbId);
+    if (crumb === undefined)
+        return false;
+    if (activation.siblingId === undefined)
+        return true;
+    return (crumb.siblings?.some((sibling) => sibling.id === activation.siblingId) ===
+        true);
+}

package/docs/api/backend-definition.md

@@ -30,6 +30,9 @@ type MethodPolicy = Readonly<{
   hidden?: true;
   anonymous?: true;
   pending?: true;
+  present?: Readonly<{
+    verb: string;
+  }>;
 }>;
 ```
 
@@ -37,6 +40,44 @@ A method's schemas own both its TypeScript contract and JSON boundary.
 
 ---
 
+### ResultRowCodec
+
+```ts
+type ResultRowCodec = Readonly<{
+  decode: (row) => ResultRow;
+  schema: z.ZodType;
+}>;
+```
+
+Decodes and bounds result rows; see `resultRows` in
+`@fungi.computer/agar/method-presentation`.
+
+---
+
+### MethodPresentation
+
+```ts
+type MethodPresentation<I, O> = Readonly<{
+  verb: string;
+  row: (call) => ResultRow;
+  rows: ResultRowCodec;
+}>;
+```
+
+How a finished call reads to a person: a pure projection run in the App backend.
+`rows` is `resultRows` from `@fungi.computer/agar/method-presentation`; only a
+backend that presents imports it, so one without presentations carries no row
+decoder.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `I`            |
+| `O`            |
+
+---
+
 ### AppBackendMethod
 
 ```ts
@@ -44,6 +85,8 @@ type AppBackendMethod<Context> = Readonly<{
   policy: MethodPolicy;
   input: z.ZodType;
   output: z.ZodType;
+  present?: (input, output) => ResultRow;
+  presentRow?: z.ZodType;
   call: (input, context, caller) => Promise<WhistleJsonValue>;
 }>;
 ```
@@ -58,6 +101,24 @@ Prepared method export consumed by the backend and its build.
 
 ---
 
+### AppBackendMethods
+
+```ts
+type AppBackendMethods<Context> = Readonly<
+  Record<string, AppBackendMethod<Context>>
+>;
+```
+
+The prepared methods of one backend, keyed by their public names.
+
+#### Type Parameters
+
+| Type Parameter | Default type |
+| -------------- | ------------ |
+| `Context`      | `void`       |
+
+---
+
 ### AppBackendClass
 
 ```ts
@@ -123,18 +184,31 @@ EVENTS.emit acknowledges delivery with native void, not a JSON value.
 ### appSendBudgetRefusalSchema
 
 ```ts
-const appSendBudgetRefusalSchema: ZodObject<
-  {
-    error: ZodLiteral<"send_budget_exceeded">;
-    retryAfterMs: ZodNumber;
-  },
-  $strict
+const appSendBudgetRefusalSchema: ZodLazy<
+  ZodObject<
+    {
+      error: ZodLiteral<"send_budget_exceeded">;
+      retryAfterMs: ZodNumber;
+    },
+    $strict
+  >
 >;
 ```
 
 App-originated Session send refusal; retry advice is a duration, not a
 timestamp.
 
+---
+
+### presentMethodName
+
+```ts
+const presentMethodName: "present" = "present";
+```
+
+Name of the generated, hidden read method that projects a finished call into its
+row.
+
 ## Functions
 
 ### defineAppMethod()
@@ -155,9 +229,9 @@ Define a typed method once; neither discovery nor builds execute its handler.
 
 #### Parameters
 
-| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `method`  | `Readonly`\<\{ `description`: `string`; `effect`: `"external"` \| `"read"` \| `"write"`; `requires`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"apps.open"` \| `"apps.call"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `hidden?`: `true`; `anonymous?`: `true`; `pending?`: `true`; \}\> & \{ input: I; output: O; \} & (\{ pending: true; handler: (input: output\<I\>, context: Context, caller: \{ computerId: string \| null; actor: \{ kind: "member"; memberId: string; \} \| \{ ...; \} \| \{ ...; \}; ... 5 more ...; idempotencyKey?: string \| undefined; \}) =\> Readonly\<...\> \| ... 1 more ... \| Promise\<...\>; \} \| \{ ...; \}) |
+| Parameter | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `method`  | `Omit`\<`Readonly`\<\{ `description`: `string`; `effect`: `"external"` \| `"read"` \| `"write"`; `requires`: readonly ( \| `"agent.list"` \| `"agent.manage"` \| `"agent.read"` \| `"agent.send"` \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"agent.rename"` \| `"agent.toolPolicy"` \| `"apps.open"` \| `"apps.call"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `hidden?`: `true`; `anonymous?`: `true`; `pending?`: `true`; `present?`: `Readonly`\<\{ `verb`: `string`; \}\>; \}\>, `"present"`\> & \{ input: I; output: O; present?: Readonly\<\{ verb: string; row: (call: Readonly\<\{ input: output\<I\>; output: output\<O\>; \}\>) =\> \{ readonly id: string; readonly title: string; ... 4 more ...; readonly media?: \{ ...; \} \| undefined; \}; rows: Readonly\<...\>; \}\> \| undefined; \} & (\{ ...; \} \| \{ ...; \}) |
 
 #### Returns
 

package/docs/api/backend.md

@@ -215,19 +215,21 @@ Bound on the App-authored refusal message that reaches callers.
 ### appMethodRefusedReplySchema
 
 ```ts
-const appMethodRefusedReplySchema: ZodObject<
-  {
-    kind: ZodLiteral<"refused">;
-    code: ZodEnum<{
-      unavailable: "unavailable";
-      invalid: "invalid";
-      conflict: "conflict";
-      forbidden: "forbidden";
-      not_found: "not_found";
-    }>;
-    message: ZodString;
-  },
-  $strict
+const appMethodRefusedReplySchema: ZodLazy<
+  ZodObject<
+    {
+      kind: ZodLiteral<"refused">;
+      code: ZodEnum<{
+        unavailable: "unavailable";
+        invalid: "invalid";
+        conflict: "conflict";
+        forbidden: "forbidden";
+        not_found: "not_found";
+      }>;
+      message: ZodString;
+    },
+    $strict
+  >
 >;
 ```
 
@@ -238,31 +240,35 @@ A refused call as it crosses the generated method boundary.
 ### appMethodReplySchema
 
 ```ts
-const appMethodReplySchema: ZodDiscriminatedUnion<
-  [
-    ZodObject<
-      {
-        kind: ZodLiteral<"ok">;
-        value: ZodJSONSchema;
-      },
-      $strict
-    >,
-    ZodObject<
-      {
-        kind: ZodLiteral<"refused">;
-        code: ZodEnum<{
-          unavailable: "unavailable";
-          invalid: "invalid";
-          conflict: "conflict";
-          forbidden: "forbidden";
-          not_found: "not_found";
-        }>;
-        message: ZodString;
-      },
-      $strict
-    >,
-  ],
-  "kind"
+const appMethodReplySchema: ZodLazy<
+  ZodDiscriminatedUnion<
+    [
+      ZodObject<
+        {
+          kind: ZodLiteral<"ok">;
+          value: ZodJSONSchema;
+        },
+        $strict
+      >,
+      ZodLazy<
+        ZodObject<
+          {
+            kind: ZodLiteral<"refused">;
+            code: ZodEnum<{
+              unavailable: "unavailable";
+              invalid: "invalid";
+              conflict: "conflict";
+              forbidden: "forbidden";
+              not_found: "not_found";
+            }>;
+            message: ZodString;
+          },
+          $strict
+        >
+      >,
+    ],
+    "kind"
+  >
 >;
 ```
 

package/docs/api/git-rpc.md

@@ -30,41 +30,41 @@ The native tuple and result grammar shared by the handle and frame entrypoint.
 
 #### Type Declaration
 
-| Name                                          | Type                                                                                                                                                                                                                                                                                                                                                                                                                 | Default value |
-| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| <a id="property-create"></a> `create`         | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `create.args`                                 | `ZodTuple`\<\[`ZodString`, `ZodOptional`\<`ZodObject`\<\{ `description`: `ZodOptional`\<`ZodString`\>; `defaultBranch`: `ZodOptional`\<`ZodString`\>; \}, `$strict`\>\>\], `null`\>                                                                                                                                                                                                                                  | -             |
-| `create.result`                               | `ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>                                                                                                                                                                                                                                               | `info`        |
-| <a id="property-fork"></a> `fork`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `fork.args`                                   | `ZodTuple`\<\[`ZodString`, `ZodString`, `ZodOptional`\<`ZodObject`\<\{ `description`: `ZodOptional`\<`ZodString`\>; \}, `$strict`\>\>\], `null`\>                                                                                                                                                                                                                                                                    | -             |
-| `fork.result`                                 | `ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>                                                                                                                                                                                                                                               | `info`        |
-| <a id="property-cloneurl"></a> `cloneUrl`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `cloneUrl.args`                               | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                | -             |
-| `cloneUrl.result`                             | `ZodURL`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| <a id="property-info"></a> `info`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `info.args`                                   | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                | -             |
-| `info.result`                                 | `ZodNullable`\<`ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>\>                                                                                                                                                                                                                              | -             |
-| <a id="property-delete"></a> `delete`         | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `delete.args`                                 | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                | -             |
-| `delete.result`                               | `ZodBoolean`                                                                                                                                                                                                                                                                                                                                                                                                         | -             |
-| <a id="property-log"></a> `log`               | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `log.args`                                    | `ZodTuple`\<\[`ZodString`, `ZodObject`\<\{ `ref`: `ZodString`; `limit`: `ZodOptional`\<`ZodNumber`\>; `offset`: `ZodOptional`\<`ZodNumber`\>; \}, `$strict`\>\], `null`\>                                                                                                                                                                                                                                            | -             |
-| `log.result`                                  | `ZodArray`\<`ZodObject`\<\{ `hash`: `ZodString`; `treeHash`: `ZodString`; `message`: `ZodString`; `author`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `committer`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `parents`: `ZodArray`\<`ZodString`\>; `authoredAt`: `ZodNumber`; `committedAt`: `ZodNumber`; \}, `$strict`\>\>                      | -             |
-| <a id="property-readcommit"></a> `readCommit` | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `readCommit.args`                             | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                   | -             |
-| `readCommit.result`                           | `ZodNullable`\<`ZodObject`\<\{ `hash`: `ZodString`; `treeHash`: `ZodString`; `message`: `ZodString`; `author`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `committer`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `parents`: `ZodArray`\<`ZodString`\>; `authoredAt`: `ZodNumber`; `committedAt`: `ZodNumber`; \}, `$strict`\>\>                   | -             |
-| <a id="property-readtree"></a> `readTree`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `readTree.args`                               | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                   | -             |
-| `readTree.result`                             | `ZodNullable`\<`ZodArray`\<`ZodObject`\<\{ `name`: `ZodString`; `mode`: `ZodString`; `hash`: `ZodString`; `type`: `ZodEnum`\<\{ `blob`: `"blob"`; `tree`: `"tree"`; `commit`: `"commit"`; \}\>; \}, `$strict`\>\>\>                                                                                                                                                                                                  | -             |
-| <a id="property-readblob"></a> `readBlob`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `readBlob.args`                               | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                   | -             |
-| `readBlob.result`                             | `ZodNullable`\<`ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>\>                                                                                                                                                                                                                                                                                                                         | -             |
-| <a id="property-refs"></a> `refs`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `refs.args`                                   | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                | -             |
-| `refs.result`                                 | `ZodArray`\<`ZodObject`\<\{ `name`: `ZodString`; `hash`: `ZodString`; \}, `$strict`\>\>                                                                                                                                                                                                                                                                                                                              | -             |
-| <a id="property-exchange"></a> `exchange`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                             | -             |
-| `exchange.args`                               | `ZodTuple`\<\[`ZodString`, `ZodObject`\<\{ `service`: `ZodEnum`\<\{ `upload-pack`: `"upload-pack"`; `receive-pack`: `"receive-pack"`; \}\>; `phase`: `ZodEnum`\<\{ `advertise`: `"advertise"`; `exchange`: `"exchange"`; \}\>; `body`: `ZodNullable`\<`ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>\>; `headers`: `ZodRecord`\<`ZodString`, `ZodString`\>; \}, `$strict`\>\], `null`\> | -             |
-| `exchange.result`                             | `ZodObject`\<\{ `status`: `ZodNumber`; `headers`: `ZodRecord`\<`ZodString`, `ZodString`\>; `body`: `ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>; \}, `$strict`\>                                                                                                                                                                                                                      | `response`    |
+| Name                                          | Type                                                                                                                                                                                                                                                                                                                                                                                                                                           | Default value |
+| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
+| <a id="property-create"></a> `create`         | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `create.args`                                 | `ZodTuple`\<\[`ZodString`, `ZodLazy`\<`ZodOptional`\<`ZodObject`\<\{ `description`: `ZodOptional`\<`ZodString`\>; `defaultBranch`: `ZodOptional`\<`ZodString`\>; \}, `$strict`\>\>\>\], `null`\>                                                                                                                                                                                                                                               | -             |
+| `create.result`                               | `ZodLazy`\<`ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>\>                                                                                                                                                                                                                                                            | `info`        |
+| <a id="property-fork"></a> `fork`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `fork.args`                                   | `ZodTuple`\<\[`ZodString`, `ZodString`, `ZodLazy`\<`ZodOptional`\<`ZodObject`\<\{ `description`: `ZodOptional`\<`ZodString`\>; \}, `$strict`\>\>\>\], `null`\>                                                                                                                                                                                                                                                                                 | -             |
+| `fork.result`                                 | `ZodLazy`\<`ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>\>                                                                                                                                                                                                                                                            | `info`        |
+| <a id="property-cloneurl"></a> `cloneUrl`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `cloneUrl.args`                               | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                                          | -             |
+| `cloneUrl.result`                             | `ZodURL`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| <a id="property-info"></a> `info`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `info.args`                                   | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                                          | -             |
+| `info.result`                                 | `ZodNullable`\<`ZodLazy`\<`ZodObject`\<\{ `name`: `ZodString`; `defaultBranch`: `ZodString`; `lastPushAt`: `ZodNullable`\<`ZodString`\>; `source`: `ZodNullable`\<`ZodString`\>; \}, `$strict`\>\>\>                                                                                                                                                                                                                                           | -             |
+| <a id="property-delete"></a> `delete`         | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `delete.args`                                 | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                                          | -             |
+| `delete.result`                               | `ZodBoolean`                                                                                                                                                                                                                                                                                                                                                                                                                                   | -             |
+| <a id="property-log"></a> `log`               | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `log.args`                                    | `ZodTuple`\<\[`ZodString`, `ZodLazy`\<`ZodObject`\<\{ `ref`: `ZodString`; `limit`: `ZodOptional`\<`ZodNumber`\>; `offset`: `ZodOptional`\<`ZodNumber`\>; \}, `$strict`\>\>\], `null`\>                                                                                                                                                                                                                                                         | -             |
+| `log.result`                                  | `ZodArray`\<`ZodLazy`\<`ZodObject`\<\{ `hash`: `ZodString`; `treeHash`: `ZodString`; `message`: `ZodString`; `author`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `committer`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `parents`: `ZodArray`\<`ZodString`\>; `authoredAt`: `ZodNumber`; `committedAt`: `ZodNumber`; \}, `$strict`\>\>\>                                   | -             |
+| <a id="property-readcommit"></a> `readCommit` | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `readCommit.args`                             | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                             | -             |
+| `readCommit.result`                           | `ZodNullable`\<`ZodLazy`\<`ZodObject`\<\{ `hash`: `ZodString`; `treeHash`: `ZodString`; `message`: `ZodString`; `author`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `committer`: `ZodObject`\<\{ `name`: `ZodString`; `email`: `ZodString`; \}, `$strict`\>; `parents`: `ZodArray`\<`ZodString`\>; `authoredAt`: `ZodNumber`; `committedAt`: `ZodNumber`; \}, `$strict`\>\>\>                                | -             |
+| <a id="property-readtree"></a> `readTree`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `readTree.args`                               | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                             | -             |
+| `readTree.result`                             | `ZodNullable`\<`ZodArray`\<`ZodLazy`\<`ZodObject`\<\{ `name`: `ZodString`; `mode`: `ZodString`; `hash`: `ZodString`; `type`: `ZodEnum`\<\{ `blob`: `"blob"`; `tree`: `"tree"`; `commit`: `"commit"`; \}\>; \}, `$strict`\>\>\>\>                                                                                                                                                                                                               | -             |
+| <a id="property-readblob"></a> `readBlob`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `readBlob.args`                               | `ZodTuple`\<\[`ZodString`, `ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                             | -             |
+| `readBlob.result`                             | `ZodNullable`\<`ZodLazy`\<`ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>\>\>                                                                                                                                                                                                                                                                                                                                      | -             |
+| <a id="property-refs"></a> `refs`             | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `refs.args`                                   | `ZodTuple`\<\[`ZodString`\], `null`\>                                                                                                                                                                                                                                                                                                                                                                                                          | -             |
+| `refs.result`                                 | `ZodArray`\<`ZodObject`\<\{ `name`: `ZodString`; `hash`: `ZodString`; \}, `$strict`\>\>                                                                                                                                                                                                                                                                                                                                                        | -             |
+| <a id="property-exchange"></a> `exchange`     | `object`                                                                                                                                                                                                                                                                                                                                                                                                                                       | -             |
+| `exchange.args`                               | `ZodTuple`\<\[`ZodString`, `ZodObject`\<\{ `service`: `ZodEnum`\<\{ `upload-pack`: `"upload-pack"`; `receive-pack`: `"receive-pack"`; \}\>; `phase`: `ZodEnum`\<\{ `advertise`: `"advertise"`; `exchange`: `"exchange"`; \}\>; `body`: `ZodNullable`\<`ZodLazy`\<`ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>\>\>; `headers`: `ZodLazy`\<`ZodRecord`\<`ZodString`, `ZodString`\>\>; \}, `$strict`\>\], `null`\> | -             |
+| `exchange.result`                             | `ZodObject`\<\{ `status`: `ZodNumber`; `headers`: `ZodLazy`\<`ZodRecord`\<`ZodString`, `ZodString`\>\>; `body`: `ZodLazy`\<`ZodCustom`\<`Uint8Array`\<`ArrayBuffer`\>, `Uint8Array`\<`ArrayBuffer`\>\>\>; \}, `$strict`\>                                                                                                                                                                                                                      | `response`    |
 
 ---