@ikenga/contract 0.3.0

package/dist/artifact.d.ts

@@ -0,0 +1,1249 @@
+import { z } from 'zod';
+export declare const RefreshSchema: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+    mode: z.ZodLiteral<"manual">;
+}, "strip", z.ZodTypeAny, {
+    mode: "manual";
+}, {
+    mode: "manual";
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"interval">;
+    /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+    every: z.ZodString;
+    /** When true, also refresh whenever the artifact's pane regains focus. */
+    onFocus: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "interval";
+    every: string;
+    onFocus?: boolean | undefined;
+}, {
+    mode: "interval";
+    every: string;
+    onFocus?: boolean | undefined;
+}>, z.ZodObject<{
+    mode: z.ZodLiteral<"watch">;
+}, "strip", z.ZodTypeAny, {
+    mode: "watch";
+}, {
+    mode: "watch";
+}>]>;
+export declare const DataSourceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"supabase">;
+    table: z.ZodString;
+    select: z.ZodOptional<z.ZodString>;
+    /** PostgREST-style filters: `[column, operator, value][]`. */
+    filter: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodUnknown], null>, "many">>;
+    refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"manual">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "manual";
+    }, {
+        mode: "manual";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"interval">;
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.ZodString;
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"watch">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "watch";
+    }, {
+        mode: "watch";
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "supabase";
+    table: string;
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    filter?: [string, string, unknown][] | undefined;
+    select?: string | undefined;
+}, {
+    type: "supabase";
+    table: string;
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    filter?: [string, string, unknown][] | undefined;
+    select?: string | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"sql">;
+    /** Logical DB name (e.g. `ikenga.local`). Resolved by the host. */
+    db: z.ZodString;
+    query: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"manual">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "manual";
+    }, {
+        mode: "manual";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"interval">;
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.ZodString;
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"watch">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "watch";
+    }, {
+        mode: "watch";
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "sql";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    db: string;
+    query: string;
+    params?: unknown[] | undefined;
+}, {
+    type: "sql";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    db: string;
+    query: string;
+    params?: unknown[] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"fetch">;
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"manual">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "manual";
+    }, {
+        mode: "manual";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"interval">;
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.ZodString;
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"watch">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "watch";
+    }, {
+        mode: "watch";
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "fetch";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+}, {
+    type: "fetch";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    headers?: Record<string, string> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"mcp">;
+    server: z.ZodString;
+    tool: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"manual">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "manual";
+    }, {
+        mode: "manual";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"interval">;
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.ZodString;
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"watch">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "watch";
+    }, {
+        mode: "watch";
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    type: "mcp";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    server: string;
+    tool: string;
+    args?: Record<string, unknown> | undefined;
+}, {
+    type: "mcp";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+    server: string;
+    tool: string;
+    args?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"file">;
+    path: z.ZodString;
+    refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"manual">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "manual";
+    }, {
+        mode: "manual";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"interval">;
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.ZodString;
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }, {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"watch">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "watch";
+    }, {
+        mode: "watch";
+    }>]>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "file";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+}, {
+    path: string;
+    type: "file";
+    refresh: {
+        mode: "manual";
+    } | {
+        mode: "interval";
+        every: string;
+        onFocus?: boolean | undefined;
+    } | {
+        mode: "watch";
+    };
+}>]>;
+export declare const FallbackSchema: z.ZodEffects<z.ZodObject<{
+    mode: z.ZodLiteral<"mock">;
+    /** Single-file mode: id of the inline `<script type="application/json">` tag carrying mock data. */
+    dataTag: z.ZodOptional<z.ZodString>;
+    /** Folder mode: relative path to a JSON file with mock data. */
+    data: z.ZodOptional<z.ZodString>;
+    banner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "mock";
+    dataTag?: string | undefined;
+    data?: string | undefined;
+    banner?: string | undefined;
+}, {
+    mode: "mock";
+    dataTag?: string | undefined;
+    data?: string | undefined;
+    banner?: string | undefined;
+}>, {
+    mode: "mock";
+    dataTag?: string | undefined;
+    data?: string | undefined;
+    banner?: string | undefined;
+}, {
+    mode: "mock";
+    dataTag?: string | undefined;
+    data?: string | undefined;
+    banner?: string | undefined;
+}>;
+export declare const PinSchema: z.ZodObject<{
+    suggested: z.ZodDefault<z.ZodBoolean>;
+    /** Free-form section name. Host fuzzy-matches against existing sections at pin time. */
+    section: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodObject<{
+        lucide: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        lucide?: string | undefined;
+    }, {
+        lucide?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    suggested: boolean;
+    section?: string | undefined;
+    label?: string | undefined;
+    icon?: {
+        lucide?: string | undefined;
+    } | undefined;
+}, {
+    suggested?: boolean | undefined;
+    section?: string | undefined;
+    label?: string | undefined;
+    icon?: {
+        lucide?: string | undefined;
+    } | undefined;
+}>;
+export declare const NotesSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+}, {
+    enabled?: boolean | undefined;
+}>;
+export declare const RequiresSchema: z.ZodObject<{
+    ikenga: z.ZodOptional<z.ZodString>;
+    bridge: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ikenga?: string | undefined;
+    bridge?: string | undefined;
+}, {
+    ikenga?: string | undefined;
+    bridge?: string | undefined;
+}>;
+export declare const IconSchema: z.ZodObject<{
+    lucide: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    lucide?: string | undefined;
+}, {
+    lucide?: string | undefined;
+}>;
+/**
+ * Escape-hatch capabilities block. Default behaviour is to auto-derive
+ * capabilities from `dataSources`, so most artifacts omit this entirely.
+ * Use only when narrowing below the derived set, expressing capabilities
+ * sources can't (e.g. arbitrary FS reads), or driving raw `bridge.fetch` /
+ * `bridge.mcp` calls that aren't bound to a declared source.
+ */
+export declare const CapabilitiesSchema: z.ZodObject<{
+    network: z.ZodOptional<z.ZodObject<{
+        allow: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        allow: string[];
+    }, {
+        allow: string[];
+    }>>;
+    supabase: z.ZodOptional<z.ZodObject<{
+        project: z.ZodOptional<z.ZodString>;
+        tables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rls: z.ZodOptional<z.ZodEnum<["user", "service"]>>;
+    }, "strip", z.ZodTypeAny, {
+        project?: string | undefined;
+        tables?: string[] | undefined;
+        rls?: "user" | "service" | undefined;
+    }, {
+        project?: string | undefined;
+        tables?: string[] | undefined;
+        rls?: "user" | "service" | undefined;
+    }>>;
+    sqlite: z.ZodOptional<z.ZodObject<{
+        db: z.ZodString;
+        queries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        db: string;
+        queries?: string[] | undefined;
+    }, {
+        db: string;
+        queries?: string[] | undefined;
+    }>>;
+    mcp: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        server: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        server: string;
+        tools?: string[] | undefined;
+    }, {
+        server: string;
+        tools?: string[] | undefined;
+    }>, "many">>;
+    fs: z.ZodOptional<z.ZodObject<{
+        read: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        write: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        read?: string[] | undefined;
+        write?: string[] | undefined;
+    }, {
+        read?: string[] | undefined;
+        write?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    supabase?: {
+        project?: string | undefined;
+        tables?: string[] | undefined;
+        rls?: "user" | "service" | undefined;
+    } | undefined;
+    mcp?: {
+        server: string;
+        tools?: string[] | undefined;
+    }[] | undefined;
+    network?: {
+        allow: string[];
+    } | undefined;
+    sqlite?: {
+        db: string;
+        queries?: string[] | undefined;
+    } | undefined;
+    fs?: {
+        read?: string[] | undefined;
+        write?: string[] | undefined;
+    } | undefined;
+}, {
+    supabase?: {
+        project?: string | undefined;
+        tables?: string[] | undefined;
+        rls?: "user" | "service" | undefined;
+    } | undefined;
+    mcp?: {
+        server: string;
+        tools?: string[] | undefined;
+    }[] | undefined;
+    network?: {
+        allow: string[];
+    } | undefined;
+    sqlite?: {
+        db: string;
+        queries?: string[] | undefined;
+    } | undefined;
+    fs?: {
+        read?: string[] | undefined;
+        write?: string[] | undefined;
+    } | undefined;
+}>;
+export declare const ArtifactManifestSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    format: z.ZodLiteral<"ikenga-artifact">;
+    /** Major.minor of the artifact format spec, e.g. "0.1". */
+    formatVersion: z.ZodString;
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    license: z.ZodOptional<z.ZodString>;
+    /** Folder mode only — relative path to the entry HTML. Single-file artifacts omit this. */
+    entry: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodObject<{
+        lucide: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        lucide?: string | undefined;
+    }, {
+        lucide?: string | undefined;
+    }>>;
+    dataSources: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"supabase">;
+        table: z.ZodString;
+        select: z.ZodOptional<z.ZodString>;
+        /** PostgREST-style filters: `[column, operator, value][]`. */
+        filter: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodUnknown], null>, "many">>;
+        refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"manual">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "manual";
+        }, {
+            mode: "manual";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"interval">;
+            /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+            every: z.ZodString;
+            /** When true, also refresh whenever the artifact's pane regains focus. */
+            onFocus: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"watch">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "watch";
+        }, {
+            mode: "watch";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "supabase";
+        table: string;
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        filter?: [string, string, unknown][] | undefined;
+        select?: string | undefined;
+    }, {
+        type: "supabase";
+        table: string;
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        filter?: [string, string, unknown][] | undefined;
+        select?: string | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"sql">;
+        /** Logical DB name (e.g. `ikenga.local`). Resolved by the host. */
+        db: z.ZodString;
+        query: z.ZodString;
+        params: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+        refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"manual">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "manual";
+        }, {
+            mode: "manual";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"interval">;
+            /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+            every: z.ZodString;
+            /** When true, also refresh whenever the artifact's pane regains focus. */
+            onFocus: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"watch">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "watch";
+        }, {
+            mode: "watch";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "sql";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        db: string;
+        query: string;
+        params?: unknown[] | undefined;
+    }, {
+        type: "sql";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        db: string;
+        query: string;
+        params?: unknown[] | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"fetch">;
+        url: z.ZodString;
+        method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"manual">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "manual";
+        }, {
+            mode: "manual";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"interval">;
+            /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+            every: z.ZodString;
+            /** When true, also refresh whenever the artifact's pane regains focus. */
+            onFocus: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"watch">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "watch";
+        }, {
+            mode: "watch";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "fetch";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        url: string;
+        method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+        headers?: Record<string, string> | undefined;
+    }, {
+        type: "fetch";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        url: string;
+        method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+        headers?: Record<string, string> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"mcp">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"manual">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "manual";
+        }, {
+            mode: "manual";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"interval">;
+            /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+            every: z.ZodString;
+            /** When true, also refresh whenever the artifact's pane regains focus. */
+            onFocus: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"watch">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "watch";
+        }, {
+            mode: "watch";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "mcp";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        server: string;
+        tool: string;
+        args?: Record<string, unknown> | undefined;
+    }, {
+        type: "mcp";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        server: string;
+        tool: string;
+        args?: Record<string, unknown> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"file">;
+        path: z.ZodString;
+        refresh: z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"manual">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "manual";
+        }, {
+            mode: "manual";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"interval">;
+            /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+            every: z.ZodString;
+            /** When true, also refresh whenever the artifact's pane regains focus. */
+            onFocus: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }, {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"watch">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "watch";
+        }, {
+            mode: "watch";
+        }>]>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "file";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+    }, {
+        path: string;
+        type: "file";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+    }>]>>;
+    fallback: z.ZodEffects<z.ZodObject<{
+        mode: z.ZodLiteral<"mock">;
+        /** Single-file mode: id of the inline `<script type="application/json">` tag carrying mock data. */
+        dataTag: z.ZodOptional<z.ZodString>;
+        /** Folder mode: relative path to a JSON file with mock data. */
+        data: z.ZodOptional<z.ZodString>;
+        banner: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    }, {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    }>, {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    }, {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    }>;
+    pin: z.ZodOptional<z.ZodObject<{
+        suggested: z.ZodDefault<z.ZodBoolean>;
+        /** Free-form section name. Host fuzzy-matches against existing sections at pin time. */
+        section: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodObject<{
+            lucide: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            lucide?: string | undefined;
+        }, {
+            lucide?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        suggested: boolean;
+        section?: string | undefined;
+        label?: string | undefined;
+        icon?: {
+            lucide?: string | undefined;
+        } | undefined;
+    }, {
+        suggested?: boolean | undefined;
+        section?: string | undefined;
+        label?: string | undefined;
+        icon?: {
+            lucide?: string | undefined;
+        } | undefined;
+    }>>;
+    notes: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+    }, {
+        enabled?: boolean | undefined;
+    }>>;
+    requires: z.ZodOptional<z.ZodObject<{
+        ikenga: z.ZodOptional<z.ZodString>;
+        bridge: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        ikenga?: string | undefined;
+        bridge?: string | undefined;
+    }, {
+        ikenga?: string | undefined;
+        bridge?: string | undefined;
+    }>>;
+    capabilities: z.ZodOptional<z.ZodObject<{
+        network: z.ZodOptional<z.ZodObject<{
+            allow: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            allow: string[];
+        }, {
+            allow: string[];
+        }>>;
+        supabase: z.ZodOptional<z.ZodObject<{
+            project: z.ZodOptional<z.ZodString>;
+            tables: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            rls: z.ZodOptional<z.ZodEnum<["user", "service"]>>;
+        }, "strip", z.ZodTypeAny, {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        }, {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        }>>;
+        sqlite: z.ZodOptional<z.ZodObject<{
+            db: z.ZodString;
+            queries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            db: string;
+            queries?: string[] | undefined;
+        }, {
+            db: string;
+            queries?: string[] | undefined;
+        }>>;
+        mcp: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            server: z.ZodString;
+            tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            server: string;
+            tools?: string[] | undefined;
+        }, {
+            server: string;
+            tools?: string[] | undefined;
+        }>, "many">>;
+        fs: z.ZodOptional<z.ZodObject<{
+            read: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            write: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        }, {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        supabase?: {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        } | undefined;
+        mcp?: {
+            server: string;
+            tools?: string[] | undefined;
+        }[] | undefined;
+        network?: {
+            allow: string[];
+        } | undefined;
+        sqlite?: {
+            db: string;
+            queries?: string[] | undefined;
+        } | undefined;
+        fs?: {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        } | undefined;
+    }, {
+        supabase?: {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        } | undefined;
+        mcp?: {
+            server: string;
+            tools?: string[] | undefined;
+        }[] | undefined;
+        network?: {
+            allow: string[];
+        } | undefined;
+        sqlite?: {
+            db: string;
+            queries?: string[] | undefined;
+        } | undefined;
+        fs?: {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    format: "ikenga-artifact";
+    formatVersion: string;
+    id: string;
+    name: string;
+    version: string;
+    dataSources: Record<string, {
+        type: "supabase";
+        table: string;
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        filter?: [string, string, unknown][] | undefined;
+        select?: string | undefined;
+    } | {
+        type: "sql";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        db: string;
+        query: string;
+        params?: unknown[] | undefined;
+    } | {
+        type: "fetch";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        url: string;
+        method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "mcp";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        server: string;
+        tool: string;
+        args?: Record<string, unknown> | undefined;
+    } | {
+        path: string;
+        type: "file";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+    }>;
+    fallback: {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    };
+    icon?: {
+        lucide?: string | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    author?: string | undefined;
+    license?: string | undefined;
+    entry?: string | undefined;
+    pin?: {
+        suggested: boolean;
+        section?: string | undefined;
+        label?: string | undefined;
+        icon?: {
+            lucide?: string | undefined;
+        } | undefined;
+    } | undefined;
+    notes?: {
+        enabled: boolean;
+    } | undefined;
+    requires?: {
+        ikenga?: string | undefined;
+        bridge?: string | undefined;
+    } | undefined;
+    capabilities?: {
+        supabase?: {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        } | undefined;
+        mcp?: {
+            server: string;
+            tools?: string[] | undefined;
+        }[] | undefined;
+        network?: {
+            allow: string[];
+        } | undefined;
+        sqlite?: {
+            db: string;
+            queries?: string[] | undefined;
+        } | undefined;
+        fs?: {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    format: "ikenga-artifact";
+    formatVersion: string;
+    id: string;
+    name: string;
+    version: string;
+    dataSources: Record<string, {
+        type: "supabase";
+        table: string;
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        filter?: [string, string, unknown][] | undefined;
+        select?: string | undefined;
+    } | {
+        type: "sql";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        db: string;
+        query: string;
+        params?: unknown[] | undefined;
+    } | {
+        type: "fetch";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        url: string;
+        method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+        headers?: Record<string, string> | undefined;
+    } | {
+        type: "mcp";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+        server: string;
+        tool: string;
+        args?: Record<string, unknown> | undefined;
+    } | {
+        path: string;
+        type: "file";
+        refresh: {
+            mode: "manual";
+        } | {
+            mode: "interval";
+            every: string;
+            onFocus?: boolean | undefined;
+        } | {
+            mode: "watch";
+        };
+    }>;
+    fallback: {
+        mode: "mock";
+        dataTag?: string | undefined;
+        data?: string | undefined;
+        banner?: string | undefined;
+    };
+    icon?: {
+        lucide?: string | undefined;
+    } | undefined;
+    $schema?: string | undefined;
+    description?: string | undefined;
+    author?: string | undefined;
+    license?: string | undefined;
+    entry?: string | undefined;
+    pin?: {
+        suggested?: boolean | undefined;
+        section?: string | undefined;
+        label?: string | undefined;
+        icon?: {
+            lucide?: string | undefined;
+        } | undefined;
+    } | undefined;
+    notes?: {
+        enabled?: boolean | undefined;
+    } | undefined;
+    requires?: {
+        ikenga?: string | undefined;
+        bridge?: string | undefined;
+    } | undefined;
+    capabilities?: {
+        supabase?: {
+            project?: string | undefined;
+            tables?: string[] | undefined;
+            rls?: "user" | "service" | undefined;
+        } | undefined;
+        mcp?: {
+            server: string;
+            tools?: string[] | undefined;
+        }[] | undefined;
+        network?: {
+            allow: string[];
+        } | undefined;
+        sqlite?: {
+            db: string;
+            queries?: string[] | undefined;
+        } | undefined;
+        fs?: {
+            read?: string[] | undefined;
+            write?: string[] | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type ArtifactManifest = z.infer<typeof ArtifactManifestSchema>;
+export type DataSource = z.infer<typeof DataSourceSchema>;
+export type Refresh = z.infer<typeof RefreshSchema>;
+export type Fallback = z.infer<typeof FallbackSchema>;
+export type Capabilities = z.infer<typeof CapabilitiesSchema>;
+/** Format-spec version this package's schema targets. Bumped together with the JSON Schema file. */
+export declare const ARTIFACT_FORMAT_VERSION: "0.1";
+//# sourceMappingURL=artifact.d.ts.map