@schlenkr/ragents 0.1.14 → 0.1.16

package/bundles/ragents.ask/server/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../plugins/ragents.ask/server/index.ts", "../../../plugins/ragents.ask/server/answer-method.ts", "../../../plugins/ragents.ask/contract.ts", "../../../plugins/ragents.ask/server/ask-service.ts", "../../../plugins/ragents.ask/ask-payload.ts", "../../../plugins/ragents.ask/server/tool-contributor.ts", "../../../plugins/ragents.ask/server/ask-tool.ts"],
-  "sourcesContent": ["import type { RAgentsPlugin } from \"@ragents/engine\";\nimport { pluginAsset } from \"@ragents/host/plugin-support/plugin-folder.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { handlebarsPrompt } from \"@ragents/host/plugin-support/prompt.js\";\nimport { runGuardToken } from \"@ragents/host/ragents/host-services.js\";\nimport { runtimeBridgeToken } from \"@ragents/host/ragents/runtime-bridge.js\";\nimport { createAnswerMethod } from \"./answer-method.js\";\nimport { RuntimeAskService } from \"./ask-service.js\";\nimport { askServiceToken } from \"./contract.js\";\nimport { createAskToolContributor } from \"./tool-contributor.js\";\n\nconst askPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.ask\" },\n  register: (host) => {\n    const service = new RuntimeAskService();\n    host.provide(askServiceToken, service);\n    host.provide(runtimeBridgeToken, { bind: (runtime) => service.bind(runtime) });\n    host.prompts(handlebarsPrompt(\"ragents.ask.prompt\", 480, pluginAsset(\"ragents.ask\", \"ask.hbs\")));\n    host.functions(createAskToolContributor(service));\n    host.methods(createAnswerMethod(service, host.service(runGuardToken)));\n  },\n};\n\nexport const plugin: PluginModule = { create: () => askPlugin };\n", "import { DomainError, implement, type MethodContribution } from \"@ragents/engine\";\nimport { askContracts } from \"../contract.js\";\nimport type { RuntimeAskService } from \"./ask-service.js\";\n\nexport const createAnswerMethod = (\n  service: RuntimeAskService,\n  ensureSession: (runId: string) => void,\n): MethodContribution => implement(askContracts.answer, ({ runId, actionId, answer, dismiss }) => {\n  if (dismiss !== true && (typeof answer !== \"string\" || answer.trim() === \"\")) {\n    throw new DomainError(\"answer-missing\", \"answer is required unless the question is dismissed\", 400);\n  }\n  ensureSession(runId);\n  service.answer(runId, actionId, { ...(answer !== undefined ? { answer } : {}), ...(dismiss !== undefined ? { dismiss } : {}) });\n  return null;\n});\n", "import { Type } from \"typebox\";\nimport { defineOperation } from \"@ragents/engine/src/rpc/contract\";\n\nexport const askContracts = {\n  answer: defineOperation({\n    id: \"ragents.ask.answer\",\n    description: \"Answer or dismiss a question of the run. Rights: runs.read and runs.write.\",\n    rights: [\"runs.read\", \"runs.write\"],\n    input: Type.Object({\n      runId: Type.String({ minLength: 1, maxLength: 64, description: \"Run id\" }),\n      actionId: Type.String({ minLength: 1, maxLength: 80, description: \"Question id\" }),\n      answer: Type.Optional(Type.String({ description: \"The user's answer\" })),\n      dismiss: Type.Optional(Type.Boolean({ description: \"true dismisses the question without an answer\" })),\n    }, { additionalProperties: false }),\n    result: Type.Null(),\n  }),\n};\n", "import { randomUUID } from \"node:crypto\";\nimport {\n  DomainError,\n  type Action,\n  type CommandContext,\n  type JournalEvent,\n  type JsonValue,\n  type Orchestration,\n} from \"@ragents/engine\";\nimport { askPayloadOf, ASK_PLUGIN_ID, SUPERSEDED_ANSWER, supersedingInputOf } from \"../ask-payload.js\";\nimport { DISMISSED_ANSWER, type AskCall, type AskRequest, type AskService } from \"./contract.js\";\n\nconst answerOf = (decision: \"approved\" | \"dismissed\", result: unknown): string =>\n  decision !== \"approved\"\n    ? supersedingInputOf(result) === undefined ? DISMISSED_ANSWER : SUPERSEDED_ANSWER\n    : typeof result === \"string\" ? result : result === null || result === undefined ? \"\" : JSON.stringify(result);\n\nconst resolvedAnswerOf = (action: Action): string | null =>\n  action.status === \"pending\" ? null : answerOf(action.status, action.result);\n\nconst humanInputPendingFor = (runtime: Orchestration, runId: string, actorId: string): boolean =>\n  [...runtime.state(runId).inputs.values()].some((input) =>\n    input.actorId === actorId && input.origin === \"human\" && input.lifecycle.kind === \"pending\");\n\ninterface Waiter {\n  runId: string;\n  /** The actor whose running turn waits for the answer; null for a question asked outside a turn. */\n  blockedActorId: string | null;\n  settle: (answer: string) => void;\n}\n\nexport class RuntimeAskService implements AskService {\n  #runtime: Orchestration | undefined;\n  readonly #waiters = new Map<string, Waiter>();\n  readonly #aborting = new Set<string>();\n\n  bind(runtime: Orchestration): void {\n    if (this.#runtime) throw new Error(\"The ask service is already bound to a runtime\");\n    this.#runtime = runtime;\n    runtime.subscribe((events) => this.#onJournal(events));\n  }\n\n  ask(call: AskCall, request: AskRequest, signal: AbortSignal | undefined): Promise<string> {\n    const runtime = this.#requireRuntime();\n    if (call.turnId && humanInputPendingFor(runtime, call.runId, call.agentId)) return Promise.resolve(SUPERSEDED_ANSWER);\n    const context: CommandContext = {\n      actorId: call.agentId,\n      commandId: call.commandId,\n      ...(call.turnId ? { turnId: call.turnId, correlationId: call.turnId, causationId: call.turnId } : {}),\n    };\n    runtime.proposeAction(context, call.runId, {\n      owner: ASK_PLUGIN_ID,\n      title: request.question,\n      description: request.description,\n      parameters: request.parameters,\n      input: { label: \"Answer\", placeholder: null, required: true },\n      payload: {\n        question: request.question,\n        options: [...request.options],\n        multi: request.multi === true,\n        ...(request.recipient ? { recipient: request.recipient } : {}),\n      },\n    });\n    const proposed = runtime.events(call.runId).find((event) =>\n      event.type === \"action.proposed\" && event.commandId === call.commandId);\n    if (proposed?.type !== \"action.proposed\") {\n      throw new Error(`The question from ${call.agentId} was not created in the journal of ${call.runId}`);\n    }\n    return this.#awaitAnswer(call.runId, proposed.payload.actionId, call.turnId ? call.agentId : null, signal);\n  }\n\n  answer(runId: string, actionId: string, input: { answer?: string; dismiss?: boolean }): void {\n    const runtime = this.#requireRuntime();\n    const state = runtime.state(runId);\n    const action = state.actions.get(actionId);\n    if (!action || action.owner !== ASK_PLUGIN_ID) {\n      throw new DomainError(\"question-not-found\", `Question ${actionId} does not exist in run ${runId}.`, 404);\n    }\n    runtime.resolveAction(\n      { actorId: state.ownerId, commandId: `ask-answer:${actionId}:${randomUUID()}` },\n      runId,\n      actionId,\n      input.dismiss === true\n        ? { decision: \"dismissed\", result: null }\n        : { decision: \"approved\", result: input.answer ?? null },\n    );\n  }\n\n  withdraw(runId: string, actionId: string): void {\n    this.#dismiss(runId, actionId, \"ask-withdraw\", null, DISMISSED_ANSWER);\n  }\n\n  #supersede(runId: string, actionId: string, inputId: string): void {\n    try {\n      this.#dismiss(runId, actionId, \"ask-supersede\", { supersededBy: inputId }, SUPERSEDED_ANSWER);\n    } catch (error) {\n      console.error(`Question ${actionId} could not be closed for message ${inputId}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  #dismiss(runId: string, actionId: string, commandPrefix: string, result: JsonValue, answer: string): void {\n    const runtime = this.#requireRuntime();\n    const state = runtime.state(runId);\n    const action = state.actions.get(actionId);\n    if (action?.owner !== ASK_PLUGIN_ID || action.status !== \"pending\") return;\n    this.#aborting.add(actionId);\n    try {\n      runtime.resolveAction(\n        { actorId: state.ownerId, commandId: `${commandPrefix}:${actionId}:${randomUUID()}` },\n        runId,\n        actionId,\n        { decision: \"dismissed\", result },\n      );\n    } finally {\n      this.#aborting.delete(actionId);\n    }\n    this.#waiters.get(actionId)?.settle(answer);\n  }\n\n  #awaitAnswer(runId: string, actionId: string, blockedActorId: string | null, signal: AbortSignal | undefined): Promise<string> {\n    const runtime = this.#requireRuntime();\n    const action = runtime.state(runId).actions.get(actionId);\n    if (!action) throw new Error(`Question ${actionId} does not exist in run ${runId}`);\n    const settled = resolvedAnswerOf(action);\n    if (settled !== null) return Promise.resolve(settled);\n    return new Promise<string>((resolve, reject) => {\n      const abort = () => {\n        this.#waiters.delete(actionId);\n        this.#aborting.add(actionId);\n        try {\n          const state = runtime.state(runId);\n          const pending = state.actions.get(actionId);\n          if (pending?.status === \"pending\") {\n            runtime.resolveAction(\n              { actorId: state.ownerId, commandId: `ask-abort:${actionId}:${randomUUID()}` },\n              runId,\n              actionId,\n              { decision: \"dismissed\", result: null },\n            );\n          }\n          reject(new Error(\"Waiting for the answer was cancelled.\"));\n        } catch (error) {\n          reject(error);\n        } finally {\n          this.#aborting.delete(actionId);\n        }\n      };\n      if (signal?.aborted) {\n        abort();\n        return;\n      }\n      signal?.addEventListener(\"abort\", abort, { once: true });\n      this.#waiters.set(actionId, {\n        runId,\n        blockedActorId,\n        settle: (answer) => {\n          signal?.removeEventListener(\"abort\", abort);\n          this.#waiters.delete(actionId);\n          resolve(answer);\n        },\n      });\n    });\n  }\n\n  #onJournal(events: JournalEvent[]): void {\n    for (const event of events) {\n      if (event.type === \"actor.input.enqueued\") {\n        if (event.payload.origin !== \"human\") continue;\n        const { actorId, inputId } = event.payload;\n        for (const [actionId, waiter] of this.#waiters) {\n          if (waiter.runId !== event.runId || waiter.blockedActorId !== actorId) continue;\n          queueMicrotask(() => this.#supersede(event.runId, actionId, inputId));\n        }\n        continue;\n      }\n      if (event.type !== \"action.resolved\") continue;\n      if (this.#aborting.has(event.payload.actionId)) continue;\n      const resolved = this.#requireRuntime().state(event.runId).actions.get(event.payload.actionId);\n      if (resolved?.owner !== ASK_PLUGIN_ID) continue;\n      const answer = answerOf(event.payload.decision, event.payload.result);\n      const waiter = this.#waiters.get(event.payload.actionId);\n      if (waiter) {\n        waiter.settle(answer);\n        continue;\n      }\n      queueMicrotask(() => this.#enqueueAnswer(event.runId, event.payload.actionId, answer));\n    }\n  }\n\n  #enqueueAnswer(runId: string, actionId: string, answer: string): void {\n    try {\n      const runtime = this.#requireRuntime();\n      const state = runtime.state(runId);\n      const action = state.actions.get(actionId);\n      if (!action) return;\n      const recipientId = askPayloadOf(action.payload)?.recipient ?? action.askedBy;\n      const recipient = state.actors.get(recipientId);\n      if (!recipient || recipient.kind === \"human\" || recipient.lifecycle.kind === \"stopped\") return;\n      runtime.enqueueInput(\n        { actorId: state.ownerId, commandId: `ask-input:${actionId}` },\n        runId,\n        {\n          actorId: recipientId,\n          content: `Answer to ${recipientId === action.askedBy ? \"your question\" : \"the question\"}: ${action.title}\\nAnswer: ${answer}`,\n        },\n      );\n    } catch (error) {\n      console.error(`Answer to question ${actionId} could not be enqueued as input: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  #requireRuntime(): Orchestration {\n    if (!this.#runtime) throw new Error(\"The ask service is not bound to the runtime yet\");\n    return this.#runtime;\n  }\n}\n", "export const ASK_PLUGIN_ID = \"ragents.ask\";\n\n/** What the asking tool call gets when a person's message to the asker closes its question. */\nexport const SUPERSEDED_ANSWER = \"Not answered: the user sent a new message instead.\";\n\nexport interface AskPayload {\n  question: string;\n  options: string[];\n  multi: boolean;\n  /** The actor the question stands for when the run owner asks it outside a turn. */\n  recipient?: string;\n}\n\nconst stringArrayOf = (value: unknown): string[] | undefined =>\n  Array.isArray(value) && value.every((entry) => typeof entry === \"string\") ? [...value] : undefined;\n\nexport const askPayloadOf = (payload: unknown): AskPayload | undefined => {\n  if (typeof payload !== \"object\" || payload === null) return undefined;\n  const candidate = payload as Partial<AskPayload>;\n  const options = stringArrayOf(candidate.options);\n  if (typeof candidate.question !== \"string\" || !options) return undefined;\n  return {\n    question: candidate.question,\n    options,\n    multi: candidate.multi === true,\n    ...(typeof candidate.recipient === \"string\" ? { recipient: candidate.recipient } : {}),\n  };\n};\n\nexport const supersedingInputOf = (result: unknown): string | undefined => {\n  if (typeof result !== \"object\" || result === null) return undefined;\n  const { supersededBy } = result as { supersededBy?: unknown };\n  return typeof supersededBy === \"string\" ? supersededBy : undefined;\n};\n", "import type { ToolContributor } from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\nimport { facesOperator } from \"@ragents/host/plugin-support/tool-availability.js\";\nimport { askToolMetadata, createAskTool } from \"./ask-tool.js\";\nimport type { AskService } from \"./contract.js\";\n\nexport const createAskToolContributor = (service: AskService): ToolContributor => ({\n  name: \"ragents.ask\",\n  descriptors: [toolDescriptorFrom(askToolMetadata, facesOperator)],\n  tools: () => [createAskTool(service)],\n});\n", "import { Type } from \"typebox\";\nimport { defineRunFunction, type RunFunction } from \"@ragents/engine\";\nimport { facesOperator } from \"@ragents/host/plugin-support/tool-availability.js\";\nimport type { AskService } from \"./contract.js\";\n\nexport const askToolMetadata = {\n  name: \"ask_user\",\n  label: \"Question\",\n  description: \"Asks the user for a required decision with answer options and waits for the answer.\",\n  longDescription: \"Always use this tool when you need a decision from the user \"\n    + \"(e.g. choosing a branch or a time range), instead of only asking the question as text. \"\n    + \"With multi=true the user may choose several options; the answer is then joined with '; '. \"\n    + \"Instead of choosing an option, the user can always answer freely - so expect \"\n    + \"the answer to be arbitrary text.\",\n} as const;\n\nexport const createAskTool = (service: AskService): RunFunction =>\n  defineRunFunction({\n    ...askToolMetadata,\n    schema: Type.Object({\n      question: Type.String({ description: \"The question to the user, short and concrete\" }),\n      options: Type.Array(Type.String(), { description: \"Answer options (2 to 6)\" }),\n      multi: Type.Optional(Type.Boolean({ description: \"true = multiple choice allowed\" })),\n    }),\n    resultSchema: Type.String(),\n    available: facesOperator,\n    executionMode: \"sequential\",\n    run: (scope, toolCallId, input) =>\n      service.ask(\n        {\n          runId: scope.caller.runId,\n          agentId: scope.caller.actorId,\n          turnId: scope.caller.turnId,\n          commandId: scope.context(toolCallId).commandId,\n        },\n        { question: input.question, options: input.options, multi: input.multi === true },\n        scope.signal,\n      ),\n  });\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { RAgentsPlugin } from \"@ragents/engine\";\nimport { pluginAsset } from \"@ragents/host/plugin-support/plugin-folder.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { handlebarsPrompt } from \"@ragents/host/plugin-support/prompt.js\";\nimport { runGuardToken } from \"@ragents/host/ragents/host-services.js\";\nimport { runtimeBridgeToken } from \"@ragents/host/ragents/runtime-bridge.js\";\nimport { createAnswerMethod } from \"./answer-method.js\";\nimport { RuntimeAskService } from \"./ask-service.js\";\nimport { askServiceToken } from \"./contract.js\";\nimport { createAskToolContributor } from \"./tool-contributor.js\";\n\nconst askPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.ask\" },\n  register: (host) => {\n    const service = new RuntimeAskService();\n    host.provide(askServiceToken, service);\n    host.provide(runtimeBridgeToken, { bind: (runtime) => service.bind(runtime) });\n    host.prompts(handlebarsPrompt(\"ragents.ask.prompt\", 480, pluginAsset(\"ragents.ask\", \"ask.hbs\")));\n    host.functions(createAskToolContributor(service));\n    host.methods(createAnswerMethod(service, host.service(runGuardToken)));\n  },\n};\n\nexport const plugin: PluginModule = { create: () => askPlugin };\n", "import { DomainError, implement, type MethodContribution } from \"@ragents/engine\";\nimport { askContracts } from \"../contract.js\";\nimport type { RuntimeAskService } from \"./ask-service.js\";\n\nexport const createAnswerMethod = (\n  service: RuntimeAskService,\n  ensureSession: (runId: string) => void,\n): MethodContribution => implement(askContracts.answer, ({ runId, actionId, answer, dismiss }) => {\n  if (dismiss !== true && (typeof answer !== \"string\" || answer.trim() === \"\")) {\n    throw new DomainError(\"answer-missing\", \"answer is required unless the question is dismissed\", 400);\n  }\n  ensureSession(runId);\n  service.answer(runId, actionId, { ...(answer !== undefined ? { answer } : {}), ...(dismiss !== undefined ? { dismiss } : {}) });\n  return null;\n});\n", "import { Type } from \"typebox\";\nimport { defineOperation } from \"@ragents/engine/src/rpc/contract\";\n\nexport const askContracts = {\n  answer: defineOperation({\n    id: \"ragents.ask.answer\",\n    description: \"Answer or dismiss a question of the run. Rights: runs.read and runs.write.\",\n    rights: [\"runs.read\", \"runs.write\"],\n    input: Type.Object({\n      runId: Type.String({ minLength: 1, maxLength: 64, description: \"Run id\" }),\n      actionId: Type.String({ minLength: 1, maxLength: 80, description: \"Question id\" }),\n      answer: Type.Optional(Type.String({ description: \"The user's answer\" })),\n      dismiss: Type.Optional(Type.Boolean({ description: \"true dismisses the question without an answer\" })),\n    }, { additionalProperties: false }),\n    result: Type.Null(),\n  }),\n};\n", "import { randomUUID } from \"node:crypto\";\nimport {\n  DomainError,\n  type Action,\n  type CommandContext,\n  type JournalEvent,\n  type JsonValue,\n  type Orchestration,\n} from \"@ragents/engine\";\nimport { askPayloadOf, ASK_PLUGIN_ID, SUPERSEDED_ANSWER, supersedingInputOf } from \"../ask-payload.js\";\nimport { DISMISSED_ANSWER, type AskCall, type AskRequest, type AskService } from \"./contract.js\";\n\nconst answerOf = (decision: \"approved\" | \"dismissed\", result: unknown): string =>\n  decision !== \"approved\"\n    ? supersedingInputOf(result) === undefined ? DISMISSED_ANSWER : SUPERSEDED_ANSWER\n    : typeof result === \"string\" ? result : result === null || result === undefined ? \"\" : JSON.stringify(result);\n\nconst resolvedAnswerOf = (action: Action): string | null =>\n  action.status === \"pending\" ? null : answerOf(action.status, action.result);\n\nconst humanInputPendingFor = (runtime: Orchestration, runId: string, actorId: string): boolean =>\n  [...runtime.state(runId).inputs.values()].some((input) =>\n    input.actorId === actorId && input.origin === \"human\" && input.lifecycle.kind === \"pending\");\n\ninterface Waiter {\n  runId: string;\n  /** The actor whose running turn waits for the answer; null for a question asked outside a turn. */\n  blockedActorId: string | null;\n  settle: (answer: string) => void;\n}\n\nexport class RuntimeAskService implements AskService {\n  #runtime: Orchestration | undefined;\n  readonly #waiters = new Map<string, Waiter>();\n  readonly #aborting = new Set<string>();\n\n  bind(runtime: Orchestration): void {\n    if (this.#runtime) throw new Error(\"The ask service is already bound to a runtime\");\n    this.#runtime = runtime;\n    runtime.subscribe((events) => this.#onJournal(events));\n  }\n\n  ask(call: AskCall, request: AskRequest, signal: AbortSignal | undefined): Promise<string> {\n    const runtime = this.#requireRuntime();\n    if (call.turnId && humanInputPendingFor(runtime, call.runId, call.agentId)) return Promise.resolve(SUPERSEDED_ANSWER);\n    const context: CommandContext = {\n      actorId: call.agentId,\n      commandId: call.commandId,\n      ...(call.turnId ? { turnId: call.turnId, correlationId: call.turnId, causationId: call.turnId } : {}),\n    };\n    runtime.proposeAction(context, call.runId, {\n      owner: ASK_PLUGIN_ID,\n      title: request.question,\n      description: request.description,\n      parameters: request.parameters,\n      input: { label: \"Answer\", placeholder: null, required: true },\n      payload: {\n        question: request.question,\n        options: [...request.options],\n        multi: request.multi === true,\n        ...(request.recipient ? { recipient: request.recipient } : {}),\n      },\n    });\n    const proposed = runtime.events(call.runId).find((event) =>\n      event.type === \"action.proposed\" && event.commandId === call.commandId);\n    if (proposed?.type !== \"action.proposed\") {\n      throw new Error(`The question from ${call.agentId} was not created in the journal of ${call.runId}`);\n    }\n    return this.#awaitAnswer(call.runId, proposed.payload.actionId, call.turnId ? call.agentId : null, signal);\n  }\n\n  answer(runId: string, actionId: string, input: { answer?: string; dismiss?: boolean }): void {\n    const runtime = this.#requireRuntime();\n    const state = runtime.state(runId);\n    const action = state.actions.get(actionId);\n    if (!action || action.owner !== ASK_PLUGIN_ID) {\n      throw new DomainError(\"question-not-found\", `Question ${actionId} does not exist in run ${runId}.`, 404);\n    }\n    runtime.resolveAction(\n      { actorId: state.ownerId, commandId: `ask-answer:${actionId}:${randomUUID()}` },\n      runId,\n      actionId,\n      input.dismiss === true\n        ? { decision: \"dismissed\", result: null }\n        : { decision: \"approved\", result: input.answer ?? null },\n    );\n  }\n\n  withdraw(runId: string, actionId: string): void {\n    this.#dismiss(runId, actionId, \"ask-withdraw\", null, DISMISSED_ANSWER);\n  }\n\n  #supersede(runId: string, actionId: string, inputId: string): void {\n    try {\n      this.#dismiss(runId, actionId, \"ask-supersede\", { supersededBy: inputId }, SUPERSEDED_ANSWER);\n    } catch (error) {\n      console.error(`Question ${actionId} could not be closed for message ${inputId}: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  #dismiss(runId: string, actionId: string, commandPrefix: string, result: JsonValue, answer: string): void {\n    const runtime = this.#requireRuntime();\n    const state = runtime.state(runId);\n    const action = state.actions.get(actionId);\n    if (action?.owner !== ASK_PLUGIN_ID || action.status !== \"pending\") return;\n    this.#aborting.add(actionId);\n    try {\n      runtime.resolveAction(\n        { actorId: state.ownerId, commandId: `${commandPrefix}:${actionId}:${randomUUID()}` },\n        runId,\n        actionId,\n        { decision: \"dismissed\", result },\n      );\n    } finally {\n      this.#aborting.delete(actionId);\n    }\n    this.#waiters.get(actionId)?.settle(answer);\n  }\n\n  #awaitAnswer(runId: string, actionId: string, blockedActorId: string | null, signal: AbortSignal | undefined): Promise<string> {\n    const runtime = this.#requireRuntime();\n    const action = runtime.state(runId).actions.get(actionId);\n    if (!action) throw new Error(`Question ${actionId} does not exist in run ${runId}`);\n    const settled = resolvedAnswerOf(action);\n    if (settled !== null) return Promise.resolve(settled);\n    return new Promise<string>((resolve, reject) => {\n      const abort = () => {\n        this.#waiters.delete(actionId);\n        this.#aborting.add(actionId);\n        try {\n          const state = runtime.state(runId);\n          const pending = state.actions.get(actionId);\n          if (pending?.status === \"pending\") {\n            runtime.resolveAction(\n              { actorId: state.ownerId, commandId: `ask-abort:${actionId}:${randomUUID()}` },\n              runId,\n              actionId,\n              { decision: \"dismissed\", result: null },\n            );\n          }\n          reject(new Error(\"Waiting for the answer was cancelled.\"));\n        } catch (error) {\n          reject(error);\n        } finally {\n          this.#aborting.delete(actionId);\n        }\n      };\n      if (signal?.aborted) {\n        abort();\n        return;\n      }\n      signal?.addEventListener(\"abort\", abort, { once: true });\n      this.#waiters.set(actionId, {\n        runId,\n        blockedActorId,\n        settle: (answer) => {\n          signal?.removeEventListener(\"abort\", abort);\n          this.#waiters.delete(actionId);\n          resolve(answer);\n        },\n      });\n    });\n  }\n\n  #onJournal(events: JournalEvent[]): void {\n    for (const event of events) {\n      if (event.type === \"actor.input.enqueued\") {\n        if (event.payload.origin !== \"human\") continue;\n        const { actorId, inputId } = event.payload;\n        for (const [actionId, waiter] of this.#waiters) {\n          if (waiter.runId !== event.runId || waiter.blockedActorId !== actorId) continue;\n          queueMicrotask(() => this.#supersede(event.runId, actionId, inputId));\n        }\n        continue;\n      }\n      if (event.type !== \"action.resolved\") continue;\n      if (this.#aborting.has(event.payload.actionId)) continue;\n      const resolved = this.#requireRuntime().state(event.runId).actions.get(event.payload.actionId);\n      if (resolved?.owner !== ASK_PLUGIN_ID) continue;\n      const answer = answerOf(event.payload.decision, event.payload.result);\n      const waiter = this.#waiters.get(event.payload.actionId);\n      if (waiter) {\n        waiter.settle(answer);\n        continue;\n      }\n      queueMicrotask(() => this.#enqueueAnswer(event.runId, event.payload.actionId, answer));\n    }\n  }\n\n  #enqueueAnswer(runId: string, actionId: string, answer: string): void {\n    try {\n      const runtime = this.#requireRuntime();\n      const state = runtime.state(runId);\n      const action = state.actions.get(actionId);\n      if (!action) return;\n      const recipientId = askPayloadOf(action.payload)?.recipient ?? action.askedBy;\n      const recipient = state.actors.get(recipientId);\n      if (!recipient || recipient.kind === \"human\" || recipient.lifecycle.kind === \"stopped\") return;\n      runtime.enqueueInput(\n        { actorId: state.ownerId, commandId: `ask-input:${actionId}` },\n        runId,\n        {\n          actorId: recipientId,\n          content: `Answer to ${recipientId === action.askedBy ? \"your question\" : \"the question\"}: ${action.title}\\nAnswer: ${answer}`,\n        },\n      );\n    } catch (error) {\n      console.error(`Answer to question ${actionId} could not be enqueued as input: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  #requireRuntime(): Orchestration {\n    if (!this.#runtime) throw new Error(\"The ask service is not bound to the runtime yet\");\n    return this.#runtime;\n  }\n}\n", "export const ASK_PLUGIN_ID = \"ragents.ask\";\n\n/** What the asking tool call gets when a person's message to the asker closes its question. */\nexport const SUPERSEDED_ANSWER = \"Not answered: the user sent a new message instead.\";\n\nexport interface AskPayload {\n  question: string;\n  options: string[];\n  multi: boolean;\n  /** The actor the question stands for when the run owner asks it outside a turn. */\n  recipient?: string;\n}\n\nconst stringArrayOf = (value: unknown): string[] | undefined =>\n  Array.isArray(value) && value.every((entry) => typeof entry === \"string\") ? [...value] : undefined;\n\nexport const askPayloadOf = (payload: unknown): AskPayload | undefined => {\n  if (typeof payload !== \"object\" || payload === null) return undefined;\n  const candidate = payload as Partial<AskPayload>;\n  const options = stringArrayOf(candidate.options);\n  if (typeof candidate.question !== \"string\" || !options) return undefined;\n  return {\n    question: candidate.question,\n    options,\n    multi: candidate.multi === true,\n    ...(typeof candidate.recipient === \"string\" ? { recipient: candidate.recipient } : {}),\n  };\n};\n\nexport const supersedingInputOf = (result: unknown): string | undefined => {\n  if (typeof result !== \"object\" || result === null) return undefined;\n  const { supersededBy } = result as { supersededBy?: unknown };\n  return typeof supersededBy === \"string\" ? supersededBy : undefined;\n};\n", "import type { ToolContributor } from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\nimport { facesOperator } from \"@ragents/host/plugin-support/tool-availability.js\";\nimport { askToolMetadata, createAskTool } from \"./ask-tool.js\";\nimport type { AskService } from \"./contract.js\";\n\nexport const createAskToolContributor = (service: AskService): ToolContributor => ({\n  name: \"ragents.ask\",\n  descriptors: [toolDescriptorFrom(askToolMetadata, facesOperator)],\n  tools: () => [createAskTool(service)],\n});\n", "import { Type } from \"typebox\";\nimport { defineRunFunction, type RunFunction } from \"@ragents/engine\";\nimport { facesOperator } from \"@ragents/host/plugin-support/tool-availability.js\";\nimport type { AskService } from \"./contract.js\";\n\nexport const askToolMetadata = {\n  name: \"ask_user\",\n  label: \"Question\",\n  nativeTool: true,\n  description: \"Asks the user for a required decision with answer options and waits for the answer.\",\n  longDescription: \"Always use this tool when you need a decision from the user \"\n    + \"(e.g. choosing a branch or a time range), instead of only asking the question as text. \"\n    + \"With multi=true the user may choose several options; the answer is then joined with '; '. \"\n    + \"Instead of choosing an option, the user can always answer freely - so expect \"\n    + \"the answer to be arbitrary text.\",\n} as const;\n\nexport const createAskTool = (service: AskService): RunFunction =>\n  defineRunFunction({\n    ...askToolMetadata,\n    schema: Type.Object({\n      question: Type.String({ description: \"The question to the user, short and concrete\" }),\n      options: Type.Array(Type.String(), { description: \"Answer options (2 to 6)\" }),\n      multi: Type.Optional(Type.Boolean({ description: \"true = multiple choice allowed\" })),\n    }),\n    resultSchema: Type.String(),\n    available: facesOperator,\n    executionMode: \"sequential\",\n    run: (scope, toolCallId, input) =>\n      service.ask(\n        {\n          runId: scope.caller.runId,\n          agentId: scope.caller.actorId,\n          turnId: scope.caller.turnId,\n          commandId: scope.context(toolCallId).commandId,\n        },\n        { question: input.question, options: input.options, multi: input.multi === true },\n        scope.signal,\n      ),\n  });\n"],
+  "mappings": "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",
   "names": ["DomainError", "DomainError", "waiter", "facesOperator", "Type", "facesOperator"]
 }

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

