@ai-matrx/coding-sessions 0.1.83 → 0.1.86

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatMessage } from '@ai-matrx/chat';
 
 /**
@@ -6,6 +7,7 @@ import { ChatMessage } from '@ai-matrx/chat';
  * touches Node or the DOM, and every value is JSON-serializable because it
  * crosses a transport (WebSocket today, desktop IPC later).
  */
+
 /** The coding agents this package drives. "coding session" is the canonical
  *  platform term (chat.coding_session, the Coding Session Bridge). */
 type CodingProvider = "claude" | "codex";
@@ -197,6 +199,10 @@ interface CodingSession {
     lastRunStatus: RunStatus | null;
     /** Prompts waiting for the active run to finish, oldest first. */
     queued: string[];
+    /** The AI Matrx agent loaded into every run of this session, when one was picked. */
+    agent?: SessionAgent | null | undefined;
+    /** Codex must be told, in the next prompt, that an earlier agent no longer applies. */
+    agentRemovedDue?: boolean | undefined;
 }
 /**
  * One normalized transcript item — the same shape from Claude and Codex, from
@@ -277,12 +283,105 @@ interface StartInput {
     prompt: string;
     model?: string | null | undefined;
     effort?: string | null | undefined;
+    /** An AI Matrx agent to load into the CLI. Needs the host's `agents` credentials. */
+    agent?: AgentSelection | null | undefined;
+}
+/** Which AI Matrx agent a new session loads, and the person's variable values. */
+interface AgentSelection {
+    agentId: string;
+    /** Pin one saved version; omitted = the latest, pinned at start. */
+    versionId?: string | null | undefined;
+    variables?: Record<string, JsonValue> | undefined;
+}
+/** One part of an agent and whether this session's CLI carries it. */
+interface SessionAgentPart {
+    part: "instructions" | "skills" | "tools";
+    loaded: number;
+    total: number;
+}
+/**
+ * The agent a session runs with. Recorded at start and never drifts: every
+ * later turn reloads the SAME bundle (same version, same hash).
+ */
+interface SessionAgent {
+    agentId: string;
+    versionId: string | null;
+    versionNumber: number | null;
+    name: string;
+    definitionHash: string;
+    loaded: SessionAgentPart[];
+    /** What could not be carried, with the reason. */
+    unavailable: {
+        kind: string;
+        name: string;
+        reason: string;
+    }[];
+    /** The skills it carries (labels) and the tools it serves (names) — the agent's own set. */
+    skills?: string[] | undefined;
+    tools?: string[] | undefined;
+    /** The person's variable values, kept so "Update to vN" can reuse them. */
+    variables?: Record<string, JsonValue> | undefined;
+    /**
+     * The CLI must be TOLD in the next prompt (a delimited block): a Codex
+     * takeover or agent switch (Codex ignores developer_instructions on resume),
+     * or a Codex compaction that dropped the block. Cleared once delivered.
+     */
+    blockDue?: boolean | undefined;
+    /** When the block (or native instructions) last reached the CLI. */
+    deliveredAt?: string | null | undefined;
+}
+/** Whether this host can reach AI Matrx as a signed-in person. */
+interface AgentAccess {
+    signedIn: boolean;
+    userId: string | null;
+    organizationId: string | null;
+    /** True when the host was started with no AI Matrx connection at all. */
+    configured: boolean;
+}
+/** A catalogue read the picker asks the host to make (PostgREST RPC shape). */
+interface AgentCatalogRpcRequest {
+    fn: string;
+    args?: Record<string, unknown> | undefined;
+    count?: "exact" | "planned" | "estimated" | undefined;
+    range?: [number, number] | undefined;
+    order?: {
+        column: string;
+        ascending?: boolean | undefined;
+    } | undefined;
+}
+interface AgentCatalogRpcResult {
+    data: unknown;
+    error: {
+        message: string;
+        code?: string | undefined;
+        details?: string | null | undefined;
+        hint?: string | null | undefined;
+    } | null;
+    count?: number | null;
+}
+/** What a picker needs about one agent — the LIGHT read (no skills, no tools). */
+interface AgentDetails {
+    agentId: string;
+    name: string;
+    /** Variable declarations as authored (camelCase). */
+    variables: Record<string, JsonValue>[];
+    /** Newest first. */
+    versions: {
+        id: string;
+        versionNumber: number;
+        changedAt: string | null;
+    }[];
+    /** The version "Latest" resolves to right now. */
+    latestVersionNumber: number | null;
+    latestVersionId: string | null;
 }
 interface TakeoverInput {
     provider: CodingProvider;
     providerSessionId: string;
     cwd: string;
     title?: string | undefined;
+    /** Continue the chat WITH an AI Matrx agent ("Continue with agent"). */
+    agent?: AgentSelection | null | undefined;
 }
 interface SendResult {
     session: CodingSession;
@@ -353,6 +452,18 @@ interface CodingSessionsApi {
         model?: string | null;
         effort?: string | null;
     }): Promise<CodingSession>;
