@ai-matrx/api 0.1.22 → 0.1.24

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog — @ai-matrx/api
 
+### Unreleased
+
+- **Removed** the deprecated aliases `ENDPOINTS.ai.chat` (use `ENDPOINTS.ai.manual`) and `ENDPOINTS.utilities.pdfExtractText` (use `ENDPOINTS.pdf.extractText`); no importer existed. Added `FEATURE.md`. Consumer action: none.
+
+## 0.1.24
+
+UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
+Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/api/src`.
+
+## 0.1.23
+
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff e2771d68e0 cdea8c928e -- apps/shared/api/src`
+
+Changed shipped source files (31):
+- `apps/shared/api/src/deployments.generated.ts`
+- `apps/shared/api/src/generated/account.ts`
+- `apps/shared/api/src/generated/agents.ts`
+- `apps/shared/api/src/generated/ai.ts`
+- `apps/shared/api/src/generated/apps.ts`
+- `apps/shared/api/src/generated/architecture.ts`
+- `apps/shared/api/src/generated/audio.ts`
+- `apps/shared/api/src/generated/chat.ts`
+- `apps/shared/api/src/generated/code.ts`
+- `apps/shared/api/src/generated/commerce.ts`
+- `apps/shared/api/src/generated/communications.ts`
+- `apps/shared/api/src/generated/computer.ts`
+- ...and 19 more
+
 ## 0.1.22
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -8,9 +38,12 @@ No source changes intended and no consumer action required.
 
 ## 0.1.21
 
-Automatic changed-only republish (docs/metadata drift since the last tag — see
-`git diff npm/api/v0.1.20..npm/api/v0.1.21 -- apps/shared/api`).
-No source changes intended and no consumer action required.
+BREAKING (corrected after the fact; the original entry wrongly said "no source changes"):
+the v1 protocol fallback was deleted (`src/core/protocol.ts`, `client.ts`, `call.ts`), and
+`MatrxTransportDiagnostics.onProtocolDowngrade` no longer exists.
+
+Consumer action: remove any use of `diagnostics.onProtocolDowngrade` (it is now a TS2353
+excess-property error). No v1 fallback exists any more; there is nothing to replace it with.
 
 ## 0.1.20
 

package/dist/account.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions } from './index-oZNMwcTG.cjs';
+import { A as Api, C as CallOptions } from './index-BgjdVvrS.cjs';
 import { JsonValue, UserAnalysisPreferencesResponse } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be
+ * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
  */
 
 /** Result of opening, completing, or re-minting an action request. */

package/dist/account.d.ts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions } from './index-oZNMwcTG.js';
+import { A as Api, C as CallOptions } from './index-BgjdVvrS.js';
 import { JsonValue, UserAnalysisPreferencesResponse } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be
+ * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
  */
 
 /** Result of opening, completing, or re-minting an action request. */

package/dist/agents.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkFSXBRXRX_cjs = require('./chunk-FSXBRXRX.cjs');
+var chunkZOZOF5DN_cjs = require('./chunk-ZOZOF5DN.cjs');
 require('./chunk-2SXAAKGV.cjs');
 
 // src/generated/agents.ts
