@ikenga/contract 0.17.0 → 0.18.0

package/dist/ngwa.d.ts

@@ -0,0 +1,1650 @@
+import { z } from 'zod';
+/** Eleven kinds — two more than D-02's locked Kind facet. `bundle` and
+ *  `sidecar` are real in the code (`Kind::Bundle`, `SidecarSpec`) and reachable
+ *  through *More filters*; `workflow` has no producer in Phase 2 (Phase 4 /
+ *  G-MANIFEST-V5) but stays in the union so adding one is not a contract break.
+ *  `project` and `artifact` from the older `ngwa-surface.html` are NOT here —
+ *  neither is in the locked facet list and neither has a producer. */
+export declare const NGWA_KINDS: readonly ["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"];
+export declare const NgwaKindSchema: z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>;
+export type NgwaKind = (typeof NGWA_KINDS)[number];
+/** `personal` is the kernel's `project_id: null` and Ọba's `workspace`. */
+export declare const NgwaScopeSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"personal">;
+}, "strip", z.ZodTypeAny, {
+    kind: "personal";
+}, {
+    kind: "personal";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"project">;
+    project_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "project";
+    project_id: string;
+}, {
+    kind: "project";
+    project_id: string;
+}>]>;
+export type NgwaScope = z.infer<typeof NgwaScopeSchema>;
+/** The union of the kernel's `InstallSource` (`builtin`/`registry`/`local`/
+ *  `dev`) and Ọba's `ProvenanceSource` (`local`/`git`/`npx`/`catalog`). */
+export declare const NGWA_SOURCES: readonly ["builtin", "registry", "git", "npx", "local", "dev", "catalog"];
+export declare const NgwaSourceSchema: z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>;
+export type NgwaSource = z.infer<typeof NgwaSourceSchema>;
+/** Provenance. The plan's single `source` string could not hold the url / ref /
+ *  resolved version / publisher both provenance records carry, so it became an
+ *  object; `origin.source` is the facet value. */
+export declare const NgwaOriginSchema: z.ZodObject<{
+    source: z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>;
+    /** registry url | git remote | npm spec */
+    url: z.ZodNullable<z.ZodString>;
+    /** git ref */
+    ref: z.ZodNullable<z.ZodString>;
+    /** git SHA | npm version */
+    resolved_version: z.ZodNullable<z.ZodString>;
+    /** `InstallSource::Registry.publisher_key`, or catalog publisher */
+    publisher: z.ZodNullable<z.ZodString>;
+    /** vault-owned and deletable (Ọba `managed`) */
+    managed: z.ZodBoolean;
+    auto_update: z.ZodBoolean;
+    installed_at_ms: z.ZodNullable<z.ZodNumber>;
+    updated_at_ms: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    url: string | null;
+    ref: string | null;
+    source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+    resolved_version: string | null;
+    publisher: string | null;
+    managed: boolean;
+    auto_update: boolean;
+    installed_at_ms: number | null;
+    updated_at_ms: number | null;
+}, {
+    url: string | null;
+    ref: string | null;
+    source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+    resolved_version: string | null;
+    publisher: string | null;
+    managed: boolean;
+    auto_update: boolean;
+    installed_at_ms: number | null;
+    updated_at_ms: number | null;
+}>;
+export type NgwaOrigin = z.infer<typeof NgwaOriginSchema>;
+export declare const NGWA_STATES: readonly ["enabled", "disabled", "available", "update", "orphaned", "broken"];
+export declare const NgwaStateSchema: z.ZodEnum<["enabled", "disabled", "available", "update", "orphaned", "broken"]>;
+export type NgwaState = z.infer<typeof NgwaStateSchema>;
+/** Live supervisor state. Only long-lived sidecars / MCP servers have one.
+ *  Read from `sidecar_supervisor` directly — `PkgRowV2.state` never does, which
+ *  is drift §10.5 that this type fixes for the new surface. */
+export declare const NgwaRuntimeSchema: z.ZodObject<{
+    state: z.ZodEnum<["spawning", "running", "crashed", "blocked", "parked", "stopped", "shuttingdown"]>;
+    pid: z.ZodNullable<z.ZodNumber>;
+    uptime_s: z.ZodNullable<z.ZodNumber>;
+    restarts: z.ZodNumber;
+    last_err: z.ZodNullable<z.ZodString>;
+    last_crash_ms: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+    pid: number | null;
+    uptime_s: number | null;
+    restarts: number;
+    last_err: string | null;
+    last_crash_ms: number | null;
+}, {
+    state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+    pid: number | null;
+    uptime_s: number | null;
+    restarts: number;
+    last_err: string | null;
+    last_crash_ms: number | null;
+}>;
+export type NgwaRuntime = z.infer<typeof NgwaRuntimeSchema>;
+/** The four sorted permission lists the trust snapshot hash is taken over
+ *  (`trust.rs:61-67`, `159-182`). All-or-nothing: no per-permission row exists
+ *  anywhere, which is the constraint WP-18 inherits. */
+export declare const NgwaPermsSummarySchema: z.ZodObject<{
+    shell_execute: z.ZodArray<z.ZodString, "many">;
+    fs_write_outside_sandbox: z.ZodArray<z.ZodString, "many">;
+    net: z.ZodArray<z.ZodString, "many">;
+    vault_keys: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    net: string[];
+    shell_execute: string[];
+    fs_write_outside_sandbox: string[];
+    vault_keys: string[];
+}, {
+    net: string[];
+    shell_execute: string[];
+    fs_write_outside_sandbox: string[];
+    vault_keys: string[];
+}>;
+export type NgwaPermsSummary = z.infer<typeof NgwaPermsSummarySchema>;
+/** Two distinct trust systems exist and must not be conflated: `pkg/trust.rs`
+ *  is the per-call sensitive-permission gate (`state`), `commands/pkg_trust.rs`
+ *  is the separate boot-time capability-diff review (`review_pending`). The
+ *  D-02 facet values are derived, not read off one enum:
+ *  `builtin` ← `auto_trusted`; `signed` ← `signed`; `unsigned` ← `!signed &&
+ *  state !== 'needs_approval'`; `review` ← `state === 'needs_approval' ||
+ *  review_pending`. Ọba primitives get `state: 'not_applicable'`, `perms: null`
+ *  — a skill declares intent and is never granted anything. */
+export declare const NgwaTrustSchema: z.ZodObject<{
+    /** Mirrors PkgTrustState; 'not_applicable' for everything that is not a pkg. */
+    state: z.ZodEnum<["auto_trusted", "auto_granted", "granted", "needs_approval", "not_applicable"]>;
+    /** manifest `signature` present, or minisign-verified catalog entry */
+    signed: z.ZodBoolean;
+    /** provenance-trusted (builtin / dev) */
+    auto_trusted: z.ZodBoolean;
+    /** a TrustReview row is waiting (pkg_trust.rs) */
+    review_pending: z.ZodBoolean;
+    /** null when state is 'not_applicable' */
+    perms: z.ZodNullable<z.ZodObject<{
+        shell_execute: z.ZodArray<z.ZodString, "many">;
+        fs_write_outside_sandbox: z.ZodArray<z.ZodString, "many">;
+        net: z.ZodArray<z.ZodString, "many">;
+        vault_keys: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        net: string[];
+        shell_execute: string[];
+        fs_write_outside_sandbox: string[];
+        vault_keys: string[];
+    }, {
+        net: string[];
+        shell_execute: string[];
+        fs_write_outside_sandbox: string[];
+        vault_keys: string[];
+    }>>;
+    last_granted_at_ms: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+    auto_trusted: boolean;
+    signed: boolean;
+    review_pending: boolean;
+    perms: {
+        net: string[];
+        shell_execute: string[];
+        fs_write_outside_sandbox: string[];
+        vault_keys: string[];
+    } | null;
+    last_granted_at_ms: number | null;
+}, {
+    state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+    auto_trusted: boolean;
+    signed: boolean;
+    review_pending: boolean;
+    perms: {
+        net: string[];
+        shell_execute: string[];
+        fs_write_outside_sandbox: string[];
+        vault_keys: string[];
+    } | null;
+    last_granted_at_ms: number | null;
+}>;
+export type NgwaTrust = z.infer<typeof NgwaTrustSchema>;
+/** The real per-instance placement record, sourced primarily from the
+ *  `claude_config` scan; `engine_assets` is a second contributor that marks a
+ *  placement `managed_by: 'pkg'`. `present === false` on an `enabled` item is
+ *  the orphan case WP-16 Health reports. */
+export declare const NgwaPlacementSchema: z.ZodObject<{
+    /** 'claude' | 'gemini' | 'codex' | ... */
+    engine: z.ZodString;
+    scope: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"personal">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "personal";
+    }, {
+        kind: "personal";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"project">;
+        project_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "project";
+        project_id: string;
+    }, {
+        kind: "project";
+        project_id: string;
+    }>]>;
+    path: z.ZodString;
+    mechanism: z.ZodEnum<["symlink-dir", "file", "settings-key"]>;
+    /** the target actually exists on disk */
+    present: z.ZodBoolean;
+    link_target: z.ZodNullable<z.ZodString>;
+    /** the link resolves into the Ọba store */
+    in_store: z.ZodBoolean;
+    managed_by: z.ZodEnum<["oba", "pkg", "user"]>;
+    /** path of the placement that shadows this one */
+    overridden_by: z.ZodNullable<z.ZodString>;
+    format: z.ZodNullable<z.ZodEnum<["md-yaml", "toml", "json-embedded"]>>;
+    status: z.ZodEnum<["active", "deprecated"]>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    status: "active" | "deprecated";
+    format: "md-yaml" | "toml" | "json-embedded" | null;
+    engine: string;
+    scope: {
+        kind: "personal";
+    } | {
+        kind: "project";
+        project_id: string;
+    };
+    mechanism: "file" | "symlink-dir" | "settings-key";
+    present: boolean;
+    link_target: string | null;
+    in_store: boolean;
+    managed_by: "user" | "oba" | "pkg";
+    overridden_by: string | null;
+}, {
+    path: string;
+    status: "active" | "deprecated";
+    format: "md-yaml" | "toml" | "json-embedded" | null;
+    engine: string;
+    scope: {
+        kind: "personal";
+    } | {
+        kind: "project";
+        project_id: string;
+    };
+    mechanism: "file" | "symlink-dir" | "settings-key";
+    present: boolean;
+    link_target: string | null;
+    in_store: boolean;
+    managed_by: "user" | "oba" | "pkg";
+    overridden_by: string | null;
+}>;
+export type NgwaPlacement = z.infer<typeof NgwaPlacementSchema>;
+/** null on the item means "never measured" and MUST render as "—", never as 0
+ *  (designs/frame-workbench-v4.html:2679 — "anything not measured reads —").
+ *  Phase 2 sources this from transcript JSONL (DEC-24); `'hooks'` stays a legal
+ *  value so a later increment can add it — principally for `hook` rows, which
+ *  the transcript cannot see at all — without reopening the gate. */
+export declare const NgwaUsageSchema: z.ZodObject<{
+    source: z.ZodEnum<["hooks", "transcript"]>;
+    last_used_ms: z.ZodNullable<z.ZodNumber>;
+    count_7d: z.ZodNullable<z.ZodNumber>;
+    count_30d: z.ZodNullable<z.ZodNumber>;
+    /** null when the chosen source carries no tokens */
+    tokens_30d: z.ZodNullable<z.ZodNumber>;
+    /** Earliest moment the source can see. Anything before it is unknown, not zero. */
+    window_start_ms: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    source: "hooks" | "transcript";
+    last_used_ms: number | null;
+    count_7d: number | null;
+    count_30d: number | null;
+    tokens_30d: number | null;
+    window_start_ms: number;
+}, {
+    source: "hooks" | "transcript";
+    last_used_ms: number | null;
+    count_7d: number | null;
+    count_30d: number | null;
+    tokens_30d: number | null;
+    window_start_ms: number;
+}>;
+export type NgwaUsage = z.infer<typeof NgwaUsageSchema>;
+export declare const NgwaRefSchema: z.ZodObject<{
+    /** open, mirroring RequiresEntry.kind (manifest.rs:177-192) */
+    kind: z.ZodUnion<[z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>, z.ZodString]>;
+    name: z.ZodString;
+    /** resolved NgwaItem.id, or null if unresolved */
+    item_id: z.ZodNullable<z.ZodString>;
+    source: z.ZodNullable<z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>>;
+    ref: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    name: string;
+    ref: string | null;
+    source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+    item_id: string | null;
+}, {
+    kind: string;
+    name: string;
+    ref: string | null;
+    source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+    item_id: string | null;
+}>;
+export type NgwaRef = z.infer<typeof NgwaRefSchema>;
+export declare const NgwaItemSchema: z.ZodObject<{
+    /** Stable across a refresh. Pkg-backed: the manifest id. Everything else:
+     *  `${kind}:${scope_key}:${name}` where scope_key is 'personal' | `project:<id>`. */
+    id: z.ZodString;
+    kind: z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>;
+    /** the on-disk / manifest name (stable, used for joins) */
+    name: z.ZodString;
+    /** manifest `name`, else `name` */
+    display_name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    /** null for Ọba primitives with no resolved version */
+    version: z.ZodNullable<z.ZodString>;
+    /** registry index only; null otherwise */
+    latest_version: z.ZodNullable<z.ZodString>;
+    scope: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"personal">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "personal";
+    }, {
+        kind: "personal";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"project">;
+        project_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "project";
+        project_id: string;
+    }, {
+        kind: "project";
+        project_id: string;
+    }>]>;
+    origin: z.ZodObject<{
+        source: z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>;
+        /** registry url | git remote | npm spec */
+        url: z.ZodNullable<z.ZodString>;
+        /** git ref */
+        ref: z.ZodNullable<z.ZodString>;
+        /** git SHA | npm version */
+        resolved_version: z.ZodNullable<z.ZodString>;
+        /** `InstallSource::Registry.publisher_key`, or catalog publisher */
+        publisher: z.ZodNullable<z.ZodString>;
+        /** vault-owned and deletable (Ọba `managed`) */
+        managed: z.ZodBoolean;
+        auto_update: z.ZodBoolean;
+        installed_at_ms: z.ZodNullable<z.ZodNumber>;
+        updated_at_ms: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        url: string | null;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+        resolved_version: string | null;
+        publisher: string | null;
+        managed: boolean;
+        auto_update: boolean;
+        installed_at_ms: number | null;
+        updated_at_ms: number | null;
+    }, {
+        url: string | null;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+        resolved_version: string | null;
+        publisher: string | null;
+        managed: boolean;
+        auto_update: boolean;
+        installed_at_ms: number | null;
+        updated_at_ms: number | null;
+    }>;
+    state: z.ZodEnum<["enabled", "disabled", "available", "update", "orphaned", "broken"]>;
+    runtime: z.ZodNullable<z.ZodObject<{
+        state: z.ZodEnum<["spawning", "running", "crashed", "blocked", "parked", "stopped", "shuttingdown"]>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        uptime_s: z.ZodNullable<z.ZodNumber>;
+        restarts: z.ZodNumber;
+        last_err: z.ZodNullable<z.ZodString>;
+        last_crash_ms: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+        pid: number | null;
+        uptime_s: number | null;
+        restarts: number;
+        last_err: string | null;
+        last_crash_ms: number | null;
+    }, {
+        state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+        pid: number | null;
+        uptime_s: number | null;
+        restarts: number;
+        last_err: string | null;
+        last_crash_ms: number | null;
+    }>>;
+    trust: z.ZodObject<{
+        /** Mirrors PkgTrustState; 'not_applicable' for everything that is not a pkg. */
+        state: z.ZodEnum<["auto_trusted", "auto_granted", "granted", "needs_approval", "not_applicable"]>;
+        /** manifest `signature` present, or minisign-verified catalog entry */
+        signed: z.ZodBoolean;
+        /** provenance-trusted (builtin / dev) */
+        auto_trusted: z.ZodBoolean;
+        /** a TrustReview row is waiting (pkg_trust.rs) */
+        review_pending: z.ZodBoolean;
+        /** null when state is 'not_applicable' */
+        perms: z.ZodNullable<z.ZodObject<{
+            shell_execute: z.ZodArray<z.ZodString, "many">;
+            fs_write_outside_sandbox: z.ZodArray<z.ZodString, "many">;
+            net: z.ZodArray<z.ZodString, "many">;
+            vault_keys: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        }, {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        }>>;
+        last_granted_at_ms: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+        auto_trusted: boolean;
+        signed: boolean;
+        review_pending: boolean;
+        perms: {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        } | null;
+        last_granted_at_ms: number | null;
+    }, {
+        state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+        auto_trusted: boolean;
+        signed: boolean;
+        review_pending: boolean;
+        perms: {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        } | null;
+        last_granted_at_ms: number | null;
+    }>;
+    /** An item with no placements is not an error: a pkg app has none. */
+    placements: z.ZodArray<z.ZodObject<{
+        /** 'claude' | 'gemini' | 'codex' | ... */
+        engine: z.ZodString;
+        scope: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"personal">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "personal";
+        }, {
+            kind: "personal";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            project_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "project";
+            project_id: string;
+        }, {
+            kind: "project";
+            project_id: string;
+        }>]>;
+        path: z.ZodString;
+        mechanism: z.ZodEnum<["symlink-dir", "file", "settings-key"]>;
+        /** the target actually exists on disk */
+        present: z.ZodBoolean;
+        link_target: z.ZodNullable<z.ZodString>;
+        /** the link resolves into the Ọba store */
+        in_store: z.ZodBoolean;
+        managed_by: z.ZodEnum<["oba", "pkg", "user"]>;
+        /** path of the placement that shadows this one */
+        overridden_by: z.ZodNullable<z.ZodString>;
+        format: z.ZodNullable<z.ZodEnum<["md-yaml", "toml", "json-embedded"]>>;
+        status: z.ZodEnum<["active", "deprecated"]>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        status: "active" | "deprecated";
+        format: "md-yaml" | "toml" | "json-embedded" | null;
+        engine: string;
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        mechanism: "file" | "symlink-dir" | "settings-key";
+        present: boolean;
+        link_target: string | null;
+        in_store: boolean;
+        managed_by: "user" | "oba" | "pkg";
+        overridden_by: string | null;
+    }, {
+        path: string;
+        status: "active" | "deprecated";
+        format: "md-yaml" | "toml" | "json-embedded" | null;
+        engine: string;
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        mechanism: "file" | "symlink-dir" | "settings-key";
+        present: boolean;
+        link_target: string | null;
+        in_store: boolean;
+        managed_by: "user" | "oba" | "pkg";
+        overridden_by: string | null;
+    }>, "many">;
+    /** null = unmeasured. A measured zero is `{ count_7d: 0, … }`; the UI must
+     *  distinguish them. */
+    usage: z.ZodNullable<z.ZodObject<{
+        source: z.ZodEnum<["hooks", "transcript"]>;
+        last_used_ms: z.ZodNullable<z.ZodNumber>;
+        count_7d: z.ZodNullable<z.ZodNumber>;
+        count_30d: z.ZodNullable<z.ZodNumber>;
+        /** null when the chosen source carries no tokens */
+        tokens_30d: z.ZodNullable<z.ZodNumber>;
+        /** Earliest moment the source can see. Anything before it is unknown, not zero. */
+        window_start_ms: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        source: "hooks" | "transcript";
+        last_used_ms: number | null;
+        count_7d: number | null;
+        count_30d: number | null;
+        tokens_30d: number | null;
+        window_start_ms: number;
+    }, {
+        source: "hooks" | "transcript";
+        last_used_ms: number | null;
+        count_7d: number | null;
+        count_30d: number | null;
+        tokens_30d: number | null;
+        window_start_ms: number;
+    }>>;
+    requires: z.ZodArray<z.ZodObject<{
+        /** open, mirroring RequiresEntry.kind (manifest.rs:177-192) */
+        kind: z.ZodUnion<[z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>, z.ZodString]>;
+        name: z.ZodString;
+        /** resolved NgwaItem.id, or null if unresolved */
+        item_id: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>>;
+        ref: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }, {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }>, "many">;
+    /** Computed per snapshot by inverting `requires[]`, never stored — Ọba
+     *  deliberately does not persist the reverse graph (claude_store.rs:120-122). */
+    required_by: z.ZodArray<z.ZodObject<{
+        /** open, mirroring RequiresEntry.kind (manifest.rs:177-192) */
+        kind: z.ZodUnion<[z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>, z.ZodString]>;
+        name: z.ZodString;
+        /** resolved NgwaItem.id, or null if unresolved */
+        item_id: z.ZodNullable<z.ZodString>;
+        source: z.ZodNullable<z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>>;
+        ref: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }, {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }>, "many">;
+    /** The pkg that contributed this item, when it is not itself a pkg. */
+    owner_pkg_id: z.ZodNullable<z.ZodString>;
+    install_path: z.ZodNullable<z.ZodString>;
+    /** Engines this item is placed in, derived from placements[]. Facet source. */
+    engines: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+    name: string;
+    description: string | null;
+    id: string;
+    version: string | null;
+    requires: {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }[];
+    usage: {
+        source: "hooks" | "transcript";
+        last_used_ms: number | null;
+        count_7d: number | null;
+        count_30d: number | null;
+        tokens_30d: number | null;
+        window_start_ms: number;
+    } | null;
+    engines: string[];
+    state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+    scope: {
+        kind: "personal";
+    } | {
+        kind: "project";
+        project_id: string;
+    };
+    display_name: string;
+    latest_version: string | null;
+    origin: {
+        url: string | null;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+        resolved_version: string | null;
+        publisher: string | null;
+        managed: boolean;
+        auto_update: boolean;
+        installed_at_ms: number | null;
+        updated_at_ms: number | null;
+    };
+    runtime: {
+        state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+        pid: number | null;
+        uptime_s: number | null;
+        restarts: number;
+        last_err: string | null;
+        last_crash_ms: number | null;
+    } | null;
+    trust: {
+        state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+        auto_trusted: boolean;
+        signed: boolean;
+        review_pending: boolean;
+        perms: {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        } | null;
+        last_granted_at_ms: number | null;
+    };
+    placements: {
+        path: string;
+        status: "active" | "deprecated";
+        format: "md-yaml" | "toml" | "json-embedded" | null;
+        engine: string;
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        mechanism: "file" | "symlink-dir" | "settings-key";
+        present: boolean;
+        link_target: string | null;
+        in_store: boolean;
+        managed_by: "user" | "oba" | "pkg";
+        overridden_by: string | null;
+    }[];
+    required_by: {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }[];
+    owner_pkg_id: string | null;
+    install_path: string | null;
+}, {
+    kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+    name: string;
+    description: string | null;
+    id: string;
+    version: string | null;
+    requires: {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }[];
+    usage: {
+        source: "hooks" | "transcript";
+        last_used_ms: number | null;
+        count_7d: number | null;
+        count_30d: number | null;
+        tokens_30d: number | null;
+        window_start_ms: number;
+    } | null;
+    engines: string[];
+    state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+    scope: {
+        kind: "personal";
+    } | {
+        kind: "project";
+        project_id: string;
+    };
+    display_name: string;
+    latest_version: string | null;
+    origin: {
+        url: string | null;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+        resolved_version: string | null;
+        publisher: string | null;
+        managed: boolean;
+        auto_update: boolean;
+        installed_at_ms: number | null;
+        updated_at_ms: number | null;
+    };
+    runtime: {
+        state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+        pid: number | null;
+        uptime_s: number | null;
+        restarts: number;
+        last_err: string | null;
+        last_crash_ms: number | null;
+    } | null;
+    trust: {
+        state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+        auto_trusted: boolean;
+        signed: boolean;
+        review_pending: boolean;
+        perms: {
+            net: string[];
+            shell_execute: string[];
+            fs_write_outside_sandbox: string[];
+            vault_keys: string[];
+        } | null;
+        last_granted_at_ms: number | null;
+    };
+    placements: {
+        path: string;
+        status: "active" | "deprecated";
+        format: "md-yaml" | "toml" | "json-embedded" | null;
+        engine: string;
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        mechanism: "file" | "symlink-dir" | "settings-key";
+        present: boolean;
+        link_target: string | null;
+        in_store: boolean;
+        managed_by: "user" | "oba" | "pkg";
+        overridden_by: string | null;
+    }[];
+    required_by: {
+        kind: string;
+        name: string;
+        ref: string | null;
+        source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+        item_id: string | null;
+    }[];
+    owner_pkg_id: string | null;
+    install_path: string | null;
+}>;
+export type NgwaItem = z.infer<typeof NgwaItemSchema>;
+/** Per-source health entry, so the UI can say "Ọba unreadable" instead of
+ *  silently rendering "no skills". */
+export declare const NgwaSourceHealthSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    error: z.ZodNullable<z.ZodString>;
+    count: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    error: string | null;
+    count: number;
+}, {
+    ok: boolean;
+    error: string | null;
+    count: number;
+}>;
+export type NgwaSourceHealth = z.infer<typeof NgwaSourceHealthSchema>;
+export declare const NgwaSnapshotSchema: z.ZodObject<{
+    /** `id` is unique within a snapshot; WP-14 asserts uniqueness. */
+    items: z.ZodArray<z.ZodObject<{
+        /** Stable across a refresh. Pkg-backed: the manifest id. Everything else:
+         *  `${kind}:${scope_key}:${name}` where scope_key is 'personal' | `project:<id>`. */
+        id: z.ZodString;
+        kind: z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>;
+        /** the on-disk / manifest name (stable, used for joins) */
+        name: z.ZodString;
+        /** manifest `name`, else `name` */
+        display_name: z.ZodString;
+        description: z.ZodNullable<z.ZodString>;
+        /** null for Ọba primitives with no resolved version */
+        version: z.ZodNullable<z.ZodString>;
+        /** registry index only; null otherwise */
+        latest_version: z.ZodNullable<z.ZodString>;
+        scope: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"personal">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "personal";
+        }, {
+            kind: "personal";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"project">;
+            project_id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "project";
+            project_id: string;
+        }, {
+            kind: "project";
+            project_id: string;
+        }>]>;
+        origin: z.ZodObject<{
+            source: z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>;
+            /** registry url | git remote | npm spec */
+            url: z.ZodNullable<z.ZodString>;
+            /** git ref */
+            ref: z.ZodNullable<z.ZodString>;
+            /** git SHA | npm version */
+            resolved_version: z.ZodNullable<z.ZodString>;
+            /** `InstallSource::Registry.publisher_key`, or catalog publisher */
+            publisher: z.ZodNullable<z.ZodString>;
+            /** vault-owned and deletable (Ọba `managed`) */
+            managed: z.ZodBoolean;
+            auto_update: z.ZodBoolean;
+            installed_at_ms: z.ZodNullable<z.ZodNumber>;
+            updated_at_ms: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        }, {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        }>;
+        state: z.ZodEnum<["enabled", "disabled", "available", "update", "orphaned", "broken"]>;
+        runtime: z.ZodNullable<z.ZodObject<{
+            state: z.ZodEnum<["spawning", "running", "crashed", "blocked", "parked", "stopped", "shuttingdown"]>;
+            pid: z.ZodNullable<z.ZodNumber>;
+            uptime_s: z.ZodNullable<z.ZodNumber>;
+            restarts: z.ZodNumber;
+            last_err: z.ZodNullable<z.ZodString>;
+            last_crash_ms: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        }, {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        }>>;
+        trust: z.ZodObject<{
+            /** Mirrors PkgTrustState; 'not_applicable' for everything that is not a pkg. */
+            state: z.ZodEnum<["auto_trusted", "auto_granted", "granted", "needs_approval", "not_applicable"]>;
+            /** manifest `signature` present, or minisign-verified catalog entry */
+            signed: z.ZodBoolean;
+            /** provenance-trusted (builtin / dev) */
+            auto_trusted: z.ZodBoolean;
+            /** a TrustReview row is waiting (pkg_trust.rs) */
+            review_pending: z.ZodBoolean;
+            /** null when state is 'not_applicable' */
+            perms: z.ZodNullable<z.ZodObject<{
+                shell_execute: z.ZodArray<z.ZodString, "many">;
+                fs_write_outside_sandbox: z.ZodArray<z.ZodString, "many">;
+                net: z.ZodArray<z.ZodString, "many">;
+                vault_keys: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            }, {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            }>>;
+            last_granted_at_ms: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        }, {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        }>;
+        /** An item with no placements is not an error: a pkg app has none. */
+        placements: z.ZodArray<z.ZodObject<{
+            /** 'claude' | 'gemini' | 'codex' | ... */
+            engine: z.ZodString;
+            scope: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"personal">;
+            }, "strip", z.ZodTypeAny, {
+                kind: "personal";
+            }, {
+                kind: "personal";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"project">;
+                project_id: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                kind: "project";
+                project_id: string;
+            }, {
+                kind: "project";
+                project_id: string;
+            }>]>;
+            path: z.ZodString;
+            mechanism: z.ZodEnum<["symlink-dir", "file", "settings-key"]>;
+            /** the target actually exists on disk */
+            present: z.ZodBoolean;
+            link_target: z.ZodNullable<z.ZodString>;
+            /** the link resolves into the Ọba store */
+            in_store: z.ZodBoolean;
+            managed_by: z.ZodEnum<["oba", "pkg", "user"]>;
+            /** path of the placement that shadows this one */
+            overridden_by: z.ZodNullable<z.ZodString>;
+            format: z.ZodNullable<z.ZodEnum<["md-yaml", "toml", "json-embedded"]>>;
+            status: z.ZodEnum<["active", "deprecated"]>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }, {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }>, "many">;
+        /** null = unmeasured. A measured zero is `{ count_7d: 0, … }`; the UI must
+         *  distinguish them. */
+        usage: z.ZodNullable<z.ZodObject<{
+            source: z.ZodEnum<["hooks", "transcript"]>;
+            last_used_ms: z.ZodNullable<z.ZodNumber>;
+            count_7d: z.ZodNullable<z.ZodNumber>;
+            count_30d: z.ZodNullable<z.ZodNumber>;
+            /** null when the chosen source carries no tokens */
+            tokens_30d: z.ZodNullable<z.ZodNumber>;
+            /** Earliest moment the source can see. Anything before it is unknown, not zero. */
+            window_start_ms: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        }, {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        }>>;
+        requires: z.ZodArray<z.ZodObject<{
+            /** open, mirroring RequiresEntry.kind (manifest.rs:177-192) */
+            kind: z.ZodUnion<[z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>, z.ZodString]>;
+            name: z.ZodString;
+            /** resolved NgwaItem.id, or null if unresolved */
+            item_id: z.ZodNullable<z.ZodString>;
+            source: z.ZodNullable<z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>>;
+            ref: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }, {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }>, "many">;
+        /** Computed per snapshot by inverting `requires[]`, never stored — Ọba
+         *  deliberately does not persist the reverse graph (claude_store.rs:120-122). */
+        required_by: z.ZodArray<z.ZodObject<{
+            /** open, mirroring RequiresEntry.kind (manifest.rs:177-192) */
+            kind: z.ZodUnion<[z.ZodEnum<["app", "engine", "tool", "sidecar", "skill", "agent", "command", "hook", "bundle", "schedule", "workflow"]>, z.ZodString]>;
+            name: z.ZodString;
+            /** resolved NgwaItem.id, or null if unresolved */
+            item_id: z.ZodNullable<z.ZodString>;
+            source: z.ZodNullable<z.ZodEnum<["builtin", "registry", "git", "npx", "local", "dev", "catalog"]>>;
+            ref: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }, {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }>, "many">;
+        /** The pkg that contributed this item, when it is not itself a pkg. */
+        owner_pkg_id: z.ZodNullable<z.ZodString>;
+        install_path: z.ZodNullable<z.ZodString>;
+        /** Engines this item is placed in, derived from placements[]. Facet source. */
+        engines: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+        name: string;
+        description: string | null;
+        id: string;
+        version: string | null;
+        requires: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        usage: {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        } | null;
+        engines: string[];
+        state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        display_name: string;
+        latest_version: string | null;
+        origin: {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        };
+        runtime: {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        } | null;
+        trust: {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        };
+        placements: {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }[];
+        required_by: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        owner_pkg_id: string | null;
+        install_path: string | null;
+    }, {
+        kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+        name: string;
+        description: string | null;
+        id: string;
+        version: string | null;
+        requires: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        usage: {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        } | null;
+        engines: string[];
+        state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        display_name: string;
+        latest_version: string | null;
+        origin: {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        };
+        runtime: {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        } | null;
+        trust: {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        };
+        placements: {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }[];
+        required_by: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        owner_pkg_id: string | null;
+        install_path: string | null;
+    }>, "many">;
+    as_of_ms: z.ZodNumber;
+    /** Per-source health, so the UI can say "Ọba unreadable" instead of "no skills". */
+    sources: z.ZodObject<{
+        kernel: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+        oba: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+        engine_config: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+        engine_assets: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+        trust: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+        usage: z.ZodObject<{
+            ok: z.ZodBoolean;
+            error: z.ZodNullable<z.ZodString>;
+            count: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }, {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        usage: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        oba: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        trust: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        kernel: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_config: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_assets: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+    }, {
+        usage: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        oba: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        trust: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        kernel: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_config: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_assets: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+        name: string;
+        description: string | null;
+        id: string;
+        version: string | null;
+        requires: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        usage: {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        } | null;
+        engines: string[];
+        state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        display_name: string;
+        latest_version: string | null;
+        origin: {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        };
+        runtime: {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        } | null;
+        trust: {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        };
+        placements: {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }[];
+        required_by: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        owner_pkg_id: string | null;
+        install_path: string | null;
+    }[];
+    as_of_ms: number;
+    sources: {
+        usage: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        oba: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        trust: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        kernel: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_config: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_assets: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+    };
+}, {
+    items: {
+        kind: "sidecar" | "tool" | "schedule" | "engine" | "agent" | "command" | "app" | "skill" | "hook" | "bundle" | "workflow";
+        name: string;
+        description: string | null;
+        id: string;
+        version: string | null;
+        requires: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        usage: {
+            source: "hooks" | "transcript";
+            last_used_ms: number | null;
+            count_7d: number | null;
+            count_30d: number | null;
+            tokens_30d: number | null;
+            window_start_ms: number;
+        } | null;
+        engines: string[];
+        state: "enabled" | "disabled" | "available" | "update" | "orphaned" | "broken";
+        scope: {
+            kind: "personal";
+        } | {
+            kind: "project";
+            project_id: string;
+        };
+        display_name: string;
+        latest_version: string | null;
+        origin: {
+            url: string | null;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev";
+            resolved_version: string | null;
+            publisher: string | null;
+            managed: boolean;
+            auto_update: boolean;
+            installed_at_ms: number | null;
+            updated_at_ms: number | null;
+        };
+        runtime: {
+            state: "running" | "spawning" | "crashed" | "blocked" | "parked" | "stopped" | "shuttingdown";
+            pid: number | null;
+            uptime_s: number | null;
+            restarts: number;
+            last_err: string | null;
+            last_crash_ms: number | null;
+        } | null;
+        trust: {
+            state: "auto_trusted" | "auto_granted" | "granted" | "needs_approval" | "not_applicable";
+            auto_trusted: boolean;
+            signed: boolean;
+            review_pending: boolean;
+            perms: {
+                net: string[];
+                shell_execute: string[];
+                fs_write_outside_sandbox: string[];
+                vault_keys: string[];
+            } | null;
+            last_granted_at_ms: number | null;
+        };
+        placements: {
+            path: string;
+            status: "active" | "deprecated";
+            format: "md-yaml" | "toml" | "json-embedded" | null;
+            engine: string;
+            scope: {
+                kind: "personal";
+            } | {
+                kind: "project";
+                project_id: string;
+            };
+            mechanism: "file" | "symlink-dir" | "settings-key";
+            present: boolean;
+            link_target: string | null;
+            in_store: boolean;
+            managed_by: "user" | "oba" | "pkg";
+            overridden_by: string | null;
+        }[];
+        required_by: {
+            kind: string;
+            name: string;
+            ref: string | null;
+            source: "git" | "npx" | "catalog" | "local" | "builtin" | "registry" | "dev" | null;
+            item_id: string | null;
+        }[];
+        owner_pkg_id: string | null;
+        install_path: string | null;
+    }[];
+    as_of_ms: number;
+    sources: {
+        usage: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        oba: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        trust: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        kernel: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_config: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+        engine_assets: {
+            ok: boolean;
+            error: string | null;
+            count: number;
+        };
+    };
+}>;
+export type NgwaSnapshot = z.infer<typeof NgwaSnapshotSchema>;
+//# sourceMappingURL=ngwa.d.ts.map