@ikenga/contract 0.10.0 → 0.12.0

package/dist/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAE5D,gFAAgF;;YA/BhF,4DAA4D;;YAE5D,0DAA0D;;;;;;;;;QA+B1D;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaH,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,mBAAmB;IAC9B,qBAAqB;;IAErB,qBAAqB;;IAErB;;;;;OAKG;;IAEH,4EAA4E;;IAE5E,2EAA2E;;IAE3E;;;;OAIG;;IAEH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;EAEH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,mBAAmB;;IAE9B,wDAAwD;;;QAnCxD,qBAAqB;;QAErB,qBAAqB;;QAErB;;;;;WAKG;;QAEH,4EAA4E;;QAE5E,2EAA2E;;QAE3E;;;;WAIG;;QAEH;;;;;;;WAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/window.d.ts

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+/** Envelope + descriptor wire version. Bumped on non-additive change. */
+export declare const WINDOW_CONTRACT_VERSION: 1;
+/**
+ * What a window is.
+ * - `primary`        — the original "main" window (full chrome).
+ * - `single-surface` — a thin detached window hosting one surface (Flavor C).
+ * - `pane-set`       — a torn-off pane group (Flavor A, Phase 2).
+ * - `workspace`      — a second full workspace window (Flavor B, Phase 3).
+ */
+export declare const WindowKindSchema: z.ZodEnum<["primary", "single-surface", "pane-set", "workspace"]>;
+export type WindowKind = z.infer<typeof WindowKindSchema>;
+export declare const WindowDescriptorSchema: z.ZodObject<{
+    /** OS window label. "main" for the primary; "detached-<n>" otherwise. */
+    label: z.ZodString;
+    kind: z.ZodEnum<["primary", "single-surface", "pane-set", "workspace"]>;
+    /** Surface/route ids the window's FE entry mounts. */
+    surface_set: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** Project this window is bound to (Flavor B); null = follows primary. */
+    project_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /**
+     * SQLite `layout_state` partition. A KEY-STRING suffix folded into
+     * `scopedKey()` (G-03) — NOT a new column. Usually equals `label`.
+     */
+    layout_key: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    surface_set: string[];
+    project_id: string | null;
+    layout_key: string;
+}, {
+    label: string;
+    kind: "primary" | "single-surface" | "pane-set" | "workspace";
+    layout_key: string;
+    surface_set?: string[] | undefined;
+    project_id?: string | null | undefined;
+}>;
+export type WindowDescriptor = z.infer<typeof WindowDescriptorSchema>;
+/**
+ * Where a window event goes. The DEFAULT for streaming/data channels is
+ * `broadcast` (every window filters its own subscription); only the channels
+ * that race (see WINDOW_TARGETED_CHANNELS) carry `window` targeting.
+ */
+export declare const WindowEventTargetSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"broadcast">;
+}, "strict", z.ZodTypeAny, {
+    kind: "broadcast";
+}, {
+    kind: "broadcast";
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"window">;
+    label: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    label: string;
+    kind: "window";
+}, {
+    label: string;
+    kind: "window";
+}>]>;
+export type WindowEventTarget = z.infer<typeof WindowEventTargetSchema>;
+/**
+ * The base shape every cross-window event rides. `payload` is opaque at the
+ * contract layer (each topic refines it); the envelope itself is what the
+ * registry + windows agree on.
+ */
+export declare const WindowEventEnvelopeSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    /** Channel name, e.g. "window://opened". */
+    topic: z.ZodString;
+    /** Emitting window label, or "core" for the Rust core. */
+    source_label: z.ZodString;
+    target: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"broadcast">;
+    }, "strict", z.ZodTypeAny, {
+        kind: "broadcast";
+    }, {
+        kind: "broadcast";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"window">;
+        label: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        label: string;
+        kind: "window";
+    }, {
+        label: string;
+        kind: "window";
+    }>]>;
+    payload: z.ZodUnknown;
+}, "strict", z.ZodTypeAny, {
+    v: 1;
+    topic: string;
+    source_label: string;
+    target: {
+        kind: "broadcast";
+    } | {
+        label: string;
+        kind: "window";
+    };
+    payload?: unknown;
+}, {
+    v: 1;
+    topic: string;
+    source_label: string;
+    target: {
+        kind: "broadcast";
+    } | {
+        label: string;
+        kind: "window";
+    };
+    payload?: unknown;
+}>;
+export type WindowEventEnvelope = z.infer<typeof WindowEventEnvelopeSchema>;
+/** Canonical window-lifecycle channels emitted by the Rust core. */
+export declare const WINDOW_TOPICS: {
+    readonly opened: "window://opened";
+    readonly closed: "window://closed";
+    readonly focusChanged: "window://focus-changed";
+};
+export type WindowTopic = (typeof WINDOW_TOPICS)[keyof typeof WINDOW_TOPICS];
+/**
+ * Channels that MUST be window-targeted (`emit_to`) rather than broadcast,
+ * because a broadcast races across windows (first-reply-wins / wrong-window).
+ * Everything not listed here stays broadcast + per-window topic filtering.
+ * (plans/multi-window 03-research-internal: the ~25-channel routing table.)
+ */
+export declare const WINDOW_TARGETED_CHANNELS: readonly ["screenshot://request", "screenshot://shortcut", "projects:active-changed"];
+//# sourceMappingURL=window.d.ts.map

