antechamber 0.1.0 → 0.2.0

package/dist/types.d.ts

@@ -12,14 +12,42 @@ export interface OCSession {
     projectID: string;
     directory: string;
     parentID?: string;
+    parentMessageID?: string;
+    agent?: string;
+    model?: {
+        id: string;
+        providerID: string;
+        variant?: string;
+    };
+    metadata?: Record<string, unknown>;
+    outcome?: "succeeded" | "failed" | "interrupted";
+    slug?: string;
+    path?: string;
+    summary?: {
+        additions: number;
+        deletions: number;
+        files: number;
+    };
+    tokens?: {
+        input: number;
+        output: number;
+        reasoning: number;
+        cache: {
+            read: number;
+            write: number;
+        };
+    };
     title: string;
     version: string;
     revert?: {
         messageID: string;
     };
+    /** USD spent by this session's own assistant messages; OpenChamber adds child sessions via parentID. */
+    cost?: number;
     time: {
         created: number;
         updated: number;
+        idle?: number;
         compacting?: number;
         /** Epoch ms — presence marks the session archived (SDK v2 session.update). */
         archived?: number;
@@ -34,6 +62,10 @@ export interface OCUserMessage {
     };
     agent: string;
     model: OCModelRef;
+    /** No-reply context admitted without a turn (v2 lists it as `type: "synthetic"`). */
+    synthetic?: boolean;
+    /** Client metadata sent with the prompt (OpenChamber 2.x). */
+    metadata?: Record<string, unknown>;
 }
 export interface OCAssistantMessage {
     id: string;
@@ -68,6 +100,8 @@ export interface OCAssistantMessage {
             message: string;
         };
     };
+    /** Marks a compaction summary (OpenCode `AssistantMessage.summary`). */
+    summary?: boolean;
 }
 export type OCMessage = OCUserMessage | OCAssistantMessage;
 export interface OCTextPart {
@@ -144,7 +178,42 @@ export interface OCToolPart {
     tool: string;
     state: OCToolState;
 }
-export type OCPart = OCTextPart | OCReasoningPart | OCToolPart;
+/** OpenChamber renders a user message holding this part as `/compact`. */
+export interface OCCompactionPart {
+    id: string;
+    sessionID: string;
+    messageID: string;
+    type: "compaction";
+    auto: boolean;
+}
+export type OCPromptPart = ({
+    type: "text";
+    text: string;
+    synthetic?: boolean;
+} | {
+    type: "file";
+    mime: string;
+    url: string;
+    filename?: string;
+} | {
+    type: "agent";
+    name: string;
+    source?: {
+        value: string;
+        start: number;
+        end: number;
+    };
+}) & {
+    id?: string;
+};
+export type OCInputPart = OCPromptPart & {
+    id: string;
+    sessionID: string;
+    messageID: string;
+};
+export type OCPart = OCTextPart | OCReasoningPart | OCToolPart | OCCompactionPart | Exclude<OCInputPart, {
+    type: "text";
+}>;
 export interface OCMessageWithParts {
     info: OCMessage;
     parts: OCPart[];
@@ -169,6 +238,15 @@ export type OCEvent = {
             delivery: "steer" | "queue";
             payload: {
                 text: string;
+                files?: Array<Record<string, unknown>>;
+                agents?: Array<Record<string, unknown>>;
+                metadata?: Record<string, unknown>;
+            };
+        } | {
+            type: "synthetic";
+            payload: {
+                text: string;
+                metadata?: Record<string, unknown>;
             };
         };
     };
@@ -197,6 +275,79 @@ export type OCEvent = {
     properties: {
         info: OCSession;
     };
+} | {
+    type: "session.revert.staged";
+    properties: {
+        sessionID: string;
+        revert: {
+            messageID: string;
+        };
+    };
+} | {
+    type: "session.revert.cleared";
+    properties: {
+        sessionID: string;
+    };
+} | {
+    type: "session.revert.committed";
+    properties: {
+        sessionID: string;
+        to: string;
+    };
+} | {
+    type: "session.compaction.started";
+    properties: {
+        sessionID: string;
+        reason: string;
+        inputID: string;
+    };
+} | {
+    type: "session.compaction.ended";
+    properties: {
+        sessionID: string;
+        reason: string;
+        inputID: string;
+        text: string;
+        recent: string;
+    };
+} | {
+    type: "session.compaction.failed";
+    properties: {
+        sessionID: string;
+        reason: string;
+        inputID: string;
+        error: {
+            name: string;
+            data: {
+                message: string;
+            };
+        };
+    };
+} | {
+    type: "session.shell.started" | "session.shell.ended";
+    properties: {
+        sessionID: string;
+        shell: {
+            id: string;
+            command: string;
+            cwd: string;
+            shell: string;
+            file: string;
+            status: "running" | "exited" | "timeout" | "killed";
+            exit?: number;
+            metadata: Record<string, unknown>;
+            time: {
+                started: number;
+                completed?: number;
+            };
+        };
+        output?: {
+            output: string;
+            cursor: number;
+            size: number;
+            truncated: boolean;
+        };
+    };
 } | {
     type: "session.deleted";
     properties: {
@@ -241,6 +392,15 @@ export type OCEvent = {
         part: OCPart;
         delta?: string;
     };
+} | {
+    type: "message.part.delta";
+    properties: {
+        sessionID: string;
+        messageID: string;
+        partID: string;
+        field: "text";
+        delta: string;
+    };
 } | {
     type: "permission.asked";
     properties: {
@@ -320,12 +480,15 @@ export interface OCProject {
     vcs?: "git";
     time: {
         created: number;
+        updated?: number;
         initialized?: number;
     };
+    sandboxes?: string[];
 }
 /** Incoming prompt body for POST /session/{id}/message and /prompt_async */
 export interface OCPromptBody {
     messageID?: string;
+    delivery?: "steer" | "queue";
     model?: OCModelRef;
     agent?: string;
     noReply?: boolean;

package/dist/v2.d.ts

@@ -92,7 +92,7 @@ interface CatalogProviderLike {
     name: string;
     models: Record<string, CatalogModelLike>;
 }
-export interface CatalogLike {
+interface CatalogLike {
     providers: CatalogProviderLike[];
     defaults: Record<string, string>;
     /** The model the agent reported as active (see catalog.ts). */
@@ -108,6 +108,7 @@ export declare function defaultV2Model(cat: CatalogLike): V2Model | undefined;
 export interface V2Session {
     id: string;
     parentID?: string;
+    parentMessageID?: string;
     projectID: string;
     agent: string;
     model?: {
@@ -127,6 +128,12 @@ export interface V2Session {
     location: {
         directory: string;
     };
+    directory: string;
+    metadata?: Record<string, unknown>;
+    outcome?: OCSession["outcome"];
+    revert?: {
+        messageID: string;
+    };
 }
 export declare function toV2Session(info: OCSession, opts?: {
     model?: OCModelRef | undefined;
@@ -139,8 +146,11 @@ export interface V2Message {
         completed?: number;
         streamed?: number;
     };
-    type: "user" | "assistant";
+    type: "user" | "assistant" | "synthetic";
     text?: string;
+    files?: Array<Record<string, unknown>>;
+    agents?: Array<Record<string, unknown>>;
+    metadata?: Record<string, unknown>;
     agent?: string;
     model?: {
         id: string;
@@ -153,8 +163,6 @@ export interface V2Message {
     tokens?: V2Tokens;
     error?: OCAssistantMessage["error"];
 }
-/** v2 user message (list + prompt response): the UI reads `.text`. */
-export declare function toV2UserMessage(info: OCMessageWithParts): V2Message;
 /**
  * v2 assistant message: parts become `content` blocks. The UI rebuilds
  * text/reasoning part ids from per-type indices into this array.
@@ -162,6 +170,11 @@ export declare function toV2UserMessage(info: OCMessageWithParts): V2Message;
 export declare function toV2AssistantMessage(info: OCMessageWithParts): V2Message;
 export declare function toV2Message(info: OCMessageWithParts): V2Message;
 export interface V2Envelope {
+    durable?: {
+        aggregateID: string;
+        seq: number;
+        version: number;
+    };
     id: string;
     created: number;
     type: string;
@@ -177,6 +190,7 @@ export interface V2Envelope {
  */
 export declare class V2EventTranslator {
     private sessions;
+    private sequences;
     translate(directory: string, ev: OCEvent): V2Envelope[];
     private onStatus;
     private onMessageUpdated;

package/dist/v2.js

@@ -24,6 +24,7 @@
 import { randomUUID } from "node:crypto";
 import { getAgentName } from "./agent-name.js";
 import { questionFormID, toQuestionForm } from "./question-forms.js";
+import { v2PromptAttachments } from "./prompt-parts.js";
 function genId(prefix) {
     return `${prefix}_${randomUUID().replaceAll("-", "")}`;
 }
@@ -89,35 +90,51 @@ export function toV2Session(info, opts = {}) {
         id: info.id,
         projectID: info.projectID,
         agent: opts.agent ?? getAgentName(),
-        cost: 0,
-        tokens: zeroTokens(),
+        cost: info.cost ?? 0,
+        tokens: info.tokens ?? zeroTokens(),
         time: {
             created: info.time.created,
             updated: info.time.updated,
+            ...(info.time.idle !== undefined ? { idle: info.time.idle } : {}),
             ...(info.time.archived !== undefined ? { archived: info.time.archived } : {}),
         },
         title: info.title,
         subpath: subpathOf(info.directory),
         location: { directory: info.directory },
+        directory: info.directory,
+        ...(info.metadata !== undefined ? { metadata: info.metadata } : {}),
+        ...(info.outcome !== undefined ? { outcome: info.outcome } : {}),
+        ...(info.revert !== undefined ? { revert: info.revert } : {}),
     };
     if (info.parentID !== undefined)
         session.parentID = info.parentID;
+    if (info.parentMessageID !== undefined)
+        session.parentMessageID = info.parentMessageID;
     if (opts.model !== undefined) {
-        session.model = { id: opts.model.modelID, providerID: opts.model.providerID };
+        session.model = {
+            id: opts.model.modelID,
+            providerID: opts.model.providerID,
+            variant: info.model?.variant ?? "default",
+        };
     }
     return session;
 }
 /** v2 user message (list + prompt response): the UI reads `.text`. */
-export function toV2UserMessage(info) {
-    const text = info.parts
-        .filter((p) => p.type === "text")
-        .map((p) => p.text)
-        .join("");
+function toV2UserMessage(info) {
+    const text = info.parts.map((p) => (p.type === "text" ? p.text : p.type === "compaction" ? "/compact" : "")).join("");
+    const user = info.info;
+    const metadata = user.metadata !== undefined ? { metadata: user.metadata } : {};
+    // Admitted no-reply context lists as OpenCode's synthetic item, not as a user turn.
+    if (user.synthetic)
+        return { id: user.id, time: { created: user.time.created }, type: "synthetic", text, ...metadata };
+    const inputs = info.parts.flatMap((part) => (part.type === "file" || part.type === "agent" ? [part] : []));
     return {
-        id: info.info.id,
-        time: { created: info.info.time.created },
+        id: user.id,
+        time: { created: user.time.created },
         type: "user",
         text,
+        ...v2PromptAttachments(inputs),
+        ...metadata,
     };
 }
 /**
@@ -126,7 +143,7 @@ export function toV2UserMessage(info) {
  */
 export function toV2AssistantMessage(info) {
     const i = info.info;
-    const model = { id: i.modelID, providerID: i.providerID };
+    const model = { id: i.modelID, providerID: i.providerID, variant: "default" };
     const content = [];
     for (const part of info.parts) {
         if (part.type === "text") {
@@ -142,13 +159,16 @@ export function toV2AssistantMessage(info) {
                 },
             });
         }
-        else {
+        else if (part.type === "tool") {
             content.push(toolContent(part));
         }
     }
     const msg = { id: i.id, time: { created: i.time.created }, type: "assistant", content };
     if (i.time.completed !== undefined)
         msg.time.completed = i.time.completed;
+    const streamed = info.parts.flatMap((part) => part.type === "text" || part.type === "reasoning" ? (part.time?.start === undefined ? [] : [part.time.start]) : []);
+    if (streamed.length > 0)
+        msg.time.streamed = Math.min(...streamed);
     msg.agent = i.mode;
     msg.model = model;
     if (i.finish !== undefined)
@@ -217,10 +237,19 @@ export function toV2Message(info) {
  */
 export class V2EventTranslator {
     sessions = new Map();
+    sequences = new Map();
     translate(directory, ev) {
         switch (ev.type) {
             case "session.inbox.enqueued":
             case "session.inbox.delivered":
+            case "session.revert.staged":
+            case "session.revert.cleared":
+            case "session.revert.committed":
+            case "session.compaction.started":
+            case "session.compaction.ended":
+            case "session.compaction.failed":
+            case "session.shell.started":
+            case "session.shell.ended":
                 return [this.frame(directory, ev.type, ev.properties)];
             case "message.removed":
                 return [
@@ -238,12 +267,22 @@ export class V2EventTranslator {
                         location: { directory: info.directory },
                         subpath: subpathOf(info.directory),
                         title: info.title,
+                        agent: info.agent ?? getAgentName(),
+                        ...(info.parentID !== undefined ? { parentID: info.parentID } : {}),
+                        ...(info.parentMessageID !== undefined ? { parentMessageID: info.parentMessageID } : {}),
+                        ...(info.metadata !== undefined ? { metadata: info.metadata } : {}),
                     }),
                 ];
             }
             case "session.updated": {
                 const info = ev.properties.info;
-                return [this.frame(directory, "session.renamed", { sessionID: info.id, title: info.title })];
+                return [
+                    this.frame(directory, "session.renamed", { sessionID: info.id, title: info.title }),
+                    ...(info.metadata !== undefined
+                        ? [this.frame(directory, "session.metadata.updated", { sessionID: info.id, metadata: info.metadata })]
+                        : []),
+                    this.frame(directory, "session.agent.selected", { sessionID: info.id, agent: info.agent ?? getAgentName() }),
+                ];
             }
             case "session.diff":
                 return [this.frame(directory, "session.diff", ev.properties)];
@@ -260,7 +299,21 @@ export class V2EventTranslator {
                 const frames = [];
                 if (st?.step && !st.step.ended)
                     frames.push(...this.finalizeStep(directory, st.step));
-                frames.push(this.frame(directory, "session.execution.succeeded", { sessionID }));
+                if (st?.executionEnded) {
+                    // session.error already published the execution's terminal frame.
+                }
+                else if (st?.step?.error?.name === "MessageAbortedError") {
+                    frames.push(this.frame(directory, "session.execution.interrupted", { sessionID, reason: "user" }));
+                }
+                else if (st?.step?.finish === "error") {
+                    frames.push(this.frame(directory, "session.execution.failed", {
+                        sessionID,
+                        error: st.step.error ?? { name: "UnknownError", data: { message: "Provider error" } },
+                    }));
+                }
+                else {
+                    frames.push(this.frame(directory, "session.execution.succeeded", { sessionID }));
+                }
                 frames.push(this.frame(directory, "session.idle", { sessionID }));
                 this.sessions.delete(sessionID);
                 return frames;
@@ -268,24 +321,20 @@ export class V2EventTranslator {
             case "session.error": {
                 const { sessionID, error } = ev.properties;
                 const frames = [];
-                const st = sessionID !== undefined ? this.sessions.get(sessionID) : undefined;
+                const st = sessionID !== undefined ? this.state(sessionID) : undefined;
                 if (sessionID !== undefined && st?.step && !st.step.ended) {
-                    st.step.ended = true;
-                    frames.push(this.frame(directory, "session.step.failed", {
-                        sessionID,
-                        assistantMessageID: st.step.messageID,
-                        finish: st.step.finish ?? "error",
-                        error: error ?? { name: "UnknownError", data: { message: "session error" } },
-                        cost: st.step.cost,
-                        tokens: st.step.tokens,
-                    }));
-                    this.sessions.delete(sessionID);
+                    st.step.finish = "error";
+                    st.step.error = error ?? { name: "UnknownError", data: { message: "session error" } };
+                    frames.push(...this.finalizeStep(directory, st.step));
                 }
-                if (sessionID !== undefined) {
-                    frames.push(this.frame(directory, "session.execution.failed", {
-                        sessionID,
-                        error: error ?? { name: "UnknownError", data: { message: "session error" } },
-                    }));
+                if (sessionID !== undefined && st !== undefined && !st.executionEnded) {
+                    st.executionEnded = true;
+                    frames.push(error?.name === "MessageAbortedError"
+                        ? this.frame(directory, "session.execution.interrupted", { sessionID, reason: "user" })
+                        : this.frame(directory, "session.execution.failed", {
+                            sessionID,
+                            error: error ?? { name: "UnknownError", data: { message: "session error" } },
+                        }));
                 }
                 return frames;
             }
@@ -293,6 +342,20 @@ export class V2EventTranslator {
                 return this.onMessageUpdated(directory, ev.properties.info);
             case "message.part.updated":
                 return this.onPartUpdated(directory, ev.properties.part, ev.properties.delta);
+            case "message.part.delta": {
+                const { sessionID, messageID, partID, delta } = ev.properties;
+                const part = this.state(sessionID).parts.get(partID);
+                if (part === undefined || delta === "")
+                    return [];
+                return [
+                    this.frame(directory, `session.${part.kind}.delta`, {
+                        sessionID,
+                        assistantMessageID: messageID,
+                        ordinal: part.ordinal,
+                        delta,
+                    }),
+                ];
+            }
             case "model.changed": {
                 const { sessionID, model, previous } = ev.properties;
                 return [
@@ -305,20 +368,10 @@ export class V2EventTranslator {
             }
             case "permission.asked": {
                 const p = ev.properties;
-                return [
-                    this.frame(directory, "permission.v2.asked", {
-                        id: p.id,
-                        sessionID: p.sessionID,
-                        action: p.permission,
-                        resources: p.patterns,
-                        save: p.always,
-                        metadata: p.metadata,
-                        ...(p.tool ? { source: { type: "tool", ...p.tool } } : {}),
-                    }),
-                ];
+                return [this.frame(directory, "permission.asked", p)];
             }
             case "permission.replied":
-                return [this.frame(directory, "permission.v2.replied", ev.properties)];
+                return [this.frame(directory, "permission.replied", ev.properties)];
             case "question.asked":
                 return [this.frame(directory, "form.created", { form: toQuestionForm(ev.properties) })];
             case "question.replied":
@@ -371,6 +424,9 @@ export class V2EventTranslator {
             };
             if (info.finish !== undefined)
                 step.finish = info.finish;
+            if (info.finish === "error") {
+                step.error = info.error ?? { name: "UnknownError", data: { message: "Provider error" } };
+            }
             st.step = step;
             frames.push(this.frame(directory, "session.step.started", {
                 sessionID: info.sessionID,
@@ -384,6 +440,9 @@ export class V2EventTranslator {
             st.step.tokens = info.tokens;
             if (info.finish !== undefined)
                 st.step.finish = info.finish;
+            if (info.finish === "error") {
+                st.step.error = info.error ?? { name: "UnknownError", data: { message: "Provider error" } };
+            }
             if (!st.step.streamed) {
                 st.step.streamed = true;
                 frames.push(this.frame(directory, "session.step.streamed", { sessionID: info.sessionID, assistantMessageID: info.id }));
@@ -402,16 +461,37 @@ export class V2EventTranslator {
         st.ended = true;
         return [
             this.frame(directory, "session.usage.updated", { sessionID: st.sessionID, cost: st.cost, tokens: st.tokens }),
-            this.frame(directory, "session.step.ended", {
-                sessionID: st.sessionID,
-                assistantMessageID: st.messageID,
-                ...(st.finish !== undefined ? { finish: st.finish } : {}),
-                cost: st.cost,
-                tokens: st.tokens,
-            }),
+            st.finish === "error"
+                ? this.frame(directory, "session.step.failed", {
+                    sessionID: st.sessionID,
+                    assistantMessageID: st.messageID,
+                    rawFinish: st.finish,
+                    error: st.error ?? { name: "UnknownError", data: { message: "Provider error" } },
+                    cost: st.cost,
+                    tokens: st.tokens,
+                })
+                : this.frame(directory, "session.step.ended", {
+                    sessionID: st.sessionID,
+                    assistantMessageID: st.messageID,
+                    ...(st.finish !== undefined ? { finish: st.finish } : {}),
+                    cost: st.cost,
+                    tokens: st.tokens,
+                }),
         ];
     }
     onPartUpdated(directory, part, delta) {
+        if (part.type === "file" || part.type === "agent")
+            return [];
+        if (part.type === "compaction")
+            // Like shell turns, the server creates this user turn; there is no optimistic prompt.
+            return [
+                this.frame(directory, "session.prompted", {
+                    sessionID: part.sessionID,
+                    messageID: part.messageID,
+                    prompt: { text: "/compact" },
+                    delivery: "queue",
+                }),
+            ];
         return part.type === "tool" ? this.onToolPart(directory, part) : this.onTextPart(directory, part, delta);
     }
     onTextPart(directory, part, delta) {
@@ -540,7 +620,18 @@ export class V2EventTranslator {
         return st;
     }
     frame(directory, type, data) {
-        return { id: genId("evt"), created: Date.now(), type, location: { directory }, data };
+        const aggregateID = typeof data.sessionID === "string" ? data.sessionID : undefined;
+        const seq = aggregateID === undefined ? undefined : (this.sequences.get(aggregateID) ?? 0) + 1;
+        if (aggregateID !== undefined && seq !== undefined)
+            this.sequences.set(aggregateID, seq);
+        return {
+            id: genId("evt"),
+            created: Date.now(),
+            type,
+            location: { directory },
+            data,
+            ...(aggregateID !== undefined && seq !== undefined ? { durable: { aggregateID, seq, version: 1 } } : {}),
+        };
     }
 }
 function safeJson(value) {

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 export declare const ADAPTER_VERSION: string;
-export declare const OPENCODE_API_VERSION = "2.0.18";
+export declare const OPENCODE_API_VERSION = "2.0.20";

package/dist/version.js

@@ -10,4 +10,4 @@ if (typeof manifest !== "object" ||
 export const ADAPTER_VERSION = manifest.version;
 // OpenChamber parses --version as an OpenCode version and requires major 2.
 // This API contract version must not follow the npm package version.
-export const OPENCODE_API_VERSION = "2.0.18";
+export const OPENCODE_API_VERSION = "2.0.20";

package/extensions/omo-dag/README.md

@@ -25,6 +25,8 @@ sessions on OmO.
 - **Pan and zoom.** Drag the background, and scroll or pinch to zoom. `0`
   fits the graph; the target button centres on the current or first running
   agent.
+- Very large runs are sent within a bounded response size. When tasks are
+  omitted to fit that limit, the panel shows the omitted-node count.
 
 The panel docks in the right rail. The same page is also available full
 screen from the sidebar's Extension pages menu.

package/extensions/omo-dag/docs/DESIGN.md

@@ -28,6 +28,14 @@ does that in ~2 ms with an mtime cache and returns one JSON document.
 2. **Connector registry**: `<stateDir>/sessions.json`, mapping OpenChamber
    session ids to OmO session ids and titles.
 
+Task discovery reads regular `.json` files and skips directories and symlinks.
+The service resolves configured root spellings before using them as cache
+keys; its recency-updated task-store cache holds at most 32 root sets. Graph
+responses are capped at 240,000 serialized characters. If the full graph
+exceeds that bound, the service keeps the root and a valid task prefix, removes
+edges to omitted tasks, and returns `truncated.omittedNodes`; the panel
+validates that field and displays the count.
+
 The connector names sub-agent sessions `ses_<md5(task_id)>` and root sessions
 `ses_<md5(piSessionId)>` (`ocIdFor` in `src/session-store.ts`). The graph
 uses the same function, so a node's `sessionId` is exactly the id
@@ -59,7 +67,8 @@ uses the same function, so a node's `sessionId` is exactly the id
 
 ## Layout (`src/layout.ts`)
 
-Columns are fixed-width; within a column, cards stack in the order of their
+Columns are fixed-width, and panel CSS dimensions come from the same card-size
+constants used by the layout. Within a column, cards stack in the order of their
 parents' rows, then by creation time, so a fan-out stays next to the card
 that launched it. The orchestrator is centred on its direct children. Edges
 leave a card's right side and enter the left side as horizontal cubic