@ai-matrx/coding-sessions 0.1.81 → 0.1.85

package/dist/react/index.d.cts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatThreadStore, ChatMessage } from '@ai-matrx/chat';
 
 /**
@@ -7,10 +8,27 @@ import { ChatThreadStore, 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";
 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;
@@ -48,6 +66,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;
@@ -174,6 +194,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
@@ -254,6 +276,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;
@@ -330,6 +428,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;
@@ -483,13 +587,7 @@ declare class CodingSessionsClient {
     refreshAll: () => Promise<void>;
     transcript(sessionId: string): SessionTranscript;
     readPreview(provider: CodingProvider, providerSessionId: string, maxBytes?: number): Promise<PreviewState>;
-    start(input: {
-        provider: CodingProvider;
-        cwd: string;
-        prompt: string;
-        model?: string | null;
-        effort?: string | null;
-    }): Promise<SendResult>;
+    start(input: StartInput): Promise<SendResult>;
     takeover(session: DiscoveredSession): Promise<CodingSession>;
     send(sessionId: string, prompt: string): Promise<SendResult>;
     stop(runId: string): Promise<RunRecord | null>;

package/dist/react/index.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { JsonValue } from '@ai-matrx/agents/portable';
 import { ChatThreadStore, ChatMessage } from '@ai-matrx/chat';
 
 /**
@@ -7,10 +8,27 @@ import { ChatThreadStore, 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";
 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;
@@ -48,6 +66,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;
@@ -174,6 +194,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
@@ -254,6 +276,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;
@@ -330,6 +428,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;
@@ -483,13 +587,7 @@ declare class CodingSessionsClient {
     refreshAll: () => Promise<void>;
     transcript(sessionId: string): SessionTranscript;
     readPreview(provider: CodingProvider, providerSessionId: string, maxBytes?: number): Promise<PreviewState>;
-    start(input: {
-        provider: CodingProvider;
-        cwd: string;
-        prompt: string;
-        model?: string | null;
-        effort?: string | null;
-    }): Promise<SendResult>;
+    start(input: StartInput): Promise<SendResult>;
     takeover(session: DiscoveredSession): Promise<CodingSession>;
     send(sessionId: string, prompt: string): Promise<SendResult>;
     stop(runId: string): Promise<RunRecord | null>;