@segmentstream/agent 0.10.4 → 0.12.0

package/README.md

@@ -451,7 +451,7 @@ To reach a local ontology service, set `SEGMENTSTREAM_AGENT_ONTOLOGY_URL=http://
 production tokens of the workspace's project, though, so a local run gets the ontology only from a
 local ontology service configured to accept that token.
 
-Building the package needs Node.js 24, as eve does: `npm run build` runs `eve extension build`,
+Building the package needs Node.js 24, as eve does: `pnpm run build` runs `eve extension build`,
 which writes the agent-shaped `dist/extension` tree, its declarations and eve's compatibility
 manifest.
 

package/dist/_chunks/{build-metadata-CFAnvrjf.mjs → build-metadata-SU1WsppW.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.10.4";
+var version = "0.12.0";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

package/dist/extension/extension.d.ts

@@ -20,7 +20,6 @@ export { chooseModel, model, type DynamicModel, type ModelChoice } from "./model
 export { groupPolicy, effectiveGroupPolicy, DEFAULT_GROUP_POLICY, type GroupPolicy, type GroupPolicyInput, type SmartPolicyInput, type ChatOverrideInput, } from "./lib/group-routing/policy.js";
 export { addressingReason as groupAddressingReason, conversationKey, type GroupMessageSignals, type AgentMessageSignals, type GroupChannelAdapter, } from "./lib/group-routing/signals.js";
 export { routeMessage as routeGroupMessage, decisionRouter as groupDecisionRouter, } from "./lib/group-routing/router.js";
-export { groupSettings as readGroupSettings, type CloudGroupSettings, } from "./lib/group-routing/settings.js";
 export { observedMessages as groupObservedMessages, agentMessage as groupAgentMessage, type RecentMessage, type AgentMessage, type ObservedMessage, } from "./lib/group-routing/observed.js";
 export { archivedRoutingMessages } from "./lib/group-routing/routing-context.js";
 export { replayRouterPayload } from "./lib/group-routing/replay.js";

package/dist/extension/extension.mjs

@@ -10,7 +10,6 @@ import { chooseModel, model } from "./model.mjs";
 import { addressingReason, conversationKey } from "./lib/group-routing/signals.mjs";
 import { conversationAddressing, conversationState } from "./lib/group-routing/conversation.mjs";
 import { decisionRouter, routeMessage } from "./lib/group-routing/router.mjs";
-import { groupSettings } from "./lib/group-routing/settings.mjs";
 import { agentMessage, observedMessages } from "./lib/group-routing/observed.mjs";
 import { archivedRoutingMessages } from "./lib/group-routing/routing-context.mjs";
 import { replayRouterPayload } from "./lib/group-routing/replay.mjs";
@@ -21,4 +20,4 @@ const segmentstream = Object.assign(extension, {
 	model: (choice) => model(choice ?? (() => extension.config.models.chat)),
 	manifestOf
 });
-export { DEFAULT_ADMISSION_LIMITS, DEFAULT_DECISION_MODEL, DEFAULT_GROUP_POLICY, DEFAULT_STT_MODEL, SegmentStreamAgentConfigError, archivedRoutingMessages, chooseModel, conversationKey, debounceBurst, segmentstream as default, segmentstream, effectiveGroupPolicy, addressingReason as groupAddressingReason, agentMessage as groupAgentMessage, conversationAddressing as groupConversationAddressing, conversationState as groupConversationState, decisionRouter as groupDecisionRouter, observedMessages as groupObservedMessages, groupPolicy, manifestOf, model, groupSettings as readGroupSettings, replayRouterPayload, routeMessage as routeGroupMessage, routingBurst };
+export { DEFAULT_ADMISSION_LIMITS, DEFAULT_DECISION_MODEL, DEFAULT_GROUP_POLICY, DEFAULT_STT_MODEL, SegmentStreamAgentConfigError, archivedRoutingMessages, chooseModel, conversationKey, debounceBurst, segmentstream as default, segmentstream, effectiveGroupPolicy, addressingReason as groupAddressingReason, agentMessage as groupAgentMessage, conversationAddressing as groupConversationAddressing, conversationState as groupConversationState, decisionRouter as groupDecisionRouter, observedMessages as groupObservedMessages, groupPolicy, manifestOf, model, replayRouterPayload, routeMessage as routeGroupMessage, routingBurst };

package/dist/extension/instructions.md

@@ -19,6 +19,16 @@ talking to you, and you act with exactly their permissions.
   reload definitions already known for the current ontology hash. Metadata visibility does
   not grant record access. The operation tools are narrowed to the member's current permissions;
   if an operation is missing, say so instead of looking for a way around.
+- When the ontology offers `app_feedback_submit`, the app accepts feedback for its builders.
+  Offer to send it when the member wants something no permitted tool, field or data provides, an
+  operation is refused for lack of permission, an operation fails unexpectedly or a retryable
+  failure persists, or the member says something works badly or asks for something new. Do not
+  offer what you can do yourself; offer once per problem. Before submitting, look for the member's
+  open `app_feedback` with the same subject. Submit only after the member agrees to the title and
+  summary you show in their language, then add each screenshot or file they sent with
+  `app_feedback_file_attach`, promoting a chat attachment into it. When a member starts talking to
+  you, find their `app_feedback` with `responded_at` set and `seen_at` empty, tell them the
+  builders' response, then call `app_feedback_acknowledge` with its `responded_at`.
   Older ontologies without `discover` return the legacy full catalog from `describe`; use that
   available contract. New description results carry `kind` and `hash`.
 - When the current member has permission and gives a clear instruction, act, including necessary

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

@@ -4,5 +4,5 @@ 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-CFAnvrjf.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-SU1WsppW.mjs";
 export { agentBuild };

package/dist/extension/lib/group-routing/policy.d.ts

@@ -23,9 +23,6 @@ export interface SmartPolicy {
     readonly context: {
         readonly messages: number;
         readonly includeAgentDescription: boolean;
-        readonly includeAgentInstructions: boolean | {
-            readonly maxChars: number;
-        };
         readonly includeChatGuidance: boolean;
         readonly includeParticipants: boolean;
     };
@@ -77,5 +74,5 @@ export declare function groupPolicy(input?: GroupPolicyInput, aliases?: {
 /** Dynamic defaults change only when inherited from the platform; authored fields retain precedence. */
 export declare function overlaySmartPolicy(input: SmartPolicyInput | undefined, base: GroupPolicy): SmartPolicy;
 export declare const DEFAULT_GROUP_POLICY: GroupPolicy;
-/** Agent -> Cloud override -> pinned chat -> registry. Provider-specific switches only map signals. */
-export declare function effectiveGroupPolicy(base: GroupPolicy, key: string, registry?: ChatOverrideInput, cloud?: GroupPolicyInput): GroupPolicy;
+/** Agent -> chat -> chat scope, as `groups` authors them. Provider switches only map signals. */
+export declare function effectiveGroupPolicy(base: GroupPolicy, key: string): GroupPolicy;

package/dist/extension/lib/group-routing/policy.mjs

@@ -40,7 +40,6 @@ function smartPolicy(input = {}, base) {
 		context: {
 			messages: conversation ? 60 : 30,
 			includeAgentDescription: true,
-			includeAgentInstructions: false,
 			includeChatGuidance: true,
 			includeParticipants: true,
 			...base?.context,
@@ -157,30 +156,10 @@ function overlaySmartPolicy(input, base) {
 	});
 }
 const DEFAULT_GROUP_POLICY = groupPolicy();
-function effectiveGroupPolicy(base, key, registry, cloud) {
-	let result = cloud === void 0 ? base : {
-		...base,
-		mode: cloud.mode ?? base.mode,
-		smart: overlaySmartPolicy(cloud.smart, base),
-		chats: {
-			...base.chats,
-			...cloud.chats
-		},
-		observability: {
-			...base.observability,
-			...cloud.observability
-		},
-		sources: {
-			...base.sources,
-			...sources(cloud, "cloud")
-		}
-	};
+function effectiveGroupPolicy(base, key) {
+	let result = base;
 	const parent = key.includes("/") ? result.chats[key.slice(0, key.indexOf("/"))] : void 0;
-	for (const layer of [
-		parent,
-		result.chats[key],
-		registry
-	]) if (layer !== void 0) result = {
+	for (const layer of [parent, result.chats[key]]) if (layer !== void 0) result = {
 		...result,
 		mode: layer.mode ?? result.mode,
 		smart: overlaySmartPolicy(layer.smart, result),
@@ -190,7 +169,7 @@ function effectiveGroupPolicy(base, key, registry, cloud) {
 		},
 		sources: {
 			...result.sources,
-			...sources(layer, layer === registry ? "registry" : "agent.chat")
+			...sources(layer, "agent.chat")
 		}
 	};
 	const thresholds = result.smart.thresholds;

package/dist/extension/lib/group-routing/router.d.ts

@@ -14,7 +14,6 @@ export interface RouteQuestion {
     readonly processingAt?: string;
     readonly messagesToClassify?: ReadonlyArray<ObservedMessage>;
     readonly signals?: GroupMessageSignals;
-    readonly agentInstructions?: string;
     /** The agent's own description, so the model knows what it can be asked for. */
     readonly agent: string;
     readonly agentIdentity?: Partial<BotIdentity> & {

package/dist/extension/lib/group-routing/router.mjs

@@ -121,7 +121,6 @@ function conversationContext(question) {
 	}));
 	return {
 		agent: policy.smart.context.includeAgentDescription ? question.agent.slice(0, 4e3) : "",
-		...policy.smart.context.includeAgentInstructions ? { agent_instructions: (question.agentInstructions ?? "").slice(0, typeof policy.smart.context.includeAgentInstructions === "object" ? policy.smart.context.includeAgentInstructions.maxChars : 6e3) } : {},
 		agent_identity: JSON.stringify({
 			display_name: bot?.displayName ?? null,
 			username: bot?.username ?? null,

package/dist/extension/lib/identities.d.ts

@@ -1,4 +1,3 @@
-import { type ChatOverrideInput } from "@segmentstream-cloud/ontology/groups";
 import type { AdmissionLimitsInput } from "../config.js";
 import type { RuntimeToken } from "./runtime-token.js";
 /**
@@ -69,8 +68,6 @@ export interface ChatAccount {
 }
 /** A group chat in the ontology's `agent_chat` registry, with what members said it is for. */
 export interface AgentChat {
-    readonly routing?: ChatOverrideInput;
-    readonly scope?: string;
     readonly id: string;
     readonly title: string;
     readonly purpose: string | null;

package/dist/extension/lib/identities.mjs

@@ -5,7 +5,6 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { redactDiagnostic } from "./diagnostics.mjs";
-import { groupPolicyIssues } from "@segmentstream-cloud/ontology/groups";
 var AgentIdentityError = class extends Error {
 	name = "AgentIdentityError";
 	code;
@@ -94,22 +93,11 @@ function agentChat(value) {
 		code: "invalid_response",
 		message: "The ontology service answered the chat report with an invalid body."
 	});
-	const override = {
-		...isRecord(value.routing) ? value.routing : {},
-		...isRecord(value.participants) ? { participants: value.participants } : {}
-	};
-	const valid = groupPolicyIssues(override, true).length === 0;
-	if (!valid) console.error("[segmentstream] invalid chat routing override", {
-		chatId: value.id,
-		issues: groupPolicyIssues(override, true)
-	});
 	return {
 		id: value.id,
 		title: value.title,
 		purpose: value.purpose,
-		whenToUse: value.whenToUse,
-		...typeof value.scope === "string" ? { scope: value.scope } : {},
-		...valid && Object.keys(override).length > 0 ? { routing: override } : {}
+		whenToUse: value.whenToUse
 	};
 }
 async function refusal(response, call) {

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

@@ -11,10 +11,9 @@ import { chooseModel } from "../../model.mjs";
 import { groupRoutingHealth } from "../group-routing/health.mjs";
 import { decisionRouter } from "../group-routing/router.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
-import { groupSettings } from "../group-routing/settings.mjs";
 import { conversations } from "../conversations.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-CFAnvrjf.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-SU1WsppW.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
 import { d as failureText, h as withDeliveryLocale, i as withReplacedText, m as safeTelegramFetch, n as currentInboundRequest, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
@@ -71,11 +70,6 @@ const eveInteractions = async (sessionId) => {
 function segmentstreamTelegram(options) {
 	const environment = options.environment ?? process.env;
 	const token = options.token ?? runtimeToken;
-	const readGroups = groupSettings({
-		environment,
-		token,
-		fetch: options.fetch
-	});
 	const observed = options.observed ?? observedMessages(60);
 	const readHistory = options.history ?? eveHistory;
 	const readInteractions = options.history ?? eveInteractions;
@@ -183,7 +177,6 @@ function segmentstreamTelegram(options) {
 							limit: 200,
 							includeDecisions: true
 						})).events, 100),
-						cloudGroups: options.groups === void 0 ? void 0 : readGroups,
 						signalSettings: settings().groups,
 						recoverHeldApprovals: options.confirmationMode?.() === "deferred",
 						...settings().attachmentLifecycle === void 0 ? {} : { lifecycle: (principal, memberId, message) => attachmentLifecycle({

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-CFAnvrjf.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-SU1WsppW.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";

package/dist/extension/lib/telegram/inbound.d.ts

@@ -1,5 +1,4 @@
 import type { RecentMessage } from "../group-routing/observed.js";
-import type { CloudGroupSettings } from "../group-routing/settings.js";
 import { type GroupPolicy } from "../group-routing/policy.js";
 import type { TelegramSettings } from "../../config.js";
 import { attachmentLifecycle } from "./lifecycle.js";
@@ -46,7 +45,6 @@ export interface InboundDependencies {
     readonly decisionModel?: string;
     readonly groups?: GroupPolicy;
     readonly recentConversation?: (chatId: string, threadId?: string) => Promise<ReadonlyArray<RecentMessage>>;
-    readonly cloudGroups?: () => Promise<CloudGroupSettings | undefined>;
     readonly signalSettings?: TelegramSettings["groups"];
     /** Recover old held sessions only when the workspace has chosen non-blocking confirmations. */
     readonly recoverHeldApprovals?: boolean;

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

@@ -461,12 +461,10 @@ async function handleInboundMessage(input) {
 	const questionHistory = owner === void 0 || dependencies.history === void 0 ? [] : await dependencies.history(owner.id);
 	await report;
 	const policySignals = telegramSignals(sent, bot, dependencies.signalSettings);
-	const cloudGroups = await dependencies.cloudGroups?.();
-	const registryChat = dependencies.chats.chat(sent.chat.id);
 	const groups = effectiveGroupPolicy(dependencies.groups ?? groupPolicy({}, {
 		mode: dependencies.policy,
 		model: dependencies.decisionModel
-	}), conversationKey(policySignals), registryChat?.scope !== void 0 && registryChat.scope !== policySignals.conversation.scope ? void 0 : registryChat?.routing, cloudGroups?.settings);
+	}), conversationKey(policySignals));
 	const conversationPolicy = group && groups.smart.engagement.policy === "conversation";
 	const agentAliases = [...groups.smart.engagement.agentAliases, ...[
 		bot?.username,
@@ -588,7 +586,6 @@ async function handleInboundMessage(input) {
 				}
 			},
 			agent: await input.request?.agentDescription() ?? "",
-			agentInstructions: cloudGroups?.instructions,
 			agentIdentity: {
 				...bot,
 				displayName: bot?.displayName ?? name,

package/dist/extension/lib/telegram/lifecycle.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-CFAnvrjf.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-SU1WsppW.mjs";
 import { object } from "../confirmation-description.mjs";
 import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
 import { needsConfirmation } from "../confirmations.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.10.4",
+  "version": "0.12.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",
@@ -57,12 +57,12 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "eslint src tests --config ../../eslint.config.mjs",
     "test": "vitest run",
-    "prepack": "npm run build",
+    "prepack": "pnpm run build",
     "eval:routing": "tsx tests/routing-eval/cli.ts"
   },
   "dependencies": {
     "@chat-adapter/telegram": "4.41.0",
-    "@segmentstream-cloud/ontology": "0.46.0",
+    "@segmentstream-cloud/ontology": "0.48.0",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.128",
     "csv-parse": "^7.0.3",

package/dist/extension/lib/group-routing/settings.d.ts

@@ -1,14 +0,0 @@
-import { type GroupPolicyInput } from "@segmentstream-cloud/ontology/groups";
-import { type Environment } from "../environment.js";
-import { type RuntimeToken } from "../runtime-token.js";
-export interface CloudGroupSettings {
-    readonly settings: GroupPolicyInput;
-    readonly instructions?: string;
-}
-/** Bounded request-scoped identity, one policy refresh per minute, last known override on transient failure. */
-export declare function groupSettings(input?: {
-    readonly environment?: Environment;
-    readonly token?: RuntimeToken;
-    readonly fetch?: typeof fetch;
-    readonly now?: () => number;
-}): () => Promise<CloudGroupSettings | undefined>;

package/dist/extension/lib/group-routing/settings.mjs

@@ -1,58 +0,0 @@
-import { fileURLToPath as __eveFileURLToPath } from "node:url";
-import { dirname as __eveDirname } from "node:path";
-import { createRequire as __eveCreateRequire } from "node:module";
-const __filename = __eveFileURLToPath(import.meta.url);
-__eveDirname(__filename);
-__eveCreateRequire(import.meta.url);
-import { proxyEnvironment } from "../environment.mjs";
-import { runtimeToken } from "../runtime-token.mjs";
-import { groupPolicyIssues } from "@segmentstream-cloud/ontology/groups";
-function groupSettings(input = {}) {
-	let cached;
-	let expires = 0;
-	let etag;
-	let pending;
-	const now = input.now ?? Date.now;
-	return async () => {
-		if (now() < expires) return cached;
-		if (pending !== void 0) return pending;
-		pending = (async () => {
-			try {
-				const env = proxyEnvironment(input.environment);
-				const identity = await (input.token ?? runtimeToken)();
-				const workspacePath = `/api/internal/v1/workspaces/${encodeURIComponent(env.workspaceId)}`;
-				const response = await (input.fetch ?? fetch)(`${env.segmentstreamUrl}${workspacePath}/agent/groups/effective`, {
-					redirect: "error",
-					headers: {
-						"x-segmentstream-organization-id": env.organizationId,
-						"x-segmentstream-runtime-identity": identity,
-						...etag === void 0 ? {} : { "if-none-match": etag }
-					},
-					signal: AbortSignal.timeout(5e3)
-				});
-				if (response.status === 304) return cached;
-				if (response.status === 404) return cached;
-				if (!response.ok) throw new Error(`Group settings read failed (${response.status}); request ${response.headers.get("x-request-id") ?? "unknown"}.`);
-				const value = await response.json();
-				if (value.settings === void 0 || groupPolicyIssues(value.settings).length > 0) throw new Error("Invalid group settings response.");
-				cached = {
-					settings: value.settings,
-					...typeof value.instructions === "string" ? { instructions: value.instructions.slice(0, 6e3) } : {}
-				};
-				etag = response.headers.get("etag") ?? (typeof value.version === "string" ? `"${value.version}"` : void 0);
-				return cached;
-			} catch (error) {
-				console.error("[segmentstream] group settings refresh failed", { error });
-				return cached;
-			} finally {
-				expires = now() + 6e4;
-			}
-		})();
-		try {
-			return await pending;
-		} finally {
-			pending = void 0;
-		}
-	};
-}
-export { groupSettings };