@@ -50,15 +50,15 @@ function resolvePromptBlocks(api, args, options) {
 }
 var $agentsStartAgent = { m: "POST", p: "/ai/agent/{agent_id}", d: "aidream", a: "guest", o: "required", s: "ndjson_or_json", n: "agents.agents_start_agent" };
 function agentsStartAgent(api, args, options) {
-  return chunkFSXBRXRX_cjs.openJsonOrStream(api, $agentsStartAgent, args, options);
+  return chunkZOZOF5DN_cjs.openJsonOrStream(api, $agentsStartAgent, args, options);
 }
 var $agentsStartAgentPost = { m: "POST", p: "/ai/agents/{agent_id}", d: "aidream", a: "guest", o: "required", s: "ndjson_or_json", n: "agents.agents_start_agent_post" };
 function agentsStartAgentPost(api, args, options) {
-  return chunkFSXBRXRX_cjs.openJsonOrStream(api, $agentsStartAgentPost, args, options);
+  return chunkZOZOF5DN_cjs.openJsonOrStream(api, $agentsStartAgentPost, args, options);
 }
 var $startMandatedAgent = { m: "POST", p: "/ai/mandates/{mandate_key}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.start_mandated_agent" };
 function startMandatedAgent(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $startMandatedAgent, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $startMandatedAgent, args, options);
 }
 var $invalidateAgentCache = { m: "POST", p: "/ai/agents/{agent_id}/invalidate-cache", d: "aidream", a: "guest", o: "required", n: "agents.invalidate_agent_cache" };
 function invalidateAgentCache(api, args, options) {
@@ -66,7 +66,7 @@ function invalidateAgentCache(api, args, options) {
 }
 var $mockStream = { m: "POST", p: "/ai/mock-stream/{scenario}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.mock_stream" };
 function mockStream(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $mockStream, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $mockStream, args, options);
 }
 var $listScenarios = { m: "GET", p: "/ai/mock-stream/scenarios", d: "aidream", a: "guest", o: "optional", n: "agents.list_scenarios" };
 function listScenarios(api, args, options) {
@@ -82,11 +82,11 @@ function getUserPromptsAndBuiltins(api, args, options) {
 }
 var $startPrompt = { m: "POST", p: "/ai/prompts/{prompt_id}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.start_prompt" };
 function startPrompt(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $startPrompt, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $startPrompt, args, options);
 }
 var $startAgentBlocks = { m: "POST", p: "/ai/agents-blocks/{agent_id}", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.start_agent_blocks" };
 function startAgentBlocks(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $startAgentBlocks, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $startAgentBlocks, args, options);
 }
 var $previewContext = { m: "POST", p: "/ai/context/preview", d: "aidream", a: "guest", o: "required", n: "agents.preview_context" };
 function previewContext(api, args, options) {
@@ -230,7 +230,7 @@ function judgeFirstRuns(api, args, options) {
 }
 var $agentFromChat = { m: "POST", p: "/agent-studio/from-chat", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.agent_from_chat" };
 function agentFromChat(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $agentFromChat, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $agentFromChat, args, options);
 }
 var $importPreview = { m: "POST", p: "/agent-studio/import/preview", d: "aidream", a: "guest", o: "required", n: "agents.import_preview" };
 function importPreview(api, args, options) {
@@ -242,7 +242,7 @@ function importDraft(api, args, options) {
 }
 var $adminAgentFromChat = { m: "POST", p: "/admin/agent-studio/from-chat", d: "aidream", a: "admin", o: "exempt", s: "ndjson", n: "agents.admin_agent_from_chat" };
 function adminAgentFromChat(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $adminAgentFromChat, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $adminAgentFromChat, args, options);
 }
 var $adminToolsListTools = { m: "GET", p: "/admin/tools", d: "aidream", a: "admin", o: "exempt", n: "agents.admin_tools_list_tools" };
 function adminToolsListTools(api, args, options) {
@@ -278,7 +278,7 @@ function getOrCreateTestSession(api, args, options) {
 }
 var $executeToolTest = { m: "POST", p: "/tools/test/execute", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.execute_tool_test" };
 function executeToolTest(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $executeToolTest, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $executeToolTest, args, options);
 }
 var $getDbSurfaceManifest = { m: "GET", p: "/surfaces/{client_name}/{surface_name}/manifest", d: "aidream", a: "guest", o: "exempt", n: "agents.get_db_surface_manifest" };
 function getDbSurfaceManifest(api, args, options) {
@@ -310,7 +310,7 @@ function previewVariableBinding(api, args, options) {
 }
 var $runMatrixBattle = { m: "POST", p: "/agent-battles/{set_id}/run", d: "aidream", a: "guest", o: "required", s: "ndjson", n: "agents.run_matrix_battle" };
 function runMatrixBattle(api, args, options) {
-  return chunkFSXBRXRX_cjs.openStream(api, $runMatrixBattle, args, options);
+  return chunkZOZOF5DN_cjs.openStream(api, $runMatrixBattle, args, options);
 }
 var $cancelMatrixBattle = { m: "POST", p: "/agent-battles/{set_id}/cancel", d: "aidream", a: "guest", o: "required", n: "agents.cancel_matrix_battle" };
 function cancelMatrixBattle(api, args, options) {

package/dist/agents.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream } from './index-oZNMwcTG.cjs';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream } from './index-BgjdVvrS.cjs';
 import { JsonValue, ContextAnchor, TextPart, ThinkingPart, ToolCallPart, ToolResultPart, UserImageMediaPart, UserAudioMediaPart, UserVideoMediaPart, UserDocumentMediaPart, UserYouTubeMediaPart, CodeExecPart, CodeResultPart, WebSearchPart, WebpageInputPart, NotesInputPart, TaskInputPart, AgentInputPart, ProjectInputPart, AgentAppInputPart, TranscriptInputPart, TranscriptSessionInputPart, WorkbookInputPart, DocumentInputPart, TableInputPart, ListInputPart, DataInputPart, ContextInputPart, RemarksInputPart, DecisionQuestionsPart, DecisionAnswersPart, SpeechScriptPart, LLMParams, HostTurn, MandateTestHolder, ResourceContextPolicy, RegisteredToolSpec, InlineToolSpec, AgentToolSpec, ClientContext, UserOverrides, IdeState, SandboxBindingRequest, PageContext, ChatMessageInput, CacheBypass, DirectiveItemApplied, DirectiveItemFailed, ActionNeeded } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be
+ * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
  */
 
 /** AgentBlocksStartRequest */
@@ -32,6 +32,8 @@ type AgentBlocksStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     variables?: {
         [key: string]: unknown;
@@ -171,6 +173,8 @@ type AgentStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     host_turn?: HostTurn | null;
     model_this_turn_only?: boolean;
@@ -1615,6 +1619,8 @@ type PromptStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     variables?: {
         [key: string]: unknown;

package/dist/agents.d.ts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream } from './index-oZNMwcTG.js';
+import { A as Api, C as CallOptions, a as ApiStream, N as NdjsonEvent, J as JsonOrStream } from './index-BgjdVvrS.js';
 import { JsonValue, ContextAnchor, TextPart, ThinkingPart, ToolCallPart, ToolResultPart, UserImageMediaPart, UserAudioMediaPart, UserVideoMediaPart, UserDocumentMediaPart, UserYouTubeMediaPart, CodeExecPart, CodeResultPart, WebSearchPart, WebpageInputPart, NotesInputPart, TaskInputPart, AgentInputPart, ProjectInputPart, AgentAppInputPart, TranscriptInputPart, TranscriptSessionInputPart, WorkbookInputPart, DocumentInputPart, TableInputPart, ListInputPart, DataInputPart, ContextInputPart, RemarksInputPart, DecisionQuestionsPart, DecisionAnswersPart, SpeechScriptPart, LLMParams, HostTurn, MandateTestHolder, ResourceContextPolicy, RegisteredToolSpec, InlineToolSpec, AgentToolSpec, ClientContext, UserOverrides, IdeState, SandboxBindingRequest, PageContext, ChatMessageInput, CacheBypass, DirectiveItemApplied, DirectiveItemFailed, ActionNeeded } from './schemas.js';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be
+ * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
  */
 
 /** AgentBlocksStartRequest */
@@ -32,6 +32,8 @@ type AgentBlocksStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     variables?: {
         [key: string]: unknown;
@@ -171,6 +173,8 @@ type AgentStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     host_turn?: HostTurn | null;
     model_this_turn_only?: boolean;
@@ -1615,6 +1619,8 @@ type PromptStartRequest = {
     target_instance_id?: string | null;
     conversation_id: string;
     is_new: boolean;
+    /** Start this conversation as a CHILD of an existing conversation the caller may add to (a user-visible session started from a parent chat). Validated: a parent that is missing or not the caller's answer */
+    parent_conversation_id?: string | null;
     user_input?: string | ((TextPart | ThinkingPart | ToolCallPart | ToolResultPart | (UserImageMediaPart | UserAudioMediaPart | UserVideoMediaPart | UserDocumentMediaPart | UserYouTubeMediaPart) | CodeExecPart | CodeResultPart | WebSearchPart | WebpageInputPart | NotesInputPart | TaskInputPart | AgentInputPart | ProjectInputPart | AgentAppInputPart | TranscriptInputPart | TranscriptSessionInputPart | WorkbookInputPart | DocumentInputPart | TableInputPart | ListInputPart | DataInputPart | ContextInputPart | RemarksInputPart | DecisionQuestionsPart | DecisionAnswersPart | SpeechScriptPart)[]) | null;
     variables?: {
         [key: string]: unknown;

package/dist/agents.js

@@ -1,4 +1,4 @@
-import { openJsonOrStream, openStream } from './chunk-3M4Y376I.js';
+import { openJsonOrStream, openStream } from './chunk-E3PGCGP7.js';
 import './chunk-KIEAFMKB.js';
 
 // src/generated/agents.ts

package/dist/ai.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkFSXBRXRX_cjs = require('./chunk-FSXBRXRX.cjs');
+var chunkZOZOF5DN_cjs = require('./chunk-ZOZOF5DN.cjs');
 require('./chunk-2SXAAKGV.cjs');
 
 // src/generated/ai.ts
@@ -16,6 +16,30 @@ var $createEmbeddings = { m: "POST", p: "/ai/google/embeddings", d: "aidream", a
 function createEmbeddings(api, args, options) {
   return api.call($createEmbeddings, args, options);
 }
+var $getStatus = { m: "GET", p: "/ai-test-mode/status", d: "aidream", a: "user", o: "required", n: "ai.get_status" };
+function getStatus(api, args, options) {
+  return api.call($getStatus, args, options);
+}
+var $listBaselines = { m: "GET", p: "/admin/ai-test-mode/baselines", d: "aidream", a: "admin", o: "exempt", n: "ai.list_baselines" };
+function listBaselines(api, args, options) {
+  return api.call($listBaselines, args, options);
+}
+var $patchBaseline = { m: "PATCH", p: "/admin/ai-test-mode/baselines/{baseline_id}", d: "aidream", a: "admin", o: "exempt", n: "ai.patch_baseline" };
+function patchBaseline(api, args, options) {
+  return api.call($patchBaseline, args, options);
+}
+var $deleteBaseline = { m: "DELETE", p: "/admin/ai-test-mode/baselines/{baseline_id}", d: "aidream", a: "admin", o: "exempt", n: "ai.delete_baseline" };
+function deleteBaseline(api, args, options) {
+  return api.call($deleteBaseline, args, options);
+}
+var $putStandIn = { m: "PUT", p: "/admin/ai-test-mode/stand-ins/{mandate_key}", d: "aidream", a: "admin", o: "exempt", n: "ai.put_stand_in" };
+function putStandIn(api, args, options) {
+  return api.call($putStandIn, args, options);
+}
+var $getReport = { m: "GET", p: "/admin/ai-test-mode/report", d: "aidream", a: "admin", o: "exempt", n: "ai.get_report" };
+function getReport(api, args, options) {
+  return api.call($getReport, args, options);
+}
 var $syncRegisteredUsagesEndpoint = { m: "POST", p: "/agent-usage/sync", d: "aidream", a: "admin", o: "exempt", n: "ai.sync_registered_usages_endpoint" };
 function syncRegisteredUsagesEndpoint(api, args, options) {
   return api.call($syncRegisteredUsagesEndpoint, args, options);
@@ -54,7 +78,7 @@ function listModels(api, args, options) {
 }
 var $chatCompletions = { m: "POST", p: "/v1/chat/completions", d: "matrx-local", a: "loopback_token", o: "exempt", s: "sse_or_json", n: "ai.chat_completions" };
 function chatCompletions(api, args, options) {
-  return chunkFSXBRXRX_cjs.openJsonOrStream(api, $chatCompletions, args, options);
+  return chunkZOZOF5DN_cjs.openJsonOrStream(api, $chatCompletions, args, options);
 }
 var $audioSpeech = { m: "POST", p: "/v1/audio/speech", d: "matrx-local", a: "loopback_token", o: "exempt", n: "ai.audio_speech" };
 function audioSpeech(api, args, options) {
@@ -76,6 +100,12 @@ var TABLE = {
   "GET /ai-models": $getAllAiModels,
   "POST /ai/latency/client-report": $clientLatencyReport,
   "POST /ai/google/embeddings": $createEmbeddings,
+  "GET /ai-test-mode/status": $getStatus,
+  "GET /admin/ai-test-mode/baselines": $listBaselines,
+  "PATCH /admin/ai-test-mode/baselines/{baseline_id}": $patchBaseline,
+  "DELETE /admin/ai-test-mode/baselines/{baseline_id}": $deleteBaseline,
+  "PUT /admin/ai-test-mode/stand-ins/{mandate_key}": $putStandIn,
+  "GET /admin/ai-test-mode/report": $getReport,
   "POST /agent-usage/sync": $syncRegisteredUsagesEndpoint,
   "GET /agent-usage/registry": $registryDiffEndpoint,
   "POST /agent-usage/scan": $runScanEndpoint,
@@ -101,10 +131,16 @@ exports.call = call;
 exports.chatCompletions = chatCompletions;
 exports.clientLatencyReport = clientLatencyReport;
 exports.createEmbeddings = createEmbeddings;
+exports.deleteBaseline = deleteBaseline;
 exports.embeddings = embeddings;
 exports.getAllAiModels = getAllAiModels;
+exports.getReport = getReport;
+exports.getStatus = getStatus;
 exports.hfTokenAssist = hfTokenAssist;
+exports.listBaselines = listBaselines;
 exports.listModels = listModels;
+exports.patchBaseline = patchBaseline;
+exports.putStandIn = putStandIn;
 exports.refreshProviderModels = refreshProviderModels;
 exports.registryDiffEndpoint = registryDiffEndpoint;
 exports.reloadCatalog = reloadCatalog;

package/dist/ai.d.cts

@@ -1,10 +1,10 @@
-import { A as Api, C as CallOptions, J as JsonOrStream, S as SseEvent } from './index-oZNMwcTG.cjs';
+import { A as Api, C as CallOptions, J as JsonOrStream, S as SseEvent } from './index-BgjdVvrS.cjs';
 import { JsonValue } from './schemas.cjs';
 import '@ai-matrx/auth/credentials';
 
 /**
  * GENERATED by @ai-matrx/api scripts/generate.mjs from aidream/api-contract — never edit by hand.
- * CONTRACT_SHA256 605c060bacf38697b876c603bf0260b9b2941fe22b1da1722810724c3d0c39be
+ * CONTRACT_SHA256 a7cc7154fd90de65bc0e3e819210f0337696cb50814b5a366e64ecb1b00412e4
  */
 
 /** AgentUsageReportResponse */
@@ -60,6 +60,18 @@ type AvailabilityDriftSummary = {
     };
     write_failures?: string[];
 };
+/** BaselineList */
+type BaselineList = {
+    baselines: {
+        [key: string]: JsonValue;
+    }[];
+};
+/** BaselinePatch */
+type BaselinePatch = {
+    label?: string | null;
+    /** True pins this as the mandate's stand-in. */
+    stand_in?: boolean | null;
+};
 /** ClientLatencyReport */
 type ClientLatencyReport = {
     latency_id: string;
@@ -313,6 +325,24 @@ type SettingsProbeSkippedOffering = {
     modality: string;
     why: string;
 };
+/** StandInBody */
+type StandInBody = {
+    label?: string | null;
+    /** The answer the step should return: any AiExecutionResult fields — usually `content` (kind instances) and/or `structured_output` and `final_text`. */
+    result: {
+        [key: string]: JsonValue;
+    };
+};
+/** TestModeStatus */
+type TestModeStatus = {
+    requested: "real" | "replay" | "stand_in";
+    effective: "real" | "replay" | "stand_in";
+    reason: string;
+    /** The server allows test modes AND this caller may use them. */
+    available: boolean;
+    server_reason: string;
+    modes?: string[];
+};
 /** An AVAILABLE offering the provider's own fresh list says it cannot serve. */
 type UnservableOffering = {
     offering_id: string;
@@ -344,6 +374,67 @@ type CreateEmbeddingsResult = EmbeddingResponse;
 /** Create Embeddings */
 /** `POST /ai/google/embeddings` · aidream · auth guest · org required */
 declare function createEmbeddings(api: Api, args: CreateEmbeddingsArgs, options?: CallOptions): Promise<CreateEmbeddingsResult>;
+type GetStatusArgs = {
+    [key: string]: never;
+};
+type GetStatusResult = TestModeStatus;
+/** Get Status */
+/** `GET /ai-test-mode/status` · aidream · auth user · org required */
+declare function getStatus(api: Api, args?: GetStatusArgs, options?: CallOptions): Promise<GetStatusResult>;
+type ListBaselinesArgs = {
+    query?: {
+        mandate_key?: string | null;
+        include_provider_calls?: boolean;
+    };
+};
+type ListBaselinesResult = BaselineList;
+/** List Baselines */
+/** `GET /admin/ai-test-mode/baselines` · aidream · auth admin · org exempt */
+declare function listBaselines(api: Api, args?: ListBaselinesArgs, options?: CallOptions): Promise<ListBaselinesResult>;
+type PatchBaselineArgs = {
+    path: {
+        baseline_id: string;
+    };
+    body: BaselinePatch;
+};
+type PatchBaselineResult = {
+    [key: string]: JsonValue;
+};
+/** Patch Baseline */
+/** `PATCH /admin/ai-test-mode/baselines/{baseline_id}` · aidream · auth admin · org exempt */
+declare function patchBaseline(api: Api, args: PatchBaselineArgs, options?: CallOptions): Promise<PatchBaselineResult>;
+type DeleteBaselineArgs = {
+    path: {
+        baseline_id: string;
+    };
+};
+type DeleteBaselineResult = {
+    [key: string]: boolean;
+};
+/** Delete Baseline */
+/** `DELETE /admin/ai-test-mode/baselines/{baseline_id}` · aidream · auth admin · org exempt */
+declare function deleteBaseline(api: Api, args: DeleteBaselineArgs, options?: CallOptions): Promise<DeleteBaselineResult>;
+type PutStandInArgs = {
+    path: {
+        mandate_key: string;
+    };
+    body: StandInBody;
+};
+type PutStandInResult = {
+    [key: string]: JsonValue;
+};
+/** Put Stand In */
+/** `PUT /admin/ai-test-mode/stand-ins/{mandate_key}` · aidream · auth admin · org exempt */
+declare function putStandIn(api: Api, args: PutStandInArgs, options?: CallOptions): Promise<PutStandInResult>;
+type GetReportArgs = {
+    [key: string]: never;
+};
+type GetReportResult = {
+    [key: string]: JsonValue;
+};
+/** Get Report */
+/** `GET /admin/ai-test-mode/report` · aidream · auth admin · org exempt */
+declare function getReport(api: Api, args?: GetReportArgs, options?: CallOptions): Promise<GetReportResult>;
 type SyncRegisteredUsagesEndpointArgs = {
     [key: string]: never;
 };
@@ -458,6 +549,30 @@ interface Operations {
         args: CreateEmbeddingsArgs;
         result: CreateEmbeddingsResult;
     };
+    "GET /ai-test-mode/status": {
+        args: GetStatusArgs;
+        result: GetStatusResult;
+    };
+    "GET /admin/ai-test-mode/baselines": {
+        args: ListBaselinesArgs;
+        result: ListBaselinesResult;
+    };
+    "PATCH /admin/ai-test-mode/baselines/{baseline_id}": {
+        args: PatchBaselineArgs;
+        result: PatchBaselineResult;
+    };
+    "DELETE /admin/ai-test-mode/baselines/{baseline_id}": {
+        args: DeleteBaselineArgs;
+        result: DeleteBaselineResult;
+    };
+    "PUT /admin/ai-test-mode/stand-ins/{mandate_key}": {
+        args: PutStandInArgs;
+        result: PutStandInResult;
+    };
+    "GET /admin/ai-test-mode/report": {
+        args: GetReportArgs;
+        result: GetReportResult;
+    };
     "POST /agent-usage/sync": {
         args: SyncRegisteredUsagesEndpointArgs;
         result: SyncRegisteredUsagesEndpointResult;
@@ -514,4 +629,4 @@ interface Operations {
 /** Path-keyed call, scoped to this domain only (never a global path map). */
 declare function call<K extends keyof Operations>(api: Api, key: K, args?: Operations[K]["args"], options?: CallOptions): Promise<Operations[K]["result"]>;
 
-export { type AgentUsageReportResponse, type AgentUsageRollupEntry, type AiCatalogReloadSummary, type AiModelsResponse, type AnalyzeRepoArgs, type AnalyzeRepoResult, type AnalyzeRequest_MatrxLocal, type AudioSpeechArgs, type AudioSpeechResult, type AudioTranscriptionsArgs, type AudioTranscriptionsResult, type AvailabilityDriftSummary, type ChatCompletionsArgs, type ChatCompletionsResult, type ClientLatencyReport, type ClientLatencyReportAck, type ClientLatencyReportArgs, type ClientLatencyReportResult, type CodeAgentUsage, type CreateEmbeddingsArgs, type CreateEmbeddingsResult, type EmbeddingPart, type EmbeddingRequest, type EmbeddingResponse, type EmbeddingsArgs, type EmbeddingsResult, type GetAllAiModelsArgs, type GetAllAiModelsResult, type HardwareInfo, type HfAssistRequest, type HfAssistResponse, type HfTokenAssistArgs, type HfTokenAssistResult, type ListModelsArgs, type ListModelsResult, type ModelFileEntry, type Operations, type ParameterFactsSummary, type ProviderModelsRefreshRequest, type ProviderModelsRefreshSummary, type ProviderRefreshResult, type QuarantinedRowSummary, type RefreshProviderModelsArgs, type RefreshProviderModelsResult, type RegistryDbRow, type RegistryDiffEndpointArgs, type RegistryDiffEndpointResult, type RegistryDiffResponse, type RegistrySyncReport, type ReloadCatalogArgs, type ReloadCatalogResult, type RepoAnalysisResult, type ReportEndpointArgs, type ReportEndpointResult, type RunScanEndpointArgs, type RunScanEndpointResult, type RunSettingsProbeArgs, type RunSettingsProbeResult, type ScanSummary, type SettingsProbeOutcome, type SettingsProbeRequest, type SettingsProbeResponse, type SettingsProbeSkippedOffering, type SyncRegisteredUsagesEndpointArgs, type SyncRegisteredUsagesEndpointResult, type UnservableOffering, analyzeRepo, audioSpeech, audioTranscriptions, call, chatCompletions, clientLatencyReport, createEmbeddings, embeddings, getAllAiModels, hfTokenAssist, listModels, refreshProviderModels, registryDiffEndpoint, reloadCatalog, reportEndpoint, runScanEndpoint, runSettingsProbe, syncRegisteredUsagesEndpoint };
+export { type AgentUsageReportResponse, type AgentUsageRollupEntry, type AiCatalogReloadSummary, type AiModelsResponse, type AnalyzeRepoArgs, type AnalyzeRepoResult, type AnalyzeRequest_MatrxLocal, type AudioSpeechArgs, type AudioSpeechResult, type AudioTranscriptionsArgs, type AudioTranscriptionsResult, type AvailabilityDriftSummary, type BaselineList, type BaselinePatch, type ChatCompletionsArgs, type ChatCompletionsResult, type ClientLatencyReport, type ClientLatencyReportAck, type ClientLatencyReportArgs, type ClientLatencyReportResult, type CodeAgentUsage, type CreateEmbeddingsArgs, type CreateEmbeddingsResult, type DeleteBaselineArgs, type DeleteBaselineResult, type EmbeddingPart, type EmbeddingRequest, type EmbeddingResponse, type EmbeddingsArgs, type EmbeddingsResult, type GetAllAiModelsArgs, type GetAllAiModelsResult, type GetReportArgs, type GetReportResult, type GetStatusArgs, type GetStatusResult, type HardwareInfo, type HfAssistRequest, type HfAssistResponse, type HfTokenAssistArgs, type HfTokenAssistResult, type ListBaselinesArgs, type ListBaselinesResult, type ListModelsArgs, type ListModelsResult, type ModelFileEntry, type Operations, type ParameterFactsSummary, type PatchBaselineArgs, type PatchBaselineResult, type ProviderModelsRefreshRequest, type ProviderModelsRefreshSummary, type ProviderRefreshResult, type PutStandInArgs, type PutStandInResult, type QuarantinedRowSummary, type RefreshProviderModelsArgs, type RefreshProviderModelsResult, type RegistryDbRow, type RegistryDiffEndpointArgs, type RegistryDiffEndpointResult, type RegistryDiffResponse, type RegistrySyncReport, type ReloadCatalogArgs, type ReloadCatalogResult, type RepoAnalysisResult, type ReportEndpointArgs, type ReportEndpointResult, type RunScanEndpointArgs, type RunScanEndpointResult, type RunSettingsProbeArgs, type RunSettingsProbeResult, type ScanSummary, type SettingsProbeOutcome, type SettingsProbeRequest, type SettingsProbeResponse, type SettingsProbeSkippedOffering, type StandInBody, type SyncRegisteredUsagesEndpointArgs, type SyncRegisteredUsagesEndpointResult, type TestModeStatus, type UnservableOffering, analyzeRepo, audioSpeech, audioTranscriptions, call, chatCompletions, clientLatencyReport, createEmbeddings, deleteBaseline, embeddings, getAllAiModels, getReport, getStatus, hfTokenAssist, listBaselines, listModels, patchBaseline, putStandIn, refreshProviderModels, registryDiffEndpoint, reloadCatalog, reportEndpoint, runScanEndpoint, runSettingsProbe, syncRegisteredUsagesEndpoint };