@@ -32,7 +32,7 @@
     "web": {}
   },
   "revision": "333c6a9b57576a4ab95556e201da67ed864acdf02787ce5edbd653e7beba6020",
-  "sourceRevision": "375fa6c75837bfa8ca23980d1d117e381a64ff823371f84ddb4e02c8c4b879db",
+  "sourceRevision": "6c3246a05b9b6ddc46373f88bca9113a2b1705487b4de41711be7f5ccb5617f3",
   "server": "server/index.js",
   "executor": "executor/index.mjs",
   "exports": {

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

@@ -101,7 +101,7 @@
     }
   },
   "revision": "3fdba8c39f30027176229901cf731b778170f0e1597c287ad94f7e48a430b5e8",
-  "sourceRevision": "3f8cba204a1cc01725fa7dd006e39766cc5dabe502d40a1ab9c7b620566019dd",
+  "sourceRevision": "8875b59b406fa0e663b9f69dff1f6525bff867dca5947d3e114084650393ebf2",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-fsharp/ragents-bundle.json

@@ -29,7 +29,7 @@
     }
   },
   "revision": "a39dafc264c6703d9481f358b21e5bf3997dc5d2dc7fe0d969d4905d49c7a1f8",
-  "sourceRevision": "9fcf26f814c6cedb6eebf90070ef2167d72bbb9a896f8ff263a2ebe488e50bfa",
+  "sourceRevision": "4ff8724bbc7065832b907cfc53ea561fa4df3e8802f2937e0df6963840baba31",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-roslyn/ragents-bundle.json

