sliccy 6.130.1 → 6.131.0

package/README.md

@@ -76,7 +76,7 @@ SLICC is for you if:
 - **Read markdown and HTML, or read their source.** A `.md` or `.html` preview opens as the document — formatted prose, a laid-out page — with a **Source** toggle for the syntax-highlighted markup (and **Diff** when the file has uncommitted changes). HTML renders in a sandboxed frame that cannot run scripts or reach the app.
 - **Preview any file, not just the well-known types.** The previewer identifies files from their CONTENT rather than a list of extensions, so an unrecognized extension (`.jsh`, a `Justfile`) previews as source instead of refusing. Text is syntax-highlighted, PDFs render inline, and images, audio, and video play as before.
 - **Add visual and file context directly in chat.** Drop images or files onto the workspace, or use the paperclip button. Dropped `.skill` archives still install into `/workspace/skills`.
-- **Never lose a conversation to compaction.** Whenever a cone's history is summarized to fit the context window, the full transcript is first saved to `/sessions` as a live snapshot (one per cone, extended on every round) and the summary tells the agent where to find it. **New chat** completes that snapshot into a normal frozen session (Save / New chat, fast) or deletes it (Discard). With the experimental **Compact on idle** flag on, a cone that has sat idle for 30 minutes with a context of at least 200k tokens compacts in the background; if you come back mid-round, the round is thrown away and your chat continues as it was.
+- **Never lose a conversation to compaction.** Whenever a cone's history is summarized to fit the context window, the full transcript is first saved to `/sessions` as a live snapshot (one per cone, extended on every round) and the summary tells the agent where to find it. **New chat** completes that snapshot into a normal frozen session (Save / New chat, fast) or deletes it (Discard). With the experimental **Compact on idle** flag on, a cone that has sat idle for 30 minutes with a context of at least 200k tokens compacts in the background; if you come back mid-round, the round is thrown away and your chat continues as it was. Every compaction — idle or not — leaves a small marker in the transcript naming what happened, with a link to the snapshot it replaced; a round that ends up keeping nothing takes its marker back out.
 - **Inspect experimental features from the avatar menu.** When centrally managed flags enable the surface for the current runtime, click your avatar and choose **Experimental features…** to open its standalone dialog. The dialog may honestly be empty: `experimental-settings` controls its availability but is not itself user-toggleable.
 - **Steer a running turn instead of waiting for it.** In the chat composer, `Enter` sends — including from a hardware keyboard in the native iOS follower — and queues behind whatever the cone is already doing; `Shift+Enter` inserts a newline. `Ctrl+Enter` (`Cmd+Enter` on macOS) steers: the message is injected as soon as the current step finishes, so you can redirect the agent mid-turn.
 - **Boot full x86 virtual machines in the browser.** `v86 start` runs real operating systems (Alpine, FreeDOS, KolibriOS, ...) on the wasm-based [v86](https://github.com/copy/v86) emulator, entirely client-side. The agent drives the guest from the shell — type, click, screenshot, stream the screen live, save/restore state — and `-net <model>,relay=fetch` gives the guest HTTP access through SLICC's fetch proxy. Install with `ipk add -g v86`.

package/dist/node-server/_shared/agent-wire-types.d.ts

@@ -118,6 +118,26 @@ export type AgentEvent = {
 } | {
     type: 'turn_end';
     messageId: string;
+}
+/**
+ * A context-compaction round announcing itself as its own transcript row.
+ *
+ * Deliberately NOT a `message_start` / `content_delta` / `content_done`
+ * triple: a compaction round is not an assistant turn. Faking one made the
+ * UI's `message_start` handler declare the cone busy, and nothing ever
+ * cleared it — no `turn_end` follows a notice, and a live float drives
+ * `processing` from scoop-status broadcasts that only fire when the status
+ * CHANGES (an idle round never leaves `ready`). The stranded busy state
+ * then parked every later user submission in the queued stack while the
+ * agent answered it anyway (#2843).
+ *
+ * `messageId` is stable for the whole round, so the terminal state UPDATES
+ * the row the opening state created rather than appending a second one.
+ */
+ | {
+    type: 'compaction_notice';
+    messageId: string;
+    marker: ChatCompactionMarker;
 } | {
     type: 'error';
     error: string;
@@ -136,6 +156,34 @@ export type MessageRole = 'user' | 'assistant';
  * `dismissed` (denied). Drives the `<slicc-lick-card>` `state` attribute.
  */
 export type LickState = 'pending' | 'confirmed' | 'dismissed';
+/** What started a compaction round; mirrors `CompactionTrigger` in the webapp core. */
+export type CompactionMarkerTrigger = 'threshold' | 'overflow' | 'idle';
+/**
+ * How a compaction round ended, as the transcript shows it:
+ *
+ * - `summarizing` — in flight; the summary LLM call has not returned yet.
+ * - `summarized` — the history was replaced by a summary.
+ * - `fallback` — summarization was unavailable or failed, so older messages
+ *   were truncated WITHOUT a summary.
+ * - `discarded` — the round produced nothing the conversation kept: the user
+ *   came back mid-round (compact-on-idle aborts and throws the result away),
+ *   or the summary made no progress. A `discarded` marker is not a row to
+ *   render — hosts REMOVE the row, because announcing a compaction that never
+ *   happened is worse than saying nothing.
+ */
+export type CompactionMarkerState = 'summarizing' | 'summarized' | 'fallback' | 'discarded';
+/**
+ * The transcript's record of one context-compaction round. Carries state, not
+ * prose: every renderer (web `<slicc-compaction-marker>`, iOS
+ * `CompactionMarkerRow`) derives its own copy from these fields, so the two
+ * can never drift into different wordings of the same envelope.
+ */
+export interface ChatCompactionMarker {
+    trigger: CompactionMarkerTrigger;
+    state: CompactionMarkerState;
+    /** `/sessions` path of the pre-compaction transcript snapshot, once written. */
+    transcriptPath?: string;
+}
 export interface ChatMessage {
     id: string;
     role: MessageRole;
@@ -165,6 +213,12 @@ export interface ChatMessage {
     lickState?: LickState;
     /** True when the message is queued (submitted while the agent is still processing). */
     queued?: boolean;
+    /**
+     * Compaction-marker row: this message records a compaction round rather
+     * than anything anyone said. Set, the view renders a
+     * `<slicc-compaction-marker>` seam instead of an assistant bubble.
+     */
+    compaction?: ChatCompactionMarker;
     /**
      * Cone-error marker — set by the chat controller's `error` AgentEvent
      * handler. The view renders this assistant message as a `slicc-error-card`

package/dist/node-server/_shared/agent-wire-types.d.ts.map

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

package/dist/node-server/_shared/cdp-target-info.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `TargetInfo` — the subset of `packages/webapp/src/cdp/types.ts` the thin
+ * chrome extension needs (`Target.getTargets` results). The rest of that
+ * file (command/response/event envelopes, connection state, page-level
+ * types) stays webapp-internal; only this shape crosses the package
+ * boundary (#2276 slice E).
+ */
+/** Target info returned by Target.getTargets. */
+export interface TargetInfo {
+    targetId: string;
+    type: string;
+    title: string;
+    url: string;
+    attached: boolean;
+    browserContextId?: string;
+    /** True if this is the user's active tab (extension mode only). */
+    active?: boolean;
+}
+//# sourceMappingURL=cdp-target-info.d.ts.map

package/dist/node-server/_shared/cdp-target-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-target-info.d.ts","sourceRoot":"","sources":["../src/cdp-target-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/node-server/_shared/cdp-target-info.js

@@ -0,0 +1,9 @@
+/**
+ * `TargetInfo` — the subset of `packages/webapp/src/cdp/types.ts` the thin
+ * chrome extension needs (`Target.getTargets` results). The rest of that
+ * file (command/response/event envelopes, connection state, page-level
+ * types) stays webapp-internal; only this shape crosses the package
+ * boundary (#2276 slice E).
+ */
+export {};
+//# sourceMappingURL=cdp-target-info.js.map

package/dist/node-server/_shared/cdp-target-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-target-info.js","sourceRoot":"","sources":["../src/cdp-target-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/node-server/_shared/discovery-link.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Agentic Resource Discovery (ARD) `Link` extractor.
+ *
+ * The ARD spec advertises a capability manifest at
+ * `/.well-known/ai-catalog.json`. Beyond the well-known file, a response can
+ * point agents at it with a bare `rel="ai-catalog"` relation carried in an RFC
+ * 8288 `Link` header (or the equivalent HTML `<link rel="ai-catalog">`):
+ *
+ *   Link: <https://example.com/.well-known/ai-catalog.json>; rel="ai-catalog"
+ *
+ * Unlike SLICC's `handoff` / `upskill` rels (which are URI rels under the
+ * `https://www.sliccy.ai/rel/` namespace), `ai-catalog` is a bare token
+ * defined by the ARD spec — so recognition is a plain token match against the
+ * parsed `rel` list.
+ *
+ * This module is pure — no I/O. It is the `Link`-header half of discovery; the
+ * `/.well-known` fallback lives in `well-known-probe.ts`.
+ */
+import type { DiscoveryKind } from './agent-wire-types.js';
+import type { ParsedLink } from './link-header.js';
+/** The bare ARD relation token that advertises an `ai-catalog.json` manifest. */
+export declare const AI_CATALOG_REL = "ai-catalog";
+/**
+ * CDP `Network.Response.headers` bag. Header names map to string values;
+ * same-name headers are joined with `\n`.
+ */
+export type CdpResponseHeaders = Record<string, string>;
+export interface CatalogMatch {
+    /** Always `'ai-catalog'` for a `Link`-header match. */
+    kind: DiscoveryKind;
+    /** Absolute URL of the advertised `ai-catalog.json` manifest. */
+    url: string;
+}
+/**
+ * Find the first ARD `ai-catalog` link in a parsed Link header set.
+ *
+ * Rel comparison is exact-token and case-sensitive: RFC 8288 relation types
+ * are compared as-is, and the ARD spec's canonical token is lowercase
+ * `ai-catalog`. Returns `null` when no such relation is present.
+ */
+export declare function extractCatalog(links: ParsedLink[]): CatalogMatch | null;
+/**
+ * Stable identity for a discovery artifact, independent of the page URL that
+ * advertised it.
+ *
+ * A site can advertise the same `ai-catalog` rel on every page response (and
+ * the well-known probe re-checks the same origin on every navigation), so
+ * keying dedup on the page URL would never collapse repeats. Keying on the
+ * artifact identity (`origin` + `kind` + manifest `url`) lets callers surface a
+ * given discovery once per session and drop repeat sightings.
+ *
+ * The NUL separator can't appear in an origin, kind token, or URL, so
+ * concatenation is collision-free without hashing (mirrors
+ * `handoffFingerprint`).
+ */
+export declare function discoveryFingerprint(input: {
+    origin?: string;
+    kind?: string;
+    url?: string;
+}): string;
+export declare function extractCatalogFromCdpHeaders(headers: CdpResponseHeaders | undefined, baseUrl?: string): {
+    match: CatalogMatch | null;
+    links: ParsedLink[];
+};
+export declare function extractCatalogFromWebRequest(headers: Array<{
+    name: string;
+    value?: string;
+}> | undefined, baseUrl?: string): {
+    match: CatalogMatch | null;
+    links: ParsedLink[];
+};
+export declare function extractCatalogFromFetchHeaders(headers: Headers | undefined, baseUrl?: string): {
+    match: CatalogMatch | null;
+    links: ParsedLink[];
+};
+//# sourceMappingURL=discovery-link.d.ts.map

package/dist/node-server/_shared/discovery-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-link.d.ts","sourceRoot":"","sources":["../src/discovery-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQnD,iFAAiF;AACjF,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,aAAa,CAAC;IACpB,iEAAiE;IACjE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,YAAY,GAAG,IAAI,CAOvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,MAAM,CAET;AAID,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAKrD;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,EAC5D,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAKrD;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAKrD"}

package/dist/node-server/_shared/discovery-link.js

@@ -0,0 +1,76 @@
+/**
+ * Agentic Resource Discovery (ARD) `Link` extractor.
+ *
+ * The ARD spec advertises a capability manifest at
+ * `/.well-known/ai-catalog.json`. Beyond the well-known file, a response can
+ * point agents at it with a bare `rel="ai-catalog"` relation carried in an RFC
+ * 8288 `Link` header (or the equivalent HTML `<link rel="ai-catalog">`):
+ *
+ *   Link: <https://example.com/.well-known/ai-catalog.json>; rel="ai-catalog"
+ *
+ * Unlike SLICC's `handoff` / `upskill` rels (which are URI rels under the
+ * `https://www.sliccy.ai/rel/` namespace), `ai-catalog` is a bare token
+ * defined by the ARD spec — so recognition is a plain token match against the
+ * parsed `rel` list.
+ *
+ * This module is pure — no I/O. It is the `Link`-header half of discovery; the
+ * `/.well-known` fallback lives in `well-known-probe.ts`.
+ */
+import { getLinkHeaderValuesFromCdp, getLinkHeaderValuesFromHeaders, getLinkHeaderValuesFromWebRequest, parseLinkHeader, } from './link-header.js';
+/** The bare ARD relation token that advertises an `ai-catalog.json` manifest. */
+export const AI_CATALOG_REL = 'ai-catalog';
+/**
+ * Find the first ARD `ai-catalog` link in a parsed Link header set.
+ *
+ * Rel comparison is exact-token and case-sensitive: RFC 8288 relation types
+ * are compared as-is, and the ARD spec's canonical token is lowercase
+ * `ai-catalog`. Returns `null` when no such relation is present.
+ */
+export function extractCatalog(links) {
+    for (const link of links) {
+        if (link.rel.includes(AI_CATALOG_REL)) {
+            return { kind: 'ai-catalog', url: link.href };
+        }
+    }
+    return null;
+}
+/**
+ * Stable identity for a discovery artifact, independent of the page URL that
+ * advertised it.
+ *
+ * A site can advertise the same `ai-catalog` rel on every page response (and
+ * the well-known probe re-checks the same origin on every navigation), so
+ * keying dedup on the page URL would never collapse repeats. Keying on the
+ * artifact identity (`origin` + `kind` + manifest `url`) lets callers surface a
+ * given discovery once per session and drop repeat sightings.
+ *
+ * The NUL separator can't appear in an origin, kind token, or URL, so
+ * concatenation is collision-free without hashing (mirrors
+ * `handoffFingerprint`).
+ */
+export function discoveryFingerprint(input) {
+    return [input.origin ?? '', input.kind ?? '', input.url ?? ''].join('\u0000');
+}
+/* ────────── header-shape adapters that go straight to a catalog match ────────── */
+export function extractCatalogFromCdpHeaders(headers, baseUrl) {
+    const values = getLinkHeaderValuesFromCdp(headers);
+    if (values.length === 0)
+        return { match: null, links: [] };
+    const links = parseLinkHeader(values, baseUrl);
+    return { match: extractCatalog(links), links };
+}
+export function extractCatalogFromWebRequest(headers, baseUrl) {
+    const values = getLinkHeaderValuesFromWebRequest(headers);
+    if (values.length === 0)
+        return { match: null, links: [] };
+    const links = parseLinkHeader(values, baseUrl);
+    return { match: extractCatalog(links), links };
+}
+export function extractCatalogFromFetchHeaders(headers, baseUrl) {
+    const values = getLinkHeaderValuesFromHeaders(headers);
+    if (values.length === 0)
+        return { match: null, links: [] };
+    const links = parseLinkHeader(values, baseUrl);
+    return { match: extractCatalog(links), links };
+}
+//# sourceMappingURL=discovery-link.js.map

package/dist/node-server/_shared/discovery-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-link.js","sourceRoot":"","sources":["../src/discovery-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAe3C;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IACC,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChF,CAAC;AAED,qFAAqF;AAErF,MAAM,UAAU,4BAA4B,CAC1C,OAAuC,EACvC,OAAgB;IAEhB,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA4D,EAC5D,OAAgB;IAEhB,MAAM,MAAM,GAAG,iCAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAA4B,EAC5B,OAAgB;IAEhB,MAAM,MAAM,GAAG,8BAA8B,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC"}

package/dist/node-server/_shared/extension-bridge-protocol.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Extension bridge protocol: envelope contract spoken between the sliccy.ai
+ * leader tab and the extension service worker over the long-lived
+ * `chrome.runtime.connect` Port.
+ *
+ * Wave 3b — full CDP pass-through. The leader tab opens a Port to the
+ * extension via `chrome.runtime.connect(EXT_ID, { name: PORT_NAME })`; the SW
+ * gates the connection in `onConnectExternal` with the three-factor pin
+ * (origin allowlist + `sender.tab.id === storedLeaderTabId` + `sender.frameId
+ * === 0`) decided in Wave-1 Spike B. The envelope shapes below are the
+ * post-handshake wire format both sides exchange.
+ *
+ * The envelopes deliberately mirror the Cherry handshake/CDP-request shape
+ * (`packages/webapp/src/cdp/cherry-host-protocol.ts`) so the two transports
+ * stay structurally aligned; they are NOT interchangeable (Cherry is a
+ * synthetic CDP subset over postMessage; this one is full chrome.debugger
+ * pass-through over chrome.runtime.Port).
+ */
+import type { DiscoveryKind } from './agent-wire-types.js';
+import type { CDPPayload } from './tray-sync-protocol.js';
+/** Protocol version bumped on any breaking envelope change. */
+export declare const EXTENSION_BRIDGE_PROTOCOL_VERSION = 1;
+/** Port name the leader passes to `chrome.runtime.connect`. */
+export declare const EXTENSION_BRIDGE_PORT_NAME = "slicc.cdp-bridge";
+/** Envelope-shaped message with a non-current `bridge` version (version skew). */
+export interface ExtensionBridgeVersionMismatch {
+    bridge: number;
+    channelId: string;
+    kind: string;
+}
+export interface ExtensionBridgeHello {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'handshake.hello';
+}
+export interface ExtensionBridgeWelcome {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'handshake.welcome';
+}
+/**
+ * Handshake rejection. The SW posts this when the three-factor pin fails
+ * (e.g. `slicc_leader_tab_id` absent, sender tab mismatch, non-top-level
+ * frame). Pin failures fail closed: the SW disconnects right after.
+ */
+export interface ExtensionBridgeRejected {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'handshake.rejected';
+    reason: string;
+}
+export interface ExtensionBridgeCdpRequest {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'cdp.request';
+    id: number;
+    method: string;
+    /** Per-method CDP params; shape is known only to the caller that issued the method. */
+    params?: CDPPayload;
+    sessionId?: string;
+}
+export interface ExtensionBridgeCdpResponse {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'cdp.response';
+    id: number;
+    /** Per-method CDP result; shape depends on the request method. */
+    result?: CDPPayload;
+    error?: string;
+}
+export interface ExtensionBridgeCdpEvent {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'cdp.event';
+    method: string;
+    /** Per-method CDP event params; shape depends on `method`. */
+    params?: CDPPayload;
+    sessionId?: string;
+}
+/**
+ * Navigate/upskill lick pushed SW → leader tab. The SW observes a SLICC
+ * handoff `Link` header (`chrome.webRequest.onHeadersReceived`) and forwards
+ * it over the welcomed Port so the leader can inject it into the worker-side
+ * `LickManager`. The payload mirrors `dispatchNavigateEvent`'s fields in
+ * `scoops/lick-ws-bridge.ts` (the standalone `/licks-ws` navigate shape).
+ */
+export interface ExtensionBridgeLick {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'extension.lick';
+    verb: 'handoff' | 'upskill';
+    target: string;
+    url: string;
+    instruction?: string;
+    branch?: string;
+    path?: string;
+    title?: string;
+}
+/**
+ * Discovery lick pushed SW → leader tab. The SW observes an agentic-resource-
+ * discovery artifact on a main-frame document response — either a bare
+ * `rel="ai-catalog"` RFC 8288 `Link` header (`chrome.webRequest`) or a
+ * throttled per-origin well-known probe of `/.well-known/ai-catalog.json` /
+ * `/llms.txt` (host_permissions bypass CORS) — and forwards it over the
+ * welcomed Port so the leader can inject a `discovery` `LickEvent` into the
+ * worker-side `LickManager`. Mirrors {@link ExtensionBridgeLick} (the navigate
+ * path) but carries the structured discovery fields the `discovery` lick needs
+ * (`discoveryOrigin` + `discoveryKind` + `discoveryUrl`). Silent: no OS
+ * notification is shown for discovery (unlike a handoff).
+ */
+export interface ExtensionBridgeDiscovery {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'extension.discovery';
+    /** Origin the artifact was advertised on / found at. */
+    discoveryOrigin: string;
+    /** Which artifact: an ARD `ai-catalog` manifest or an `llms-txt` digest. */
+    discoveryKind: DiscoveryKind;
+    /** Absolute URL of the manifest (`ai-catalog.json`) or digest (`llms.txt`). */
+    discoveryUrl: string;
+    /** URL of the main-frame document whose response triggered the discovery. */
+    url: string;
+}
+/**
+ * Leader tray joinUrl pushed leader tab → SW. The leader's tray session mints a
+ * `/join/<trayId>.<secret>` URL that per-page cherry followers need to connect;
+ * the URL is NOT in the page URL itself (only `/tray/<trayId>` with no secret).
+ * The leader sends this over the welcomed Port so the SW can cache it and push
+ * it to injected per-page cherry relays. `null` when the tray drops (so the SW
+ * clears its cache).
+ */
+export interface ExtensionBridgeLeaderJoinUrl {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'leader.join-url';
+    joinUrl: string | null;
+}
+/**
+ * SW → leader tab: open the provider Settings dialog. Sent when the extension
+ * side-panel follower hands a sign-in off to the leader (a provider login can't
+ * complete in the cross-origin panel iframe). The SW focuses the leader tab and
+ * posts this so the user lands on an already-open Settings dialog instead of a
+ * dead tab. Carries no payload — it's a pure command.
+ */
+export interface ExtensionBridgeOpenSettings {
+    bridge: typeof EXTENSION_BRIDGE_PROTOCOL_VERSION;
+    channelId: string;
+    kind: 'extension.open-settings';
+}
+export type ExtensionBridgeEnvelope = ExtensionBridgeHello | ExtensionBridgeWelcome | ExtensionBridgeRejected | ExtensionBridgeCdpRequest | ExtensionBridgeCdpResponse | ExtensionBridgeCdpEvent | ExtensionBridgeLick | ExtensionBridgeDiscovery | ExtensionBridgeLeaderJoinUrl | ExtensionBridgeOpenSettings;
+/**
+ * Structural validator. Both sides MUST run this on every inbound message
+ * before acting on it — the Port is trusted (gated by `onConnectExternal`),
+ * but a buggy / outdated peer could still post malformed envelopes.
+ */
+export declare function isExtensionBridgeEnvelope(value: unknown): value is ExtensionBridgeEnvelope;
+/**
+ * True when a message is shaped like a bridge envelope but carries a DIFFERENT
+ * protocol version — i.e. the peer (hosted leader tab vs installed extension)
+ * is a version-skewed build, not Port noise. `isExtensionBridgeEnvelope`
+ * rejects these, so without this check a skewed peer is indistinguishable
+ * from the generic handshake timeout. Callers log it distinctly.
+ */
+export declare function isBridgeVersionMismatch(value: unknown): value is ExtensionBridgeVersionMismatch;
+//# sourceMappingURL=extension-bridge-protocol.d.ts.map

package/dist/node-server/_shared/extension-bridge-protocol.d.ts.map

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

package/dist/node-server/_shared/extension-bridge-protocol.js

@@ -0,0 +1,65 @@
+/**
+ * Extension bridge protocol: envelope contract spoken between the sliccy.ai
+ * leader tab and the extension service worker over the long-lived
+ * `chrome.runtime.connect` Port.
+ *
+ * Wave 3b — full CDP pass-through. The leader tab opens a Port to the
+ * extension via `chrome.runtime.connect(EXT_ID, { name: PORT_NAME })`; the SW
+ * gates the connection in `onConnectExternal` with the three-factor pin
+ * (origin allowlist + `sender.tab.id === storedLeaderTabId` + `sender.frameId
+ * === 0`) decided in Wave-1 Spike B. The envelope shapes below are the
+ * post-handshake wire format both sides exchange.
+ *
+ * The envelopes deliberately mirror the Cherry handshake/CDP-request shape
+ * (`packages/webapp/src/cdp/cherry-host-protocol.ts`) so the two transports
+ * stay structurally aligned; they are NOT interchangeable (Cherry is a
+ * synthetic CDP subset over postMessage; this one is full chrome.debugger
+ * pass-through over chrome.runtime.Port).
+ */
+/** Protocol version bumped on any breaking envelope change. */
+export const EXTENSION_BRIDGE_PROTOCOL_VERSION = 1;
+/** Port name the leader passes to `chrome.runtime.connect`. */
+export const EXTENSION_BRIDGE_PORT_NAME = 'slicc.cdp-bridge';
+const KINDS = new Set([
+    'handshake.hello',
+    'handshake.welcome',
+    'handshake.rejected',
+    'cdp.request',
+    'cdp.response',
+    'cdp.event',
+    'extension.lick',
+    'extension.discovery',
+    'leader.join-url',
+    'extension.open-settings',
+]);
+/**
+ * Structural validator. Both sides MUST run this on every inbound message
+ * before acting on it — the Port is trusted (gated by `onConnectExternal`),
+ * but a buggy / outdated peer could still post malformed envelopes.
+ */
+export function isExtensionBridgeEnvelope(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (v.bridge === EXTENSION_BRIDGE_PROTOCOL_VERSION &&
+        typeof v.channelId === 'string' &&
+        typeof v.kind === 'string' &&
+        KINDS.has(v.kind));
+}
+/**
+ * True when a message is shaped like a bridge envelope but carries a DIFFERENT
+ * protocol version — i.e. the peer (hosted leader tab vs installed extension)
+ * is a version-skewed build, not Port noise. `isExtensionBridgeEnvelope`
+ * rejects these, so without this check a skewed peer is indistinguishable
+ * from the generic handshake timeout. Callers log it distinctly.
+ */
+export function isBridgeVersionMismatch(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return (typeof v.bridge === 'number' &&
+        v.bridge !== EXTENSION_BRIDGE_PROTOCOL_VERSION &&
+        typeof v.channelId === 'string' &&
+        typeof v.kind === 'string');
+}
+//# sourceMappingURL=extension-bridge-protocol.js.map

package/dist/node-server/_shared/extension-bridge-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-bridge-protocol.js","sourceRoot":"","sources":["../src/extension-bridge-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAiK7D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAkC;IACrD,iBAAiB;IACjB,mBAAmB;IACnB,oBAAoB;IACpB,aAAa;IACb,cAAc;IACd,WAAW;IACX,gBAAgB;IAChB,qBAAqB;IACrB,iBAAiB;IACjB,yBAAyB;CAC1B,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAiC,CAAC;IAC5C,OAAO,CACL,CAAC,CAAC,MAAM,KAAK,iCAAiC;QAC9C,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;QAC1B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAuC,CAAC,CACrD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAiC,CAAC;IAC5C,OAAO,CACL,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAC5B,CAAC,CAAC,MAAM,KAAK,iCAAiC;QAC9C,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;QAC/B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAC3B,CAAC;AACJ,CAAC"}

package/dist/node-server/_shared/handoff-link.d.ts

@@ -0,0 +1,90 @@
+/**
+ * SLICC handoff link extractor.
+ *
+ * Replaces the legacy `x-slicc` response header with two custom rels carried
+ * in a standard RFC 8288 `Link` header:
+ *
+ *   Link: <https://github.com/owner/repo>; rel="https://www.sliccy.ai/rel/upskill"
+ *   Link: <>; rel="https://www.sliccy.ai/rel/handoff";
+ *         title*=UTF-8''Continue%20the%20signup%20flow
+ *
+ * SLICC dispatches by rel — the rel IS the verb. New verbs add new rels under
+ * the `https://www.sliccy.ai/rel/` namespace.
+ */
+import type { ParsedLink } from './link-header.js';
+export declare const HANDOFF_REL = "https://www.sliccy.ai/rel/handoff";
+export declare const UPSKILL_REL = "https://www.sliccy.ai/rel/upskill";
+/**
+ * CDP `Network.Response.headers` bag. Values are strings at runtime (same-name
+ * headers joined with `\n`); the protocol envelope leaves them untyped until
+ * `getLinkHeaderValuesFromCdp` narrows.
+ */
+export type CdpHeaderBag = Record<string, unknown>;
+export type HandoffVerb = 'handoff' | 'upskill';
+export interface HandoffMatch {
+    verb: HandoffVerb;
+    /**
+     * Absolute URL when the verb's payload is a URL (e.g. upskill points at a
+     * GitHub repo). For prose-only verbs (handoff), this resolves to the page
+     * itself via the empty `<>` anchor convention.
+     */
+    target: string;
+    /** Free-form prose instruction from the link's `title` parameter, if any. */
+    instruction?: string;
+    /**
+     * Optional branch name carried by the upskill rel's `branch` Link param.
+     * Only populated for the upskill verb; the handoff verb ignores both
+     * `branch` and `path` because its target is the page itself, not a repo.
+     */
+    branch?: string;
+    /**
+     * Optional sub-path under the upskill rel's repo carried by the `path`
+     * Link param. Canonical directory form: a trailing `/SKILL.md` (which
+     * some emitters include to point at the manifest itself) is stripped so
+     * downstream consumers always see the skill's containing directory.
+     * Only populated for the upskill verb.
+     */
+    path?: string;
+}
+export declare function isSafeUpskillBranch(value: string): boolean;
+export declare function isSafeUpskillPath(value: string): boolean;
+export declare function extractHandoff(links: ParsedLink[]): HandoffMatch | null;
+/**
+ * Stable identity for a handoff/upskill payload, independent of the page URL
+ * that advertised it.
+ *
+ * A site can emit the same SLICC `Link` rel on every page response (e.g. a
+ * site-wide upskill pointing at one repo). Keying dedup on the page URL would
+ * never collapse those because the path changes on every navigation, while the
+ * payload (`verb` + `target` repo + `branch` + `path`, or for the prose
+ * `handoff` verb the page `target` + `instruction`) stays constant. Keying on
+ * this fingerprint lets callers process a given handoff once and silently drop
+ * repeat sightings of the same payload within a session.
+ *
+ * The NUL separator can't appear in any of the parts (URLs, git refs, paths,
+ * and the RFC 8187-decoded title are all NUL-free), so concatenation is
+ * collision-free without hashing.
+ */
+export declare function handoffFingerprint(input: {
+    verb: string;
+    target: string;
+    branch?: string;
+    path?: string;
+    instruction?: string;
+}): string;
+export declare function extractHandoffFromCdpHeaders(headers: CdpHeaderBag | undefined, baseUrl?: string): {
+    match: HandoffMatch | null;
+    links: ParsedLink[];
+};
+export declare function extractHandoffFromWebRequest(headers: Array<{
+    name: string;
+    value?: string;
+}> | undefined, baseUrl?: string): {
+    match: HandoffMatch | null;
+    links: ParsedLink[];
+};
+export declare function extractHandoffFromFetchHeaders(headers: Headers | undefined, baseUrl?: string): {
+    match: HandoffMatch | null;
+    links: ParsedLink[];
+};
+//# sourceMappingURL=handoff-link.d.ts.map