+    /** Is this host signed in to AI Matrx (so agents can load)? */
+    agentAccess(): Promise<AgentAccess>;
+    /** One allowlisted agent-catalogue read, made by the host as the signed-in person. */
+    agentCatalogRpc(request: AgentCatalogRpcRequest): Promise<AgentCatalogRpcResult>;
+    /** An agent's variables and saved versions, for the New session form. */
+    agentDetails(agentId: string): Promise<AgentDetails>;
+    /**
+     * Load a different agent into a session from its next message on (or
+     * remove it, with `null`). Claude reads it every turn; Codex is told in the
+     * next prompt.
+     */
+    setAgent(sessionId: string, agent: AgentSelection | null): Promise<CodingSession>;
 }
 type RawTranscript = {
     available: true;
@@ -527,4 +638,4 @@ declare function friendlyToolName(name: string): string;
 /** The key argument, for the card's subtitle. null when there is none worth showing. */
 declare function toolSubtitle(name: string, input: unknown): string | null;
 
-export { type ActiveElsewhere, type Billing, type BinarySource, CODING_PROVIDERS, type ChatPreference, type ChatSearchHit, type ChatSearchResult, type ClaudeNormalizer, type CodexRolloutNormalizer, type CodexStreamNormalizer, type CodingEvent, type CodingProvider, type CodingSession, type CodingSessionsApi, type CodingSessionsMethod, type CodingSessionsTransport, type DiscoveredSession, type FolderCheck, type HistoryOptions, type LineSplitter, type ModelOption, type OpenTarget, PROVIDER_LABEL, type ProviderBinary, type ProviderProblem, type ProviderStatus, type QuotaWindow, type RawTranscript, type RecentFolder, type RunRecord, type RunStatus, type RunUsage, type SendResult, type SessionHistory, type SessionOrigin, type StartInput, TERMINAL_RUN_STATUSES, type TakeoverInput, type TranscriptBuilder, type TranscriptItem, type TransportStatus, type WebSocketTransportOptions, chatKey, createClaudeNormalizer, createCodexRolloutNormalizer, createCodexStreamNormalizer, createLineSplitter, createTranscriptBuilder, createWebSocketTransport, friendlyToolName, isSyntheticClaudeUserText, isTerminalRunStatus, parseJsonl, parseMcpToolName, stripCodexInjectedContext, toolSubtitle };
+export { type ActiveElsewhere, type AgentAccess, type AgentCatalogRpcRequest, type AgentCatalogRpcResult, type AgentDetails, type AgentSelection, type Billing, type BinarySource, CODING_PROVIDERS, type ChatPreference, type ChatSearchHit, type ChatSearchResult, type ClaudeNormalizer, type CodexRolloutNormalizer, type CodexStreamNormalizer, type CodingEvent, type CodingProvider, type CodingSession, type CodingSessionsApi, type CodingSessionsMethod, type CodingSessionsTransport, type DiscoveredSession, type FolderCheck, type HistoryOptions, type LineSplitter, type ModelOption, type OpenTarget, PROVIDER_LABEL, type ProviderBinary, type ProviderProblem, type ProviderStatus, type QuotaWindow, type RawTranscript, type RecentFolder, type RunRecord, type RunStatus, type RunUsage, type SendResult, type SessionAgent, type SessionAgentPart, type SessionHistory, type SessionOrigin, type StartInput, TERMINAL_RUN_STATUSES, type TakeoverInput, type TranscriptBuilder, type TranscriptItem, type TransportStatus, type WebSocketTransportOptions, chatKey, createClaudeNormalizer, createCodexRolloutNormalizer, createCodexStreamNormalizer, createLineSplitter, createTranscriptBuilder, createWebSocketTransport, friendlyToolName, isSyntheticClaudeUserText, isTerminalRunStatus, parseJsonl, parseMcpToolName, stripCodexInjectedContext, toolSubtitle };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatMessage } from '@ai-matrx/chat';
 
 /**
@@ -6,6 +7,7 @@ import { ChatMessage } from '@ai-matrx/chat';
  * touches Node or the DOM, and every value is JSON-serializable because it
  * crosses a transport (WebSocket today, desktop IPC later).
  */
