@ikenga/contract 0.11.0 → 0.12.0

package/dist/index.d.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 declare const CONTRACT_PACKAGE_VERSION: "0.5.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -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';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pa-actions.d.ts

@@ -27,6 +27,25 @@ export interface DraftSequence {
     /** Audience size for this step (e.g. a 388-recipient newsletter section). */
     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
@@ -82,6 +101,22 @@ export interface DraftItem {
     threadCount?: string;
     /** Explicit section bucket; otherwise derived from `scheduledIso`. */
     section?: string;
+    /**
+     * 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;
 }
 /**
  * Partial-success result returned by a `ChannelAdapter.send()` call (DEC-9).

package/dist/pa-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pa-actions.d.ts","sourceRoot":"","sources":["../src/pa-actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pa-actions.d.ts","sourceRoot":"","sources":["../src/pa-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAChF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAErE,qCAAqC;AACrC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKtD,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvC,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,8FAA8F;IAC9F,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,cAAc,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACpD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sEAAsE;IACtE,cAAc,EAAE,MAAM,CAAC;IACvB,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,+EAA+E;IAC/E,EAAE,EAAE,OAAO,CAAC;IACZ,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC/B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;IACF,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,MAAM,CAGpE;AAYD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC5B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,eAAe,EACrB,GAAG,GAAE,MAAmB,GACtB,WAAW,CA4Cb"}

package/dist/pa-actions.js.map

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

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.11.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/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/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;