@openchamber/sdk 2.5.3 → 2.6.0

package/dist/session-events.js

@@ -0,0 +1,108 @@
+/**
+ * Session events for an extension's service (`contributes.sessionEvents`).
+ *
+ * OpenChamber posts each event a package subscribed to as one HTTP request to
+ * the service at `SESSION_EVENTS_PATH`, from every project, whether or not a
+ * window is open. Approving the package is the subscription: the request
+ * carries identifiers only (`event`), and the `transcript` capability, asked
+ * for with `content: true`, adds what the agent said or asked (`content`).
+ * The service answers `{ ok: true }` once it has taken the event; OpenChamber
+ * reads nothing else from the answer. Which projects an extension acts on is
+ * its own business: filter on `event.project.directory`.
+ */
+/**
+ * `turn-finished`: the session went idle with nothing waiting (no running
+ * subagent, no open permission, question or page, no goal or auto-review
+ * step still driving it). `turn-failed`: the turn ended in an error.
+ * `permission-asked`: the agent asked for a permission the user has to
+ * answer. `question-asked`: the agent asked the user a question through a
+ * form or a page. A turn the user stopped emits nothing.
+ */
+export const GUEST_SESSION_EVENT_TYPES = ['turn-finished', 'turn-failed', 'permission-asked', 'question-asked'];
+/** Route on the service loopback OpenChamber posts every event to. */
+export const SESSION_EVENTS_PATH = '/session-events';
+/** The `v` of every request; a service answers a version it does not know with HTTP 400. */
+export const SESSION_EVENTS_WIRE_VERSION = 1;
+/** One delivery may take this long; a slower service drops that event. */
+export const SESSION_EVENT_TIMEOUT_MS = 10_000;
+/** No event for this long stops the service; the next event starts it again. */
+export const SESSION_EVENTS_IDLE_MS = 10 * 60_000;
+/** Characters of the agent's reply carried in `content`; a longer reply is cut and flagged. */
+export const SESSION_EVENT_REPLY_MAX = 64_000;
+/** Events kept while the service starts; newer ones past this are dropped. */
+export const SESSION_EVENT_PENDING_MAX = 200;
+/** Characters of `error` OpenChamber reads from a failed answer. */
+export const SESSION_EVENT_ERROR_MAX = 2_000;
+const EVENT_TYPES = new Set(GUEST_SESSION_EVENT_TYPES);
+export const isGuestSessionEventType = (value) => EVENT_TYPES.has(value);
+/**
+ * A service's read of the body OpenChamber posted to `SESSION_EVENTS_PATH`.
+ * OpenChamber built the event, so this checks the envelope and the fields a
+ * service branches on, not every content field, and the service bundle needs
+ * no schema library. `null` is a body that is not a session event of this
+ * wire version; answer it with HTTP 400.
+ */
+export const readSessionEventRequest = (body) => {
+    let wire;
+    try {
+        const parsed = JSON.parse(body);
+        if (Object(parsed) !== parsed || parsed === null)
+            return null;
+        wire = parsed;
+    }
+    catch {
+        return null;
+    }
+    const { v, requestId, event, content } = wire;
+    if (v !== SESSION_EVENTS_WIRE_VERSION)
+        return null;
+    if (String(requestId) !== requestId || requestId.length === 0)
+        return null;
+    if (Object(event) !== event || event === undefined)
+        return null;
+    const { id, type, at, session, project, linked, permission } = event;
+    if (String(id) !== id || id.length === 0)
+        return null;
+    if (String(type) !== type || !isGuestSessionEventType(type))
+        return null;
+    if (!Number.isFinite(at))
+        return null;
+    if (Object(session) !== session || session === undefined)
+        return null;
+    const sessionId = session.id;
+    if (String(sessionId) !== sessionId || sessionId.length === 0)
+        return null;
+    const parentId = session.parentId;
+    if (parentId !== null && (String(parentId) !== parentId || parentId.length === 0))
+        return null;
+    if (Object(project) !== project || project === undefined)
+        return null;
+    const directory = project.directory;
+    if (directory !== null && (String(directory) !== directory || directory.length === 0))
+        return null;
+    if (!Array.isArray(linked))
+        return null;
+    // SAFETY: OpenChamber built `linked` from the session's stored link entries;
+    // a service reads each item under `GuestSessionLinkedItem`.
+    const request = {
+        v: SESSION_EVENTS_WIRE_VERSION,
+        requestId,
+        event: { id, type, at: Number(at), session: { id: sessionId, parentId }, project: { directory }, linked: linked },
+    };
+    if (permission !== undefined) {
+        if (Object(permission) !== permission)
+            return null;
+        const permissionRequestId = permission.requestId;
+        if (String(permissionRequestId) !== permissionRequestId || permissionRequestId.length === 0)
+            return null;
+        request.event.permission = { requestId: permissionRequestId };
+    }
+    if (content !== undefined) {
+        if (Object(content) !== content || content.type !== type)
+            return null;
+        // SAFETY: the content's `type` equals the event's, and OpenChamber built
+        // the rest of it for that type (`GuestSessionEventContent`).
+        request.content = content;
+    }
+    return request;
+};

