@ikenga/contract 0.3.0

package/dist/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"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"}

package/dist/artifact.js

@@ -0,0 +1,164 @@
+// Ikenga artifact manifest schema (v0.1).
+//
+// The artifact format is the small, agent-authorable single-file (or folder)
+// HTML doc that renders standalone in any browser AND lights up with live
+// data inside the Ikenga shell. This Zod schema is the source of truth for
+// the manifest block embedded in `<script type="application/json"
+// id="ikenga-manifest">…</script>` (single-file mode) or in
+// `manifest.json` (folder mode).
+//
+// JSON Schema is generated from this file via `pnpm generate:schemas`
+// into `schemas/artifact/v0.json` and published at:
+//   https://royalti-io.github.io/ikenga-contract/schemas/artifact/v0.json
+//
+// NOTE: this is **unrelated** to the pkg manifest in `./manifest.ts`. They
+// describe different things (pkgs are Tauri-side mini-apps; artifacts are
+// portable HTML docs). Don't conflate them.
+import { z } from 'zod';
+// ---------- Refresh modes ----------
+export const RefreshSchema = z.discriminatedUnion('mode', [
+    z.object({ mode: z.literal('manual') }),
+    z.object({
+        mode: z.literal('interval'),
+        /** Duration string: `<number><unit>` where unit ∈ s|m|h|d. e.g. "30s", "15m", "1h", "1d". */
+        every: z.string().regex(/^\d+\s*(s|m|h|d)$/),
+        /** When true, also refresh whenever the artifact's pane regains focus. */
+        onFocus: z.boolean().optional(),
+    }),
+    /** File / realtime sources only — bridge subscribes via fs_watch or equivalent. */
+    z.object({ mode: z.literal('watch') }),
+]);
+// ---------- Data sources ----------
+const SourceSupabase = z.object({
+    type: z.literal('supabase'),
+    table: z.string(),
+    select: z.string().optional(),
+    /** PostgREST-style filters: `[column, operator, value][]`. */
+    filter: z.array(z.tuple([z.string(), z.string(), z.unknown()])).optional(),
+    refresh: RefreshSchema,
+});
+const SourceSql = z.object({
+    type: z.literal('sql'),
+    /** Logical DB name (e.g. `ikenga.local`). Resolved by the host. */
+    db: z.string(),
+    query: z.string(),
+    params: z.array(z.unknown()).optional(),
+    refresh: RefreshSchema,
+});
+const SourceFetch = z.object({
+    type: z.literal('fetch'),
+    url: z.string().url(),
+    method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']).optional(),
+    headers: z.record(z.string()).optional(),
+    refresh: RefreshSchema,
+});
+const SourceMcp = z.object({
+    type: z.literal('mcp'),
+    server: z.string(),
+    tool: z.string(),
+    args: z.record(z.unknown()).optional(),
+    refresh: RefreshSchema,
+});
+const SourceFile = z.object({
+    type: z.literal('file'),
+    path: z.string(),
+    refresh: RefreshSchema,
+});
+export const DataSourceSchema = z.discriminatedUnion('type', [
+    SourceSupabase,
+    SourceSql,
+    SourceFetch,
+    SourceMcp,
+    SourceFile,
+]);
+// ---------- Fallback ----------
+export const FallbackSchema = z
+    .object({
+    mode: z.literal('mock'),
+    /** Single-file mode: id of the inline `<script type="application/json">` tag carrying mock data. */
+    dataTag: z.string().optional(),
+    /** Folder mode: relative path to a JSON file with mock data. */
+    data: z.string().optional(),
+    banner: z.string().optional(),
+})
+    .refine((v) => !!v.dataTag || !!v.data, {
+    message: "fallback must specify either 'dataTag' (single-file) or 'data' (folder mode)",
+});
+// ---------- Misc top-level blocks ----------
+export const PinSchema = z.object({
+    suggested: z.boolean().default(false),
+    /** Free-form section name. Host fuzzy-matches against existing sections at pin time. */
+    section: z.string().optional(),
+    label: z.string().optional(),
+    icon: z.object({ lucide: z.string() }).partial().optional(),
+});
+export const NotesSchema = z.object({
+    enabled: z.boolean().default(true),
+});
+export const RequiresSchema = z.object({
+    ikenga: z.string().optional(),
+    bridge: z.string().optional(),
+});
+export const IconSchema = z.object({
+    lucide: z.string().optional(),
+}).partial();
+/**
+ * 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 const CapabilitiesSchema = z.object({
+    network: z.object({ allow: z.array(z.string()) }).optional(),
+    supabase: z
+        .object({
+        project: z.string().optional(),
+        tables: z.array(z.string()).optional(),
+        rls: z.enum(['user', 'service']).optional(),
+    })
+        .optional(),
+    sqlite: z
+        .object({
+        db: z.string(),
+        queries: z.array(z.string()).optional(),
+    })
+        .optional(),
+    mcp: z
+        .array(z.object({
+        server: z.string(),
+        tools: z.array(z.string()).optional(),
+    }))
+        .optional(),
+    fs: z
+        .object({
+        read: z.array(z.string()).optional(),
+        write: z.array(z.string()).optional(),
+    })
+        .optional(),
+});
+// ---------- Top-level manifest ----------
+export const ArtifactManifestSchema = z.object({
+    $schema: z.string().url().optional(),
+    format: z.literal('ikenga-artifact'),
+    /** Major.minor of the artifact format spec, e.g. "0.1". */
+    formatVersion: z.string(),
+    id: z.string().regex(/^[a-z0-9][a-z0-9-]*$/, { message: 'id must be kebab-case' }),
+    name: z.string(),
+    version: z.string(),
+    description: z.string().optional(),
+    author: z.string().optional(),
+    license: z.string().optional(),
+    /** Folder mode only — relative path to the entry HTML. Single-file artifacts omit this. */
+    entry: z.string().optional(),
+    icon: IconSchema.optional(),
+    dataSources: z.record(DataSourceSchema),
+    fallback: FallbackSchema,
+    pin: PinSchema.optional(),
+    notes: NotesSchema.optional(),
+    requires: RequiresSchema.optional(),
+    capabilities: CapabilitiesSchema.optional(),
+});
+/** Format-spec version this package's schema targets. Bumped together with the JSON Schema file. */
+export const ARTIFACT_FORMAT_VERSION = '0.1';
+//# sourceMappingURL=artifact.js.map