@@ -41,7 +41,7 @@
     }
   },
   "revision": "cbe81aa88a4ea56476537fabbbb0995d09ccbfa269dd6a003df50a57c8286b02",
-  "sourceRevision": "e157d2e34935c7790000759082a4091d1f6e789195f283f6530406f78e30988f",
+  "sourceRevision": "0bb27e39ad643657c464d5c3c28d045ed71c2164dea8e76c4c0ffe491a84442a",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.lsp-typescript/ragents-bundle.json

@@ -18,7 +18,7 @@
     }
   },
   "revision": "8387de707a4fe8fdb8c67315346522b331728f8adf51a7fadda8db662681f0c4",
-  "sourceRevision": "fe0fb4d49e457200d447d211c6ed9ecfe807a2357701cbc2679026118965de0a",
+  "sourceRevision": "9b9bdd5a6858ef808ae2541fefb7cb0262e4bc963cfb0674166ff9a29da22c5c",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.model-relay/ragents-bundle.json

@@ -26,7 +26,7 @@
     "web": {}
   },
   "revision": "9090692eca49235944f149b25dccdc986a3c638007d8da2fb35f74d942454379",
-  "sourceRevision": "eb8c167097d78ebb63cf599f23cf938d1fd85370164f6b5dd0caf6d8d6ef7e28",
+  "sourceRevision": "9548157817cee5c693da03f3a7e0f37e1099915826ef682cb0339a32736b70ef",
   "server": "server/index.js",
   "exports": {
     "server": {},

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

@@ -13,7 +13,8 @@
         "defineToolAvailability",
         "enqueueActorInput",
         "eventResultSchemaOf",
-        "holdsUsable"
+        "holdsUsable",
+        "serviceToken"
       ],
       "@ragents/engine/src/http/contracts": [
         "handleKey"
@@ -171,15 +172,17 @@
       ]
     }
   },
