@nyte-ai/schema 0.0.0-stage → 0.0.18

package/dist/src/serial.js

@@ -0,0 +1,39 @@
+// src/serial.ts
+function serial() {
+  let tail = Promise.resolve();
+  let pending = 0;
+  const settle = () => {
+    pending -= 1;
+  };
+  return {
+    run(task) {
+      pending += 1;
+      const done = tail.then(task);
+      tail = done.then(settle, settle);
+      return done;
+    },
+    settled: () => tail,
+    get busy() {
+      return pending > 0;
+    }
+  };
+}
+function keyedSerial() {
+  const queues = new Map;
+  return {
+    run(key, task) {
+      const queue = queues.get(key) ?? serial();
+      queues.set(key, queue);
+      const done = queue.run(task);
+      queue.settled().then(() => {
+        if (!queue.busy && queues.get(key) === queue)
+          queues.delete(key);
+      });
+      return done;
+    }
+  };
+}
+export {
+  keyedSerial,
+  serial
+};

package/dist/src/sessions.d.ts

@@ -0,0 +1,578 @@
+import { Type } from "typebox";
+import type { Decoded, Schema } from "./schema.ts";
+export declare const HeadInfoType: Type.TObject<{
+    name: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+    tip: Type.TUnion<[Type.TObject<{
+        kind: Type.TLiteral<"start">;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"commit">;
+        id: Type.TUnsafe<import("./ids.ts").Id<"commit">>;
+    }>]>;
+    stack: Type.TUnion<[Type.TObject<{
+        parent: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+        base: Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"start">;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"commit">;
+            id: Type.TUnsafe<import("./ids.ts").Id<"commit">>;
+        }>]>;
+        stale: Type.TBoolean;
+    }>, Type.TNull]>;
+    execution: Type.TUnion<[Type.TObject<{
+        kind: Type.TLiteral<"idle">;
+        lastRun: Type.TUnion<[Type.TObject<{
+            id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+            end: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"completed">;
+                usage: Type.TObject<{
+                    input: Type.TNumber;
+                    output: Type.TNumber;
+                    cacheRead: Type.TNumber;
+                    cacheWrite: Type.TNumber;
+                    reasoning: Type.TUnion<[Type.TNumber, Type.TNull]>;
+                    total: Type.TNumber;
+                    cost: Type.TObject<{
+                        input: Type.TNumber;
+                        output: Type.TNumber;
+                        cacheRead: Type.TNumber;
+                        cacheWrite: Type.TNumber;
+                        total: Type.TNumber;
+                    }>;
+                }>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"stopped">;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"failed">;
+                failure: Type.TObject<{
+                    class: Type.TEnum<["rate_limit", "auth", "quota", "context_window", "overloaded", "network", "aborted", "provider", "runner"]>;
+                    message: Type.TString;
+                    retryAfterMs: Type.TOptional<Type.TNumber>;
+                }>;
+            }>]>;
+            endedAt: Type.TNumber;
+        }>, Type.TNull]>;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"live">;
+        run: Type.TObject<{
+            id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+            head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+            startedAt: Type.TNumber;
+            attempt: Type.TNumber;
+            configuration: Type.TObject<{
+                kind: Type.TLiteral<"exact">;
+                model: Type.TObject<{
+                    provider: Type.TString;
+                    id: Type.TString;
+                }>;
+                thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                settingsVersion: Type.TString;
+            }>;
+            origin: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"input">;
+                message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"continuation">;
+                from: Type.TEnum<["child", "job", "wake"]>;
+            }>]>;
+        }>;
+        phase: Type.TEnum<["responding", "executing"]>;
+        stopping: Type.TBoolean;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"waiting">;
+        run: Type.TObject<{
+            id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+            head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+            startedAt: Type.TNumber;
+            attempt: Type.TNumber;
+            configuration: Type.TObject<{
+                kind: Type.TLiteral<"exact">;
+                model: Type.TObject<{
+                    provider: Type.TString;
+                    id: Type.TString;
+                }>;
+                thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                settingsVersion: Type.TString;
+            }>;
+            origin: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"input">;
+                message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"continuation">;
+                from: Type.TEnum<["child", "job", "wake"]>;
+            }>]>;
+        }>;
+        on: Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"run">;
+            session: Type.TUnsafe<import("./ids.ts").Id<"session">>;
+            run: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+            deadline: Type.TOptional<Type.TNumber>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"job">;
+            job: Type.TUnsafe<import("./ids.ts").Id<"job">>;
+            deadline: Type.TOptional<Type.TNumber>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"part">;
+            part: Type.TUnsafe<import("./ids.ts").Id<"part">>;
+            deadline: Type.TOptional<Type.TNumber>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"timer">;
+            until: Type.TNumber;
+            deadline: Type.TOptional<Type.TNumber>;
+        }>]>;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"retrying">;
+        run: Type.TObject<{
+            id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+            head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+            startedAt: Type.TNumber;
+            attempt: Type.TNumber;
+            configuration: Type.TObject<{
+                kind: Type.TLiteral<"exact">;
+                model: Type.TObject<{
+                    provider: Type.TString;
+                    id: Type.TString;
+                }>;
+                thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                settingsVersion: Type.TString;
+            }>;
+            origin: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"input">;
+                message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"continuation">;
+                from: Type.TEnum<["child", "job", "wake"]>;
+            }>]>;
+        }>;
+        until: Type.TNumber;
+        reason: Type.TString;
+    }>]>;
+    unread: Type.TBoolean;
+}>;
+export type HeadInfo = Decoded<typeof HeadInfoType>;
+export declare const SessionInfoType: Type.TObject<{
+    id: Type.TUnsafe<import("./ids.ts").Id<"session">>;
+    name: Type.TUnion<[Type.TString, Type.TNull]>;
+    parent: Type.TUnion<[Type.TUnsafe<import("./ids.ts").Id<"session">>, Type.TNull]>;
+    call: Type.TUnion<[Type.TUnsafe<import("./ids.ts").Id<"call">>, Type.TNull]>;
+    workspace: Type.TUnsafe<import("./ids.ts").Id<"workspace">>;
+    pinned: Type.TBoolean;
+    archived: Type.TBoolean;
+    activation: Type.TUnion<[Type.TObject<{
+        kind: Type.TLiteral<"active">;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"inactive">;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"unavailable">;
+        reason: Type.TEnum<["unsupported", "unreachable"]>;
+        workspace: Type.TUnsafe<import("./ids.ts").Id<"workspace">>;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"failed">;
+        message: Type.TString;
+    }>]>;
+    heads: Type.TArray<Type.TObject<{
+        name: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+        tip: Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"start">;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"commit">;
+            id: Type.TUnsafe<import("./ids.ts").Id<"commit">>;
+        }>]>;
+        stack: Type.TUnion<[Type.TObject<{
+            parent: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+            base: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"start">;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"commit">;
+                id: Type.TUnsafe<import("./ids.ts").Id<"commit">>;
+            }>]>;
+            stale: Type.TBoolean;
+        }>, Type.TNull]>;
+        execution: Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"idle">;
+            lastRun: Type.TUnion<[Type.TObject<{
+                id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+                end: Type.TUnion<[Type.TObject<{
+                    kind: Type.TLiteral<"completed">;
+                    usage: Type.TObject<{
+                        input: Type.TNumber;
+                        output: Type.TNumber;
+                        cacheRead: Type.TNumber;
+                        cacheWrite: Type.TNumber;
+                        reasoning: Type.TUnion<[Type.TNumber, Type.TNull]>;
+                        total: Type.TNumber;
+                        cost: Type.TObject<{
+                            input: Type.TNumber;
+                            output: Type.TNumber;
+                            cacheRead: Type.TNumber;
+                            cacheWrite: Type.TNumber;
+                            total: Type.TNumber;
+                        }>;
+                    }>;
+                }>, Type.TObject<{
+                    kind: Type.TLiteral<"stopped">;
+                }>, Type.TObject<{
+                    kind: Type.TLiteral<"failed">;
+                    failure: Type.TObject<{
+                        class: Type.TEnum<["rate_limit", "auth", "quota", "context_window", "overloaded", "network", "aborted", "provider", "runner"]>;
+                        message: Type.TString;
+                        retryAfterMs: Type.TOptional<Type.TNumber>;
+                    }>;
+                }>]>;
+                endedAt: Type.TNumber;
+            }>, Type.TNull]>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"live">;
+            run: Type.TObject<{
+                id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+                head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+                startedAt: Type.TNumber;
+                attempt: Type.TNumber;
+                configuration: Type.TObject<{
+                    kind: Type.TLiteral<"exact">;
+                    model: Type.TObject<{
+                        provider: Type.TString;
+                        id: Type.TString;
+                    }>;
+                    thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                    agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                    settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                    settingsVersion: Type.TString;
+                }>;
+                origin: Type.TUnion<[Type.TObject<{
+                    kind: Type.TLiteral<"input">;
+                    message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+                }>, Type.TObject<{
+                    kind: Type.TLiteral<"continuation">;
+                    from: Type.TEnum<["child", "job", "wake"]>;
+                }>]>;
+            }>;
+            phase: Type.TEnum<["responding", "executing"]>;
+            stopping: Type.TBoolean;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"waiting">;
+            run: Type.TObject<{
+                id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+                head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+                startedAt: Type.TNumber;
+                attempt: Type.TNumber;
+                configuration: Type.TObject<{
+                    kind: Type.TLiteral<"exact">;
+                    model: Type.TObject<{
+                        provider: Type.TString;
+                        id: Type.TString;
+                    }>;
+                    thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                    agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                    settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                    settingsVersion: Type.TString;
+                }>;
+                origin: Type.TUnion<[Type.TObject<{
+                    kind: Type.TLiteral<"input">;
+                    message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+                }>, Type.TObject<{
+                    kind: Type.TLiteral<"continuation">;
+                    from: Type.TEnum<["child", "job", "wake"]>;
+                }>]>;
+            }>;
+            on: Type.TUnion<[Type.TObject<{
+                kind: Type.TLiteral<"run">;
+                session: Type.TUnsafe<import("./ids.ts").Id<"session">>;
+                run: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+                deadline: Type.TOptional<Type.TNumber>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"job">;
+                job: Type.TUnsafe<import("./ids.ts").Id<"job">>;
+                deadline: Type.TOptional<Type.TNumber>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"part">;
+                part: Type.TUnsafe<import("./ids.ts").Id<"part">>;
+                deadline: Type.TOptional<Type.TNumber>;
+            }>, Type.TObject<{
+                kind: Type.TLiteral<"timer">;
+                until: Type.TNumber;
+                deadline: Type.TOptional<Type.TNumber>;
+            }>]>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"retrying">;
+            run: Type.TObject<{
+                id: Type.TUnsafe<import("./ids.ts").Id<"run">>;
+                head: Type.TUnsafe<import("./ids.ts").Id<"head">>;
+                startedAt: Type.TNumber;
+                attempt: Type.TNumber;
+                configuration: Type.TObject<{
+                    kind: Type.TLiteral<"exact">;
+                    model: Type.TObject<{
+                        provider: Type.TString;
+                        id: Type.TString;
+                    }>;
+                    thinking: Type.TEnum<["off", "minimal", "low", "medium", "high", "xhigh", "max"]>;
+                    agent: Type.TUnion<[Type.TString, Type.TNull]>;
+                    settings: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+                    settingsVersion: Type.TString;
+                }>;
+                origin: Type.TUnion<[Type.TObject<{
+                    kind: Type.TLiteral<"input">;
+                    message: Type.TUnsafe<import("./ids.ts").Id<"message">>;
+                }>, Type.TObject<{
+                    kind: Type.TLiteral<"continuation">;
+                    from: Type.TEnum<["child", "job", "wake"]>;
+                }>]>;
+            }>;
+            until: Type.TNumber;
+            reason: Type.TString;
+        }>]>;
+        unread: Type.TBoolean;
+    }>>;
+    createdAt: Type.TNumber;
+    lastActivityAt: Type.TNumber;
+}>;
+export type SessionInfo = Decoded<typeof SessionInfoType>;
+/**
+ * The slash names Nyte's own clients keep for their built-in commands and
+ * aliases. The host refuses a plugin command that takes one, so a client never
+ * hides it behind its own.
+ */
+export declare const CLIENT_COMMAND_NAMES: readonly ["accounts", "cd", "compact", "continue", "edit", "help", "login", "logout", "mcp", "new", "plugins", "pr", "quit", "reload", "resume", "sessions", "settings", "skills", "tasks", "tree", "trust", "update", "usage"];
+export type ClientCommandName = (typeof CLIENT_COMMAND_NAMES)[number];
+/** A name a user can type after `/` in every client: lowercase ASCII letters, digits and `-`, not starting with `-`. */
+export declare const COMMAND_NAME: RegExp;
+export declare const CommandInfoType: Type.TObject<{
+    name: Type.TString;
+    owner: Type.TString;
+    side: Type.TEnum<["core", "client"]>;
+    title: Type.TString;
+    description: Type.TString;
+    /** Picking the command waits for text after its name instead of running it at once. */
+    takesText: Type.TBoolean;
+    /** The command suggests that text: ask `completeCommand` as it is typed. */
+    completes: Type.TBoolean;
+    category: Type.TOptional<Type.TString>;
+    keywords: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export type CommandInfo = Decoded<typeof CommandInfoType>;
+/** One suggestion for the text after a command's name: picking it replaces that text with `value`. */
+export declare const CommandCompletionType: Type.TObject<{
+    value: Type.TString;
+    label: Type.TString;
+    description: Type.TOptional<Type.TString>;
+}>;
+export type CommandCompletion = Decoded<typeof CommandCompletionType>;
+export declare const SettingInfoType: Type.TObject<{
+    id: Type.TString;
+    owner: Type.TString;
+    scope: Type.TEnum<["host", "session"]>;
+    label: Type.TString;
+    schema: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+    choices: Type.TUnion<[Type.TArray<Type.TObject<{
+        value: Type.TUnsafe<import("./json.ts").Json>;
+        label: Type.TString;
+        badge: Type.TOptional<Type.TString>;
+    }>>, Type.TNull]>;
+    value: Type.TUnsafe<import("./json.ts").Json>;
+    from: Type.TEnum<["default", "host", "session"]>;
+}>;
+export type SettingInfo = Decoded<typeof SettingInfoType>;
+export declare const SkillInfoType: Type.TObject<{
+    name: Type.TString;
+    owner: Type.TString;
+    description: Type.TString;
+    location: Type.TString;
+}>;
+export type SkillInfo = Decoded<typeof SkillInfoType>;
+export declare const AgentInfoType: Type.TObject<{
+    id: Type.TString;
+    owner: Type.TString;
+    description: Type.TUnion<[Type.TString, Type.TNull]>;
+    model: Type.TUnion<[Type.TObject<{
+        provider: Type.TString;
+        id: Type.TString;
+    }>, Type.TNull]>;
+    mode: Type.TEnum<["primary", "subagent", "all"]>;
+}>;
+export type AgentInfo = Decoded<typeof AgentInfoType>;
+export declare const ToolInfoType: Type.TObject<{
+    name: Type.TString;
+    owner: Type.TString;
+    namespace: Type.TUnion<[Type.TString, Type.TNull]>;
+    description: Type.TString;
+    parameters: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+    output: Type.TUnion<[Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>, Type.TNull]>;
+    exposure: Type.TEnum<["model", "deferred", "code", "hidden"]>;
+}>;
+export type ToolInfo = Decoded<typeof ToolInfoType>;
+export declare const SessionCatalogViewType: Type.TObject<{
+    commands: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        owner: Type.TString;
+        side: Type.TEnum<["core", "client"]>;
+        title: Type.TString;
+        description: Type.TString;
+        /** Picking the command waits for text after its name instead of running it at once. */
+        takesText: Type.TBoolean;
+        /** The command suggests that text: ask `completeCommand` as it is typed. */
+        completes: Type.TBoolean;
+        category: Type.TOptional<Type.TString>;
+        keywords: Type.TOptional<Type.TArray<Type.TString>>;
+    }>>;
+    settings: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        owner: Type.TString;
+        scope: Type.TEnum<["host", "session"]>;
+        label: Type.TString;
+        schema: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+        choices: Type.TUnion<[Type.TArray<Type.TObject<{
+            value: Type.TUnsafe<import("./json.ts").Json>;
+            label: Type.TString;
+            badge: Type.TOptional<Type.TString>;
+        }>>, Type.TNull]>;
+        value: Type.TUnsafe<import("./json.ts").Json>;
+        from: Type.TEnum<["default", "host", "session"]>;
+    }>>;
+    skills: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        owner: Type.TString;
+        description: Type.TString;
+        location: Type.TString;
+    }>>;
+    agents: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        owner: Type.TString;
+        description: Type.TUnion<[Type.TString, Type.TNull]>;
+        model: Type.TUnion<[Type.TObject<{
+            provider: Type.TString;
+            id: Type.TString;
+        }>, Type.TNull]>;
+        mode: Type.TEnum<["primary", "subagent", "all"]>;
+    }>>;
+    tools: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        owner: Type.TString;
+        namespace: Type.TUnion<[Type.TString, Type.TNull]>;
+        description: Type.TString;
+        parameters: Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>;
+        output: Type.TUnion<[Type.TRecord<"^.*$", Type.TUnsafe<import("./json.ts").Json>>, Type.TNull]>;
+        exposure: Type.TEnum<["model", "deferred", "code", "hidden"]>;
+    }>>;
+}>;
+export type SessionCatalogView = Decoded<typeof SessionCatalogViewType>;
+/** What a new chat in a workspace would offer before it exists: its plugin commands and skills. */
+export declare const WorkspaceCatalogViewType: Type.TObject<{
+    commands: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        owner: Type.TString;
+        side: Type.TEnum<["core", "client"]>;
+        title: Type.TString;
+        description: Type.TString;
+        /** Picking the command waits for text after its name instead of running it at once. */
+        takesText: Type.TBoolean;
+        /** The command suggests that text: ask `completeCommand` as it is typed. */
+        completes: Type.TBoolean;
+        category: Type.TOptional<Type.TString>;
+        keywords: Type.TOptional<Type.TArray<Type.TString>>;
+    }>>;
+    skills: Type.TArray<Type.TObject<{
+        name: Type.TString;
+        owner: Type.TString;
+        description: Type.TString;
+        location: Type.TString;
+    }>>;
+}>;
+export type WorkspaceCatalogView = Decoded<typeof WorkspaceCatalogViewType>;
+export declare const CommandOutcomeType: Type.TUnion<[Type.TObject<{
+    kind: Type.TLiteral<"ran">;
+    output: Type.TUnion<[Type.TString, Type.TNull]>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"sent">;
+    receipt: Type.TUnsafe<import("./ids.ts").Id<"receipt">>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"unknown">;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"failed">;
+    message: Type.TString;
+}>]>;
+export type CommandOutcome = Decoded<typeof CommandOutcomeType>;
+/** What a command run outside any chat did: `prompt` is the first message of the chat it asks to start. */
+export declare const WorkspaceCommandOutcomeType: Type.TUnion<[Type.TObject<{
+    kind: Type.TLiteral<"ran">;
+    output: Type.TUnion<[Type.TString, Type.TNull]>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"prompt">;
+    content: Type.TUnion<[Type.TString, Type.TArray<Type.TUnion<[Type.TObject<{
+        kind: Type.TLiteral<"text">;
+        text: Type.TString;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"file">;
+        blob: Type.TUnsafe<import("./ids.ts").Id<"blob">>;
+        mime: Type.TString;
+        name: Type.TString;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"reference">;
+        path: Type.TString;
+        blob: Type.TOptional<Type.TUnsafe<import("./ids.ts").Id<"blob">>>;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"skill">;
+        name: Type.TString;
+        location: Type.TString;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"excerpt">;
+        source: Type.TUnion<[Type.TObject<{
+            kind: Type.TLiteral<"diff">;
+            path: Type.TString;
+            side: Type.TEnum<["old", "new"]>;
+            start: Type.TNumber;
+            end: Type.TNumber;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"terminal">;
+            command: Type.TOptional<Type.TString>;
+        }>, Type.TObject<{
+            kind: Type.TLiteral<"browser">;
+            url: Type.TString;
+            selector: Type.TString;
+        }>]>;
+        text: Type.TString;
+    }>]>>]>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"unknown">;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"failed">;
+    message: Type.TString;
+}>]>;
+export type WorkspaceCommandOutcome = Decoded<typeof WorkspaceCommandOutcomeType>;
+export declare const UpdateOutcomeType: Type.TUnion<[Type.TObject<{
+    kind: Type.TLiteral<"updated">;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"busy">;
+    runs: Type.TArray<Type.TUnsafe<import("./ids.ts").Id<"run">>>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"unknown-workspace">;
+}>]>;
+export type UpdateOutcome = Decoded<typeof UpdateOutcomeType>;
+export declare const RemoveSessionOutcomeType: Type.TUnion<[Type.TObject<{
+    kind: Type.TLiteral<"removed">;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"busy">;
+    runs: Type.TArray<Type.TUnsafe<import("./ids.ts").Id<"run">>>;
+}>, Type.TObject<{
+    kind: Type.TLiteral<"has-children">;
+    children: Type.TArray<Type.TUnsafe<import("./ids.ts").Id<"session">>>;
+}>]>;
+export type RemoveSessionOutcome = Decoded<typeof RemoveSessionOutcomeType>;
+export declare const HeadInfoSchema: Schema<HeadInfo>;
+export declare const SessionInfoSchema: Schema<SessionInfo>;
+export declare const CommandInfoSchema: Schema<CommandInfo>;
+export declare const SettingInfoSchema: Schema<SettingInfo>;
+export declare const SkillInfoSchema: Schema<SkillInfo>;
+export declare const AgentInfoSchema: Schema<AgentInfo>;
+export declare const ToolInfoSchema: Schema<ToolInfo>;
+export declare const SessionCatalogViewSchema: Schema<SessionCatalogView>;
+export declare const CommandOutcomeSchema: Schema<CommandOutcome>;
+export declare const CommandCompletionsSchema: Schema<readonly CommandCompletion[]>;
+export declare const WorkspaceCommandOutcomeSchema: Schema<WorkspaceCommandOutcome>;
+export declare const UpdateOutcomeSchema: Schema<UpdateOutcome>;
+export declare const RemoveSessionOutcomeSchema: Schema<RemoveSessionOutcome>;