package/dist/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAC;AAIlD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,mEAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;IAEjC,yEAAyE;;;IAGzE,sDAAsD;;IAEtD,0EAA0E;;IAE1E;;;OAGG;;;;;;;;;;;;;;EAGK,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;IAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;IAGpC,4CAA4C;;IAE5C,0DAA0D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlD,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,oEAAoE;AACpE,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,uFAI3B,CAAC"}

package/dist/window.js

@@ -0,0 +1,86 @@
+// Multi-window contract — mirrors the Rust source-of-truth in
+// `royalti-io/ikenga` at `src-tauri/src/window/{descriptor,events}.rs`.
+//
+// This is the `G-WINDOW-MODEL` freeze-gate output (plans/multi-window WP-02).
+// It has TWO co-equal halves: the `WindowDescriptor` (what a window IS) and the
+// cross-window event envelope (how windows talk over the shared Rust core).
+// Both are imported by every downstream consumer (the window registry, the thin
+// detached FE entry, Flavor C). Field changes MUST be made in lockstep with the
+// Rust structs; bump WINDOW_CONTRACT_VERSION on any non-additive change.
+import { z } from 'zod';
+/** Envelope + descriptor wire version. Bumped on non-additive change. */
+export const WINDOW_CONTRACT_VERSION = 1;
+// ---------- WindowDescriptor ----------
+/**
+ * What a window is.
+ * - `primary`        — the original "main" window (full chrome).
+ * - `single-surface` — a thin detached window hosting one surface (Flavor C).
+ * - `pane-set`       — a torn-off pane group (Flavor A, Phase 2).
+ * - `workspace`      — a second full workspace window (Flavor B, Phase 3).
+ */
+export const WindowKindSchema = z.enum([
+    'primary',
+    'single-surface',
+    'pane-set',
+    'workspace',
+]);
+export const WindowDescriptorSchema = z
+    .object({
+    /** OS window label. "main" for the primary; "detached-<n>" otherwise. */
+    label: z.string().min(1),
+    kind: WindowKindSchema,
+    /** Surface/route ids the window's FE entry mounts. */
+    surface_set: z.array(z.string()).default([]),
+    /** Project this window is bound to (Flavor B); null = follows primary. */
+    project_id: z.string().nullable().default(null),
+    /**
+     * SQLite `layout_state` partition. A KEY-STRING suffix folded into
+     * `scopedKey()` (G-03) — NOT a new column. Usually equals `label`.
+     */
+    layout_key: z.string().min(1),
+})
+    .strict();
+// ---------- Cross-window event envelope ----------
+/**
+ * Where a window event goes. The DEFAULT for streaming/data channels is
+ * `broadcast` (every window filters its own subscription); only the channels
+ * that race (see WINDOW_TARGETED_CHANNELS) carry `window` targeting.
+ */
+export const WindowEventTargetSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('broadcast') }).strict(),
+    z.object({ kind: z.literal('window'), label: z.string().min(1) }).strict(),
+]);
+/**
+ * The base shape every cross-window event rides. `payload` is opaque at the
+ * contract layer (each topic refines it); the envelope itself is what the
+ * registry + windows agree on.
+ */
+export const WindowEventEnvelopeSchema = z
+    .object({
+    v: z.literal(WINDOW_CONTRACT_VERSION),
+    /** Channel name, e.g. "window://opened". */
+    topic: z.string().min(1),
+    /** Emitting window label, or "core" for the Rust core. */
+    source_label: z.string().min(1),
+    target: WindowEventTargetSchema,
+    payload: z.unknown(),
+})
+    .strict();
+/** Canonical window-lifecycle channels emitted by the Rust core. */
+export const WINDOW_TOPICS = {
+    opened: 'window://opened',
+    closed: 'window://closed',
+    focusChanged: 'window://focus-changed',
+};
+/**
+ * Channels that MUST be window-targeted (`emit_to`) rather than broadcast,
+ * because a broadcast races across windows (first-reply-wins / wrong-window).
+ * Everything not listed here stays broadcast + per-window topic filtering.
+ * (plans/multi-window 03-research-internal: the ~25-channel routing table.)
+ */
+export const WINDOW_TARGETED_CHANNELS = [
+    'screenshot://request',
+    'screenshot://shortcut',
+    'projects:active-changed',
+];
+//# sourceMappingURL=window.js.map