package/dist/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"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"}

package/dist/engine.d.ts

@@ -0,0 +1,65 @@
+export interface SessionOpts {
+    cwd?: string;
+    systemPrompt?: string;
+    toolAllowList?: string[];
+    /** Caller pkg id, used by the engine for per-pkg billing/audit. */
+    callerPkg?: string;
+}
+export interface Session {
+    readonly id: string;
+    /** Best-effort cancellation. Resolves once the engine has stopped streaming. */
+    cancel(): Promise<void>;
+}
+export type EngineEvent = {
+    type: 'message_delta';
+    text: string;
+} | {
+    type: 'tool_use';
+    tool: string;
+    input: unknown;
+    toolUseId: string;
+} | {
+    type: 'tool_result';
+    toolUseId: string;
+    output: unknown;
+    isError?: boolean;
+} | {
+    type: 'thinking_delta';
+    text: string;
+} | {
+    type: 'usage';
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+} | {
+    type: 'done';
+    reason: 'stop' | 'cancel' | 'error';
+    error?: string;
+};
+export interface McpServerSpec {
+    id: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface Engine {
+    /** Stable identifier — matches the pkg id of the engine adapter. */
+    readonly id: string;
+    /** Human-readable adapter version. */
+    readonly version: string;
+    /** Open a new session. Sessions are cheap; create one per pkg invocation. */
+    startSession(opts: SessionOpts): Promise<Session>;
+    /** Send input and stream events. The iterable completes on `done`. */
+    stream(session: Session, input: string): AsyncIterable<EngineEvent>;
+    /** Register an MCP server with the engine. Idempotent on `id`. */
+    registerMcpServer(spec: McpServerSpec): Promise<void>;
+    /** Unregister an MCP server. */
+    unregisterMcpServer(id: string): Promise<void>;
+    /** Health check — used by the kernel before routing pkg requests. */
+    healthCheck(): Promise<{
+        ok: boolean;
+        reason?: string;
+    }>;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACpH;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,6EAA6E;IAC7E,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElD,sEAAsE;IACtE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAEpE,kEAAkE;IAClE,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,gCAAgC;IAChC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,qEAAqE;IACrE,WAAW,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1D"}

package/dist/engine.js

@@ -0,0 +1,7 @@
+// Engine adapter contract. Implementations:
+//   - engine-claude-code  (default, ships preinstalled)
+//   - engine-codex        (future)
+//   - engine-aider        (future)
+//   - engine-noop         (testing / shell-without-AI mode)
+export {};
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,wDAAwD;AACxD,mCAAmC;AACnC,mCAAmC;AACnC,4DAA4D"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './manifest.js';
+export * from './rpc.js';
+export * from './engine.js';
+export * from './scopes.js';
+export * from './iyke.js';
+export * from './artifact.js';
+/** This package's own version. */
+export declare const CONTRACT_PACKAGE_VERSION: "0.3.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,EAAG,OAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './manifest.js';
+export * from './rpc.js';
+export * from './engine.js';
+export * from './scopes.js';
+export * from './iyke.js';
+export * from './artifact.js';
+/** This package's own version. */
+export const CONTRACT_PACKAGE_VERSION = '0.3.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAE9B,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAgB,CAAC"}

package/dist/iyke.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Activity-bar sidebar modes the shell renders.
+ *
+ * - The first five (`app`, `files`, `agents`, `sessions`, `settings`) are
+ *   core modes always present on the shell.
+ * - The remaining are mini-app modes contributed by built-in pkgs.
+ *
+ * MCP / iyke clients pass these strings to `iyke_mode` to switch the
+ * sidebar. Adding a new mode is a non-breaking minor bump (consumers can
+ * still pass any of the older modes). Removing or renaming is breaking.
+ */
+export declare const ACTIVITY_MODES: readonly ["app", "files", "agents", "sessions", "settings", "storyboard", "video-engine", "canvas-design", "image-generator"];
+export type ActivityMode = (typeof ACTIVITY_MODES)[number];
+/**
+ * Names of mini-app surfaces the kernel exposes via `iyke_open` with
+ * `kind: "mini-app"`. Subset of {@link ACTIVITY_MODES} that map to a
+ * full-screen mini-app surface (not a plain sidebar mode).
+ */
+export declare const MINI_APP_NAMES: readonly ["storyboard", "video-engine", "canvas-design", "image-generator"];
+export type MiniAppName = (typeof MINI_APP_NAMES)[number];
+//# sourceMappingURL=iyke.d.ts.map

package/dist/iyke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iyke.d.ts","sourceRoot":"","sources":["../src/iyke.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,+HAUjB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,cAAc,6EAKjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/iyke.js

@@ -0,0 +1,38 @@
+// Iyke runtime constants shared between the shell, the iyke CLI, and any
+// MCP/RPC bridge that drives the shell. These are the activity modes the
+// shell's sidebar knows about and the names of mini-app surfaces the
+// kernel exposes — runtime values, not manifest schema.
+/**
+ * Activity-bar sidebar modes the shell renders.
+ *
+ * - The first five (`app`, `files`, `agents`, `sessions`, `settings`) are
+ *   core modes always present on the shell.
+ * - The remaining are mini-app modes contributed by built-in pkgs.
+ *
+ * MCP / iyke clients pass these strings to `iyke_mode` to switch the
+ * sidebar. Adding a new mode is a non-breaking minor bump (consumers can
+ * still pass any of the older modes). Removing or renaming is breaking.
+ */
+export const ACTIVITY_MODES = [
+    'app',
+    'files',
+    'agents',
+    'sessions',
+    'settings',
+    'storyboard',
+    'video-engine',
+    'canvas-design',
+    'image-generator',
+];
+/**
+ * Names of mini-app surfaces the kernel exposes via `iyke_open` with
+ * `kind: "mini-app"`. Subset of {@link ACTIVITY_MODES} that map to a
+ * full-screen mini-app surface (not a plain sidebar mode).
+ */
+export const MINI_APP_NAMES = [
+    'storyboard',
+    'video-engine',
+    'canvas-design',
+    'image-generator',
+];
+//# sourceMappingURL=iyke.js.map

package/dist/iyke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iyke.js","sourceRoot":"","sources":["../src/iyke.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,wDAAwD;AAExD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK;IACL,OAAO;IACP,QAAQ;IACR,UAAU;IACV,UAAU;IACV,YAAY;IACZ,cAAc;IACd,eAAe;IACf,iBAAiB;CACT,CAAC;AAIX;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY;IACZ,cAAc;IACd,eAAe;IACf,iBAAiB;CACT,CAAC"}