-  "revision": "748e0652641587a4a1db0474b7c1e4e55651114f8cca8e0c7c1c9f481ed22059",
-  "sourceRevision": "e3a411d8d2bc019261af133ee86e9a2cf29b4b3df1f43b280dded996f73a24e5",
+  "revision": "cbd72b88af0c8ac76486b4c0617545fc53b23315cf93dd924631ceb8e389b34b",
+  "sourceRevision": "306e4ba17b1cae6ee69a03bf8dd492a61b51eccc426b68bb55ab9b6721f08e0c",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",
     "classes": "web/classes.json"
   },
   "exports": {
-    "server": {},
+    "server": {
+      "server/contract": "server/exports/server/contract.js"
+    },
     "web": {
       "web/surface-entities": "web/exports/web/surface-entities.js",
       "web/program-slot": "web/exports/web/program-slot.js",

package/bundles/ragents.orchestration/server/chunks/chunk-QS3WJ3D7.js

@@ -0,0 +1,11 @@
+import { createRequire as __ragentsCreateRequire } from "node:module";
+const require = __ragentsCreateRequire(import.meta.url);
+
+// server/contract.ts
+import { serviceToken } from "@ragents/engine";
+var surfacePlacementToken = serviceToken("ragents.orchestration.surface-placement");
+
+export {
+  surfacePlacementToken
+};
+//# sourceMappingURL=chunk-QS3WJ3D7.js.map

package/bundles/ragents.orchestration/server/chunks/chunk-QS3WJ3D7.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../plugins/ragents.orchestration/server/contract.ts"],
+  "sourcesContent": ["import { serviceToken, type CommandContext, type ServiceToken } from \"@ragents/engine\";\n\nexport interface SurfacePlacementRequest {\n  entity: string;\n  direction?: \"horizontal\" | \"vertical\";\n  weight?: number;\n}\n\n/** Places an entity next to a run's surface layout, as canvas_layout_place does; an entity the layout shows already stays. */\nexport interface SurfacePlacement {\n  place: (context: CommandContext, runId: string, request: SurfacePlacementRequest) => { placed: boolean };\n}\n\nexport const surfacePlacementToken: ServiceToken<SurfacePlacement> = serviceToken(\"ragents.orchestration.surface-placement\");\n"],
+  "mappings": ";;;;AAAA,SAAS,oBAA4D;AAa9D,IAAM,wBAAwD,aAAa,yCAAyC;",
+  "names": []
+}

package/bundles/ragents.orchestration/server/exports/server/contract.js

@@ -0,0 +1,9 @@
+import { createRequire as __ragentsCreateRequire } from "node:module";
+const require = __ragentsCreateRequire(import.meta.url);
+import {
+  surfacePlacementToken
+} from "../../chunks/chunk-QS3WJ3D7.js";
+export {
+  surfacePlacementToken
+};
+//# sourceMappingURL=contract.js.map

package/bundles/ragents.orchestration/server/exports/server/contract.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/bundles/ragents.orchestration/server/index.js

@@ -1,5 +1,8 @@
 import { createRequire as __ragentsCreateRequire } from "node:module";
 const require = __ragentsCreateRequire(import.meta.url);
+import {
+  surfacePlacementToken
+} from "./chunks/chunk-QS3WJ3D7.js";
 
 // server/index.ts
 import {
@@ -106,6 +109,12 @@ var surfaceToolMetadata = {
   description: "Arrange actors and mini-apps as tiles on the viewport-filling work surface, using a binary tree of weighted splits.",
   longDescription: "root is the whole arrangement and replaces the stored one. A tile is {entity:'@helper'} or {entity:'app:@workspace/main'}; a split is {direction:'horizontal',weights:[1,1],children:[tile,tile]}. horizontal means left/right, vertical means top/bottom, and weights give the ratio of the two children. App left, chat right at 50:50: {root:{direction:'horizontal',weights:[1,1],children:[{entity:'app:@workspace/main'},{entity:'@helper'}]}}. One tile above two tiles at 2:1: {root:{direction:'vertical',weights:[2,1],children:[{entity:'@lead'},{direction:'horizontal',weights:[1,1],children:[{entity:'@first'},{entity:'@second'}]}]}}. root:null clears the surface. Dividers are draggable, so do not resend a layout to fight a personal arrangement. Participants you do not place stay reachable through the run header."
 };
+var placeToolMetadata = {
+  name: "canvas_layout_place",
+  label: "Place on Surface",
+  description: "Place one actor or mini-app next to the current surface layout instead of replacing it.",
+  longDescription: "entity is {entity} of a tile: '@helper' or 'app:@workspace/main'. The current arrangement becomes one side of a new split and the entity the other: direction 'horizontal' (default) puts it to the right, 'vertical' below. weight is its share against the existing arrangement's weight 1, default 1. An entity the layout already shows stays where it is; placed is then false. On an empty surface the entity becomes the only tile. Use it when you join a running run, such as a run script started with start.embedded, so that the tiles others arranged stay."
+};
 var canDesignSurface = defineToolAvailability({
   availability: "conditional",
   availabilityDetail: "Only for agents and TypeScript actors with the capability plugin.state.write.",
@@ -178,6 +187,41 @@ var checkLayoutAgainstRun = (view, input) => {
   }
   return layout;
 };
+var currentLayout = (view) => {
+  const state = view.pluginStates.find((entry) => entry.pluginId === ORCHESTRATION_PLUGIN_ID && entry.scope.kind === "run")?.state;
+  return state === void 0 || state === null ? { root: null } : surfaceLayoutOf(state);
+};
+var placed = (view, request) => {
+  const current = currentLayout(view);
+  const [tile] = surfaceTileEntities(checkLayoutAgainstRun(view, parsedLayout({ root: { entity: request.entity } })).root);
+  if (surfaceTileEntities(current.root).includes(tile)) return void 0;
+  const root = current.root === null ? { entity: tile } : {
+    direction: request.direction ?? "horizontal",
+    weights: [1, request.weight ?? 1],
+    children: [current.root, { entity: tile }]
+  };
+  return parsedLayout({ root });
+};
+var placeOnSurface = (runtime) => ({
+  place: (context, runId, request) => {
+    const layout = placed(runtime().view(runId), request);
+    if (!layout) return { placed: false };
+    runtime().replacePluginState(context, runId, { pluginId: ORCHESTRATION_PLUGIN_ID, scope: { kind: "run" }, state: layout });
+    return { placed: true };
+  }
+});
+var placeSchema = Type.Object({
+  entity: Type.String({ minLength: 1, description: "Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key" }),
+  direction: Type.Optional(Type.Union([Type.Literal("horizontal"), Type.Literal("vertical")], { description: "horizontal: to the right of the current layout (default); vertical: below it" })),
+  weight: Type.Optional(Type.Number({ exclusiveMinimum: 0, description: "Share of the placed tile against the existing arrangement's weight 1; default 1" }))
+}, { additionalProperties: false });
+var createPlaceTool = () => defineRunFunction({
+  ...placeToolMetadata,
+  schema: placeSchema,
+  resultSchema: Type.Object({ placed: Type.Boolean() }, { additionalProperties: false }),
+  available: canDesignSurface,
+  run: ({ runtime, caller, context }, toolCallId, input) => placeOnSurface(() => runtime).place(context(toolCallId), caller.runId, input)
+});
 var createSurfaceTool = () => defineRunFunction({
   ...surfaceToolMetadata,
   schema: surfaceLayoutSchema,
@@ -196,8 +240,8 @@ var createSurfaceTool = () => defineRunFunction({
 });
 var createSurfaceToolContributor = () => ({
   name: "ragents.orchestration.surface",
-  descriptors: [toolDescriptorFrom(surfaceToolMetadata, canDesignSurface)],
-  tools: () => [createSurfaceTool()]
+  descriptors: [toolDescriptorFrom(surfaceToolMetadata, canDesignSurface), toolDescriptorFrom(placeToolMetadata, canDesignSurface)],
+  tools: () => [createSurfaceTool(), createPlaceTool()]
 });
 
 // server/run-stop-tool.ts
@@ -236,6 +280,7 @@ var orchestrationPlugin = {
   manifest: { id: "ragents.orchestration" },
   register: (host) => {
     host.functions(createSurfaceToolContributor());
+    host.provide(surfacePlacementToken, placeOnSurface(host.service(runtimeProviderToken)));
     host.functions(createRunStopContributor(
       (runId) => host.service(runManagementToken)().stop(runId),
       (error) => console.error("Run stop by the coordinator failed", error)
@@ -265,7 +310,8 @@ var orchestrationPlugin = {
       handlebarsPrompt("ragents.orchestration.prompt", 600, pluginAsset("ragents.orchestration", "orchestration.hbs")),
       boundToTools(
         handlebarsPrompt("ragents.orchestration.surface", 650, pluginAsset("ragents.orchestration", "surface.hbs")),
-        "canvas_layout_replace"
+        "canvas_layout_replace",
+        "canvas_layout_place"
       )
     );
   }

package/bundles/ragents.orchestration/server/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../plugins/ragents.orchestration/server/index.ts", "../../../plugins/ragents.orchestration/server/surface-tool.ts", "../../../plugins/ragents.orchestration/contract.ts", "../../../plugins/ragents.orchestration/tiled-layout.ts", "../../../plugins/ragents.orchestration/server/run-stop-tool.ts"],
-  "sourcesContent": ["import {\n  actorInputSchema,\n  agentTools,\n  enqueueActorInput,\n  eventResultSchemaOf,\n  ScriptDriver,\n  type ActorInputRequest,\n  type RAgentsPlugin,\n} from \"@ragents/engine\";\nimport { runtimeProviderToken } from \"@ragents/host/ragents/host-services.js\";\nimport { pluginAsset } from \"@ragents/host/plugin-support/plugin-folder.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { boundToTools, handlebarsPrompt } from \"@ragents/host/plugin-support/prompt.js\";\nimport { createSurfaceToolContributor } from \"./surface-tool.js\";\nimport { createRunStopContributor } from \"./run-stop-tool.js\";\nimport { runManagementToken } from \"@ragents/host/ragents/global-chat.js\";\n\nconst orchestrationPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.orchestration\" },\n  register: (host) => {\n    host.functions(createSurfaceToolContributor());\n    host.functions(createRunStopContributor(\n      (runId) => host.service(runManagementToken)().stop(runId),\n      (error) => console.error(\"Run stop by the coordinator failed\", error),\n    ));\n    host.operations({\n      id: \"actor_input\",\n      label: \"Enqueue actor input\",\n      description: \"Enqueues a normal text input for an actor under the bound identity - \"\n        + \"as an agent or, from an app action, as the owner of the run. Only confirms the enqueueing. TypeScript actors understand only their programmed input protocol, no free-form tasks.\",\n      schema: actorInputSchema,\n      resultSchema: eventResultSchemaOf(\"actor.input.enqueued\"),\n      operator: \"direct\",\n      execute: (context, input) =>\n        enqueueActorInput(host.service(runtimeProviderToken)(), {\n          actorId: context.principal.actorId,\n          commandId: context.invocationId,\n          ...(context.principal.kind === \"agent\" && context.principal.turnId\n            ? { turnId: context.principal.turnId }\n            : {}),\n          correlationId: context.invocationId,\n          causationId: context.invocationId,\n        }, context.runId, input as ActorInputRequest),\n    });\n    host.script({\n      id: \"typescript\",\n      create: (context) => ({\n        driver: new ScriptDriver({ runtime: context.runtime }),\n      }),\n    });\n    host.prompts(\n      handlebarsPrompt(\"ragents.orchestration.prompt\", 600, pluginAsset(\"ragents.orchestration\", \"orchestration.hbs\")),\n      boundToTools(\n        handlebarsPrompt(\"ragents.orchestration.surface\", 650, pluginAsset(\"ragents.orchestration\", \"surface.hbs\")),\n        \"canvas_layout_replace\",\n      ),\n    );\n  },\n};\n\nexport const plugin: PluginModule = { create: () => orchestrationPlugin };\n", "import { Type } from \"typebox\";\nimport {\n  DomainError,\n  actorByHandle,\n  defineRunFunction,\n  defineToolAvailability,\n  holdsUsable,\n  type RunFunction,\n  type RunView,\n  type ToolContributor,\n} from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\nimport { ACTOR_PROGRAMS_STATE_ID, resolveActorView, type ActorProgramState } from \"@ragents/host/plugin-support/actor-programs/contract.js\";\nimport {\n  ORCHESTRATION_PLUGIN_ID,\n  surfaceEntityOf,\n  surfaceLayoutOf,\n  type SurfaceLayout,\n} from \"../contract.js\";\nimport { surfaceTileEntities, mapSurfaceTileEntities } from \"../tiled-layout.js\";\n\nexport const surfaceToolMetadata = {\n  name: \"canvas_layout_replace\",\n  label: \"Replace Surface Layout\",\n  description: \"Arrange actors and mini-apps as tiles on the viewport-filling work surface, using a binary tree of weighted splits.\",\n  longDescription: \"root is the whole arrangement and replaces the stored one. A tile is {entity:'@helper'} or \"\n    + \"{entity:'app:@workspace/main'}; a split is {direction:'horizontal',weights:[1,1],children:[tile,tile]}. \"\n    + \"horizontal means left/right, vertical means top/bottom, and weights give the ratio of the two children. \"\n    + \"App left, chat right at 50:50: {root:{direction:'horizontal',weights:[1,1],children:[\"\n    + \"{entity:'app:@workspace/main'},{entity:'@helper'}]}}. One tile above two tiles at 2:1: \"\n    + \"{root:{direction:'vertical',weights:[2,1],children:[{entity:'@lead'},\"\n    + \"{direction:'horizontal',weights:[1,1],children:[{entity:'@first'},{entity:'@second'}]}]}}. \"\n    + \"root:null clears the surface. Dividers are draggable, so do not resend a layout to fight a personal arrangement. \"\n    + \"Participants you do not place stay reachable through the run header.\",\n} as const;\n\nexport const canDesignSurface = defineToolAvailability({\n  availability: \"conditional\",\n  availabilityDetail: \"Only for agents and TypeScript actors with the capability plugin.state.write.\",\n  requiredCapabilities: [\"plugin.state.write\"],\n}, (actor) => actor.kind !== \"human\" && holdsUsable(actor, \"plugin.state.write\"));\n\nconst tileSchema = Type.Cyclic({\n  SurfaceTile: Type.Union([\n    Type.Object({\n      entity: Type.String({ minLength: 1, description: \"Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key; the server resolves the view ID\" }),\n      chatInput: Type.Optional(Type.Boolean({ description: \"Actor tiles only: false hides the chat composer in the tile; default true. Does not change permissions or the inspector\" })),\n    }, { additionalProperties: false }),\n    Type.Object({\n      direction: Type.Union([Type.Literal(\"horizontal\"), Type.Literal(\"vertical\")]),\n      weights: Type.Tuple([Type.Number({ exclusiveMinimum: 0 }), Type.Number({ exclusiveMinimum: 0 })]),\n      children: Type.Tuple([Type.Ref(\"SurfaceTile\"), Type.Ref(\"SurfaceTile\")]),\n    }, { additionalProperties: false }),\n  ]),\n}, \"SurfaceTile\");\n\nconst surfaceLayoutSchema = Type.Object({\n  root: Type.Union([tileSchema, Type.Null()], { description: \"The whole arrangement: a tile or a binary split. Maximum 64 unique tiles and 16 nested splits. null clears the surface\" }),\n});\n\nconst invalid = (message: string) => new DomainError(\"invalid-surface-layout\", message, 400);\n\nconst parsedLayout = (input: unknown): SurfaceLayout => {\n  try {\n    return surfaceLayoutOf(input);\n  } catch (caught) {\n    throw invalid(caught instanceof Error ? caught.message : String(caught));\n  }\n};\n\nconst isStopped = (actor: RunView[\"actors\"][number]) => actor.kind !== \"human\" && actor.lifecycle.kind === \"stopped\";\n\nconst surfaceActorOf = (view: RunView, reference: string, where: string) => {\n  const entity = surfaceEntityOf(reference);\n  if (entity.kind !== \"actor\") throw invalid(`${where}: ${reference} is not an actor`);\n  const handle = entity.handle;\n  const found = actorByHandle(view.actors, handle);\n  if (!found) {\n    const known = view.actors.filter((actor) => actor.kind !== \"human\").map((actor) => `@${actor.handle}`);\n    throw invalid(`${where}: @${handle} is not an actor of this run. Present: ${known.join(\", \") || \"none\"}`);\n  }\n  if (found.kind === \"human\") {\n    throw invalid(`${where}: @${handle} is the human in the chat; the chat is fixed to the left of the surface`);\n  }\n  return found;\n};\n\nconst isActorReference = (reference: string) => surfaceEntityOf(reference).kind === \"actor\";\n\nconst resolveAppReferences = (view: RunView, layout: SurfaceLayout): SurfaceLayout => {\n  const programs = view.pluginStates.flatMap((entry) => {\n    if (entry.pluginId !== ACTOR_PROGRAMS_STATE_ID || entry.scope.kind !== \"actor\") return [];\n    const actorId = entry.scope.actorId;\n    const actor = view.actors.find((candidate) => candidate.id === actorId);\n    if (!actor || actor.kind === \"human\" || isStopped(actor)) return [];\n    const { program } = entry.state as unknown as ActorProgramState;\n    return program ? [program] : [];\n  });\n  const resolve = (reference: string, where: string): string => {\n    const entity = surfaceEntityOf(reference);\n    if (entity.kind !== \"app\") return reference;\n    try {\n      return `app:${resolveActorView(programs, entity.id).view.id}`;\n    } catch (error) {\n      throw invalid(`${where}: ${reference}: ${error instanceof Error ? error.message : String(error)} Surface entities get the prefix app:.`);\n    }\n  };\n  return parsedLayout({ root: layout.root ? mapSurfaceTileEntities(layout.root, (entity) => resolve(entity, \"root\")) : null });\n};\n\n/** Resolve app names and validate the placed actors before any layout is stored. */\nexport const checkLayoutAgainstRun = (view: RunView, input: SurfaceLayout): SurfaceLayout => {\n  const layout = resolveAppReferences(view, input);\n  for (const reference of surfaceTileEntities(layout.root)) {\n    if (isActorReference(reference)) surfaceActorOf(view, reference, \"root\");\n  }\n  return layout;\n};\n\nexport const createSurfaceTool = (): RunFunction =>\n  defineRunFunction({\n    ...surfaceToolMetadata,\n    schema: surfaceLayoutSchema,\n    resultSchema: Type.Null(),\n    available: canDesignSurface,\n    run: ({ runtime, caller, context }, toolCallId, input) => {\n      const view = runtime.view(caller.runId);\n      const layout = checkLayoutAgainstRun(view, parsedLayout(input));\n      runtime.replacePluginState(context(toolCallId), caller.runId, {\n        pluginId: ORCHESTRATION_PLUGIN_ID,\n        scope: { kind: \"run\" },\n        state: layout,\n      });\n      return null;\n    },\n  });\n\nexport const createSurfaceToolContributor = (): ToolContributor => ({\n  name: \"ragents.orchestration.surface\",\n  descriptors: [toolDescriptorFrom(surfaceToolMetadata, canDesignSurface)],\n  tools: () => [createSurfaceTool()],\n});\n", "import { handleKey } from \"@ragents/engine/src/http/contracts\";\nimport { surfaceTileNodeOf } from \"./tiled-layout.js\";\n\nexport const ORCHESTRATION_PLUGIN_ID = \"ragents.orchestration\";\n\nexport type SurfaceEntity =\n  | { kind: \"actor\"; handle: string }\n  | { kind: \"app\"; id: string };\n\nexport type SurfaceTileNode =\n  | { entity: string; chatInput?: boolean }\n  | { direction: \"horizontal\" | \"vertical\"; weights: [number, number]; children: [SurfaceTileNode, SurfaceTileNode] };\n\nexport type SurfaceLayout = {\n  root: SurfaceTileNode | null;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nexport const surfaceEntityOf = (text: string): SurfaceEntity => {\n  const trimmed = text.trim();\n  if (trimmed.startsWith(\"@\")) {\n    const handle = handleKey(trimmed);\n    if (!handle || /\\s/.test(handle)) throw new Error(`Entity ${JSON.stringify(text)}: a handle is missing after the @`);\n    return { kind: \"actor\", handle };\n  }\n  const match = /^app:(.+)$/s.exec(trimmed);\n  if (!match) {\n    throw new Error(`Entity ${JSON.stringify(text)}: expected @handle or app:<id>`);\n  }\n  const id = match[1].trim();\n  if (!id) throw new Error(`Entity ${JSON.stringify(text)}: the ID after the colon is empty`);\n  return { kind: \"app\", id };\n};\n\nexport const surfaceEntityKey = (entity: SurfaceEntity): string =>\n  entity.kind === \"actor\" ? `@${entity.handle}` : `app:${entity.id}`;\n\nconst LEGACY_KEYS = [\"nodes\", \"shapes\", \"lines\", \"mode\"] as const;\n\n/** Parses and validates a tile layout; throws an error naming the first violation. */\nexport const surfaceLayoutOf = (value: unknown): SurfaceLayout => {\n  if (!isRecord(value)) throw new Error(\"The arrangement must be an object with root\");\n  const legacy = LEGACY_KEYS.filter((key) => key in value);\n  if (legacy.length > 0) {\n    throw new Error(`The program arrangement comes from the removed free surface (${legacy.join(\", \")}); `\n      + \"canvas_layout_replace with root sets it anew as a tile layout\");\n  }\n  if (!(\"root\" in value)) throw new Error(\"root is missing; expected a tile, a split or null\");\n  return { root: value.root === null ? null : surfaceTileNodeOf(value.root) };\n};\n", "import { surfaceEntityKey, surfaceEntityOf, type SurfaceTileNode } from \"./contract.js\";\n\nexport type { SurfaceTileNode } from \"./contract.js\";\n\nexport const MAX_SURFACE_TILE_DEPTH = 16;\nexport const MAX_SURFACE_TILES = 64;\n\nexport const surfaceTileNodeOf = (input: unknown): SurfaceTileNode => {\n  const entities = new Set<string>();\n  const parse = (value: unknown, where: string, depth: number): SurfaceTileNode => {\n    if (depth > MAX_SURFACE_TILE_DEPTH) throw new Error(`${where}: at most ${MAX_SURFACE_TILE_DEPTH} nested splits are allowed`);\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) throw new Error(`${where} must be a tile or a split`);\n    const node = value as Record<string, unknown>;\n    if (Object.hasOwn(node, \"entity\")) {\n      if (Object.keys(node).some((key) => key !== \"entity\" && key !== \"chatInput\")) throw new Error(`${where}: a tile carries only entity and chatInput; a split direction, weights and children`);\n      if (typeof node.entity !== \"string\") throw new Error(`${where}.entity must be @handle or app:<name>/<view>`);\n      const entity = surfaceEntityOf(node.entity);\n      const key = surfaceEntityKey(entity);\n      if (node.chatInput !== undefined && (entity.kind !== \"actor\" || typeof node.chatInput !== \"boolean\")) {\n        throw new Error(`${where}.chatInput is only allowed for actors, as a boolean`);\n      }\n      if (entities.has(key)) throw new Error(`${where}: ${key} is placed as a tile more than once`);\n      entities.add(key);\n      if (entities.size > MAX_SURFACE_TILES) throw new Error(`At most ${MAX_SURFACE_TILES} tiles are allowed`);\n      return node.chatInput === undefined ? { entity: key } : { entity: key, chatInput: node.chatInput as boolean };\n    }\n    if (Object.keys(node).some((key) => ![\"direction\", \"weights\", \"children\"].includes(key))) throw new Error(`${where}: a split carries only direction, weights and children`);\n    if (node.direction !== \"horizontal\" && node.direction !== \"vertical\") throw new Error(`${where}.direction must be horizontal or vertical`);\n    if (!Array.isArray(node.weights) || node.weights.length !== 2 || node.weights.some((weight) => typeof weight !== \"number\" || !Number.isFinite(weight) || weight <= 0)) {\n      throw new Error(`${where}.weights must contain exactly two finite positive numbers`);\n    }\n    if (!Array.isArray(node.children) || node.children.length !== 2) throw new Error(`${where}.children must contain exactly two tiles or splits`);\n    return {\n      direction: node.direction,\n      weights: [node.weights[0], node.weights[1]],\n      children: [parse(node.children[0], `${where}.children[0]`, depth + 1), parse(node.children[1], `${where}.children[1]`, depth + 1)],\n    };\n  };\n  return parse(input, \"root\", 0);\n};\n\n/** A tile hides the chat composer of its actor only when its leaf says chatInput: false. */\nexport const surfaceTileChatInput = (root: SurfaceTileNode | null | undefined, entity: string): boolean =>\n  !root ? true : \"entity\" in root\n    ? root.entity !== entity || root.chatInput !== false\n    : surfaceTileChatInput(root.children[0], entity) && surfaceTileChatInput(root.children[1], entity);\n\nexport const surfaceTileEntities = (root: SurfaceTileNode | null | undefined): string[] =>\n  !root ? [] : \"entity\" in root ? [root.entity] : root.children.flatMap(surfaceTileEntities);\n\nexport const mapSurfaceTileEntities = (root: SurfaceTileNode, resolve: (entity: string) => string): SurfaceTileNode =>\n  \"entity\" in root ? { ...root, entity: resolve(root.entity) } : {\n    ...root,\n    children: [mapSurfaceTileEntities(root.children[0], resolve), mapSurfaceTileEntities(root.children[1], resolve)],\n  };\n", "import { Type } from \"typebox\";\nimport { defineRunFunction, defineToolAvailability, holdsUsable, type ToolContributor } from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\n\nconst available = defineToolAvailability({\n  availability: \"conditional\",\n  availabilityDetail: \"For the primary actor with execution.stopOwned in its own run.\",\n  requiredCapabilities: [\"execution.stopOwned\"],\n}, (actor, view) => actor.kind !== \"human\" && actor.id === view.primaryActorId && holdsUsable(actor, \"execution.stopOwned\"));\n\nexport const createRunStopContributor = (stop: (runId: string) => Promise<void>, onError: (error: unknown) => void): ToolContributor => {\n  const definition = defineRunFunction({\n    name: \"run_stop\",\n    label: \"Stop run\",\n    description: \"Initiates the complete stop of your own run: running turns, tools, subagents and plugin services. Conversation and files are kept. Also cancels your own turn; acceptance is not a confirmation of completed cleanup. Use immediately when the user wants a complete cancellation; do not send a cancel message to busy agents.\",\n    schema: Type.Object({}, { additionalProperties: false }),\n    resultSchema: Type.Object({ requested: Type.Literal(true) }, { additionalProperties: false }),\n    available,\n    run: ({ caller, signal }) => {\n      signal?.throwIfAborted();\n      void stop(caller.runId).catch(onError);\n      return { requested: true as const };\n    },\n  });\n  return {\n    name: \"ragents.orchestration.run-stop\",\n    descriptors: [toolDescriptorFrom(definition, available)],\n    tools: () => [definition],\n  };\n};\n"],
-  "mappings": ";;;;AAAA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,4BAA4B;AACrC,SAAS,mBAAmB;AAE5B,SAAS,cAAc,wBAAwB;;;ACZ/C,SAAS,YAAY;AACrB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,0BAA0B;AACnC,SAAS,yBAAyB,wBAAgD;;;ACZlF,SAAS,iBAAiB;;;ACInB,IAAM,yBAAyB;AAC/B,IAAM,oBAAoB;AAE1B,IAAM,oBAAoB,CAAC,UAAoC;AACpE,QAAM,WAAW,oBAAI,IAAY;AACjC,QAAM,QAAQ,CAAC,OAAgB,OAAe,UAAmC;AAC/E,QAAI,QAAQ,uBAAwB,OAAM,IAAI,MAAM,GAAG,KAAK,aAAa,sBAAsB,4BAA4B;AAC3H,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,4BAA4B;AAC7H,UAAM,OAAO;AACb,QAAI,OAAO,OAAO,MAAM,QAAQ,GAAG;AACjC,UAAI,OAAO,KAAK,IAAI,EAAE,KAAK,CAACA,SAAQA,SAAQ,YAAYA,SAAQ,WAAW,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,qFAAqF;AAC3L,UAAI,OAAO,KAAK,WAAW,SAAU,OAAM,IAAI,MAAM,GAAG,KAAK,8CAA8C;AAC3G,YAAM,SAAS,gBAAgB,KAAK,MAAM;AAC1C,YAAM,MAAM,iBAAiB,MAAM;AACnC,UAAI,KAAK,cAAc,WAAc,OAAO,SAAS,WAAW,OAAO,KAAK,cAAc,YAAY;AACpG,cAAM,IAAI,MAAM,GAAG,KAAK,qDAAqD;AAAA,MAC/E;AACA,UAAI,SAAS,IAAI,GAAG,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,KAAK,GAAG,qCAAqC;AAC5F,eAAS,IAAI,GAAG;AAChB,UAAI,SAAS,OAAO,kBAAmB,OAAM,IAAI,MAAM,WAAW,iBAAiB,oBAAoB;AACvG,aAAO,KAAK,cAAc,SAAY,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ,KAAK,WAAW,KAAK,UAAqB;AAAA,IAC9G;AACA,QAAI,OAAO,KAAK,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,aAAa,WAAW,UAAU,EAAE,SAAS,GAAG,CAAC,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,wDAAwD;AAC1K,QAAI,KAAK,cAAc,gBAAgB,KAAK,cAAc,WAAY,OAAM,IAAI,MAAM,GAAG,KAAK,2CAA2C;AACzI,QAAI,CAAC,MAAM,QAAQ,KAAK,OAAO,KAAK,KAAK,QAAQ,WAAW,KAAK,KAAK,QAAQ,KAAK,CAAC,WAAW,OAAO,WAAW,YAAY,CAAC,OAAO,SAAS,MAAM,KAAK,UAAU,CAAC,GAAG;AACrK,YAAM,IAAI,MAAM,GAAG,KAAK,2DAA2D;AAAA,IACrF;AACA,QAAI,CAAC,MAAM,QAAQ,KAAK,QAAQ,KAAK,KAAK,SAAS,WAAW,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,oDAAoD;AAC7I,WAAO;AAAA,MACL,WAAW,KAAK;AAAA,MAChB,SAAS,CAAC,KAAK,QAAQ,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;AAAA,MAC1C,UAAU,CAAC,MAAM,KAAK,SAAS,CAAC,GAAG,GAAG,KAAK,gBAAgB,QAAQ,CAAC,GAAG,MAAM,KAAK,SAAS,CAAC,GAAG,GAAG,KAAK,gBAAgB,QAAQ,CAAC,CAAC;AAAA,IACnI;AAAA,EACF;AACA,SAAO,MAAM,OAAO,QAAQ,CAAC;AAC/B;AAQO,IAAM,sBAAsB,CAAC,SAClC,CAAC,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,KAAK,MAAM,IAAI,KAAK,SAAS,QAAQ,mBAAmB;AAEpF,IAAM,yBAAyB,CAAC,MAAuB,YAC5D,YAAY,OAAO,EAAE,GAAG,MAAM,QAAQ,QAAQ,KAAK,MAAM,EAAE,IAAI;AAAA,EAC7D,GAAG;AAAA,EACH,UAAU,CAAC,uBAAuB,KAAK,SAAS,CAAC,GAAG,OAAO,GAAG,uBAAuB,KAAK,SAAS,CAAC,GAAG,OAAO,CAAC;AACjH;;;ADnDK,IAAM,0BAA0B;AAcvC,IAAM,WAAW,CAAC,UAAqD,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAEnI,IAAM,kBAAkB,CAAC,SAAgC;AAC9D,QAAM,UAAU,KAAK,KAAK;AAC1B,MAAI,QAAQ,WAAW,GAAG,GAAG;AAC3B,UAAM,SAAS,UAAU,OAAO;AAChC,QAAI,CAAC,UAAU,KAAK,KAAK,MAAM,EAAG,OAAM,IAAI,MAAM,UAAU,KAAK,UAAU,IAAI,CAAC,mCAAmC;AACnH,WAAO,EAAE,MAAM,SAAS,OAAO;AAAA,EACjC;AACA,QAAM,QAAQ,cAAc,KAAK,OAAO;AACxC,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,UAAU,KAAK,UAAU,IAAI,CAAC,gCAAgC;AAAA,EAChF;AACA,QAAM,KAAK,MAAM,CAAC,EAAE,KAAK;AACzB,MAAI,CAAC,GAAI,OAAM,IAAI,MAAM,UAAU,KAAK,UAAU,IAAI,CAAC,mCAAmC;AAC1F,SAAO,EAAE,MAAM,OAAO,GAAG;AAC3B;AAEO,IAAM,mBAAmB,CAAC,WAC/B,OAAO,SAAS,UAAU,IAAI,OAAO,MAAM,KAAK,OAAO,OAAO,EAAE;AAElE,IAAM,cAAc,CAAC,SAAS,UAAU,SAAS,MAAM;AAGhD,IAAM,kBAAkB,CAAC,UAAkC;AAChE,MAAI,CAAC,SAAS,KAAK,EAAG,OAAM,IAAI,MAAM,6CAA6C;AACnF,QAAM,SAAS,YAAY,OAAO,CAAC,QAAQ,OAAO,KAAK;AACvD,MAAI,OAAO,SAAS,GAAG;AACrB,UAAM,IAAI,MAAM,gEAAgE,OAAO,KAAK,IAAI,CAAC,kEAC9B;AAAA,EACrE;AACA,MAAI,EAAE,UAAU,OAAQ,OAAM,IAAI,MAAM,mDAAmD;AAC3F,SAAO,EAAE,MAAM,MAAM,SAAS,OAAO,OAAO,kBAAkB,MAAM,IAAI,EAAE;AAC5E;;;AD7BO,IAAM,sBAAsB;AAAA,EACjC,MAAM;AAAA,EACN,OAAO;AAAA,EACP,aAAa;AAAA,EACb,iBAAiB;AASnB;AAEO,IAAM,mBAAmB,uBAAuB;AAAA,EACrD,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,sBAAsB,CAAC,oBAAoB;AAC7C,GAAG,CAAC,UAAU,MAAM,SAAS,WAAW,YAAY,OAAO,oBAAoB,CAAC;AAEhF,IAAM,aAAa,KAAK,OAAO;AAAA,EAC7B,aAAa,KAAK,MAAM;AAAA,IACtB,KAAK,OAAO;AAAA,MACV,QAAQ,KAAK,OAAO,EAAE,WAAW,GAAG,aAAa,yHAAyH,CAAC;AAAA,MAC3K,WAAW,KAAK,SAAS,KAAK,QAAQ,EAAE,aAAa,0HAA0H,CAAC,CAAC;AAAA,IACnL,GAAG,EAAE,sBAAsB,MAAM,CAAC;AAAA,IAClC,KAAK,OAAO;AAAA,MACV,WAAW,KAAK,MAAM,CAAC,KAAK,QAAQ,YAAY,GAAG,KAAK,QAAQ,UAAU,CAAC,CAAC;AAAA,MAC5E,SAAS,KAAK,MAAM,CAAC,KAAK,OAAO,EAAE,kBAAkB,EAAE,CAAC,GAAG,KAAK,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;AAAA,MAChG,UAAU,KAAK,MAAM,CAAC,KAAK,IAAI,aAAa,GAAG,KAAK,IAAI,aAAa,CAAC,CAAC;AAAA,IACzE,GAAG,EAAE,sBAAsB,MAAM,CAAC;AAAA,EACpC,CAAC;AACH,GAAG,aAAa;AAEhB,IAAM,sBAAsB,KAAK,OAAO;AAAA,EACtC,MAAM,KAAK,MAAM,CAAC,YAAY,KAAK,KAAK,CAAC,GAAG,EAAE,aAAa,yHAAyH,CAAC;AACvL,CAAC;AAED,IAAM,UAAU,CAAC,YAAoB,IAAI,YAAY,0BAA0B,SAAS,GAAG;AAE3F,IAAM,eAAe,CAAC,UAAkC;AACtD,MAAI;AACF,WAAO,gBAAgB,KAAK;AAAA,EAC9B,SAAS,QAAQ;AACf,UAAM,QAAQ,kBAAkB,QAAQ,OAAO,UAAU,OAAO,MAAM,CAAC;AAAA,EACzE;AACF;AAEA,IAAM,YAAY,CAAC,UAAqC,MAAM,SAAS,WAAW,MAAM,UAAU,SAAS;AAE3G,IAAM,iBAAiB,CAAC,MAAe,WAAmB,UAAkB;AAC1E,QAAM,SAAS,gBAAgB,SAAS;AACxC,MAAI,OAAO,SAAS,QAAS,OAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,kBAAkB;AACnF,QAAM,SAAS,OAAO;AACtB,QAAM,QAAQ,cAAc,KAAK,QAAQ,MAAM;AAC/C,MAAI,CAAC,OAAO;AACV,UAAM,QAAQ,KAAK,OAAO,OAAO,CAAC,UAAU,MAAM,SAAS,OAAO,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM,MAAM,EAAE;AACrG,UAAM,QAAQ,GAAG,KAAK,MAAM,MAAM,0CAA0C,MAAM,KAAK,IAAI,KAAK,MAAM,EAAE;AAAA,EAC1G;AACA,MAAI,MAAM,SAAS,SAAS;AAC1B,UAAM,QAAQ,GAAG,KAAK,MAAM,MAAM,yEAAyE;AAAA,EAC7G;AACA,SAAO;AACT;AAEA,IAAM,mBAAmB,CAAC,cAAsB,gBAAgB,SAAS,EAAE,SAAS;AAEpF,IAAM,uBAAuB,CAAC,MAAe,WAAyC;AACpF,QAAM,WAAW,KAAK,aAAa,QAAQ,CAAC,UAAU;AACpD,QAAI,MAAM,aAAa,2BAA2B,MAAM,MAAM,SAAS,QAAS,QAAO,CAAC;AACxF,UAAM,UAAU,MAAM,MAAM;AAC5B,UAAM,QAAQ,KAAK,OAAO,KAAK,CAAC,cAAc,UAAU,OAAO,OAAO;AACtE,QAAI,CAAC,SAAS,MAAM,SAAS,WAAW,UAAU,KAAK,EAAG,QAAO,CAAC;AAClE,UAAM,EAAE,QAAQ,IAAI,MAAM;AAC1B,WAAO,UAAU,CAAC,OAAO,IAAI,CAAC;AAAA,EAChC,CAAC;AACD,QAAM,UAAU,CAAC,WAAmB,UAA0B;AAC5D,UAAM,SAAS,gBAAgB,SAAS;AACxC,QAAI,OAAO,SAAS,MAAO,QAAO;AAClC,QAAI;AACF,aAAO,OAAO,iBAAiB,UAAU,OAAO,EAAE,EAAE,KAAK,EAAE;AAAA,IAC7D,SAAS,OAAO;AACd,YAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,wCAAwC;AAAA,IACzI;AAAA,EACF;AACA,SAAO,aAAa,EAAE,MAAM,OAAO,OAAO,uBAAuB,OAAO,MAAM,CAAC,WAAW,QAAQ,QAAQ,MAAM,CAAC,IAAI,KAAK,CAAC;AAC7H;AAGO,IAAM,wBAAwB,CAAC,MAAe,UAAwC;AAC3F,QAAM,SAAS,qBAAqB,MAAM,KAAK;AAC/C,aAAW,aAAa,oBAAoB,OAAO,IAAI,GAAG;AACxD,QAAI,iBAAiB,SAAS,EAAG,gBAAe,MAAM,WAAW,MAAM;AAAA,EACzE;AACA,SAAO;AACT;AAEO,IAAM,oBAAoB,MAC/B,kBAAkB;AAAA,EAChB,GAAG;AAAA,EACH,QAAQ;AAAA,EACR,cAAc,KAAK,KAAK;AAAA,EACxB,WAAW;AAAA,EACX,KAAK,CAAC,EAAE,SAAS,QAAQ,QAAQ,GAAG,YAAY,UAAU;AACxD,UAAM,OAAO,QAAQ,KAAK,OAAO,KAAK;AACtC,UAAM,SAAS,sBAAsB,MAAM,aAAa,KAAK,CAAC;AAC9D,YAAQ,mBAAmB,QAAQ,UAAU,GAAG,OAAO,OAAO;AAAA,MAC5D,UAAU;AAAA,MACV,OAAO,EAAE,MAAM,MAAM;AAAA,MACrB,OAAO;AAAA,IACT,CAAC;AACD,WAAO;AAAA,EACT;AACF,CAAC;AAEI,IAAM,+BAA+B,OAAwB;AAAA,EAClE,MAAM;AAAA,EACN,aAAa,CAAC,mBAAmB,qBAAqB,gBAAgB,CAAC;AAAA,EACvE,OAAO,MAAM,CAAC,kBAAkB,CAAC;AACnC;;;AG7IA,SAAS,QAAAC,aAAY;AACrB,SAAS,qBAAAC,oBAAmB,0BAAAC,yBAAwB,eAAAC,oBAAyC;AAC7F,SAAS,sBAAAC,2BAA0B;AAEnC,IAAM,YAAYF,wBAAuB;AAAA,EACvC,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,sBAAsB,CAAC,qBAAqB;AAC9C,GAAG,CAAC,OAAO,SAAS,MAAM,SAAS,WAAW,MAAM,OAAO,KAAK,kBAAkBC,aAAY,OAAO,qBAAqB,CAAC;AAEpH,IAAM,2BAA2B,CAAC,MAAwC,YAAuD;AACtI,QAAM,aAAaF,mBAAkB;AAAA,IACnC,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,QAAQD,MAAK,OAAO,CAAC,GAAG,EAAE,sBAAsB,MAAM,CAAC;AAAA,IACvD,cAAcA,MAAK,OAAO,EAAE,WAAWA,MAAK,QAAQ,IAAI,EAAE,GAAG,EAAE,sBAAsB,MAAM,CAAC;AAAA,IAC5F;AAAA,IACA,KAAK,CAAC,EAAE,QAAQ,OAAO,MAAM;AAC3B,cAAQ,eAAe;AACvB,WAAK,KAAK,OAAO,KAAK,EAAE,MAAM,OAAO;AACrC,aAAO,EAAE,WAAW,KAAc;AAAA,IACpC;AAAA,EACF,CAAC;AACD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,aAAa,CAACI,oBAAmB,YAAY,SAAS,CAAC;AAAA,IACvD,OAAO,MAAM,CAAC,UAAU;AAAA,EAC1B;AACF;;;AJdA,SAAS,0BAA0B;AAEnC,IAAM,sBAAqC;AAAA,EACzC,UAAU,EAAE,IAAI,wBAAwB;AAAA,EACxC,UAAU,CAAC,SAAS;AAClB,SAAK,UAAU,6BAA6B,CAAC;AAC7C,SAAK,UAAU;AAAA,MACb,CAAC,UAAU,KAAK,QAAQ,kBAAkB,EAAE,EAAE,KAAK,KAAK;AAAA,MACxD,CAAC,UAAU,QAAQ,MAAM,sCAAsC,KAAK;AAAA,IACtE,CAAC;AACD,SAAK,WAAW;AAAA,MACd,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,aAAa;AAAA,MAEb,QAAQ;AAAA,MACR,cAAc,oBAAoB,sBAAsB;AAAA,MACxD,UAAU;AAAA,MACV,SAAS,CAAC,SAAS,UACjB,kBAAkB,KAAK,QAAQ,oBAAoB,EAAE,GAAG;AAAA,QACtD,SAAS,QAAQ,UAAU;AAAA,QAC3B,WAAW,QAAQ;AAAA,QACnB,GAAI,QAAQ,UAAU,SAAS,WAAW,QAAQ,UAAU,SACxD,EAAE,QAAQ,QAAQ,UAAU,OAAO,IACnC,CAAC;AAAA,QACL,eAAe,QAAQ;AAAA,QACvB,aAAa,QAAQ;AAAA,MACvB,GAAG,QAAQ,OAAO,KAA0B;AAAA,IAChD,CAAC;AACD,SAAK,OAAO;AAAA,MACV,IAAI;AAAA,MACJ,QAAQ,CAAC,aAAa;AAAA,QACpB,QAAQ,IAAI,aAAa,EAAE,SAAS,QAAQ,QAAQ,CAAC;AAAA,MACvD;AAAA,IACF,CAAC;AACD,SAAK;AAAA,MACH,iBAAiB,gCAAgC,KAAK,YAAY,yBAAyB,mBAAmB,CAAC;AAAA,MAC/G;AAAA,QACE,iBAAiB,iCAAiC,KAAK,YAAY,yBAAyB,aAAa,CAAC;AAAA,QAC1G;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAEO,IAAM,SAAuB,EAAE,QAAQ,MAAM,oBAAoB;",
+  "sourcesContent": ["import {\n  actorInputSchema,\n  agentTools,\n  enqueueActorInput,\n  eventResultSchemaOf,\n  ScriptDriver,\n  type ActorInputRequest,\n  type RAgentsPlugin,\n} from \"@ragents/engine\";\nimport { runtimeProviderToken } from \"@ragents/host/ragents/host-services.js\";\nimport { pluginAsset } from \"@ragents/host/plugin-support/plugin-folder.js\";\nimport type { PluginModule } from \"@ragents/host/plugin-support/plugin-module.js\";\nimport { boundToTools, handlebarsPrompt } from \"@ragents/host/plugin-support/prompt.js\";\nimport { createSurfaceToolContributor, placeOnSurface } from \"./surface-tool.js\";\nimport { surfacePlacementToken } from \"./contract.js\";\nimport { createRunStopContributor } from \"./run-stop-tool.js\";\nimport { runManagementToken } from \"@ragents/host/ragents/global-chat.js\";\n\nconst orchestrationPlugin: RAgentsPlugin = {\n  manifest: { id: \"ragents.orchestration\" },\n  register: (host) => {\n    host.functions(createSurfaceToolContributor());\n    host.provide(surfacePlacementToken, placeOnSurface(host.service(runtimeProviderToken)));\n    host.functions(createRunStopContributor(\n      (runId) => host.service(runManagementToken)().stop(runId),\n      (error) => console.error(\"Run stop by the coordinator failed\", error),\n    ));\n    host.operations({\n      id: \"actor_input\",\n      label: \"Enqueue actor input\",\n      description: \"Enqueues a normal text input for an actor under the bound identity - \"\n        + \"as an agent or, from an app action, as the owner of the run. Only confirms the enqueueing. TypeScript actors understand only their programmed input protocol, no free-form tasks.\",\n      schema: actorInputSchema,\n      resultSchema: eventResultSchemaOf(\"actor.input.enqueued\"),\n      operator: \"direct\",\n      execute: (context, input) =>\n        enqueueActorInput(host.service(runtimeProviderToken)(), {\n          actorId: context.principal.actorId,\n          commandId: context.invocationId,\n          ...(context.principal.kind === \"agent\" && context.principal.turnId\n            ? { turnId: context.principal.turnId }\n            : {}),\n          correlationId: context.invocationId,\n          causationId: context.invocationId,\n        }, context.runId, input as ActorInputRequest),\n    });\n    host.script({\n      id: \"typescript\",\n      create: (context) => ({\n        driver: new ScriptDriver({ runtime: context.runtime }),\n      }),\n    });\n    host.prompts(\n      handlebarsPrompt(\"ragents.orchestration.prompt\", 600, pluginAsset(\"ragents.orchestration\", \"orchestration.hbs\")),\n      boundToTools(\n        handlebarsPrompt(\"ragents.orchestration.surface\", 650, pluginAsset(\"ragents.orchestration\", \"surface.hbs\")),\n        \"canvas_layout_replace\",\n        \"canvas_layout_place\",\n      ),\n    );\n  },\n};\n\nexport const plugin: PluginModule = { create: () => orchestrationPlugin };\n", "import { Type } from \"typebox\";\nimport {\n  DomainError,\n  actorByHandle,\n  defineRunFunction,\n  defineToolAvailability,\n  holdsUsable,\n  type CommandContext,\n  type Orchestration,\n  type RunFunction,\n  type RunView,\n  type ToolContributor,\n} from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\nimport { ACTOR_PROGRAMS_STATE_ID, resolveActorView, type ActorProgramState } from \"@ragents/host/plugin-support/actor-programs/contract.js\";\nimport {\n  ORCHESTRATION_PLUGIN_ID,\n  surfaceEntityOf,\n  surfaceLayoutOf,\n  type SurfaceLayout,\n} from \"../contract.js\";\nimport { surfaceTileEntities, mapSurfaceTileEntities } from \"../tiled-layout.js\";\nimport type { SurfacePlacement, SurfacePlacementRequest } from \"./contract.js\";\n\nexport const surfaceToolMetadata = {\n  name: \"canvas_layout_replace\",\n  label: \"Replace Surface Layout\",\n  description: \"Arrange actors and mini-apps as tiles on the viewport-filling work surface, using a binary tree of weighted splits.\",\n  longDescription: \"root is the whole arrangement and replaces the stored one. A tile is {entity:'@helper'} or \"\n    + \"{entity:'app:@workspace/main'}; a split is {direction:'horizontal',weights:[1,1],children:[tile,tile]}. \"\n    + \"horizontal means left/right, vertical means top/bottom, and weights give the ratio of the two children. \"\n    + \"App left, chat right at 50:50: {root:{direction:'horizontal',weights:[1,1],children:[\"\n    + \"{entity:'app:@workspace/main'},{entity:'@helper'}]}}. One tile above two tiles at 2:1: \"\n    + \"{root:{direction:'vertical',weights:[2,1],children:[{entity:'@lead'},\"\n    + \"{direction:'horizontal',weights:[1,1],children:[{entity:'@first'},{entity:'@second'}]}]}}. \"\n    + \"root:null clears the surface. Dividers are draggable, so do not resend a layout to fight a personal arrangement. \"\n    + \"Participants you do not place stay reachable through the run header.\",\n} as const;\n\nexport const placeToolMetadata = {\n  name: \"canvas_layout_place\",\n  label: \"Place on Surface\",\n  description: \"Place one actor or mini-app next to the current surface layout instead of replacing it.\",\n  longDescription: \"entity is {entity} of a tile: '@helper' or 'app:@workspace/main'. The current arrangement becomes one side of a new split \"\n    + \"and the entity the other: direction 'horizontal' (default) puts it to the right, 'vertical' below. weight is its share against \"\n    + \"the existing arrangement's weight 1, default 1. An entity the layout already shows stays where it is; placed is then false. \"\n    + \"On an empty surface the entity becomes the only tile. Use it when you join a running run, such as a run script started with \"\n    + \"start.embedded, so that the tiles others arranged stay.\",\n} as const;\n\nexport const canDesignSurface = defineToolAvailability({\n  availability: \"conditional\",\n  availabilityDetail: \"Only for agents and TypeScript actors with the capability plugin.state.write.\",\n  requiredCapabilities: [\"plugin.state.write\"],\n}, (actor) => actor.kind !== \"human\" && holdsUsable(actor, \"plugin.state.write\"));\n\nconst tileSchema = Type.Cyclic({\n  SurfaceTile: Type.Union([\n    Type.Object({\n      entity: Type.String({ minLength: 1, description: \"Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key; the server resolves the view ID\" }),\n      chatInput: Type.Optional(Type.Boolean({ description: \"Actor tiles only: false hides the chat composer in the tile; default true. Does not change permissions or the inspector\" })),\n    }, { additionalProperties: false }),\n    Type.Object({\n      direction: Type.Union([Type.Literal(\"horizontal\"), Type.Literal(\"vertical\")]),\n      weights: Type.Tuple([Type.Number({ exclusiveMinimum: 0 }), Type.Number({ exclusiveMinimum: 0 })]),\n      children: Type.Tuple([Type.Ref(\"SurfaceTile\"), Type.Ref(\"SurfaceTile\")]),\n    }, { additionalProperties: false }),\n  ]),\n}, \"SurfaceTile\");\n\nconst surfaceLayoutSchema = Type.Object({\n  root: Type.Union([tileSchema, Type.Null()], { description: \"The whole arrangement: a tile or a binary split. Maximum 64 unique tiles and 16 nested splits. null clears the surface\" }),\n});\n\nconst invalid = (message: string) => new DomainError(\"invalid-surface-layout\", message, 400);\n\nconst parsedLayout = (input: unknown): SurfaceLayout => {\n  try {\n    return surfaceLayoutOf(input);\n  } catch (caught) {\n    throw invalid(caught instanceof Error ? caught.message : String(caught));\n  }\n};\n\nconst isStopped = (actor: RunView[\"actors\"][number]) => actor.kind !== \"human\" && actor.lifecycle.kind === \"stopped\";\n\nconst surfaceActorOf = (view: RunView, reference: string, where: string) => {\n  const entity = surfaceEntityOf(reference);\n  if (entity.kind !== \"actor\") throw invalid(`${where}: ${reference} is not an actor`);\n  const handle = entity.handle;\n  const found = actorByHandle(view.actors, handle);\n  if (!found) {\n    const known = view.actors.filter((actor) => actor.kind !== \"human\").map((actor) => `@${actor.handle}`);\n    throw invalid(`${where}: @${handle} is not an actor of this run. Present: ${known.join(\", \") || \"none\"}`);\n  }\n  if (found.kind === \"human\") {\n    throw invalid(`${where}: @${handle} is the human in the chat; the chat is fixed to the left of the surface`);\n  }\n  return found;\n};\n\nconst isActorReference = (reference: string) => surfaceEntityOf(reference).kind === \"actor\";\n\nconst resolveAppReferences = (view: RunView, layout: SurfaceLayout): SurfaceLayout => {\n  const programs = view.pluginStates.flatMap((entry) => {\n    if (entry.pluginId !== ACTOR_PROGRAMS_STATE_ID || entry.scope.kind !== \"actor\") return [];\n    const actorId = entry.scope.actorId;\n    const actor = view.actors.find((candidate) => candidate.id === actorId);\n    if (!actor || actor.kind === \"human\" || isStopped(actor)) return [];\n    const { program } = entry.state as unknown as ActorProgramState;\n    return program ? [program] : [];\n  });\n  const resolve = (reference: string, where: string): string => {\n    const entity = surfaceEntityOf(reference);\n    if (entity.kind !== \"app\") return reference;\n    try {\n      return `app:${resolveActorView(programs, entity.id).view.id}`;\n    } catch (error) {\n      throw invalid(`${where}: ${reference}: ${error instanceof Error ? error.message : String(error)} Surface entities get the prefix app:.`);\n    }\n  };\n  return parsedLayout({ root: layout.root ? mapSurfaceTileEntities(layout.root, (entity) => resolve(entity, \"root\")) : null });\n};\n\n/** Resolve app names and validate the placed actors before any layout is stored. */\nexport const checkLayoutAgainstRun = (view: RunView, input: SurfaceLayout): SurfaceLayout => {\n  const layout = resolveAppReferences(view, input);\n  for (const reference of surfaceTileEntities(layout.root)) {\n    if (isActorReference(reference)) surfaceActorOf(view, reference, \"root\");\n  }\n  return layout;\n};\n\nconst currentLayout = (view: RunView): SurfaceLayout => {\n  const state = view.pluginStates.find((entry) => entry.pluginId === ORCHESTRATION_PLUGIN_ID && entry.scope.kind === \"run\")?.state;\n  return state === undefined || state === null ? { root: null } : surfaceLayoutOf(state);\n};\n\n/** Splits the root once: the existing arrangement keeps weight 1, the placed tile gets its own. */\nconst placed = (view: RunView, request: SurfacePlacementRequest): SurfaceLayout | undefined => {\n  const current = currentLayout(view);\n  const [tile] = surfaceTileEntities(checkLayoutAgainstRun(view, parsedLayout({ root: { entity: request.entity } })).root);\n  if (surfaceTileEntities(current.root).includes(tile!)) return undefined;\n  const root = current.root === null ? { entity: tile! } : {\n    direction: request.direction ?? \"horizontal\",\n    weights: [1, request.weight ?? 1],\n    children: [current.root, { entity: tile! }],\n  };\n  return parsedLayout({ root });\n};\n\nexport const placeOnSurface = (runtime: () => Orchestration): SurfacePlacement => ({\n  place: (context: CommandContext, runId: string, request: SurfacePlacementRequest) => {\n    const layout = placed(runtime().view(runId), request);\n    if (!layout) return { placed: false };\n    runtime().replacePluginState(context, runId, { pluginId: ORCHESTRATION_PLUGIN_ID, scope: { kind: \"run\" }, state: layout });\n    return { placed: true };\n  },\n});\n\nconst placeSchema = Type.Object({\n  entity: Type.String({ minLength: 1, description: \"Actor @handle or activated mini-app app:@handle/view-key or app:program-name/view-key\" }),\n  direction: Type.Optional(Type.Union([Type.Literal(\"horizontal\"), Type.Literal(\"vertical\")], { description: \"horizontal: to the right of the current layout (default); vertical: below it\" })),\n  weight: Type.Optional(Type.Number({ exclusiveMinimum: 0, description: \"Share of the placed tile against the existing arrangement's weight 1; default 1\" })),\n}, { additionalProperties: false });\n\nexport const createPlaceTool = (): RunFunction =>\n  defineRunFunction({\n    ...placeToolMetadata,\n    schema: placeSchema,\n    resultSchema: Type.Object({ placed: Type.Boolean() }, { additionalProperties: false }),\n    available: canDesignSurface,\n    run: ({ runtime, caller, context }, toolCallId, input) => placeOnSurface(() => runtime).place(context(toolCallId), caller.runId, input),\n  });\n\nexport const createSurfaceTool = (): RunFunction =>\n  defineRunFunction({\n    ...surfaceToolMetadata,\n    schema: surfaceLayoutSchema,\n    resultSchema: Type.Null(),\n    available: canDesignSurface,\n    run: ({ runtime, caller, context }, toolCallId, input) => {\n      const view = runtime.view(caller.runId);\n      const layout = checkLayoutAgainstRun(view, parsedLayout(input));\n      runtime.replacePluginState(context(toolCallId), caller.runId, {\n        pluginId: ORCHESTRATION_PLUGIN_ID,\n        scope: { kind: \"run\" },\n        state: layout,\n      });\n      return null;\n    },\n  });\n\nexport const createSurfaceToolContributor = (): ToolContributor => ({\n  name: \"ragents.orchestration.surface\",\n  descriptors: [toolDescriptorFrom(surfaceToolMetadata, canDesignSurface), toolDescriptorFrom(placeToolMetadata, canDesignSurface)],\n  tools: () => [createSurfaceTool(), createPlaceTool()],\n});\n", "import { handleKey } from \"@ragents/engine/src/http/contracts\";\nimport { surfaceTileNodeOf } from \"./tiled-layout.js\";\n\nexport const ORCHESTRATION_PLUGIN_ID = \"ragents.orchestration\";\n\nexport type SurfaceEntity =\n  | { kind: \"actor\"; handle: string }\n  | { kind: \"app\"; id: string };\n\nexport type SurfaceTileNode =\n  | { entity: string; chatInput?: boolean }\n  | { direction: \"horizontal\" | \"vertical\"; weights: [number, number]; children: [SurfaceTileNode, SurfaceTileNode] };\n\nexport type SurfaceLayout = {\n  root: SurfaceTileNode | null;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nexport const surfaceEntityOf = (text: string): SurfaceEntity => {\n  const trimmed = text.trim();\n  if (trimmed.startsWith(\"@\")) {\n    const handle = handleKey(trimmed);\n    if (!handle || /\\s/.test(handle)) throw new Error(`Entity ${JSON.stringify(text)}: a handle is missing after the @`);\n    return { kind: \"actor\", handle };\n  }\n  const match = /^app:(.+)$/s.exec(trimmed);\n  if (!match) {\n    throw new Error(`Entity ${JSON.stringify(text)}: expected @handle or app:<id>`);\n  }\n  const id = match[1].trim();\n  if (!id) throw new Error(`Entity ${JSON.stringify(text)}: the ID after the colon is empty`);\n  return { kind: \"app\", id };\n};\n\nexport const surfaceEntityKey = (entity: SurfaceEntity): string =>\n  entity.kind === \"actor\" ? `@${entity.handle}` : `app:${entity.id}`;\n\nconst LEGACY_KEYS = [\"nodes\", \"shapes\", \"lines\", \"mode\"] as const;\n\n/** Parses and validates a tile layout; throws an error naming the first violation. */\nexport const surfaceLayoutOf = (value: unknown): SurfaceLayout => {\n  if (!isRecord(value)) throw new Error(\"The arrangement must be an object with root\");\n  const legacy = LEGACY_KEYS.filter((key) => key in value);\n  if (legacy.length > 0) {\n    throw new Error(`The program arrangement comes from the removed free surface (${legacy.join(\", \")}); `\n      + \"canvas_layout_replace with root sets it anew as a tile layout\");\n  }\n  if (!(\"root\" in value)) throw new Error(\"root is missing; expected a tile, a split or null\");\n  return { root: value.root === null ? null : surfaceTileNodeOf(value.root) };\n};\n", "import { surfaceEntityKey, surfaceEntityOf, type SurfaceTileNode } from \"./contract.js\";\n\nexport type { SurfaceTileNode } from \"./contract.js\";\n\nexport const MAX_SURFACE_TILE_DEPTH = 16;\nexport const MAX_SURFACE_TILES = 64;\n\nexport const surfaceTileNodeOf = (input: unknown): SurfaceTileNode => {\n  const entities = new Set<string>();\n  const parse = (value: unknown, where: string, depth: number): SurfaceTileNode => {\n    if (depth > MAX_SURFACE_TILE_DEPTH) throw new Error(`${where}: at most ${MAX_SURFACE_TILE_DEPTH} nested splits are allowed`);\n    if (typeof value !== \"object\" || value === null || Array.isArray(value)) throw new Error(`${where} must be a tile or a split`);\n    const node = value as Record<string, unknown>;\n    if (Object.hasOwn(node, \"entity\")) {\n      if (Object.keys(node).some((key) => key !== \"entity\" && key !== \"chatInput\")) throw new Error(`${where}: a tile carries only entity and chatInput; a split direction, weights and children`);\n      if (typeof node.entity !== \"string\") throw new Error(`${where}.entity must be @handle or app:<name>/<view>`);\n      const entity = surfaceEntityOf(node.entity);\n      const key = surfaceEntityKey(entity);\n      if (node.chatInput !== undefined && (entity.kind !== \"actor\" || typeof node.chatInput !== \"boolean\")) {\n        throw new Error(`${where}.chatInput is only allowed for actors, as a boolean`);\n      }\n      if (entities.has(key)) throw new Error(`${where}: ${key} is placed as a tile more than once`);\n      entities.add(key);\n      if (entities.size > MAX_SURFACE_TILES) throw new Error(`At most ${MAX_SURFACE_TILES} tiles are allowed`);\n      return node.chatInput === undefined ? { entity: key } : { entity: key, chatInput: node.chatInput as boolean };\n    }\n    if (Object.keys(node).some((key) => ![\"direction\", \"weights\", \"children\"].includes(key))) throw new Error(`${where}: a split carries only direction, weights and children`);\n    if (node.direction !== \"horizontal\" && node.direction !== \"vertical\") throw new Error(`${where}.direction must be horizontal or vertical`);\n    if (!Array.isArray(node.weights) || node.weights.length !== 2 || node.weights.some((weight) => typeof weight !== \"number\" || !Number.isFinite(weight) || weight <= 0)) {\n      throw new Error(`${where}.weights must contain exactly two finite positive numbers`);\n    }\n    if (!Array.isArray(node.children) || node.children.length !== 2) throw new Error(`${where}.children must contain exactly two tiles or splits`);\n    return {\n      direction: node.direction,\n      weights: [node.weights[0], node.weights[1]],\n      children: [parse(node.children[0], `${where}.children[0]`, depth + 1), parse(node.children[1], `${where}.children[1]`, depth + 1)],\n    };\n  };\n  return parse(input, \"root\", 0);\n};\n\n/** A tile hides the chat composer of its actor only when its leaf says chatInput: false. */\nexport const surfaceTileChatInput = (root: SurfaceTileNode | null | undefined, entity: string): boolean =>\n  !root ? true : \"entity\" in root\n    ? root.entity !== entity || root.chatInput !== false\n    : surfaceTileChatInput(root.children[0], entity) && surfaceTileChatInput(root.children[1], entity);\n\nexport const surfaceTileEntities = (root: SurfaceTileNode | null | undefined): string[] =>\n  !root ? [] : \"entity\" in root ? [root.entity] : root.children.flatMap(surfaceTileEntities);\n\nexport const mapSurfaceTileEntities = (root: SurfaceTileNode, resolve: (entity: string) => string): SurfaceTileNode =>\n  \"entity\" in root ? { ...root, entity: resolve(root.entity) } : {\n    ...root,\n    children: [mapSurfaceTileEntities(root.children[0], resolve), mapSurfaceTileEntities(root.children[1], resolve)],\n  };\n", "import { Type } from \"typebox\";\nimport { defineRunFunction, defineToolAvailability, holdsUsable, type ToolContributor } from \"@ragents/engine\";\nimport { toolDescriptorFrom } from \"@ragents/host/plugin-support/agent-tool.js\";\n\nconst available = defineToolAvailability({\n  availability: \"conditional\",\n  availabilityDetail: \"For the primary actor with execution.stopOwned in its own run.\",\n  requiredCapabilities: [\"execution.stopOwned\"],\n}, (actor, view) => actor.kind !== \"human\" && actor.id === view.primaryActorId && holdsUsable(actor, \"execution.stopOwned\"));\n\nexport const createRunStopContributor = (stop: (runId: string) => Promise<void>, onError: (error: unknown) => void): ToolContributor => {\n  const definition = defineRunFunction({\n    name: \"run_stop\",\n    label: \"Stop run\",\n    description: \"Initiates the complete stop of your own run: running turns, tools, subagents and plugin services. Conversation and files are kept. Also cancels your own turn; acceptance is not a confirmation of completed cleanup. Use immediately when the user wants a complete cancellation; do not send a cancel message to busy agents.\",\n    schema: Type.Object({}, { additionalProperties: false }),\n    resultSchema: Type.Object({ requested: Type.Literal(true) }, { additionalProperties: false }),\n    available,\n    run: ({ caller, signal }) => {\n      signal?.throwIfAborted();\n      void stop(caller.runId).catch(onError);\n      return { requested: true as const };\n    },\n  });\n  return {\n    name: \"ragents.orchestration.run-stop\",\n    descriptors: [toolDescriptorFrom(definition, available)],\n    tools: () => [definition],\n  };\n};\n"],
+  "mappings": "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",
   "names": ["key", "Type", "defineRunFunction", "defineToolAvailability", "holdsUsable", "toolDescriptorFrom"]
 }

package/bundles/ragents.orchestration/surface.hbs

@@ -19,6 +19,11 @@ App left, chat right at 50:50:
 ]}}. Resolve the actual actor and app names before calling; the example names are not existing
 participants.
 
+To add one tile without replacing what is arranged, `context.functions.canvas_layout_place({ entity })`
+splits the current layout once and puts the entity to its right, or below with `direction: "vertical"`;
+`weight` is its share against the existing arrangement's weight 1. An entity the layout shows already
+stays where it is. A run script started inside a running run (`start.embedded`) uses place, not replace.
+
 An actor tile carries {entity:"@helper",chatInput:false} when its chat composer should stay hidden.
 That changes neither permissions nor the inspector. Mini-app tiles have no chatInput.
 

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

@@ -130,7 +130,7 @@
     }
   },
   "revision": "58b8b02a346c4323afdef69cfd96b8f3717806919f2c46f146bcc803ef12bac4",
-  "sourceRevision": "c4f7e8a0e5e78a2c4434965b30224dab58aa2a7ffad8ebb9b0857d0ffb9f2813",
+  "sourceRevision": "9310057d7fc569e6a0d103d727131e6644899a9ccf17c9ba79680cc3539c9a16",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

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

@@ -78,7 +78,7 @@
     }
   },
   "revision": "e602a8711818533fc7372c5cb2ca51ae55362079d9944da008db9084621b5ccc",