+
 /** The coding agents this package drives. "coding session" is the canonical
  *  platform term (chat.coding_session, the Coding Session Bridge). */
 type CodingProvider = "claude" | "codex";
@@ -197,6 +199,10 @@ interface CodingSession {
     lastRunStatus: RunStatus | null;
     /** Prompts waiting for the active run to finish, oldest first. */
     queued: string[];
+    /** The AI Matrx agent loaded into every run of this session, when one was picked. */
+    agent?: SessionAgent | null | undefined;
+    /** Codex must be told, in the next prompt, that an earlier agent no longer applies. */
+    agentRemovedDue?: boolean | undefined;
 }
 /**
  * One normalized transcript item — the same shape from Claude and Codex, from
@@ -277,12 +283,105 @@ interface StartInput {
     prompt: string;
     model?: string | null | undefined;
     effort?: string | null | undefined;
+    /** An AI Matrx agent to load into the CLI. Needs the host's `agents` credentials. */
+    agent?: AgentSelection | null | undefined;
+}
+/** Which AI Matrx agent a new session loads, and the person's variable values. */
+interface AgentSelection {
+    agentId: string;
+    /** Pin one saved version; omitted = the latest, pinned at start. */
+    versionId?: string | null | undefined;
+    variables?: Record<string, JsonValue> | undefined;
+}
+/** One part of an agent and whether this session's CLI carries it. */
+interface SessionAgentPart {
+    part: "instructions" | "skills" | "tools";
+    loaded: number;
+    total: number;
+}
+/**
+ * The agent a session runs with. Recorded at start and never drifts: every
+ * later turn reloads the SAME bundle (same version, same hash).
+ */
+interface SessionAgent {
+    agentId: string;
+    versionId: string | null;
+    versionNumber: number | null;
+    name: string;
+    definitionHash: string;
+    loaded: SessionAgentPart[];
+    /** What could not be carried, with the reason. */
+    unavailable: {
+        kind: string;
+        name: string;
+        reason: string;
+    }[];
+    /** The skills it carries (labels) and the tools it serves (names) — the agent's own set. */
+    skills?: string[] | undefined;
+    tools?: string[] | undefined;
+    /** The person's variable values, kept so "Update to vN" can reuse them. */
+    variables?: Record<string, JsonValue> | undefined;
+    /**
+     * The CLI must be TOLD in the next prompt (a delimited block): a Codex
+     * takeover or agent switch (Codex ignores developer_instructions on resume),
+     * or a Codex compaction that dropped the block. Cleared once delivered.
+     */
+    blockDue?: boolean | undefined;
+    /** When the block (or native instructions) last reached the CLI. */
+    deliveredAt?: string | null | undefined;
+}
+/** Whether this host can reach AI Matrx as a signed-in person. */
+interface AgentAccess {
+    signedIn: boolean;
+    userId: string | null;
+    organizationId: string | null;
+    /** True when the host was started with no AI Matrx connection at all. */
+    configured: boolean;
+}
+/** A catalogue read the picker asks the host to make (PostgREST RPC shape). */
+interface AgentCatalogRpcRequest {
+    fn: string;
+    args?: Record<string, unknown> | undefined;
+    count?: "exact" | "planned" | "estimated" | undefined;
+    range?: [number, number] | undefined;
+    order?: {
+        column: string;
+        ascending?: boolean | undefined;
+    } | undefined;
+}
+interface AgentCatalogRpcResult {
+    data: unknown;
+    error: {
+        message: string;
+        code?: string | undefined;
+        details?: string | null | undefined;
+        hint?: string | null | undefined;
+    } | null;
+    count?: number | null;
+}
+/** What a picker needs about one agent — the LIGHT read (no skills, no tools). */
+interface AgentDetails {
+    agentId: string;
+    name: string;
+    /** Variable declarations as authored (camelCase). */
+    variables: Record<string, JsonValue>[];
+    /** Newest first. */
+    versions: {
+        id: string;
+        versionNumber: number;
+        changedAt: string | null;
+    }[];
+    /** The version "Latest" resolves to right now. */
+    latestVersionNumber: number | null;
+    latestVersionId: string | null;
 }
 interface TakeoverInput {
     provider: CodingProvider;
     providerSessionId: string;
     cwd: string;
     title?: string | undefined;
+    /** Continue the chat WITH an AI Matrx agent ("Continue with agent"). */
+    agent?: AgentSelection | null | undefined;
 }
 interface SendResult {
     session: CodingSession;
@@ -353,6 +452,18 @@ interface CodingSessionsApi {
         model?: string | null;
         effort?: string | null;
     }): Promise<CodingSession>;
