@nylorun/agents 0.28.0-beta → 0.29.1-beta

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @nylorun/agents
 
+## 0.29.1-beta
+
+### Patch Changes
+
+- Pin core to the tested release.
+- Updated dependencies [2ef610b]
+  - @nylorun/core@0.30.0-beta
+
+## 0.29.0-beta
+
+### Minor Changes
+
+- d99b3ac: A session can have its own model (optional Host feature `session-model`). `PUT /v1/sessions/{id}/model` chooses one of a connected provider's models for that session's turns, `DELETE` clears it, and `GET` answers the model the next turn uses (`source: "session"` or `"tenant"`). The Tenant's model and every other session's stay as they are. The Model Gate calls the session's model on its provider's credential (a refreshed OAuth credential is written back to that provider), `turn.start.model` describes it, and the usage ledger records it. A choice names a connected provider and a model its catalog lists, is set by the application only (a trusted issuer's token can read it, not change it), and is refused while a turn runs or waits (`409 session_busy`); while its provider is disconnected the session uses the Tenant's model. The SDK adds `session.model()`, `setModel({ provider, model })` and `clearModel()`.
+
+  Studio's model picker under the message box now sets the model of that session only, instead of the Tenant's: "Tenant model" clears the session's choice, the picker is locked while a turn runs, it groups models by provider, and its search keeps what is typed. A Runtime without `session-model` shows no picker.
+
+### Patch Changes
+
+- Pin core to the tested release.
+- Updated dependencies [95f98f1]
+- Updated dependencies [d99b3ac]
+  - @nylorun/core@0.29.0-beta
+
 ## 0.28.0-beta
 
 ### Minor Changes

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { Agent, AgentBuilder } from "./builder.js";
 export { AgentBuildError, AgentLifecycleError, VerdictSchema, isVerdict, WorkflowBuildError, isBuiltWorkflow, flow, tool, http, defineSchema, ToolError, harnessSectionOf, sectionGaps, } from "@nylorun/core/define";
 export type { FlowAgentBuilder, Flow, Named, LoopOptions, StageOptions, HttpTarget, } from "@nylorun/core/define";
 export type { AgentOptions, AgentManifest, BuiltAgent, BuiltWorkflow, Verdict, WorkflowBinding, WorkflowManifest, ToolDefinition, ToolExecutionContext, ToolOutcome, JsonValue, JsonObject, } from "@nylorun/core/define";
-export type { SessionPage, SessionListItem, SessionManifestView, HistoryPage, SessionUsageTotals, CostSplit, ModelCall, ModelCallsPage, AgentPage, ToolCall, ToolCallsPage, LiveEvent, SessionEvent, SessionEventOf, EventType, SessionCommand, SubjectScope, AgentView, AgentState, AgentAttention, AgentEvent, AgentEventType, EgressRunningTurn, EnvironmentKind, EnvironmentRecipe, EnvironmentSecretSlot, AgentSecretView, AgentSnapshot, AgentRestore, AgentDiskVersions, RestoreAgentRequest, AgentForkPlan, AgentMovePlan, RestartAgentRequest, ForkAgentRequest, ForkAgentResponse, DeleteAgentResponse, PutAgentRequest, PutAgentSecretRequest, AgentManifestV8, AgentManifestFile, HarnessManifestFile, RuntimeManifestFile, RuntimeSection, AgentManifestChange, AgentManifestWarning, AgentManifestPlan, AgentManifestSource, AgentManifestSourceDiff, AgentManifestSourceSummary, AgentFolderDiagnostic, AgentManifestView, AgentManifestVersions, SaveAgentManifestResponse, DeleteAgentManifestResponse, MessagePart, ArtifactView, ArtifactKind, ArtifactListItem, ArtifactPage, ArtifactVersionView, ArtifactLink, UploadArtifactResponse, DefinitionFileView, ArtifactTree, ArtifactDiff, FolderEntry, } from "@nylorun/core/contracts";
+export type { SessionPage, SessionListItem, SessionManifestView, HistoryPage, SessionUsageTotals, SessionModelChoice, SessionModelView, CostSplit, ModelCall, ModelCallsPage, AgentPage, ToolCall, ToolCallsPage, LiveEvent, SessionEvent, SessionEventOf, EventType, SessionCommand, SubjectScope, AgentView, AgentState, AgentAttention, AgentEvent, AgentEventType, EgressRunningTurn, EnvironmentKind, EnvironmentRecipe, EnvironmentSecretSlot, AgentSecretView, AgentSnapshot, AgentRestore, AgentDiskVersions, RestoreAgentRequest, AgentForkPlan, AgentMovePlan, RestartAgentRequest, ForkAgentRequest, ForkAgentResponse, DeleteAgentResponse, PutAgentRequest, PutAgentSecretRequest, AgentManifestV8, AgentManifestFile, HarnessManifestFile, RuntimeManifestFile, RuntimeSection, AgentManifestChange, AgentManifestWarning, AgentManifestPlan, AgentManifestSource, AgentManifestSourceDiff, AgentManifestSourceSummary, AgentFolderDiagnostic, AgentManifestView, AgentManifestVersions, SaveAgentManifestResponse, DeleteAgentManifestResponse, MessagePart, ArtifactView, ArtifactKind, ArtifactListItem, ArtifactPage, ArtifactVersionView, ArtifactLink, UploadArtifactResponse, DefinitionFileView, ArtifactTree, ArtifactDiff, FolderEntry, } from "@nylorun/core/contracts";
 export { AGENT_EVENT_TYPES, AGENT_FOLDER_MEDIA_TYPE, AGENT_STATES, COMPUTE_STATES, RUNTIME_LIMIT_DEFAULTS, SUBJECT_SCOPES, } from "@nylorun/core/contracts";
 export type { AgentHarnessSection, HarnessSection, HarnessSkill, HarnessMcpServer, WorkflowHarnessSection, } from "@nylorun/core";
 export { AgentsClient, SessionClient, createClient } from "./client.js";

package/dist/session-client.d.ts

@@ -3,7 +3,7 @@
  * which resolves the connection from the environment or the Project link.
  */
 import type { JsonValue, SandboxToolName } from "@nylorun/core/define";
-import { type SessionItemsResponse, type SessionSummary, type SubjectScope, type MessageDelivery, type MessagePart, type SessionCommand } from "@nylorun/core/contracts";
+import { type SessionModelChoice, type SessionItemsResponse, type SessionSummary, type SubjectScope, type MessageDelivery, type MessagePart, type SessionCommand } from "@nylorun/core/contracts";
 import { SessionsReadClient } from "./reads.js";
 import { AccessClient } from "./access.js";
 import { AgentInstancesClient } from "./agents.js";
@@ -204,6 +204,72 @@ export declare class SessionClient {
         manifestHash: string;
         manifest: Record<string, unknown>;
     }>;
+    /**
+     * The model the session's next turn uses (Host feature `session-model`): its own while its
+     * provider is connected, else the Tenant's.
+     */
+    model(options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        configured: false;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    } | {
+        configured: true;
+        source: "session" | "tenant";
+        provider: string;
+        model: string;
+        baseUrl?: string | undefined;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    }>;
+    /**
+     * Chooses one of a connected provider's models for this session's turns; the Tenant's model and
+     * other sessions' stay as they are. Refused while a turn runs or waits (`409 session_busy`).
+     */
+    setModel(choice: SessionModelChoice, options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        configured: false;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    } | {
+        configured: true;
+        source: "session" | "tenant";
+        provider: string;
+        model: string;
+        baseUrl?: string | undefined;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    }>;
+    /** Clears the session's own model: its next turns use the Tenant's. */
+    clearModel(options?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        configured: false;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    } | {
+        configured: true;
+        source: "session" | "tenant";
+        provider: string;
+        model: string;
+        baseUrl?: string | undefined;
+        choice?: {
+            provider: string;
+            model: string;
+        } | undefined;
+    }>;
     usage(options?: {
         turnId?: string;
         signal?: AbortSignal;

package/dist/session-client.js

@@ -1,7 +1,7 @@
 import { SANDBOX_TOOL_NAMES, isSandboxToolName } from "@nylorun/core/define";
 import { z } from "zod";
 import { SCOPES_HEADER, SUBJECT_HEADER } from "@nylorun/core/compatibility";
-import { SessionManifestViewSchema, SessionUsageTotalsSchema, ModelCallsPageSchema, ToolCallsPageSchema, TurnTraceSchema, parseSessionEvent, parseSubjectHeaders, } from "@nylorun/core/contracts";
+import { SessionManifestViewSchema, SessionModelViewSchema, SessionUsageTotalsSchema, ModelCallsPageSchema, ToolCallsPageSchema, TurnTraceSchema, parseSessionEvent, parseSubjectHeaders, } from "@nylorun/core/contracts";
 import { SessionsReadClient } from "./reads.js";
 import { AccessClient } from "./access.js";
 import { AgentInstancesClient } from "./agents.js";
@@ -200,6 +200,27 @@ export class SessionClient {
         await this.transport.requireFeature("session-reads", options.signal);
         return SessionManifestViewSchema.parse(await this.transport.json(`${this.path}/manifest`, "GET", undefined, options.signal));
     }
+    /**
+     * The model the session's next turn uses (Host feature `session-model`): its own while its
+     * provider is connected, else the Tenant's.
+     */
+    async model(options = {}) {
+        await this.transport.requireFeature("session-model", options.signal);
+        return SessionModelViewSchema.parse(await this.transport.json(`${this.path}/model`, "GET", undefined, options.signal));
+    }
+    /**
+     * Chooses one of a connected provider's models for this session's turns; the Tenant's model and
+     * other sessions' stay as they are. Refused while a turn runs or waits (`409 session_busy`).
+     */
+    async setModel(choice, options = {}) {
+        await this.transport.requireFeature("session-model", options.signal);
+        return SessionModelViewSchema.parse(await this.transport.json(`${this.path}/model`, "PUT", { provider: choice.provider, model: choice.model }, options.signal));
+    }
+    /** Clears the session's own model: its next turns use the Tenant's. */
+    async clearModel(options = {}) {
+        await this.transport.requireFeature("session-model", options.signal);
+        return SessionModelViewSchema.parse(await this.transport.json(`${this.path}/model`, "DELETE", undefined, options.signal));
+    }
     async usage(options = {}) {
         await this.transport.requireFeature("session-reads", options.signal);
         const query = new URLSearchParams();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nylorun/agents",
-  "version": "0.28.0-beta",
+  "version": "0.29.1-beta",
   "description": "Nylorun agent definitions and session client",
   "type": "module",
   "license": "Apache-2.0",
@@ -43,7 +43,7 @@
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@nylorun/core": "0.28.0-beta",
+    "@nylorun/core": "0.30.0-beta",
     "gray-matter": "^4.0.3"
   },
   "peerDependencies": {