@segmentstream/agent 0.30.0 → 0.31.0

package/README.md

@@ -64,17 +64,22 @@ export default segmentstream(config);
 import { defineAgent } from "eve";
 import { segmentstream } from "@segmentstream/agent";
 
+import config from "../segmentstream.json";
+
 export default defineAgent({
   defaultTools: false,
-  model: segmentstream.model(),
+  model: segmentstream.model(config.models.chat),
   reasoning: "medium",
   limits: { sessionUsage: ({ window }) => (window.costUsd ?? 0) >= 2 },
 });
 ```
 
-`segmentstream.model()` resolves on `session.started` from `models.chat` in `agent/segmentstream.json`
-(`{ "default", "byRole", "preview" }`), where the platform reads it too; an inline
-`segmentstream.model({ default, byRole, preview })` works the same. On a preview deployment it returns `preview`
+`segmentstream.model(choice)` resolves on `session.started` from `models.chat` of
+`agent/segmentstream.json` (`{ "default", "byRole", "preview" }`), where the platform reads it too;
+an inline `segmentstream.model({ default, byRole, preview })` works the same. `agent.ts` passes the
+choice because eve binds the extension's configuration only to the modules it bundles for the
+mount: code outside the extension never sees it. A missing or invalid choice fails when `agent.ts`
+loads. On a preview deployment it returns `preview`
 when set. Otherwise it returns the model of the first `byRole` entry whose role the member holds, in
 the order written, and `default` when none matches. The roles come from the member's pairing, not
 from the message. The model is never switched mid-session, which keeps the provider's prompt cache.

package/dist/_chunks/{build-metadata-Dgh-X4S8.mjs → build-metadata-CZuxPOVF.mjs}

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-var version = "0.30.0";
+var version = "0.31.0";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

package/dist/extension/config.d.ts

@@ -196,7 +196,10 @@ export interface SegmentStreamAgentConfig extends AdmissionSettings {
         readonly telegram: TelegramSettings | null;
     };
     readonly models: {
-        /** `null` when `agent.ts` passes the choice to `segmentstream.model()` itself. */
+        /**
+         * `null` when the JSON sets none. The platform reads it at deploy; `agent.ts` passes the same
+         * value to `segmentstream.model()`, which never reads the mount's configuration.
+         */
         readonly chat: ChatModelChoice | null;
         readonly stt: string | false;
         readonly imageDescription: string | false | null;
@@ -227,6 +230,11 @@ export declare class SegmentStreamAgentConfigError extends Error {
     readonly name = "SegmentStreamAgentConfigError";
     constructor(issues: ReadonlyArray<ConfigIssue>);
 }
+/**
+ * The chat model choice `agent.ts` passes to `segmentstream.model()`, validated like `models.chat`
+ * of `agent/segmentstream.json`, where it normally comes from.
+ */
+export declare function chatModelChoiceOf(value: unknown): ChatModelChoice;
 /** Exact historical pins retain the pre-0.13 presentation contract at the archive boundary. */
 export declare function isLegacyAgentArchive(version: string | undefined): boolean;
 /** Validates the authored configuration and applies the defaults. */

package/dist/extension/config.mjs

@@ -297,6 +297,13 @@ function chatModelChoice(value, issues) {
 		...preview === void 0 ? {} : { preview }
 	};
 }
+function chatModelChoiceOf(value) {
+	const issues = [];
+	const choice = chatModelChoice(value, issues);
+	if (issues.length > 0) throw new SegmentStreamAgentConfigError(issues);
+	if (choice === null) throw new TypeError("segmentstream.model() needs the chat model choice: pass models.chat of agent/segmentstream.json, as in segmentstream.model(config.models.chat).");
+	return choice;
+}
 function isSessionScope(value) {
 	return SESSION_SCOPES.some((scope) => scope === value);
 }
@@ -717,4 +724,4 @@ function manifestOf(config) {
 	if (validation.issues !== void 0) throw new SegmentStreamAgentConfigError(validation.issues);
 	return validation.value;
 }
-export { ADMISSION_REPLY_KEYS, DEFAULT_ADMISSION_LIMITS, DEFAULT_ATTACHMENTS_MODEL, DEFAULT_DECISION_MODEL, DEFAULT_IMAGE_DESCRIPTION_MODEL, DEFAULT_STT_MODEL, SESSION_SCOPES, SegmentStreamAgentConfigError, TELEGRAM_POLICIES, configSchema, isLegacyAgentArchive, manifestOf, validateConfig };
+export { ADMISSION_REPLY_KEYS, DEFAULT_ADMISSION_LIMITS, DEFAULT_ATTACHMENTS_MODEL, DEFAULT_DECISION_MODEL, DEFAULT_IMAGE_DESCRIPTION_MODEL, DEFAULT_STT_MODEL, SESSION_SCOPES, SegmentStreamAgentConfigError, TELEGRAM_POLICIES, chatModelChoiceOf, configSchema, isLegacyAgentArchive, manifestOf, validateConfig };

package/dist/extension/extension.d.ts

@@ -1,5 +1,5 @@
 import { manifestOf } from "./config.js";
-import { type DynamicModel, type ModelChoice } from "./model.js";
+import { model } from "./model.js";
 export declare const segmentstream: import("eve/extension").ExtensionHandle<{
     readonly "~standard": {
         readonly version: 1;
@@ -16,7 +16,7 @@ export declare const segmentstream: import("eve/extension").ExtensionHandle<{
         };
     };
 }> & {
-    model: (choice?: ModelChoice) => DynamicModel;
+    model: typeof model;
     manifestOf: typeof manifestOf;
 };
 export default segmentstream;

package/dist/extension/extension.mjs

@@ -17,7 +17,7 @@ import { routingBurst } from "./lib/group-routing/burst.mjs";
 import { defineExtension } from "eve/extension";
 const extension = defineExtension({ config: configSchema });
 const segmentstream = Object.assign(extension, {
-	model: (choice) => model(choice ?? (() => extension.config.models.chat)),
+	model,
 	manifestOf
 });
 export { DEFAULT_ADMISSION_LIMITS, DEFAULT_DECISION_MODEL, DEFAULT_GROUP_POLICY, DEFAULT_STT_MODEL, SegmentStreamAgentConfigError, archivedRoutingMessages, chooseModel, conversationKey, segmentstream as default, segmentstream, effectiveGroupPolicy, addressingReason as groupAddressingReason, agentMessage as groupAgentMessage, conversationAddressing as groupConversationAddressing, decisionRouter as groupDecisionRouter, groupPolicy, manifestOf, model, replayRouterPayload, routeMessage as routeGroupMessage, routingBurst };

package/dist/extension/lib/build-metadata.mjs

@@ -4,4 +4,4 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-export { t as agentBuild } from "../../_chunks/build-metadata-Dgh-X4S8.mjs";
+export { t as agentBuild } from "../../_chunks/build-metadata-CZuxPOVF.mjs";

package/dist/extension/lib/telegram/adapter.mjs

@@ -10,7 +10,7 @@ import { groupRoutingHealth } from "../group-routing/health.mjs";
 import { dispatchStructuredMessage, structuredMessage } from "./structured.mjs";
 import { handleWorkspaceCallback, isWorkspaceCallback } from "./callbacks.mjs";
 import { telegramText, withTelegramTexts } from "./texts.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Dgh-X4S8.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CZuxPOVF.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { manifestOf } from "../../config.mjs";
 import { gatewayAttachmentDescriber } from "./attachment-description.mjs";

package/dist/extension/lib/telegram/health.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../../_chunks/build-metadata-Dgh-X4S8.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CZuxPOVF.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";

package/dist/extension/lib/telegram/lifecycle.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { d as telegramRuntimeSource, l as principalRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-CPOCTHBa.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Dgh-X4S8.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CZuxPOVF.mjs";
 import { n as currentInboundRequest } from "../../../_chunks/inbound-request-Dy7q3T23.mjs";
 import { object } from "../confirmation-description.mjs";
 import { needsConfirmation } from "../confirmations.mjs";

package/dist/extension/model.d.ts

@@ -1,6 +1,6 @@
 import { type AgentModelDefinition, type AgentStaticModelDefinition } from "eve";
 import type { SessionAuthContext } from "eve/context";
-import type { ChatModelChoice } from "./config.js";
+import { type ChatModelChoice } from "./config.js";
 import { type Environment } from "./lib/environment.js";
 /** The models `segmentstream.model()` chooses between, as AI Gateway model ids. */
 export type ModelChoice = ChatModelChoice;
@@ -15,8 +15,11 @@ export declare function chooseModel(input: {
 /**
  * The agent's model, chosen once when a session starts from the member's roles and `VERCEL_ENV`.
  * Choosing once keeps the provider's prompt cache: a switch mid-session re-reads the history at
- * full price. The choice is given here, or read when the session starts, from `models.chat` of
- * `agent/segmentstream.json` through the mounted extension; a session without either fails to
- * start with a message naming the missing setting.
+ * full price.
+ *
+ * `agent.ts` passes the choice, normally `models.chat` of `agent/segmentstream.json`, which the
+ * platform reads at deploy. eve binds the mount's configuration only to the modules it bundles for
+ * that mount, and `agent.ts` is outside it, so the choice is never read from the mount. A missing or
+ * invalid choice fails when `agent.ts` loads, not on the first message.
  */
-export declare function model(choice: ModelChoice | (() => ModelChoice | null)): DynamicModel;
+export declare function model(choice: ModelChoice): DynamicModel;

package/dist/extension/model.mjs

@@ -4,6 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { chatModelChoiceOf } from "./config.mjs";
 import { isPreview } from "./lib/environment.mjs";
 import { a as rolesOf } from "../_chunks/principal-CPOCTHBa.mjs";
 import { runs } from "eve/events";
@@ -16,11 +17,10 @@ function chooseModel(input) {
 	return choice.default;
 }
 function model(choice) {
+	const chosen = chatModelChoiceOf(choice);
 	return defineDynamic((context) => context.memo(context.session.id, () => {
 		const previous = runs(context.view).findLast((run) => run.turnId !== void 0 && run.modelId !== void 0)?.modelId;
 		if (previous !== void 0) return previous;
-		const chosen = typeof choice === "function" ? choice() : choice;
-		if (chosen === null) throw new Error("segmentstream.model() has no model to choose from: set models.chat in agent/segmentstream.json or pass the choice to segmentstream.model().");
 		return chooseModel({
 			choice: chosen,
 			principal: context.session.auth.initiator ?? context.session.auth.current

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Mount a SegmentStream workspace's agent on eve: the ontology as tools, acting as the member who writes, and Telegram through the workspace's connection.",
   "license": "Apache-2.0",
   "author": "SegmentStream",