+    /** Is this host signed in to AI Matrx (so agents can load)? */
+    agentAccess(): Promise<AgentAccess>;
+    /** One allowlisted agent-catalogue read, made by the host as the signed-in person. */
+    agentCatalogRpc(request: AgentCatalogRpcRequest): Promise<AgentCatalogRpcResult>;
+    /** An agent's variables and saved versions, for the New session form. */
+    agentDetails(agentId: string): Promise<AgentDetails>;
+    /**
+     * Load a different agent into a session from its next message on (or
+     * remove it, with `null`). Claude reads it every turn; Codex is told in the
+     * next prompt.
+     */
+    setAgent(sessionId: string, agent: AgentSelection | null): Promise<CodingSession>;
 }
 type RawTranscript = {
     available: true;
@@ -527,4 +638,4 @@ declare function friendlyToolName(name: string): string;
 /** The key argument, for the card's subtitle. null when there is none worth showing. */
 declare function toolSubtitle(name: string, input: unknown): string | null;
 
-export { type ActiveElsewhere, type Billing, type BinarySource, CODING_PROVIDERS, type ChatPreference, type ChatSearchHit, type ChatSearchResult, type ClaudeNormalizer, type CodexRolloutNormalizer, type CodexStreamNormalizer, type CodingEvent, type CodingProvider, type CodingSession, type CodingSessionsApi, type CodingSessionsMethod, type CodingSessionsTransport, type DiscoveredSession, type FolderCheck, type HistoryOptions, type LineSplitter, type ModelOption, type OpenTarget, PROVIDER_LABEL, type ProviderBinary, type ProviderProblem, type ProviderStatus, type QuotaWindow, type RawTranscript, type RecentFolder, type RunRecord, type RunStatus, type RunUsage, type SendResult, type SessionHistory, type SessionOrigin, type StartInput, TERMINAL_RUN_STATUSES, type TakeoverInput, type TranscriptBuilder, type TranscriptItem, type TransportStatus, type WebSocketTransportOptions, chatKey, createClaudeNormalizer, createCodexRolloutNormalizer, createCodexStreamNormalizer, createLineSplitter, createTranscriptBuilder, createWebSocketTransport, friendlyToolName, isSyntheticClaudeUserText, isTerminalRunStatus, parseJsonl, parseMcpToolName, stripCodexInjectedContext, toolSubtitle };
+export { type ActiveElsewhere, type AgentAccess, type AgentCatalogRpcRequest, type AgentCatalogRpcResult, type AgentDetails, type AgentSelection, type Billing, type BinarySource, CODING_PROVIDERS, type ChatPreference, type ChatSearchHit, type ChatSearchResult, type ClaudeNormalizer, type CodexRolloutNormalizer, type CodexStreamNormalizer, type CodingEvent, type CodingProvider, type CodingSession, type CodingSessionsApi, type CodingSessionsMethod, type CodingSessionsTransport, type DiscoveredSession, type FolderCheck, type HistoryOptions, type LineSplitter, type ModelOption, type OpenTarget, PROVIDER_LABEL, type ProviderBinary, type ProviderProblem, type ProviderStatus, type QuotaWindow, type RawTranscript, type RecentFolder, type RunRecord, type RunStatus, type RunUsage, type SendResult, type SessionAgent, type SessionAgentPart, type SessionHistory, type SessionOrigin, type StartInput, TERMINAL_RUN_STATUSES, type TakeoverInput, type TranscriptBuilder, type TranscriptItem, type TransportStatus, type WebSocketTransportOptions, chatKey, createClaudeNormalizer, createCodexRolloutNormalizer, createCodexStreamNormalizer, createLineSplitter, createTranscriptBuilder, createWebSocketTransport, friendlyToolName, isSyntheticClaudeUserText, isTerminalRunStatus, parseJsonl, parseMcpToolName, stripCodexInjectedContext, toolSubtitle };

package/dist/index.js

@@ -205,6 +205,20 @@ function createClaudeNormalizer() {
   };
 }
 