-  "sourceRevision": "a909e413bfca6b57bc468300f5a50b2bc85a5d8354a5a0f7dde760f38614cf76",
+  "sourceRevision": "0d7379e3a1c3fe42300ff72891203b4c4c043ce8720e58152358571b7af8adf1",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

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

@@ -76,7 +76,7 @@
     }
   },
   "revision": "7a3eb7a847ce6a4c8324b9c073c3c7a13c760088a194d419fe21342575c4208f",
-  "sourceRevision": "c6fefb62c103db8f057e3b61019810ffca13b46bcaa449ed5c53d7139a524cfe",
+  "sourceRevision": "7c8b3522ee90f89a7d3941ea396c458980ac53c83fa5096eab5a19b5f1a7aa81",
   "server": "server/index.js",
   "web": {
     "entry": "web/index.js",

package/bundles/ragents.profile-distribution/ragents-bundle.json

@@ -53,7 +53,7 @@
     "web": {}
   },
   "revision": "3e99cf5cb8921685ad83aa6aaf9657da4c648f9d68cb744988a73f227c342e1d",
-  "sourceRevision": "f86bd0f1a439a2c9d143101af2a58881306dd8910240226548afbebfc125682c",
+  "sourceRevision": "cbf9d98fe42583b619b84425e648666df7cafd04930cf0692b43a5943fb4bd39",
   "server": "server/index.js",
   "exports": {
     "server": {},

package/bundles/ragents.reference/actors/notebook/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "notebook",
+  "private": true,
+  "type": "module",
+  "ragents": {
+    "title": "Notebook",
+    "description": "Keeps the notes that run scripts send it, newest first.",
+    "backend": "src/server.ts",
+    "views": [
+      {
+        "id": "main",
+        "client": "src/client.tsx"
+      }
+    ]
+  }
+}

