@schlenkr/ragents 0.1.18 → 0.1.20

package/bundles/ragents.reference/run-scripts/conversation-circle/tests/program.test.ts

@@ -3,16 +3,11 @@ import test from "node:test";
 import program from "../src/server.ts";
 import { setupContext, startInput } from "./helpers.ts";
 
-test("topic and number of rounds control participants, surface, and task", async () => {
+test("topic and number of rounds control participants and task", async () => {
   const { calls, context } = setupContext();
   await program.onInput!(startInput({ topic: "Team breakfast", rounds: 3 }), context);
   assert.deepEqual(calls.filter((call) => call.name === "agent_spawn").map((call) => (call.input as { handle: string }).handle), ["mira", "jon", "ada"]);
   assert.deepEqual(calls.find((call) => call.name === "run_configure")?.input, { title: "Conversation circle: Team breakfast" });
-  const layout = calls.find((call) => call.name === "canvas_layout_replace")?.input as { root: unknown };
-  assert.deepEqual(layout.root, { direction: "vertical", weights: [1, 1], children: [
-    { entity: "@mira" },
-    { direction: "horizontal", weights: [1, 1], children: [{ entity: "@jon" }, { entity: "@ada" }] },
-  ] });
   assert.match(JSON.stringify(calls.at(-1)), /exactly 3 conversation rounds/);
   assert.deepEqual(context.state.read(), { built: true });
   const completedCalls = calls.length;

package/bundles/ragents.reference/run-scripts/learning-afternoon/src/server.ts

@@ -32,19 +32,12 @@ const contract = {
       capabilities: ["actor_input"],
     },
   },
-  input: { capabilities: ["model_list", "agent_spawn", "canvas_layout_replace", "run_configure", "actor_input", "event_subscribe", "event_unsubscribe", "event_query"] },
+  input: { capabilities: ["model_list", "agent_spawn", "run_configure", "actor_input", "event_subscribe", "event_unsubscribe", "event_query"] },
 } as const;
 
 const startMarker = "START_LEARNING_AFTERNOON";
 
 
-type Tile = { entity: string } | { direction: "vertical"; weights: [number, number]; children: [Tile, Tile] };
-
-function stackedTiles(entities: string[]): Tile {
-  const [first, ...rest] = entities;
-  return rest.length === 0 ? { entity: first! } : { direction: "vertical", weights: [1, rest.length], children: [{ entity: first! }, stackedTiles(rest)] };
-}
-
 function boardWith(helpers: HelperState[]): LearningState {
   const working = helpers.some((helper) => helper.status === "working");
   return { phase: working ? "working" : helpers.some((helper) => helper.status === "error") ? "error" : "complete", helpers };
@@ -72,13 +65,6 @@ export default defineActor(contract, {
         const actor = await context.functions.agent_spawn({ handle: `learning-${helper.id}`, displayName: helper.label, profile: profile.name, prompt, tools: [] });
         return { ...helper, actorId: actor.id };
       }));
-      await context.functions.canvas_layout_replace({
-        root: {
-          direction: "horizontal",
-          weights: [1, 1],
-          children: [{ entity: `app:@${context.actor.handle}/main` }, stackedTiles(helpers.map((helper) => `@learning-${helper.id}`))],
-        },
-      });
       await context.functions.run_configure({ title: learningWorkflow.title, primaryActor: `@${context.actor.handle}` });
       context.state.replace({ board: { phase: "ready", helpers } });
       return;

package/bundles/ragents.reference/run-scripts/learning-afternoon/tests/program.test.ts

@@ -19,7 +19,7 @@ function setup(options: { missingProfile?: boolean; failDispatch?: string; befor
   const calls: { name: string; input: unknown }[] = [];
   const history: CapabilityContracts["event_query"]["output"] = [];
   const functions = Object.fromEntries([
-    "model_list", "agent_spawn", "canvas_layout_replace", "run_configure", "actor_input", "event_subscribe", "event_unsubscribe", "event_query",
+    "model_list", "agent_spawn", "run_configure", "actor_input", "event_subscribe", "event_unsubscribe", "event_query",
   ].map((name) => [name, async (input: unknown) => {
     calls.push({ name, input });
     if (name === "model_list") return { profiles: options.missingProfile ? [] : [{ name: "standard", driver: "agent", description: "Test profile", turnTimeoutMs: null, isolateWorkspace: false, provider: "test", model: "test" }], models: [] };

package/bundles/ragents.reference/run-scripts/moderated-round/tests/helpers.ts

@@ -2,7 +2,7 @@ import { createTestContext } from "@ragents/server/testing";
 
 export const setupContext = (profiles = [{ name: "coordinator", driver: "agent" }, { name: "standard", driver: "agent" }]) => {
   const calls: { name: string; input: unknown }[] = [];
-  const functions = Object.fromEntries(["model_list", "agent_spawn", "run_configure", "actor_input", "canvas_layout_replace", "actor_program_activate"].map((name) => [name, (input: unknown) => {
+  const functions = Object.fromEntries(["model_list", "agent_spawn", "run_configure", "actor_input", "actor_program_activate"].map((name) => [name, (input: unknown) => {
     calls.push({ name, input });
     if (name === "agent_spawn") {
       const handle = (input as { handle: string }).handle;

package/bundles/ragents.reference/run-scripts/quick-note/RUN.md

@@ -10,5 +10,5 @@ tags: Run scripts, Concept demo, TypeScript actors
 
 The start value `{ "text": "..." }` is the note; without one, the script notes when it was
 started. The script makes the shared notebook active with `actor_program_ensure`, sends it the
-note, places the notebook's view with `canvas_layout_place`, and ends the start with
+note and ends the start with
 `context.finish`. Whether the roster check or this script comes first, the run has one notebook.

package/bundles/ragents.reference/run-scripts/quick-note/src/server.ts

@@ -4,7 +4,7 @@ import { Type } from "typebox";
 const contract = {
   state: Type.Object({}, { additionalProperties: false }),
   functions: {},
-  input: { capabilities: ["actor_program_ensure", "actor_input", "canvas_layout_place"] },
+  input: { capabilities: ["actor_program_ensure", "actor_input", ] },
 } as const;
 
 const noteOf = (input: unknown, now: string): string => {
@@ -23,7 +23,6 @@ export default defineActor(contract, {
     const note = noteOf(start.input, context.std.now());
     const notebook = await context.functions.actor_program_ensure({ name: "notebook" });
     await context.functions.actor_input({ actor: `@${notebook.handle}`, content: note });
-    await context.functions.canvas_layout_place({ entity: "app:notebook/main" });
     context.finish({ note, notebook: notebook.status }, { summary: `Noted: ${note}` });
   },
 });

package/bundles/ragents.reference/run-scripts/quick-note/tests/program.test.ts

@@ -11,7 +11,6 @@ const note = (status: "active" | "installed" = "installed") => {
   const context = createTestContext<Record<string, never>>({ state: {}, functions: {
     actor_program_ensure: record("actor_program_ensure", { actorId: "id-notebook", handle: "notebook", status }),
     actor_input: record("actor_input", []),
-    canvas_layout_place: record("canvas_layout_place", { placed: status === "installed" }),
   } });
   return { calls, context };
 };
@@ -22,7 +21,6 @@ test("sends the note to the shared notebook and reports it", async () => {
   assert.deepEqual(calls.map((call) => [call.name, call.input]), [
     ["actor_program_ensure", { name: "notebook" }],
     ["actor_input", { actor: "@notebook", content: "Ask about the budget" }],
-    ["canvas_layout_place", { entity: "app:notebook/main" }],
   ]);
   assert.deepEqual(context.finished, [{ result: { note: "Ask about the budget", notebook: "installed" }, summary: "Noted: Ask about the budget" }]);
 });

package/bundles/ragents.reference/run-scripts/run-roster/RUN.md

@@ -11,9 +11,9 @@ tags: Run scripts, Concept demo, TypeScript actors
 The TypeScript program reads the participants with `actor_list` and ends each start with
 `context.finish`. The owner reads the summary in the chat; a coordinator that starts it through
 `run_script_start` receives summary and list as a message. Started inside a running run through the
-run menu, `ragents script`, or the coordinator, it changes neither the primary actor nor the tiles,
+run menu, `ragents script`, or the coordinator, it preserves the primary actor,
 and a repeated start reuses the same actor. Started as a new run, it is the run's only participant.
 
 It shares the notebook with the quick note script: `shared-programs: notebook` copies the plugin's
 shared package into the run, `actor_program_ensure` makes it active once, and
-`canvas_layout_place` puts its view next to what is arranged.
+Its visible view enters the app catalog automatically.

package/bundles/ragents.reference/run-scripts/run-roster/src/server.ts

@@ -4,7 +4,7 @@ import { Type } from "typebox";
 const contract = {
   state: Type.Object({ reports: Type.Optional(Type.Number()) }, { additionalProperties: false }),
   functions: {},
-  input: { capabilities: ["actor_list", "actor_program_ensure", "actor_input", "canvas_layout_place"] },
+  input: { capabilities: ["actor_list", "actor_program_ensure", "actor_input", ] },
 } as const;
 
 export default defineActor(contract, {
@@ -19,7 +19,6 @@ export default defineActor(contract, {
     const summary = handles.length === 0 ? "No other participants yet." : `${handles.length} participant${handles.length === 1 ? "" : "s"}: ${handles.join(", ")}.`;
     const notebook = await context.functions.actor_program_ensure({ name: "notebook" });
     await context.functions.actor_input({ actor: `@${notebook.handle}`, content: `Roster: ${summary}` });
-    await context.functions.canvas_layout_place({ entity: "app:notebook/main" });
     context.state.replace({ reports: (context.state.read().reports ?? 0) + 1 });
     context.finish({ actors: others.map(({ handle, kind, lifecycle }) => ({ handle, kind, lifecycle })) }, { summary });
   },

package/bundles/ragents.reference/run-scripts/run-roster/tests/program.test.ts

@@ -14,7 +14,6 @@ const roster = (actors: ReturnType<typeof actor>[], state: { reports?: number }
     actor_list: record("actor_list", actors),
     actor_program_ensure: record("actor_program_ensure", { actorId: "id-notebook", handle: "notebook", status: "active" as const }),
     actor_input: record("actor_input", []),
-    canvas_layout_place: record("canvas_layout_place", { placed: true }),
   } });
   return { calls, context };
 };
@@ -29,7 +28,6 @@ test("reports the other participants as result and summary and notes them in the
   assert.deepEqual(calls.slice(1).map((call) => [call.name, call.input]), [
     ["actor_program_ensure", { name: "notebook" }],
     ["actor_input", { actor: "@notebook", content: "Roster: 2 participants: @coordinator, @helper." }],
-    ["canvas_layout_place", { entity: "app:notebook/main" }],
   ]);
   assert.deepEqual(context.state.read(), { reports: 1 });
 });

package/bundles/ragents.reference/run-scripts/shared-actor-list/src/server.ts

@@ -56,7 +56,7 @@ export default defineActor(contract, {
     await context.functions.actor_input({
       actor: "@coordinator",
       content: `The shared collection is called ${JSON.stringify(title)}. The run script has bound the program shared-list to @${helper.handle}. Its view is visible on the surface; the helper is currently adding the first entry with append_to_list. `
-        + "Below under Actors, its name opens the inspector with chat and details. Its tile is hidden by default and can be turned on in the Actors list when needed. "
+        + "Use the addressee selector to inspect its owner with chat and details. Open the mini-app from the app catalog. "
         + "Explain to the user in three sentences how to use the visible list, how to open the helper, and that the view and the function share the same list state.",
     });
 

package/bundles/ragents.reference/run-scripts/shared-actor-list/tests/helpers.ts

@@ -2,7 +2,7 @@ import { createTestContext } from "@ragents/server/testing";
 
 export const setupContext = (profiles = [{ name: "coordinator", driver: "agent" }, { name: "standard", driver: "agent" }], suffix = "") => {
   const calls: { name: string; input: unknown }[] = [];
-  const functions = Object.fromEntries(["model_list", "agent_spawn", "run_configure", "actor_input", "canvas_layout_replace", "actor_program_activate"].map((name) => [name, (input: unknown) => {
+  const functions = Object.fromEntries(["model_list", "agent_spawn", "run_configure", "actor_input", "actor_program_activate"].map((name) => [name, (input: unknown) => {
     calls.push({ name, input });
     if (name === "agent_spawn") {
       const handle = (input as { handle: string }).handle + suffix;

package/bundles/ragents.reference/run-scripts/word-game/src/contract.ts

@@ -19,5 +19,5 @@ export const contract = {
       capabilities: ["actor_input"],
     },
   },
-  input: { capabilities: ["model_list", "agent_spawn", "canvas_layout_replace", "run_configure", "event_subscribe", "event_query", "actor_input"] },
+  input: { capabilities: ["model_list", "agent_spawn", "run_configure", "event_subscribe", "event_query", "actor_input"] },
 } as const;

package/bundles/ragents.reference/run-scripts/word-game/src/server.ts

@@ -37,7 +37,6 @@ export default defineActor(contract, {
     try {
       if (!state.status) {
         await context.functions.run_configure({ title: "Word game", primaryActor: context.actor.id });
-        await context.functions.canvas_layout_replace({ root: { entity: `app:@${context.actor.handle}/main` } });
         const start = payloadOf(JSON.parse(input.content));
         if (start.input !== null || !start.options || typeof start.options !== "object" || Array.isArray(start.options)
           || Object.keys(start).some((key) => key !== "input" && key !== "options")) {

package/bundles/ragents.reference/run-scripts/word-game/tests/program.test.ts

@@ -26,7 +26,6 @@ function fixture(initialState: WordGameState = {}) {
         return { id: `actor-${input.handle}`, handle: input.handle };
       },
       run_configure: async (input) => { calls.push({ name: "run_configure", input }); return null; },
-      canvas_layout_replace: async (input) => { calls.push({ name: "canvas_layout_replace", input }); return null; },
       event_subscribe: async (input) => {
         calls.push({ name: "event_subscribe", input });
         return { subscriptionId: "subscription", sources: input.sourceActorIds ?? null };
@@ -190,7 +189,7 @@ test("a missing standard profile shows an error without creating participants",
   await program.onInput(firstInput, context);
   assert.equal(context.state.read().status, "error");
   assert.match(context.state.read().error!, /role standard is missing/);
-  assert.deepEqual(calls.map((call) => call.name), ["run_configure", "canvas_layout_replace", "model_list"]);
+  assert.deepEqual(calls.map((call) => call.name), ["run_configure", "model_list"]);
 });
 
 test("a restored state keeps counting the pending task and rebuilds nothing", async () => {

package/bundles/ragents.reference/skills/80-actor-text-analysis/SKILL.md

@@ -6,7 +6,7 @@ title: "Count characters, words, and lines"
 description: "Shows how the chat and a mini-app use the same TypeScript function and the same call counter. Hiding keeps the actor state."
 category: "Mini-apps"
 order: 10
-tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, Automatic view placement, View visibility"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, View visibility"
 ---
 
 I would like a text analysis with a text field, a count button, and understandable errors. A TypeScript actor counts characters, words, lines, and its calls without AI. Check "The world is big." and "And beautiful." as two lines: 6 words. The interface shows the same call counter. Hide it and show it again; the state is kept. Use shared layout and form building blocks: input and result side by side, stacked when space is tight.

package/bundles/ragents.reference/skills/90-actor-notes/SKILL.md

@@ -6,7 +6,7 @@ title: "Hide notes and find them again"
 description: "Shows an automatically placed mini-app with note selection. When hiding and showing it again, the actor and notes are kept."
 category: "Mini-apps"
 order: 90
-tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, Automatic view placement, View visibility"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, View visibility"
 ---
 
 I would like a TypeScript actor for my notes. Its interface with input and counter should appear on the surface by itself: a searchable list of titles on the left, the selected note on the right. Add a first note through its function. Hide the interface briefly and show it again without deleting the actor or resetting notes. Leave it open for entering my next idea.

package/bundles/ragents.todo/ragents-bundle.json

@@ -1,7 +1,7 @@
 {
   "format": 5,
   "id": "ragents.todo",
-  "api": 7,
+  "api": 10,
   "hostNames": {
     "server": {
       "@ragents/engine": [
@@ -33,7 +33,7 @@
     }
   },
   "revision": "5e18b249f3c8b53b61820ef05da59823d58163c6962e6d836dcb37c05034aad0",
-  "sourceRevision": "1c5eafe2e0da0c98f0c03b6cdd33b3d3cddc799da393df6a94c6d290fb285cbd",
+  "sourceRevision": "c889b621703da3c59cc7865f53d9f36dd4351d9e0f942d0b2808f38204133d2b",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.transcript/ragents-bundle.json

@@ -1,7 +1,7 @@
 {
   "format": 5,
   "id": "ragents.transcript",
-  "api": 7,
+  "api": 10,
   "hostNames": {
     "server": {
       "@ragents/engine": [
@@ -23,7 +23,7 @@
     "web": {}
   },
   "revision": "e3bb513053f6385f9d78d314d28302324095a5163c4e1563df6fc8b3251305f7",
-  "sourceRevision": "840c4195ce48a06cc8c49513c96a94381e7d8e10802f8835e3aab1c6ece01118",
+  "sourceRevision": "1afb89ce9536b65df330262bcd433740dc9751302927c6980e36586e613f5982",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.watch/ragents-bundle.json

@@ -1,7 +1,7 @@
 {
   "format": 5,
   "id": "ragents.watch",
-  "api": 7,
+  "api": 10,
   "hostNames": {
     "server": {
       "@ragents/engine": [
@@ -25,7 +25,7 @@
     "web": {}
   },
   "revision": "007ee50ab186e3070930f23e9795210fa36c723365657325d5440cc2f0b81d60",
-  "sourceRevision": "8cec5a0d238ff52a630bd3f822cf95ea9a640626c8c7345def28c4f1feabff10",
+  "sourceRevision": "ab44c0018a79f489b654dc8c5590dfe53404a2b0d5343a4b35a67704a00ac944",
   "server": "server/index.js",
   "exports": {
     "server": {

package/bundles/ragents.workspace/ragents-bundle.json

@@ -1,7 +1,7 @@
 {
   "format": 5,
   "id": "ragents.workspace",
-  "api": 7,
+  "api": 10,
   "hostNames": {
     "server": {
       "@ragents/engine": [
@@ -137,7 +137,7 @@
     }
   },
   "revision": "db9370b7b3449c44be49986b074806351b857c430963aa878e209d2d5c9ba4f8",
-  "sourceRevision": "25a05a48b591f8f4b575b06d495f7f191037d7419b79a98ad321328c455f4e0d",
+  "sourceRevision": "fe0162a7be0847872f9dfea32816ad843897e4fcace4b176d23998a6e6f1c5b4",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schlenkr/ragents",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "RAgents host: server, engine, plugins and tools without a source checkout",
   "keywords": [
     "agents",
@@ -71,14 +71,14 @@
     "yaml": "2.9.0"
   },
   "optionalDependencies": {
-    "@schlenkr/ragents-tools-win32-x64": "0.1.18",
-    "@schlenkr/ragents-tools-win32-arm64": "0.1.18",
-    "@schlenkr/ragents-tools-darwin-x64": "0.1.18",
-    "@schlenkr/ragents-tools-darwin-arm64": "0.1.18",
-    "@schlenkr/ragents-tools-linux-x64": "0.1.18",
-    "@schlenkr/ragents-tools-linux-arm64": "0.1.18"
+    "@schlenkr/ragents-tools-win32-x64": "0.1.20",
+    "@schlenkr/ragents-tools-win32-arm64": "0.1.20",
+    "@schlenkr/ragents-tools-darwin-x64": "0.1.20",
+    "@schlenkr/ragents-tools-darwin-arm64": "0.1.20",
+    "@schlenkr/ragents-tools-linux-x64": "0.1.20",
+    "@schlenkr/ragents-tools-linux-arm64": "0.1.20"
   },
   "ragents": {
-    "hostVersion": "6f896323c8bdb2622d4dc9459a901949bf5fae33"
+    "hostVersion": "e96d4691028bddeaecd76daca53e664da8bcd1d0"
   }
 }

package/packages/agent/dist/core/agent-settings.d.ts

@@ -6,7 +6,7 @@ export interface AgentSettings {
         maxRetries: number;
         baseDelayMs: number;
     };
-    /** Timeout and retries of a single provider request; unset values leave the SDK defaults. */
+    /** Idle timeout (time without any received chunk) and retries of a single provider request; unset values leave the SDK defaults. */
     providerRequest: {
         timeoutMs: number;
         maxRetries?: number;

package/packages/agent/src/core/agent-settings.ts

@@ -2,7 +2,7 @@
 export interface AgentSettings {
 	/** Retries after a retryable model error, with exponential backoff. */
 	retry: { enabled: boolean; maxRetries: number; baseDelayMs: number };
-	/** Timeout and retries of a single provider request; unset values leave the SDK defaults. */
+	/** Idle timeout (time without any received chunk) and retries of a single provider request; unset values leave the SDK defaults. */
 	providerRequest: { timeoutMs: number; maxRetries?: number; maxRetryDelayMs: number };
 }
 
@@ -13,5 +13,5 @@ export interface AgentSettingsInput {
 
 export const agentSettings = (input: AgentSettingsInput = {}): AgentSettings => ({
 	retry: { enabled: true, maxRetries: 3, baseDelayMs: 2000, ...input.retry },
-	providerRequest: { timeoutMs: 300_000, maxRetryDelayMs: 60_000, ...input.providerRequest },
+	providerRequest: { timeoutMs: 600_000, maxRetryDelayMs: 60_000, ...input.providerRequest },
 });

package/packages/ai/dist/types.d.ts

@@ -71,7 +71,8 @@ export interface StreamOptions {
      */
     headers?: ProviderHeaders;
     /**
-     * HTTP request timeout in milliseconds for providers/SDKs that support it.
+     * Timeout in milliseconds for providers/SDKs that support it. The openai-completions
+     * stream counts it as idle time: any received chunk restarts it, so an active stream never expires.
      * For example, OpenAI and Anthropic SDK clients default to 10 minutes.
      */
     timeoutMs?: number;

package/packages/ai/src/api/ai-sdk.ts

@@ -33,6 +33,16 @@ async function runStream(model: Model<"openai-completions">, context: Context, o
 	};
 	const controller = new AbortController();
 	const signal = options?.signal ? AbortSignal.any([options.signal, controller.signal]) : controller.signal;
+	let idleTimer: ReturnType<typeof setTimeout> | undefined;
+	let idleExpired = false;
+	const restartIdleTimer = () => {
+		clearTimeout(idleTimer);
+		if (options?.timeoutMs === undefined) return;
+		idleTimer = setTimeout(() => {
+			idleExpired = true;
+			controller.abort();
+		}, options.timeoutMs);
+	};
 	try {
 		const retention = options?.cacheRetention ?? (getProviderEnvValue("AGENT_CACHE_RETENTION", options?.env) === "long" ? "long" : "short");
 		const cacheControl = retention !== "none" && (model.compat?.cacheControlFormat === "anthropic" || model.id.startsWith("anthropic/"))
@@ -67,7 +77,6 @@ async function runStream(model: Model<"openai-completions">, context: Context, o
 			maxRetries: options?.maxRetries ?? 0,
 			streamRetries: 0,
 			abortSignal: signal,
-			timeout: options?.timeoutMs,
 			stopWhen: stepCountIs(1),
 			includeRawChunks: true,
 			onError: () => {},
@@ -83,7 +92,9 @@ async function runStream(model: Model<"openai-completions">, context: Context, o
 		let rawThinkingIndex: number | undefined;
 		let hasFinishReason = false;
 		let finished = false;
+		restartIdleTimer();
 		for await (const part of result.fullStream) {
+			restartIdleTimer();
 			switch (part.type) {
 				case "raw": {
 					const chunk = part.rawValue as { id?: string; model?: string; choices?: Array<{ finish_reason?: string | null; delta?: {
@@ -216,9 +227,11 @@ async function runStream(model: Model<"openai-completions">, context: Context, o
 	} catch (error) {
 		controller.abort();
 		output.stopReason = options?.signal?.aborted ? "aborted" : "error";
-		output.errorMessage = formatProviderError(normalizeProviderError(error), model.provider === "relay" ? `Relay ${model.baseUrl}` : undefined);
+		const failure = idleExpired ? new Error(`Timeout: no data from the provider for ${options?.timeoutMs} ms`) : error;
+		output.errorMessage = formatProviderError(normalizeProviderError(failure), model.provider === "relay" ? `Relay ${model.baseUrl}` : undefined);
 		events.push({ type: "error", reason: output.stopReason, error: output });
 	} finally {
+		clearTimeout(idleTimer);
 		events.end();
 	}
 }

package/packages/ai/src/types.ts

@@ -89,7 +89,8 @@ export interface StreamOptions {
 	 */
 	headers?: ProviderHeaders;
 	/**
-	 * HTTP request timeout in milliseconds for providers/SDKs that support it.
+	 * Timeout in milliseconds for providers/SDKs that support it. The openai-completions
+	 * stream counts it as idle time: any received chunk restarts it, so an active stream never expires.
 	 * For example, OpenAI and Anthropic SDK clients default to 10 minutes.
 	 */
 	timeoutMs?: number;

package/packages/ragents/src/runtime/journal.ts

@@ -62,6 +62,7 @@ export type JournalLoadFailure = Readonly<{
 }>;
 
 type JournalOptions = {
+    validateRecord?: (record: CommandRecord) => void;
     onLoadError?: (failure: JournalLoadFailure) => void;
     onListenerError?: (error: unknown) => void;
     onStaleLock?: (message: string) => void;
@@ -260,6 +261,7 @@ export class Journal {
     readonly #listeners = new Set<(events: JournalEvent[]) => void>();
     readonly #pendingPublications: JournalEvent[][] = [];
     readonly #runs = new Map<RunId, RunLog>();
+    readonly #validateRecord: ((record: CommandRecord) => void) | undefined;
     readonly #loadFailures = new Map<string, JournalLoadFailure>();
     readonly #onLoadError: (failure: JournalLoadFailure) => void;
     readonly #creationCommands = new Map<string, CommandRecord>();
@@ -279,6 +281,7 @@ export class Journal {
     constructor(path: string, services: RuntimeServices, options: JournalOptions = {}) {
         this.#path = path === ":memory:" ? null : path;
         this.#services = services;
+        this.#validateRecord = options.validateRecord;
         this.#onListenerError = options.onListenerError ?? ((error) => console.error("Journal listener failed:", error));
         this.#onLoadError = options.onLoadError ?? ((failure) => console.error(`Journal ${failure.runId} (${failure.path}) is not available: ${failure.message}`));
         this.#onStaleLock = options.onStaleLock ?? ((message) => console.warn(message));
@@ -561,6 +564,7 @@ export class Journal {
         for (const record of records) {
             this.assertRunAvailable(record.runId);
             assertRunId(record.runId);
+            this.#validateRecord?.(record);
             const ids = commandIds.get(record.runId) ?? new Set<string>();
 
             if (ids.has(record.command.id) || this.#runs.get(record.runId)?.commands.has(record.command.id))

package/plugins/ragents.actor-programs/prompt.hbs

@@ -68,11 +68,10 @@ The actor enforces completion and extensions; see learning-afternoon.
 Use `FlowDiagram` for other graphs (star layout, fit, actions). Keep local IDs stable.
 See `controls`. For custom SVG use `SvgEdge`, Tailwind utilities, responsive `viewBox` and
 accessible descriptions.
-Address view visibility with `package-name/view-key`, `@handle/view-key` or a unique title;
-a tile uses the same names with the `app:` prefix.
-The host sizes the tile and offers the full view. Views appear as tiles; owner cards are not
-placed by themselves but stay in the Actors list. Personal actor visibility is separate from
-`actor_view_set_visibility` and cannot be changed by layouts.
+Address view visibility with `package-name/view-key`, `@handle/view-key` or a unique title.
+Visible apps enter the catalog automatically: browser tabs beside Chat, editor tabs in VS Code.
+The host sizes each view. Use the addressee selector to inspect an app's owner.
+`actor_view_set_visibility` controls whether a view is available.
 
 Tests call `program.functions.<name>(input, context)` or `program.onInput(input, context)`.
 `createTestContext` from `@ragents/server/testing` supplies state and explicit typed `functions` mocks.

package/plugins/ragents.actor-programs/server/access-projections.ts

@@ -10,7 +10,7 @@ const visibleProgram = (state: JsonValue): JsonValue => {
   if (!program) return state;
   const views = Array.isArray(program.views) ? program.views.map((value) => {
     const view = record(value);
-    return view ? { id: view.id, key: view.key, title: view.title, visible: view.visible, placements: view.placements } : value;
+    return view ? { id: view.id, key: view.key, title: view.title, visible: view.visible } : value;
   }) : [];
   return {
     version: 1,

package/plugins/ragents.actor-programs/server/index.ts

@@ -3,7 +3,6 @@ import type { PluginHost, RAgentsPlugin } from "@ragents/engine";
 import type { PluginModule } from "@ragents/host/plugin-support/plugin-module.js";
 import { runtimeProviderToken, runGuardToken } from "@ragents/host/ragents/host-services.js";
 import { askServiceToken } from "@ragents/plugins/ragents.ask/server/contract.js";
-import { surfacePlacementToken } from "@ragents/plugins/ragents.orchestration/server/contract.js";
 import { agentToolsFrom } from "./agent-tools.js";
 import { createActorProgramMethods } from "./methods.js";
 import { createMiniAppFrameRoutes, miniAppsApiPrefix } from "./routes.js";
@@ -28,7 +27,6 @@ const actorProgramsPlugin = (pluginHost: PluginHost): RAgentsPlugin => ({
                 return !script ? undefined : script.handle === name ? script.files : script.programs.find((program) => program.name === name)?.files;
             },
             sharedPackage: (name) => pluginHost.actorPackages.get(name),
-            placeView: (context, runId, entity) => { host.service(surfacePlacementToken).place(context, runId, { entity }); },
         });
         host.provide(actorProgramsToken, runtime);
         const diagnostics = createProjectDiagnostics({

package/plugins/ragents.actor-programs/server/runtime.ts

@@ -150,8 +150,6 @@ export interface ActorProgramRuntimeOptions {
     scriptSources: (entryId: string, name: string) => readonly ActorProgramSource[] | undefined;
     /** A shared actor package of the profile, by name. */
     sharedPackage: (name: string) => { pluginId: string; files: readonly ActorProgramSource[] } | undefined;
-    /** Places a surface entity next to the run's layout unless the layout already shows it. */
-    placeView: (context: CommandContext, runId: string, entity: string) => void;
 }
 type Recognized = { start: JsonValue } | { result: JsonValue };
 export class ActorProgramRuntime implements ActorProgramsService, ActorProgramExecutor {
@@ -525,9 +523,6 @@ export class ActorProgramRuntime implements ActorProgramsService, ActorProgramEx
         const recorded = this.#script(runId).packages[handle];
         if (!recorded)
             throw new Error(`The package ${handle} was not installed by a run script.`);
-        const view = program.views[0];
-        if (start.embedded && view)
-            this.#options.placeView(this.operatorContext(runId, "place"), runId, `app:${view.id}`);
         const state = this.#script(runId);
         const record = state.packages[handle]!;
         const count = record.count + 1;
@@ -750,7 +745,7 @@ export class ActorProgramRuntime implements ActorProgramsService, ActorProgramEx
             const clientFile = `view-${view.id}.mjs`;
             clients.push({ file: clientFile, javaScript: client.javaScript });
             views.push({ id: `${name}--${view.id}`, key: view.id, title: view.title ?? pkg.title, visible: previous?.views.find((item) => item.key === view.id)?.visible ?? true,
-                placements: [{ kind: "canvas", anchorActorId: actorId }], html: `<!doctype html><html class="${FRAME_DOCUMENT_CLASS}"><head><meta charset="utf-8"></head><body class="${FRAME_BODY_CLASS}"><div id="root" class="${FRAME_ROOT_CLASS}"></div></body></html>`, styles, clientFile });
+                html: `<!doctype html><html class="${FRAME_DOCUMENT_CLASS}"><head><meta charset="utf-8"></head><body class="${FRAME_BODY_CLASS}"><div id="root" class="${FRAME_ROOT_CLASS}"></div></body></html>`, styles, clientFile });
         }
         const viewSources = [...new Set((pkg.views ?? []).map((view) => path.dirname(path.resolve(directory, view.client))))];
         const frameStyles = viewSources.length > 0 ? await buildTailwind(viewSources) : "";
@@ -857,9 +852,6 @@ export class ActorProgramRuntime implements ActorProgramsService, ActorProgramEx
                 const actor = this.resolveActor(runId, context.actorId, `@${name}`);
                 definition.actorId = actor.id;
                 definition.actorHandle = actor.handle;
-                for (const view of definition.views)
-                    for (const placement of view.placements)
-                        placement.anchorActorId = actor.id;
                 for (const fn of definition.functions)
                     if (fn.tool?.targets)
                         fn.tool.targets = fn.tool.targets.map((target) => target === "pending" ? actor.id : target);
@@ -909,7 +901,7 @@ export class ActorProgramRuntime implements ActorProgramsService, ActorProgramEx
     }
     apps(runId: string): ActorViewListing[] {
         return this.programs(runId).flatMap((program) => program.views.map((view) => ({ id: view.id, actorId: program.actorId, actorHandle: program.actorHandle, title: view.title, description: program.description, revision: program.revision,
-            actions: program.functions.map(({ id, label, description, confirmation }) => ({ id, label, description, confirmation })), placements: view.placements, visible: view.visible, state: this.data(runId, program.actorId), invocations: this.#invocations(runId).invocations.filter((invocation) => invocation.actorId === program.actorId && invocation.revision === program.revision) })));
+            actions: program.functions.map(({ id, label, description, confirmation }) => ({ id, label, description, confirmation })), visible: view.visible, state: this.data(runId, program.actorId), invocations: this.#invocations(runId).invocations.filter((invocation) => invocation.actorId === program.actorId && invocation.revision === program.revision) })));
     }
     runLocalTools(runId: string) {
         if (!this.runtime().listRuns().some(run => run.id === runId))