+// src/normalize/agent-block.ts
+var AGENT_BLOCK_MARKER = "<ai_matrx_agent ";
+function stripAgentBlock(text) {
+  const removed = text.match(/^<ai_matrx_agent_removed>[\s\S]*?<\/ai_matrx_agent_removed>\s*/);
+  if (removed) return text.slice(removed[0].length);
+  if (!text.startsWith(AGENT_BLOCK_MARKER)) return text;
+  const end = text.indexOf("</ai_matrx_agent>");
+  if (end < 0) return text;
+  let rest = text.slice(end + "</ai_matrx_agent>".length);
+  const skills = rest.match(/^\s*<skills_instructions>[\s\S]*?<\/skills_instructions>/);
+  if (skills) rest = rest.slice(skills[0].length);
+  return rest.replace(/^\s+/, "");
+}
+
 // src/normalize/codex.ts
 function isObject2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -380,7 +394,7 @@ function rolloutItem(item, fallbackId, at) {
   const id = str2(item.id) ?? fallbackId;
   switch (item.type) {
     case "UserMessage": {
-      const text = stripCodexInjectedContext(itemText(item.content));
+      const text = stripCodexInjectedContext(stripAgentBlock(itemText(item.content)));
       return text.trim() ? [{ kind: "user", id, text, at }] : [];
     }
     case "AgentMessage": {
@@ -463,7 +477,7 @@ function createCodexRolloutNormalizer() {
           return rolloutItem(payload.item, fallbackId, at);
         }
         if (payload.type === "user_message" && !appItems) {
-          const text = stripCodexInjectedContext(str2(payload.message) ?? "");
+          const text = stripCodexInjectedContext(stripAgentBlock(str2(payload.message) ?? ""));
           return text.trim() ? [{ kind: "user", id: fallbackId, text, at }] : [];
         }
         return [];