package/dist/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../src/window.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,wEAAwE;AACxE,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,4EAA4E;AAC5E,gFAAgF;AAChF,gFAAgF;AAChF,yEAAyE;AAEzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yEAAyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAU,CAAC;AAElD,yCAAyC;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,gBAAgB;IAChB,UAAU;IACV,WAAW;CACX,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC;KACrC,MAAM,CAAC;IACP,yEAAyE;IACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,gBAAgB;IACtB,sDAAsD;IACtD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5C,0EAA0E;IAC1E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C;;;OAGG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAGX,oDAAoD;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;IACnD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC1E,CAAC,CAAC;AAGH;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACxC,MAAM,CAAC;IACP,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACrC,4CAA4C;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,uBAAuB;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACpB,CAAC;KACD,MAAM,EAAE,CAAC;AAGX,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,YAAY,EAAE,wBAAwB;CAC7B,CAAC;AAGX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACvC,sBAAsB;IACtB,uBAAuB;IACvB,yBAAyB;CAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikenga/contract",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Shared contract for the Ikenga pkg system: manifest schema, RPC types, Engine interface, capability scopes.",
   "license": "Apache-2.0",
   "repository": {
@@ -55,6 +55,10 @@
     "./pa-actions": {
       "types": "./dist/pa-actions.d.ts",
       "import": "./dist/pa-actions.js"
+    },
+    "./window": {
+      "types": "./dist/window.d.ts",
+      "import": "./dist/window.js"
     }
   },
   "files": [

package/src/browser.ts

@@ -43,6 +43,21 @@ export const BrowserRefSchema = z
 
 export type BrowserRef = z.infer<typeof BrowserRefSchema>;
 
+// ---------- Engine ----------
+//
+// Which underlying browser engine backs a pane. `webkit` (default) is the
+// in-shell child-webview (WebKitGTK on Linux / WKWebView / WebView2). `chrome`
+// is "Managed mode": the shell launches the user's installed Google Chrome with
+// a dedicated `--user-data-dir` + `--remote-debugging-port` and drives it over
+// CDP. The engine is chosen at `open()`; subsequent actions address the pane by
+// id and inherit its engine. See plans/chrome-pkg/01-plan.md §Architecture.
+
+export const BROWSER_ENGINES = ['webkit', 'chrome'] as const;
+
+export const BrowserEngineSchema = z.enum(BROWSER_ENGINES);
+
+export type BrowserEngine = z.infer<typeof BrowserEngineSchema>;
+
 // ---------- Snapshot ----------
 //
 // Mirrors the shape of Iyke's `DomResult` so models can move between the
@@ -119,8 +134,17 @@ export const BrowserOpenInputSchema = z
      * Optional initial rect in main-window-client coordinates. Omitted when
      * the FE owns layout (the kernel will refuse without a rect; the MCP
      * layer is expected to supply a sane default if the caller didn't).
+     *
+     * Ignored for `engine: "chrome"` — Managed Chrome renders in its own OS
+     * window, not a shell pane.
      */
     rect: RectSchema.optional(),
+    /**
+     * Which engine backs this pane. Defaults to `"webkit"` (the in-shell
+     * child-webview). `"chrome"` is Managed mode (installed Chrome over CDP).
+     * The pkg must declare the engine in `capabilities.webview.engines`.
+     */
+    engine: BrowserEngineSchema.default('webkit'),
   })
   .refine((v) => !(v.partition && v.session), {
     message: 'pass at most one of `partition` / `session`',
@@ -132,6 +156,8 @@ export const BrowserOpenResultSchema = z.object({
   id: BrowserPaneIdSchema,
   url: z.string(),
   partition: z.string(),
+  /** The resolved engine backing this pane (`"webkit"` if absent, for back-compat). */
+  engine: BrowserEngineSchema.default('webkit'),
 });
 
 export type BrowserOpenResult = z.infer<typeof BrowserOpenResultSchema>;
@@ -147,6 +173,8 @@ export const BrowserListEntrySchema = z.object({
   url: z.string(),
   partition: z.string(),
   focused: z.boolean(),
+  /** Which engine backs this pane (`"webkit"` if absent, for back-compat). */
+  engine: BrowserEngineSchema.default('webkit'),
 });
 
 export type BrowserListEntry = z.infer<typeof BrowserListEntrySchema>;

package/src/index.ts

@@ -8,6 +8,7 @@ export * from './artifact.js';
 export * from './registry.js';
 export * from './browser.js';
 export * from './pa-actions.js';
+export * from './window.js';
 
 /** This package's own version. */
 export const CONTRACT_PACKAGE_VERSION = '0.5.0' as const;

package/src/manifest.ts

@@ -10,6 +10,7 @@
 
 import { z } from 'zod';
 import { EngineProvidesSchema } from './engine/index.js';
+import { BrowserEngineSchema } from './browser.js';
 
 // v2 (WP-05): added capabilities.sqlite + permissions["sqlite.tables"];
 // permissions["supabase.tables"] kept as a compat alias for api=1 manifests.
@@ -173,6 +174,11 @@ export const WebviewCapabilitySchema = z.object({
   child_webviews: z.boolean().default(false),
   /** Named cookie/data partitions; empty = the implicit "default" partition. */
   partitions: z.array(z.string()).default([]),
+  /** Browser engines this pkg may open panes with. `"webkit"` is the in-shell
+   *  child-webview; `"chrome"` is Managed mode (installed Chrome over CDP, its
+   *  own OS window). Defaults to `["webkit"]` so existing manifests are
+   *  unchanged. Mirrors `engines` in `WebviewCapability` (manifest.rs). */
+  engines: z.array(BrowserEngineSchema).default(['webkit']),
 });
 export type WebviewCapability = z.infer<typeof WebviewCapabilitySchema>;
 

package/src/pa-actions.ts

@@ -36,6 +36,27 @@ export interface DraftSequence {
 	recipients: number;
 }
 
+/** One sub-post in an X/Twitter thread (X allows ≤4 images per tweet). */
+export interface ThreadPost {
+	text: string;
+	/** Per-sub-post media URLs (X allows ≤4 images per tweet). */
+	imageUrls?: string[];
+}
+
+/**
+ * Media block carried on a Buffer DraftItem. `kind` selects the adapter path:
+ * - `'single'`   — 0–1 image attached to the post body.
+ * - `'carousel'` — 2–10 images (IG ≤10, LI ≤9); adapter uses multi-asset upload.
+ * - `'thread'`   — ordered sub-posts; adapter posts as N linked Buffer posts (≥2, ≤25).
+ */
+export interface SocialMedia {
+	kind: 'single' | 'carousel' | 'thread';
+	/** single = 0–1 image URL; carousel = 2–10 (platform-dependent). */
+	imageUrls?: string[];
+	/** thread-kind only: ordered sub-posts (≥2, ≤25). */
+	thread?: ThreadPost[];
+}
+
 /**
  * What an approve-aware action emits per draft — the lean, authoritative
  * producer shape. The shell derives the panel's `PausedDraft` from this via
@@ -88,6 +109,23 @@ export interface DraftItem {
 	threadCount?: string;
 	/** Explicit section bucket; otherwise derived from `scheduledIso`. */
 	section?: string;
+	// ── Buffer / social fields (mirror of payload_json media contract) ──────────
+	/**
+	 * Resolved Buffer channel id — company vs personal LinkedIn disambiguated at
+	 * enqueue time (not in the adapter). Only set for `channel: 'buffer'` drafts.
+	 */
+	channelId?: string;
+	/**
+	 * First comment text for hashtags / blog URL. Avoids Buffer link-preview
+	 * attachment errors on LinkedIn. Mapped to `metadata.<platform>.firstComment`.
+	 */
+	firstComment?: string;
+	/**
+	 * Social media block; selects single / carousel / thread adapter path.
+	 * Kept in lockstep with `payload.schema.ts` `SocialMedia` Zod schema and
+	 * the worker mirror in `scripts/cron/lib/channels/types.ts`.
+	 */
+	media?: SocialMedia;
 }
 
 /**

package/src/window.test.ts

@@ -0,0 +1,70 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import {
+	WINDOW_CONTRACT_VERSION,
+	WindowDescriptorSchema,
+	WindowEventEnvelopeSchema,
+} from './window.js';
+
+// Canonical wire fixtures — the Rust round-trip test
+// (src-tauri/src/window/descriptor.rs + events.rs) asserts the SAME JSON.
+// If these drift, the lockstep contract is broken.
+
+const DESCRIPTOR_FIXTURE = {
+	label: 'detached-1',
+	kind: 'single-surface',
+	surface_set: ['chat'],
+	project_id: null,
+	layout_key: 'detached-1',
+};
+
+const ENVELOPE_FIXTURE = {
+	v: 1,
+	topic: 'window://opened',
+	source_label: 'core',
+	target: { kind: 'window', label: 'detached-1' },
+	payload: { label: 'detached-1' },
+};
+
+test('WindowDescriptor parses the canonical fixture and round-trips', () => {
+	const parsed = WindowDescriptorSchema.parse(DESCRIPTOR_FIXTURE);
+	assert.deepEqual(parsed, DESCRIPTOR_FIXTURE);
+	// re-parse the serialized form (round-trip)
+	assert.deepEqual(
+		WindowDescriptorSchema.parse(JSON.parse(JSON.stringify(parsed))),
+		DESCRIPTOR_FIXTURE,
+	);
+});
+
+test('WindowDescriptor rejects unknown keys (deny_unknown_fields parity)', () => {
+	assert.throws(() =>
+		WindowDescriptorSchema.parse({ ...DESCRIPTOR_FIXTURE, rogue: true }),
+	);
+});
+
+test('WindowDescriptor applies defaults for surface_set/project_id', () => {
+	const parsed = WindowDescriptorSchema.parse({
+		label: 'main',
+		kind: 'primary',
+		layout_key: 'main',
+	});
+	assert.deepEqual(parsed.surface_set, []);
+	assert.equal(parsed.project_id, null);
+});
+
+test('WindowEventEnvelope parses the canonical fixture and round-trips', () => {
+	const parsed = WindowEventEnvelopeSchema.parse(ENVELOPE_FIXTURE);
+	assert.equal(parsed.v, WINDOW_CONTRACT_VERSION);
+	assert.deepEqual(
+		WindowEventEnvelopeSchema.parse(JSON.parse(JSON.stringify(parsed))),
+		ENVELOPE_FIXTURE,
+	);
+});
+
+test('WindowEventTarget broadcast variant parses', () => {
+	const parsed = WindowEventEnvelopeSchema.parse({
+		...ENVELOPE_FIXTURE,
+		target: { kind: 'broadcast' },
+	});
+	assert.equal(parsed.target.kind, 'broadcast');
+});

package/src/window.ts

@@ -0,0 +1,100 @@
+// Multi-window contract — mirrors the Rust source-of-truth in
+// `royalti-io/ikenga` at `src-tauri/src/window/{descriptor,events}.rs`.
+//
+// This is the `G-WINDOW-MODEL` freeze-gate output (plans/multi-window WP-02).
+// It has TWO co-equal halves: the `WindowDescriptor` (what a window IS) and the
+// cross-window event envelope (how windows talk over the shared Rust core).
+// Both are imported by every downstream consumer (the window registry, the thin
+// detached FE entry, Flavor C). Field changes MUST be made in lockstep with the
+// Rust structs; bump WINDOW_CONTRACT_VERSION on any non-additive change.
+
+import { z } from 'zod';
+
+/** Envelope + descriptor wire version. Bumped on non-additive change. */
+export const WINDOW_CONTRACT_VERSION = 1 as const;
+
+// ---------- WindowDescriptor ----------
+
+/**
+ * What a window is.
+ * - `primary`        — the original "main" window (full chrome).
+ * - `single-surface` — a thin detached window hosting one surface (Flavor C).
+ * - `pane-set`       — a torn-off pane group (Flavor A, Phase 2).
+ * - `workspace`      — a second full workspace window (Flavor B, Phase 3).
+ */
+export const WindowKindSchema = z.enum([
+	'primary',
+	'single-surface',
+	'pane-set',
+	'workspace',
+]);
+export type WindowKind = z.infer<typeof WindowKindSchema>;
+
+export const WindowDescriptorSchema = z
+	.object({
+		/** OS window label. "main" for the primary; "detached-<n>" otherwise. */
+		label: z.string().min(1),
+		kind: WindowKindSchema,
+		/** Surface/route ids the window's FE entry mounts. */
+		surface_set: z.array(z.string()).default([]),
+		/** Project this window is bound to (Flavor B); null = follows primary. */
+		project_id: z.string().nullable().default(null),
+		/**
+		 * SQLite `layout_state` partition. A KEY-STRING suffix folded into
+		 * `scopedKey()` (G-03) — NOT a new column. Usually equals `label`.
+		 */
+		layout_key: z.string().min(1),
+	})
+	.strict();
+export type WindowDescriptor = z.infer<typeof WindowDescriptorSchema>;
+
+// ---------- Cross-window event envelope ----------
+
+/**
+ * Where a window event goes. The DEFAULT for streaming/data channels is
+ * `broadcast` (every window filters its own subscription); only the channels
+ * that race (see WINDOW_TARGETED_CHANNELS) carry `window` targeting.
+ */
+export const WindowEventTargetSchema = z.discriminatedUnion('kind', [
+	z.object({ kind: z.literal('broadcast') }).strict(),
+	z.object({ kind: z.literal('window'), label: z.string().min(1) }).strict(),
+]);
+export type WindowEventTarget = z.infer<typeof WindowEventTargetSchema>;
+
+/**
+ * The base shape every cross-window event rides. `payload` is opaque at the
+ * contract layer (each topic refines it); the envelope itself is what the
+ * registry + windows agree on.
+ */
+export const WindowEventEnvelopeSchema = z
+	.object({
+		v: z.literal(WINDOW_CONTRACT_VERSION),
+		/** Channel name, e.g. "window://opened". */
+		topic: z.string().min(1),
+		/** Emitting window label, or "core" for the Rust core. */
+		source_label: z.string().min(1),
+		target: WindowEventTargetSchema,
+		payload: z.unknown(),
+	})
+	.strict();
+export type WindowEventEnvelope = z.infer<typeof WindowEventEnvelopeSchema>;
+
+/** Canonical window-lifecycle channels emitted by the Rust core. */
+export const WINDOW_TOPICS = {
+	opened: 'window://opened',
+	closed: 'window://closed',
+	focusChanged: 'window://focus-changed',
+} as const;
+export type WindowTopic = (typeof WINDOW_TOPICS)[keyof typeof WINDOW_TOPICS];
+
+/**
+ * Channels that MUST be window-targeted (`emit_to`) rather than broadcast,
+ * because a broadcast races across windows (first-reply-wins / wrong-window).
+ * Everything not listed here stays broadcast + per-window topic filtering.
+ * (plans/multi-window 03-research-internal: the ~25-channel routing table.)
+ */
+export const WINDOW_TARGETED_CHANNELS = [
+	'screenshot://request',
+	'screenshot://shortcut',
+	'projects:active-changed',
+] as const;