package/bundles/ragents.reference/actors/notebook/src/client.tsx

@@ -0,0 +1,31 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { context, useAppState } from "@ragents/client";
+import * as UI from "@ragents/client/ui";
+
+const App = () => {
+  const state = useAppState();
+  const notes = state.notes ?? [];
+  const [status, setStatus] = React.useState("Run scripts add their notes here.");
+
+  const clear = async (): Promise<void> => {
+    const answer = await context.capabilities.call("clear", {});
+    setStatus(`Cleared ${answer.cleared} ${answer.cleared === 1 ? "note" : "notes"}.`);
+  };
+
+  return (
+    <UI.AppLayout title="Notebook" description={<>{notes.length} {notes.length === 1 ? "note" : "notes"}</>}>
+      <UI.Stack>
+        <p className="text-muted-foreground" role="status">{status}</p>
+        <ul className="border-t border-border">
+          {notes.map((note, index) => <li className="min-h-8 border-b border-border-soft py-1.5 [overflow-wrap:anywhere]" key={index}>{note}</li>)}
+        </ul>
+        <UI.Button disabled={notes.length === 0} onClick={() => void clear()} variant="outline">Clear</UI.Button>
+      </UI.Stack>
+    </UI.AppLayout>
+  );
+};
+
+const root = document.getElementById("root");
+if (!root) throw new Error("The #root element is missing.");
+createRoot(root).render(<App />);