@ai-matrx/coding-sessions 0.1.81 → 0.1.85

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatMessage } from '@ai-matrx/chat';
 
 /**
@@ -6,12 +7,29 @@ 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";
 declare const CODING_PROVIDERS: readonly CodingProvider[];
 declare const PROVIDER_LABEL: Record<CodingProvider, string>;
 type Billing = "subscription" | "api" | "unknown";
+/** Where the CLI a provider runs came from. */
+type BinarySource = "desktop-app" | "path" | "npm-global" | "configured";
+/** The exact CLI runs use: the newest copy on this computer (or the host's pick). */
+interface ProviderBinary {
+    path: string;
+    version: string | null;
+    source: BinarySource;
+    /** "from ChatGPT app", "from PATH", … */
+    sourceLabel: string;
+    /** A newer copy than the one in use, when one exists. */
+    newer: {
+        path: string;
+        version: string;
+        sourceLabel: string;
+    } | null;
+}
 /** What `providers()` answers for one provider, in plain terms. */
 interface ProviderStatus {
     provider: CodingProvider;
@@ -49,6 +67,8 @@ interface ProviderStatus {
     } | null | undefined;
     /** The effort a run uses when none is picked (the person's own settings). */
     defaultEffort?: string | null | undefined;
+    /** Which CLI runs use, and its version. */
+    binary?: ProviderBinary | null | undefined;
 }
 interface ModelOption {
     id: string;
@@ -179,6 +199,8 @@ 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;
 }
 /**
  * One normalized transcript item — the same shape from Claude and Codex, from
@@ -259,6 +281,82 @@ 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;
+    }[];
+}
+/** 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 the New session form needs about one agent. */
+interface AgentDetails {
+    agentId: string;
+    name: string;
+    /** Variable declarations as authored (camelCase). */
+    variables: Record<string, JsonValue>[];
+    versions: {
+        id: string;
+        versionNumber: number;
+        changedAt: string | null;
+    }[];
+    /** The version "Latest" resolves to right now. */
+    latestVersionNumber: number | null;
 }
 interface TakeoverInput {
     provider: CodingProvider;
@@ -335,6 +433,12 @@ 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>;
 }
 type RawTranscript = {
     available: true;
@@ -509,4 +613,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, 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 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

@@ -593,6 +593,23 @@ import {
   createChatMessage
 } from "@ai-matrx/chat";
 
+// src/provider-health.ts
+var MODEL_UNAVAILABLE = [
+  /model is not supported when using codex/i,
+  /\bmodel[\s:'"`][^.\n]{0,80}\b(?:not supported|does not exist|not available|not found)\b/i,
+  /\bmodel_not_found\b/i,
+  /issue with the selected model/i,
+  /may not exist or you may not have access to it/i
+];
+var MODEL_UNAVAILABLE_LABEL = "Model not available on this account";
+function isModelUnavailable(text) {
+  const trimmed = (text ?? "").trim();
+  return trimmed !== "" && MODEL_UNAVAILABLE.some((re) => re.test(trimmed));
+}
+function runErrorLabel(text) {
+  return isModelUnavailable(text) ? MODEL_UNAVAILABLE_LABEL : text;
+}
+
 // src/tool-labels.ts
 var BUILTIN = {
   Bash: "Run command",
@@ -847,14 +864,15 @@ function createTranscriptBuilder() {
           }));
           return;
         case "error": {
-          const said = current?.message.parts.some((p) => p.type === "error" && p.message.trim() === item.text.trim());
+          const text = runErrorLabel(item.text);
+          const said = current?.message.parts.some((p) => p.type === "error" && p.message.trim() === text.trim());
           if (said) return;
           upsertPart(item.id, () => ({
             type: "error",
             errorType: "provider",
             code: null,
-            message: item.text,
-            userMessage: item.text,
+            message: text,
+            userMessage: text,
             recoverable: true,
             remedy: null
           }));