@myagentroam/agent 0.10.21 → 0.10.23

package/dist/agent-core/error.d.ts

@@ -1,5 +1,6 @@
 export declare class MarAgentError extends Error {
     readonly code: string;
+    readonly publicMessage: string;
     readonly details: Readonly<Record<string, unknown>> | undefined;
     readonly retryable: boolean;
     constructor(code: string, message: string, options?: {

package/dist/agent-core/error.js

@@ -1,11 +1,13 @@
 export class MarAgentError extends Error {
     code;
+    publicMessage;
     details;
     retryable;
     constructor(code, message, options = {}) {
         super(`${code}: ${message}`, { cause: options.cause });
         this.name = 'MarAgentError';
         this.code = code;
+        this.publicMessage = message;
         this.details = options.details;
         this.retryable = options.retryable ?? false;
     }

package/dist/agent-core/model/catalog-file.d.ts

@@ -11,6 +11,7 @@ export declare function readModelCatalog(home: string): Promise<CliModelCatalog>
 export declare function writeModelCatalog(home: string, catalog: CliModelCatalog): Promise<void>;
 export declare function serializeModel(model: CliModelConfiguration): {
     apiKey: string;
+    conversationModel?: boolean;
     responsesConfigurationUpdates?: boolean;
     codexCredential?: boolean;
     responsesTransport?: import("./configuration.js").ResponsesTransport;
@@ -44,6 +45,7 @@ export declare function serializeModel(model: CliModelConfiguration): {
     credential: {
         type: "CODEX_AUTH_FILE";
     };
+    conversationModel?: boolean;
     responsesConfigurationUpdates?: boolean;
     codexCredential?: boolean;
     responsesTransport?: import("./configuration.js").ResponsesTransport;

package/dist/agent-core/model/configuration.d.ts

@@ -67,6 +67,7 @@ declare const rawModelSchema: z.ZodObject<{
         max: "max";
         ultra: "ultra";
     }>>;
+    conversationModel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     titleGeneration: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     codeMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     fastMode: z.ZodOptional<z.ZodBoolean>;
@@ -99,7 +100,8 @@ declare const rawModelSchema: z.ZodObject<{
     }, z.core.$strict>>;
     enabled: z.ZodBoolean;
 }, z.core.$strict>;
-export interface MarAgentModelConfiguration extends Omit<z.infer<typeof rawModelSchema>, 'apiKey' | 'responsesPreviousResponseId' | 'responsesTransport'> {
+export interface MarAgentModelConfiguration extends Omit<z.infer<typeof rawModelSchema>, 'apiKey' | 'responsesPreviousResponseId' | 'responsesTransport' | 'conversationModel'> {
+    conversationModel?: boolean;
     apiKey?: SecretValue;
     credentialProvider?: ModelCredentialProvider;
     /** Whether this Responses endpoint accepts native configuration_update input items. */

package/dist/agent-core/model/configuration.js

@@ -47,6 +47,7 @@ const rawModelSchema = z
     outputCapabilities: z.tuple([z.literal('TEXT')]),
     reasoningEfforts: z.array(marAgentReasoningEffortSchema),
     defaultReasoningEffort: marAgentReasoningEffortSchema.optional(),
+    conversationModel: z.boolean().optional().default(true),
     titleGeneration: z.boolean().optional().default(false),
     codeMode: z.boolean().optional().default(false),
     fastMode: z.boolean().optional(),

package/dist/agent-core/sdk/model-runtime.js

@@ -21,9 +21,12 @@ export function resolveAgentModels(configurations, requestedDefaultModelId) {
     const models = new Map(configuredModels.filter((model) => model.enabled).map((model) => [model.id, model]));
     if (models.size === 0)
         throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'At least one enabled model is required.');
-    const defaultModelId = requestedDefaultModelId ?? models.keys().next().value;
-    if (!models.has(defaultModelId))
-        throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Default model is unavailable.');
+    const defaultModelId = requestedDefaultModelId ??
+        [...models.values()].find((model) => model.conversationModel !== false)?.id;
+    if (!defaultModelId ||
+        !models.has(defaultModelId) ||
+        models.get(defaultModelId).conversationModel === false)
+        throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Default conversation model is unavailable.');
     return { models, defaultModelId, credentialProviders };
 }
 export function createModelTurnSession(adapter) {

package/dist/agent-core/sdk/session.js

@@ -190,6 +190,10 @@ export function createSessionOpener(services) {
             services.assertCanStart();
             if ([...active.keys()].some((key) => key.startsWith(`${sessionId}:`)))
                 throw new MarAgentError('MAR_AGENT_EXECUTION_ACTIVE', 'Session already has an active execution.');
+            const { models: executionModels, defaultModelId: executionDefaultModelId, generation: executionModelGeneration } = services.modelState();
+            if (mode !== 'compact' &&
+                executionModels.get(input.modelId ?? executionDefaultModelId)?.conversationModel === false)
+                throw new MarAgentError('MAR_AGENT_MODEL_DISABLED', 'The selected model is not a conversation model.');
             const executionId = randomUUID(), turnId = internal.turnId ?? randomUUID(), queue = new AsyncQueue(), controller = new AbortController();
             const abortSource = () => controller.abort(internal.signal?.reason);
             internal.signal?.addEventListener('abort', abortSource, { once: true });
@@ -199,7 +203,6 @@ export function createSessionOpener(services) {
                 ...currentEnvironment,
                 ...currentLocalTimeContext()
             };
-            const { models: executionModels, defaultModelId: executionDefaultModelId, generation: executionModelGeneration } = services.modelState();
             const executionSystemInstruction = settings.systemInstruction;
             promptDefaults = {
                 executionId,
@@ -610,7 +613,9 @@ export function createSessionOpener(services) {
                         throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Host tools cannot use the MCP namespace.');
                     const selectedModelForTools = executionModels.get(input.modelId ?? executionDefaultModelId);
                     const builtinTools = BUILTIN_TOOL_DEFINITIONS.map((tool) => tool.name === 'agent_start'
-                        ? agentStartToolDefinitionWithModels([...executionModels.values()].map((configuration) => ({
+                        ? agentStartToolDefinitionWithModels([...executionModels.values()]
+                            .filter((configuration) => configuration.conversationModel !== false)
+                            .map((configuration) => ({
                             id: configuration.id,
                             name: configuration.name,
                             reasoningEfforts: configuration.reasoningEfforts

package/dist/agent-core/subagent/session-controller.d.ts

@@ -7,6 +7,7 @@ import type { SubagentController, SubagentMessageOptions, SubagentOutputOptions,
 export interface SubagentModelOption {
     readonly id: string;
     readonly name: string;
+    readonly conversationModel?: boolean;
     readonly reasoningEfforts: readonly MarAgentReasoningEffort[];
     readonly defaultReasoningEffort: MarAgentReasoningEffort;
 }

package/dist/agent-core/subagent/session-controller.js

@@ -938,7 +938,7 @@ function validateTaskInput(input, native = false) {
 function resolveModel(execution, input) {
     const modelId = input.modelId ?? execution.modelId;
     const model = execution.models.get(modelId);
-    if (!model)
+    if (!model || model.conversationModel === false)
         throw new MarAgentError('MAR_AGENT_SUBAGENT_MODEL_UNAVAILABLE', 'Selected model is unavailable for subagents.');
     if (input.reasoningEffort !== undefined &&
         !model.reasoningEfforts.includes(input.reasoningEffort))

package/dist/cli/main.js

@@ -180,6 +180,7 @@ async function modelsCommand(home, arguments_, codexAuthFile) {
                 defaultReasoningEffort: existing?.defaultReasoningEffort
             })
             : parseReasoningEffort(defaultReasoningEffortOption, '--default-reasoning-effort'),
+        conversationModel: existing?.conversationModel ?? true,
         titleGeneration: existing?.titleGeneration ?? false,
         codeMode: booleanFlag(arguments_, '--code-mode', '--no-code-mode', existing?.codeMode ?? false),
         ...(credential === 'codex-auth-file' && fastMode ? { fastMode: true } : {}),
@@ -252,7 +253,7 @@ async function main() {
         throw new MarAgentError('MAR_AGENT_CLI_ARGUMENT_INVALID', 'The deprecated --access option only accepts full-access.');
     const format = takeOption(arguments_, '--format') ?? 'text';
     const command = arguments_[0];
-    const selectedModel = catalog.models.find((model) => model.id === modelId && model.enabled);
+    const selectedModel = catalog.models.find((model) => model.id === modelId && model.enabled && model.conversationModel !== false);
     if (selectedModel !== undefined)
         assertExternalCredentialAvailable(selectedModel, codexAuthFile);
     if (reasoningEffort && selectedModel && !selectedModel.reasoningEfforts.includes(reasoningEffort))
@@ -360,7 +361,8 @@ async function main() {
                             models: runtime.models,
                             currentModelId: modelId ??
                                 catalog.defaultModelId ??
-                                runtime.models.find((model) => model.enabled).id,
+                                runtime.models.find((model) => model.enabled && model.conversationModel !== false)
+                                    .id,
                             prompt: invocation.prompt,
                             signal: titleController.signal
                         }).catch(() => undefined);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.10.21",
+  "version": "0.10.23",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",