package/dist/ui/progress.d.ts

@@ -7,5 +7,9 @@ export type ProgressProps = {
     label?: string;
 };
 export type ProgressHandle = Handle<ProgressProps>;
+/**
+ * The whole percent shown: rounded down, so it never reads 100% before the
+ * work is done (99.6 shows 99), and 100 only once the value reaches it.
+ */
 export declare const clampProgress: (value: number) => number;
 export declare const mountProgress: (root: Element, initial: ProgressProps) => ProgressHandle;

package/dist/ui/progress.js

@@ -1,14 +1,22 @@
 import { applyTone } from './badge.js';
-import { el, ensureStyle, setText } from './dom.js';
+import { el, ensureStyle, setAttr, setText } from './dom.js';
+import { icon } from './icons.js';
 import { UI_CSS } from './style.js';
-export const clampProgress = (value) => (Number.isFinite(value) ? Math.min(100, Math.max(0, Math.round(value))) : 0);
+/**
+ * The whole percent shown: rounded down, so it never reads 100% before the
+ * work is done (99.6 shows 99), and 100 only once the value reaches it.
+ */
+export const clampProgress = (value) => (Number.isFinite(value) ? Math.min(100, Math.max(0, Math.floor(value))) : 0);
 export const mountProgress = (root, initial) => {
     ensureStyle(UI_CSS);
     let props = initial;
     const node = el('div', 'oc-sdk oc-sdk-progress');
     const caption = el('div', 'oc-sdk-progress-label');
     const label = el('span');
-    const percent = el('span');
+    const percent = el('span', 'oc-sdk-progress-value');
+    const percentText = el('span');
+    const doneMark = icon('check', 14);
+    percent.append(doneMark, percentText);
     caption.append(label, percent);
     const track = el('div', 'oc-sdk-progress-track');
     track.setAttribute('role', 'progressbar');
@@ -28,7 +36,12 @@ export const mountProgress = (root, initial) => {
         else
             track.removeAttribute('aria-label');
         setText(label, props.label);
-        setText(percent, `${value}%`);
+        setText(percentText, `${value}%`);
+        // Done reads as done: the app's progress turns green with a check. A bar
+        // the extension tinted keeps its tone, as the served look keeps its fill.
+        const done = value === 100 && (!props.tone || props.tone === 'neutral');
+        setAttr(node, 'data-done', done ? 'true' : null);
+        doneMark.style.display = done ? '' : 'none';
         caption.hidden = !props.label;
     };
     paint();

package/dist/ui/style.js

@@ -67,30 +67,31 @@ const focusFill = `background-image: linear-gradient(${hover}, ${hover});`;
  * is that border: an inset ring would paint inside it, 1px in from the edge,
  * with a strip of fill around it. Fields have no border and keep the ring.
  */
-const field = (edge) => `box-shadow: inset 0 0 0 1px ${edge}, var(--oc-sdk-field-lift);`;
+// Half a pixel at rest; a focused or invalid field takes a full one.
+const field = (edge, width = '0.5px') => `box-shadow: inset 0 0 0 ${width} ${edge}, var(--oc-sdk-field-lift);`;
 const raised = 'border-color: var(--oc-sdk-edge); box-shadow: var(--oc-sdk-raised-lift);';
 const litButton = 'box-shadow: var(--oc-sdk-lit);';
-const darkLift = `inset 0 1px 0 0 ${mix(fg, 1.5)}, 0 1px 1px 0 rgb(0 0 0 / 0.28), 0 2px 3px -2px rgb(0 0 0 / 0.2)`;
+const darkLift = `inset 0 0.5px 0 0 ${mix(fg, 8)}, 0 1px 2px 0 rgb(0 0 0 / 0.4)`;
 const THEME_VARS = `
 :root {
-  --oc-sdk-edge: ${mix(fg, 10)};
+  --oc-sdk-edge: ${mix(fg, 16)};
   --oc-sdk-field-bg: ${elevated};
   --oc-sdk-raised-bg: ${bg};
   --oc-sdk-field-lift: inset 0 1px 2px 0 rgb(0 0 0 / 0.04);
-  --oc-sdk-raised-lift: 0 1px 2px 0 rgb(0 0 0 / 0.06);
-  --oc-sdk-lit: inset 0 1px 0 0 rgb(255 255 255 / 0.45), 0 1px 2px 0 rgb(0 0 0 / 0.08);
-  --oc-sdk-float-edge: rgb(0 0 0 / 0.1);
-  --oc-sdk-float: inset 0 1px 0 0 rgb(255 255 255 / 0.8), inset 0 0 0 1px rgb(0 0 0 / 0.04), 0 1px 2px -0.5px rgb(0 0 0 / 0.08), 0 4px 8px -2px rgb(0 0 0 / 0.08), 0 12px 20px -4px rgb(0 0 0 / 0.08);
+  --oc-sdk-raised-lift: 0 1px 1.5px 0 rgb(0 0 0 / 0.08);
+  --oc-sdk-lit: inset 0 1px 0 0 rgb(255 255 255 / 0.2), 0 1px 1.5px 0 rgb(0 0 0 / 0.1);
+  --oc-sdk-float-edge: rgb(0 0 0 / 0.14);
+  --oc-sdk-float: inset 0 1px 0 0 rgb(255 255 255 / 0.7), 0 1px 2px -0.5px rgb(0 0 0 / 0.06), 0 4px 8px -2px rgb(0 0 0 / 0.08), 0 12px 20px -4px rgb(0 0 0 / 0.06);
 }
 :root[data-oc-theme="dark"] {
-  --oc-sdk-edge: ${mix(fg, 6)};
+  --oc-sdk-edge: ${mix(fg, 14)};
   --oc-sdk-field-bg: ${mix(bg, 50, elevated)};
   --oc-sdk-raised-bg: ${elevated};
   --oc-sdk-field-lift: ${darkLift};
   --oc-sdk-raised-lift: ${darkLift};
-  --oc-sdk-lit: inset 0 1px 0 0 ${mix(fg, 1.5)}, 0 1px 1px 0 rgb(0 0 0 / 0.28), 0 2px 3px -2px rgb(0 0 0 / 0.2);
-  --oc-sdk-float-edge: rgb(0 0 0 / 0.36);
-  --oc-sdk-float: inset 0 1px 0 0 rgb(255 255 255 / 0.06), inset 0 0 0 1px rgb(255 255 255 / 0.08), 0 1px 1px -0.5px rgb(0 0 0 / 0.22), 0 3px 3px -1.5px rgb(0 0 0 / 0.2), 0 6px 6px -3px rgb(0 0 0 / 0.16);
+  --oc-sdk-lit: ${darkLift};
+  --oc-sdk-float-edge: rgb(0 0 0 / 0.55);
+  --oc-sdk-float: inset 0 1px 0 0 rgb(255 255 255 / 0.04), inset 0 0 0 0.5px rgb(255 255 255 / 0.08), 0 8px 16px 0 rgb(0 0 0 / 0.25), 0 4px 8px 0 rgb(0 0 0 / 0.25);
 }`;
 const tone = (name) => {
     const color = v(`status-${name}`, 'currentColor');
@@ -192,6 +193,8 @@ textarea.oc-sdk-input { height: auto; padding: 8px 10px; resize: vertical; }
 .oc-sdk-progress-label { display: flex; justify-content: space-between; font-size: 0.75rem; font-variant-numeric: tabular-nums; }
 .oc-sdk-progress-track { height: 6px; overflow: hidden; }
 .oc-sdk-progress-fill { height: 100%; transform-origin: left; transition: transform 200ms ease-out; }
+.oc-sdk-progress-value { display: inline-flex; align-items: center; gap: 2px; }
+.oc-sdk-progress[data-done="true"] .oc-sdk-progress-value { font-weight: 600; }
 
 .oc-sdk-menu { position: relative; display: inline-flex; }
 
@@ -238,8 +241,8 @@ ${tone('success')}${tone('warning')}${tone('error')}${tone('info')}
 .oc-sdk-input { border-radius: ${controlRadius}; background: var(--oc-sdk-field-bg); color: ${elevatedFg}; ${field('var(--oc-sdk-edge)')} transition: background 150ms ease-out; }
 .oc-sdk-input::placeholder { color: ${muted}; }
 .oc-sdk-input:hover:not(:focus) { background-image: linear-gradient(${hover}, ${hover}); }
-.oc-sdk-input:focus, .oc-sdk-input:focus-visible { ${field(mix(fg, 26))} }
-.oc-sdk-field[data-invalid="true"] .oc-sdk-input, .oc-sdk-field[data-invalid="true"] .oc-sdk-input:focus { ${field(v('status-error', 'red'))} }
+.oc-sdk-input:focus, .oc-sdk-input:focus-visible { ${field(mix(fg, 26), '1px')} }
+.oc-sdk-field[data-invalid="true"] .oc-sdk-input, .oc-sdk-field[data-invalid="true"] .oc-sdk-input:focus { ${field(v('status-error', 'red'), '1px')} }
 .oc-sdk-input[data-mono="true"] { font-family: ${mono}; }
 
 .oc-sdk-search-icon { color: ${muted}; }
@@ -252,7 +255,7 @@ ${tone('success')}${tone('warning')}${tone('error')}${tone('info')}
 .oc-sdk-trigger[aria-expanded="true"] { background-image: linear-gradient(${active}, ${active}); }
 .oc-sdk-trigger-value[data-empty="true"] { color: ${muted}; }
 .oc-sdk-trigger-chevron { color: ${muted}; }
-/* The app's dropdown light: lit top, hairline rings and a layered shadow. Its outer ring is the border, over the page like the app's. */
+/* The app's floating level: the glass edge (a hairline ring and a lit top line, dark outside and light inside in dark themes) over soft shadows. The outer ring is the border, over the page like the app's. */
 .oc-sdk-popup { --surface-foreground: ${elevatedFg}; border-color: var(--oc-sdk-float-edge); border-radius: 12px; background: ${elevated}; background-clip: padding-box; color: ${elevatedFg}; box-shadow: var(--oc-sdk-float); }
 .oc-sdk-option { border-radius: 8px; }
 .oc-sdk-option[data-active="true"] { background: ${hover}; }
@@ -284,7 +287,8 @@ ${tone('success')}${tone('warning')}${tone('error')}${tone('info')}
 .oc-sdk-tabs[data-track="true"] .oc-sdk-tab[aria-selected="true"] { color: ${elevatedFg}; background: var(--oc-sdk-raised-bg); ${raised} }
 .oc-sdk-tab-count { color: ${muted}; }
 
-.oc-sdk-badge { border-radius: 9999px; background: ${hover}; color: ${muted}; }
+/* The app's neutral badge: a step of the text colour, the same in every theme. */
+.oc-sdk-badge { border-radius: 9999px; background: ${mix(fg, 6)}; color: ${muted}; }
 .oc-sdk-badge[data-tone] { color: var(--oc-sdk-tone-text, var(--oc-sdk-tone)); background: ${mix('var(--oc-sdk-tone)', 15)}; }
 
 .oc-sdk-row { border-radius: 6px; transition: background 120ms ease-out; }
@@ -310,8 +314,11 @@ ${tone('success')}${tone('warning')}${tone('error')}${tone('info')}
 .oc-sdk-separator::before, .oc-sdk-separator::after { background: ${mix(border, 40)}; }
 
 .oc-sdk-progress-label { color: ${muted}; }
-.oc-sdk-progress-track { border-radius: 9999px; background: ${border}; }
+/* The app's progress: a groove a step of the text colour, green once done. Older bundles mark done only through aria-valuenow. */
+.oc-sdk-progress-track { border-radius: 9999px; background: ${mix(fg, 6)}; }
 .oc-sdk-progress-fill { border-radius: 9999px; background: var(--oc-sdk-tone, ${primary}); }
+.oc-sdk-progress-track[aria-valuenow="100"] > .oc-sdk-progress-fill:not([data-tone]) { background: ${v('status-success', 'currentColor')}; }
+.oc-sdk-progress[data-done="true"] .oc-sdk-progress-value { color: ${v('success-text', 'inherit')}; }
 
 .oc-sdk-text a { color: ${primaryText}; text-decoration: underline; text-underline-offset: 2px; }
 .oc-sdk-text img { border-radius: 8px; border: 1px solid ${mix(border, 60)}; }

package/dist/workspace-schemas.d.ts

@@ -60,6 +60,7 @@ export declare const guestWorkspaceSnapshotSchema: z.ZodDiscriminatedUnion<[z.Zo
         title: z.ZodString;
         projectId: z.ZodString;
         directory: z.ZodString;
+        agent: z.ZodOptional<z.ZodString>;
         parentId: z.ZodNullable<z.ZodString>;
         createdAt: z.ZodNumber;
         updatedAt: z.ZodNumber;

package/dist/workspace-schemas.js

@@ -17,7 +17,9 @@ export const guestWorkspaceSnapshotSchema = z.discriminatedUnion('kind', [
     z.object({ kind: z.literal('sessions'), projectId: identity, state,
         coverage: z.array(z.object({ directory: identity, state })),
         sessions: z.array(z.object({
-            id: identity, title: z.string(), projectId: identity, directory: identity, parentId: identity.nullable(),
+            id: identity, title: z.string(), projectId: identity, directory: identity,
+            agent: z.string().optional(),
+            parentId: identity.nullable(),
             createdAt: z.number(), updatedAt: z.number(), archivedAt: z.number().nullable(), worktree: worktree.nullable(),
             activity: z.enum(['unknown', 'idle', 'running', 'retrying', 'waiting-permission', 'waiting-question']),
             outcome: z.enum(['completed', 'failed']).nullable(), items: z.array(z.object({ id: identity, data: z.json().optional() })),

package/dist/workspace.d.ts

@@ -29,6 +29,8 @@ export type GuestSessionRecord = {
     title: string;
     projectId: string;
     directory: string;
+    /** The agent the session runs as. Absent from hosts older than this field. */
+    agent?: string;
     parentId: string | null;
     createdAt: number;
     updatedAt: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openchamber/sdk",
-  "version": "2.5.3",
+  "version": "2.6.0",
   "description": "Contract for OpenChamber guests: manifest parse and iframe host bridge.",
   "private": false,
   "license": "MIT",