@dxos/plugin-assistant 0.13.0 → 0.14.0

package/dist/lib/chunk-analyze-turn.mjs

@@ -0,0 +1,220 @@
+import * as Capability from "@dxos/app-framework/Capability";
+import { AssistantCapabilities } from "#types";
+import * as Capabilities from "@dxos/app-framework/Capabilities";
+import * as Option from "effect/Option";
+import { Database, Obj } from "@dxos/echo";
+import { AiService } from "@dxos/ai";
+import { AiSession } from "@dxos/assistant";
+import { log } from "@dxos/log";
+import { trim } from "@dxos/util";
+import * as Effect from "effect/Effect";
+import * as Operation from "@dxos/compute/Operation";
+import { TurnReviewSkill } from "#skills";
+import * as Schema from "effect/Schema";
+import * as Harness$1 from "@dxos/assistant/Harness";
+import * as LanguageModel from "effect/ai/LanguageModel";
+import * as Prompt from "effect/ai/Prompt";
+import { contentCaptureAllowed } from "@dxos/observability/AiObservability";
+import * as ObservabilityCapabilities from "@dxos/plugin-observability/ObservabilityCapabilities";
+//#region src/review/turn-review.ts
+/** PostHog event emitted when the reviewer finds a turn the agent struggled through. */
+var STRUGGLE_EVENT = "agent_struggle";
+/** Small enough to be cheap per turn, strong enough to judge an agentic transcript. */
+var REVIEW_MODEL = "com.anthropic.model.claude-sonnet-5.default";
+/** Bounds the transcript the reviewer reads; the uploaded trajectory is not cut. */
+var MAX_TRANSCRIPT_CHARS = 12e4;
+var MAX_BLOCK_CHARS = 4e3;
+/**
+* Why the agent struggled. Only the first four are reported: they are the ones fixable on our side
+* (prompting or tooling); the model's own reasoning and an unclear user request are not.
+*/
+var StruggleCause = Schema.Literals([
+	"system_prompt_missing",
+	"system_prompt_wrong",
+	"tool_missing",
+	"tool_faulty",
+	"model",
+	"user",
+	"none"
+]);
+var TurnVerdict = Schema.Struct({
+	struggled: Schema.Boolean.annotate({ description: "Whether the agent visibly struggled in the latest turn." }),
+	cause: StruggleCause.annotate({ description: "The root cause of the struggle, or \"none\"." }),
+	severity: Schema.Literals([
+		"low",
+		"medium",
+		"high"
+	]).annotate({ description: "low: recovered quickly; medium: wasted several steps; high: failed the request." }),
+	summary: Schema.String.annotate({ description: "One sentence naming what went wrong and what instruction or tool change would fix it." }),
+	tools: Schema.Array(Schema.String).annotate({ description: "Names of the tools implicated, if any." })
+});
+/** The dashboard's top-level split; `undefined` for a cause that is not reported. */
+var causeGroup = (cause) => {
+	switch (cause) {
+		case "system_prompt_missing":
+		case "system_prompt_wrong": return "system_prompt";
+		case "tool_missing":
+		case "tool_faulty": return "tooling";
+		default: return;
+	}
+};
+var isReportable = (verdict) => verdict.struggled && causeGroup(verdict.cause) !== void 0;
+var REVIEW_SYSTEM_PROMPT = trim`
+  You review transcripts of an AI agent working inside Composer, a collaborative workspace app.
+  Decide whether the agent struggled in the LATEST TURN (messages inside the <latest_turn> tags).
+  Earlier messages are context only.
+
+  Signs of struggling: repeated or looping tool calls, tool errors, calling tools with invalid
+  arguments, guessing at tool names or object ids, apologizing and retrying, giving up, asking the
+  user for information it should have been able to obtain, or giving an incomplete answer.
+
+  Classify the root cause:
+  - system_prompt_missing: the agent lacked instructions or context it needed (e.g. how a feature
+    works, which tool to use for a task, conventions of the app).
+  - system_prompt_wrong: instructions were present but misleading, contradictory, or outdated.
+  - tool_missing: no tool existed for an action the request clearly required.
+  - tool_faulty: a tool errored, returned unusable output, had a confusing schema or description.
+  - model: the tools and instructions were adequate; the model reasoned poorly.
+  - user: the request was ambiguous or impossible.
+  - none: the agent did not struggle.
+
+  Be conservative: a single quickly-recovered tool error is not a struggle. When unsure, answer
+  struggled=false with cause=none.
+`;
+var clip = (text, max) => text.length <= max ? text : `${text.slice(0, max)}… [${text.length - max} chars truncated]`;
+var stringify = (value) => typeof value === "string" ? value : JSON.stringify(value);
+/** One line per block, so the reviewer sees the shape of the turn without a tool result drowning it. */
+var formatMessage = (message) => {
+	const lines = message.blocks.map((block) => {
+		switch (block._tag) {
+			case "text": return clip(block.text, MAX_BLOCK_CHARS);
+			case "toolCall": return `[tool call ${block.name}] ${clip(stringify(block.input), MAX_BLOCK_CHARS)}`;
+			case "toolResult": return block.error ? `[tool error ${block.name}] ${clip(stringify(block.error), MAX_BLOCK_CHARS)}` : `[tool result ${block.name}] ${clip(stringify(block.result), MAX_BLOCK_CHARS)}`;
+			default: return `[${block._tag}]`;
+		}
+	});
+	return `${(message.sender.role ?? "unknown").toUpperCase()}:\n${lines.join("\n")}`;
+};
+/**
+* Splits the history at the turn that just ended: it starts at the last user message, which is what
+* the agent was answering. Hooks fire per request, so everything after it is this turn's work.
+*/
+var splitTurn = (history) => {
+	const index = history.findLastIndex((message) => message.sender.role === "user");
+	return index === -1 ? {
+		context: [],
+		turn: history
+	} : {
+		context: history.slice(0, index),
+		turn: history.slice(index)
+	};
+};
+/** The reviewer's prompt; context is trimmed from the front when the transcript runs long. */
+var formatReviewPrompt = (history) => {
+	const { context, turn } = splitTurn(history);
+	const turnText = turn.map(formatMessage).join("\n\n");
+	const budget = Math.max(0, MAX_TRANSCRIPT_CHARS - turnText.length);
+	const contextText = context.map(formatMessage).join("\n\n");
+	return [
+		contextText.length > budget ? `…${contextText.slice(contextText.length - budget)}` : contextText,
+		"<latest_turn>",
+		clip(turnText, MAX_TRANSCRIPT_CHARS),
+		"</latest_turn>"
+	].filter((part) => part.length > 0).join("\n\n");
+};
+var countToolCalls = (messages) => {
+	let calls = 0;
+	let errors = 0;
+	for (const message of messages) for (const block of message.blocks) if (block._tag === "toolCall") calls++;
+	else if (block._tag === "toolResult" && block.error) errors++;
+	return {
+		calls,
+		errors
+	};
+};
+/** A header line then one line per message, in the span serialization the LLM analytics traces use. */
+var toTrajectoryNdjson = (header, history) => [JSON.stringify({
+	type: "header",
+	...header
+}), ...history.map((message) => JSON.stringify({
+	type: "message",
+	created: message.created,
+	...AiSession.serializeMessage(message)
+}))].join("\n");
+/**
+* Flat properties so every one is a PostHog breakdown; lists are comma-joined for the same reason.
+* `$ai_session_id` joins the event to the conversation's LLM analytics traces.
+*/
+var toStruggleEventProperties = ({ sessionId, model, codeMode, skills, verdict, history, trajectoryKey }) => {
+	const { turn } = splitTurn(history);
+	const { calls, errors } = countToolCalls(turn);
+	return {
+		$ai_session_id: sessionId,
+		model,
+		code_mode: codeMode,
+		skills: skills.join(","),
+		cause: verdict.cause,
+		cause_group: causeGroup(verdict.cause),
+		severity: verdict.severity,
+		summary: verdict.summary,
+		tools: verdict.tools.join(","),
+		turn_message_count: turn.length,
+		turn_tool_call_count: calls,
+		turn_tool_error_count: errors,
+		review_model: REVIEW_MODEL,
+		trajectory_key: trajectoryKey
+	};
+};
+//#endregion
+//#region src/operations/analyze-turn.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/operations/analyze-turn.ts";
+var handler = TurnReviewSkill.AnalyzeTurn.pipe(Operation.withHandler(Effect.fnUntraced(function* () {
+	const settings = Option.getOrUndefined(yield* Capabilities.getAtomValueOption(AssistantCapabilities.Settings));
+	const observability = Option.getOrUndefined(yield* Capability.getOption(ObservabilityCapabilities.Observability));
+	if (!settings?.reportStruggles || !observability?.enabled) return;
+	const chat = yield* Harness$1.getChat;
+	const spaceId = Obj.getDatabase(chat)?.spaceId;
+	if (!spaceId || !contentCaptureAllowed(spaceId)) return;
+	const history = yield* Harness$1.history;
+	if (history.length === 0) return;
+	const { value: verdict } = yield* LanguageModel.generateObject({
+		schema: TurnVerdict,
+		objectName: "turn_verdict",
+		prompt: Prompt.setSystem(Prompt.make(formatReviewPrompt(history)), REVIEW_SYSTEM_PROMPT)
+	}).pipe(Effect.provide(AiService.languageModel(REVIEW_MODEL)));
+	log.info("turn reviewed", {
+		chat: chat.id,
+		struggled: verdict.struggled,
+		cause: verdict.cause
+	}, {
+		"~LogMeta": "~LogMeta",
+		F: __dxlog_file,
+		L: 66,
+		S: this
+	});
+	if (!isReportable(verdict)) return;
+	const binder = yield* Harness$1.binder;
+	const feed = yield* Database.load(chat.feed);
+	const header = {
+		sessionId: Obj.getURI(feed, { prefer: "absolute" }),
+		model: chat.session?.model,
+		codeMode: settings.codeMode ?? false,
+		skills: binder.getSkills().filter((skill) => Obj.getMeta(skill).key !== TurnReviewSkill.key).map((skill) => skill.name),
+		verdict
+	};
+	const trajectoryKey = yield* Effect.promise(() => observability.support.uploadNdjson(toTrajectoryNdjson(header, history), "trajectory"));
+	observability.events.captureEvent(STRUGGLE_EVENT, toStruggleEventProperties({
+		...header,
+		history,
+		trajectoryKey
+	}));
+}, Effect.catchCause((cause) => Effect.sync(() => log.warn("turn review failed", { cause }, {
+	"~LogMeta": "~LogMeta",
+	F: __dxlog_file,
+	L: 91,
+	S: void 0
+}))))));
+//#endregion
+export { handler as default };
+
+//# sourceMappingURL=chunk-analyze-turn.mjs.map

package/dist/lib/chunk-analyze-turn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-analyze-turn.mjs","names":[],"sources":["../../src/review/turn-review.ts","../../src/operations/analyze-turn.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiSession } from '@dxos/assistant';\nimport { type Message } from '@dxos/types';\nimport { trim } from '@dxos/util';\n\n/** PostHog event emitted when the reviewer finds a turn the agent struggled through. */\nexport const STRUGGLE_EVENT = 'agent_struggle';\n\n/** Small enough to be cheap per turn, strong enough to judge an agentic transcript. */\nexport const REVIEW_MODEL = 'com.anthropic.model.claude-sonnet-5.default';\n\n/** Bounds the transcript the reviewer reads; the uploaded trajectory is not cut. */\nconst MAX_TRANSCRIPT_CHARS = 120_000;\nconst MAX_BLOCK_CHARS = 4_000;\n\n/**\n * Why the agent struggled. Only the first four are reported: they are the ones fixable on our side\n * (prompting or tooling); the model's own reasoning and an unclear user request are not.\n */\nexport const StruggleCause = Schema.Literals([\n  'system_prompt_missing',\n  'system_prompt_wrong',\n  'tool_missing',\n  'tool_faulty',\n  'model',\n  'user',\n  'none',\n]);\nexport type StruggleCause = Schema.Schema.Type<typeof StruggleCause>;\n\nexport const TurnVerdict = Schema.Struct({\n  struggled: Schema.Boolean.annotate({\n    description: 'Whether the agent visibly struggled in the latest turn.',\n  }),\n  cause: StruggleCause.annotate({\n    description: 'The root cause of the struggle, or \"none\".',\n  }),\n  severity: Schema.Literals(['low', 'medium', 'high']).annotate({\n    description: 'low: recovered quickly; medium: wasted several steps; high: failed the request.',\n  }),\n  summary: Schema.String.annotate({\n    description: 'One sentence naming what went wrong and what instruction or tool change would fix it.',\n  }),\n  tools: Schema.Array(Schema.String).annotate({\n    description: 'Names of the tools implicated, if any.',\n  }),\n});\nexport type TurnVerdict = Schema.Schema.Type<typeof TurnVerdict>;\n\nexport type CauseGroup = 'system_prompt' | 'tooling';\n\n/** The dashboard's top-level split; `undefined` for a cause that is not reported. */\nexport const causeGroup = (cause: StruggleCause): CauseGroup | undefined => {\n  switch (cause) {\n    case 'system_prompt_missing':\n    case 'system_prompt_wrong':\n      return 'system_prompt';\n    case 'tool_missing':\n    case 'tool_faulty':\n      return 'tooling';\n    default:\n      return undefined;\n  }\n};\n\nexport const isReportable = (verdict: TurnVerdict): boolean =>\n  verdict.struggled && causeGroup(verdict.cause) !== undefined;\n\nexport const REVIEW_SYSTEM_PROMPT = trim`\n  You review transcripts of an AI agent working inside Composer, a collaborative workspace app.\n  Decide whether the agent struggled in the LATEST TURN (messages inside the <latest_turn> tags).\n  Earlier messages are context only.\n\n  Signs of struggling: repeated or looping tool calls, tool errors, calling tools with invalid\n  arguments, guessing at tool names or object ids, apologizing and retrying, giving up, asking the\n  user for information it should have been able to obtain, or giving an incomplete answer.\n\n  Classify the root cause:\n  - system_prompt_missing: the agent lacked instructions or context it needed (e.g. how a feature\n    works, which tool to use for a task, conventions of the app).\n  - system_prompt_wrong: instructions were present but misleading, contradictory, or outdated.\n  - tool_missing: no tool existed for an action the request clearly required.\n  - tool_faulty: a tool errored, returned unusable output, had a confusing schema or description.\n  - model: the tools and instructions were adequate; the model reasoned poorly.\n  - user: the request was ambiguous or impossible.\n  - none: the agent did not struggle.\n\n  Be conservative: a single quickly-recovered tool error is not a struggle. When unsure, answer\n  struggled=false with cause=none.\n`;\n\nconst clip = (text: string, max: number): string =>\n  text.length <= max ? text : `${text.slice(0, max)}… [${text.length - max} chars truncated]`;\n\nconst stringify = (value: unknown): string => (typeof value === 'string' ? value : JSON.stringify(value));\n\n/** One line per block, so the reviewer sees the shape of the turn without a tool result drowning it. */\nconst formatMessage = (message: Message.Message): string => {\n  const lines = message.blocks.map((block) => {\n    switch (block._tag) {\n      case 'text':\n        return clip(block.text, MAX_BLOCK_CHARS);\n      case 'toolCall':\n        return `[tool call ${block.name}] ${clip(stringify(block.input), MAX_BLOCK_CHARS)}`;\n      case 'toolResult':\n        return block.error\n          ? `[tool error ${block.name}] ${clip(stringify(block.error), MAX_BLOCK_CHARS)}`\n          : `[tool result ${block.name}] ${clip(stringify(block.result), MAX_BLOCK_CHARS)}`;\n      default:\n        return `[${block._tag}]`;\n    }\n  });\n  return `${(message.sender.role ?? 'unknown').toUpperCase()}:\\n${lines.join('\\n')}`;\n};\n\n/**\n * Splits the history at the turn that just ended: it starts at the last user message, which is what\n * the agent was answering. Hooks fire per request, so everything after it is this turn's work.\n */\nexport const splitTurn = (history: readonly Message.Message[]) => {\n  const index = history.findLastIndex((message) => message.sender.role === 'user');\n  return index === -1\n    ? { context: [] as readonly Message.Message[], turn: history }\n    : { context: history.slice(0, index), turn: history.slice(index) };\n};\n\n/** The reviewer's prompt; context is trimmed from the front when the transcript runs long. */\nexport const formatReviewPrompt = (history: readonly Message.Message[]): string => {\n  const { context, turn } = splitTurn(history);\n  const turnText = turn.map(formatMessage).join('\\n\\n');\n  const budget = Math.max(0, MAX_TRANSCRIPT_CHARS - turnText.length);\n  const contextText = context.map(formatMessage).join('\\n\\n');\n  const clippedContext =\n    contextText.length > budget ? `…${contextText.slice(contextText.length - budget)}` : contextText;\n  return [clippedContext, '<latest_turn>', clip(turnText, MAX_TRANSCRIPT_CHARS), '</latest_turn>']\n    .filter((part) => part.length > 0)\n    .join('\\n\\n');\n};\n\nexport const countToolCalls = (messages: readonly Message.Message[]) => {\n  let calls = 0;\n  let errors = 0;\n  for (const message of messages) {\n    for (const block of message.blocks) {\n      if (block._tag === 'toolCall') {\n        calls++;\n      } else if (block._tag === 'toolResult' && block.error) {\n        errors++;\n      }\n    }\n  }\n  return { calls, errors };\n};\n\nexport type TrajectoryHeader = {\n  sessionId: string;\n  model?: string;\n  codeMode: boolean;\n  skills: readonly string[];\n  verdict: TurnVerdict;\n};\n\n/** A header line then one line per message, in the span serialization the LLM analytics traces use. */\nexport const toTrajectoryNdjson = (header: TrajectoryHeader, history: readonly Message.Message[]): string =>\n  [\n    JSON.stringify({ type: 'header', ...header }),\n    ...history.map((message) =>\n      JSON.stringify({ type: 'message', created: message.created, ...(AiSession.serializeMessage(message) as object) }),\n    ),\n  ].join('\\n');\n\nexport type StruggleEventInput = TrajectoryHeader & {\n  history: readonly Message.Message[];\n  trajectoryKey?: string;\n};\n\n/**\n * Flat properties so every one is a PostHog breakdown; lists are comma-joined for the same reason.\n * `$ai_session_id` joins the event to the conversation's LLM analytics traces.\n */\nexport const toStruggleEventProperties = ({\n  sessionId,\n  model,\n  codeMode,\n  skills,\n  verdict,\n  history,\n  trajectoryKey,\n}: StruggleEventInput): Record<string, unknown> => {\n  const { turn } = splitTurn(history);\n  const { calls, errors } = countToolCalls(turn);\n  return {\n    $ai_session_id: sessionId,\n    model,\n    code_mode: codeMode,\n    skills: skills.join(','),\n    cause: verdict.cause,\n    cause_group: causeGroup(verdict.cause),\n    severity: verdict.severity,\n    summary: verdict.summary,\n    tools: verdict.tools.join(','),\n    turn_message_count: turn.length,\n    turn_tool_call_count: calls,\n    turn_tool_error_count: errors,\n    review_model: REVIEW_MODEL,\n    trajectory_key: trajectoryKey,\n  };\n};\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as LanguageModel from 'effect/ai/LanguageModel';\nimport * as Prompt from 'effect/ai/Prompt';\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { AiService } from '@dxos/ai';\nimport * as Capabilities from '@dxos/app-framework/Capabilities';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as Harness from '@dxos/assistant/Harness';\nimport * as Operation from '@dxos/compute/Operation';\nimport { Database, Obj } from '@dxos/echo';\nimport { log } from '@dxos/log';\nimport { contentCaptureAllowed } from '@dxos/observability/AiObservability';\nimport * as ObservabilityCapabilities from '@dxos/plugin-observability/ObservabilityCapabilities';\n\nimport { TurnReviewSkill } from '#skills';\nimport { AssistantCapabilities } from '#types';\n\nimport {\n  REVIEW_MODEL,\n  REVIEW_SYSTEM_PROMPT,\n  STRUGGLE_EVENT,\n  type TrajectoryHeader,\n  TurnVerdict,\n  formatReviewPrompt,\n  isReportable,\n  toStruggleEventProperties,\n  toTrajectoryNdjson,\n} from '../review/turn-review.ts';\n\n// Never fails: it runs as a background hook after the user's turn, so a review that cannot complete\n// is only logged.\nconst handler: Operation.WithHandler<typeof TurnReviewSkill.AnalyzeTurn> = TurnReviewSkill.AnalyzeTurn.pipe(\n  Operation.withHandler(\n    Effect.fnUntraced(\n      function* () {\n        const settings = Option.getOrUndefined(yield* Capabilities.getAtomValueOption(AssistantCapabilities.Settings));\n        const observability = Option.getOrUndefined(\n          yield* Capability.getOption(ObservabilityCapabilities.Observability),\n        );\n        // Both opt-ins are re-read here: the skill stays bound to a chat after the user opts out.\n        if (!settings?.reportStruggles || !observability?.enabled) {\n          return;\n        }\n\n        const chat = yield* Harness.getChat;\n        const spaceId = Obj.getDatabase(chat)?.spaceId;\n        if (!spaceId || !contentCaptureAllowed(spaceId)) {\n          return;\n        }\n\n        const history = yield* Harness.history;\n        if (history.length === 0) {\n          return;\n        }\n\n        const { value: verdict } = yield* LanguageModel.generateObject({\n          schema: TurnVerdict,\n          objectName: 'turn_verdict',\n          prompt: Prompt.setSystem(Prompt.make(formatReviewPrompt(history)), REVIEW_SYSTEM_PROMPT),\n        }).pipe(Effect.provide(AiService.languageModel(REVIEW_MODEL)));\n        log.info('turn reviewed', { chat: chat.id, struggled: verdict.struggled, cause: verdict.cause });\n        if (!isReportable(verdict)) {\n          return;\n        }\n\n        const binder = yield* Harness.binder;\n        const feed = yield* Database.load(chat.feed);\n        const header: TrajectoryHeader = {\n          sessionId: Obj.getURI(feed, { prefer: 'absolute' }),\n          model: chat.session?.model,\n          codeMode: settings.codeMode ?? false,\n          skills: binder\n            .getSkills()\n            .filter((skill) => Obj.getMeta(skill).key !== TurnReviewSkill.key)\n            .map((skill) => skill.name),\n          verdict,\n        };\n        const trajectoryKey = yield* Effect.promise(() =>\n          observability.support.uploadNdjson(toTrajectoryNdjson(header, history), 'trajectory'),\n        );\n        observability.events.captureEvent(\n          STRUGGLE_EVENT,\n          toStruggleEventProperties({ ...header, history, trajectoryKey }),\n        );\n      },\n      Effect.catchCause((cause) => Effect.sync(() => log.warn('turn review failed', { cause }))),\n    ),\n  ),\n);\n\nexport default handler;\n"],"mappings":"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"}

package/dist/lib/{chunk-processor.mjs → chunk-chat-model.mjs}

@@ -2,7 +2,7 @@ import { a as providerForModel } from "./chunk-presets.mjs";
 import { AssistantOperation } from "#types";
 import * as Option from "effect/Option";
 import * as Atom from "effect/reactivity/Atom";
-import { Annotation, Database, Feed, Filter, Obj, Query } from "@dxos/echo";
+import { Annotation, Database, Feed, Filter, Obj, Query, Ref } from "@dxos/echo";
 import { AiModelNotAvailableError, Model } from "@dxos/ai";
 import { Harness, ToolExecutionServices, createSystemPrompt, formatSystemPrompt, isConsumed, isInFlight, isQueued } from "@dxos/assistant";
 import { log } from "@dxos/log";
@@ -16,16 +16,19 @@ import * as Exit from "effect/Exit";
 import * as Fiber from "effect/Fiber";
 import * as AtomRegistry from "effect/reactivity/AtomRegistry";
 import * as Stream from "effect/Stream";
+import * as Agent from "@dxos/assistant/Agent";
 import * as AgentService from "@dxos/compute/AgentService";
 import * as Operation from "@dxos/compute/Operation";
+import * as Skill from "@dxos/compute/Skill";
 import * as Trace from "@dxos/compute/Trace";
 import { UsageQuotaExceededError } from "@dxos/edge-client";
 import * as EffectEx from "@dxos/effect/EffectEx";
+import { TurnReviewSkill } from "#skills";
 import * as Array from "effect/Array";
 import * as Order$1 from "effect/Order";
 import { DeliveryAnnotation } from "@dxos/react-ui-assistant/types";
-//#region src/processor/outbox.ts
-var __dxlog_file$1 = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/processor/outbox.ts";
+//#region src/chat-model/outbox.ts
+var __dxlog_file$1 = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/chat-model/outbox.ts";
 /** A dispatch stopped before the prompt reached the agent, by the reader: the prompt is dropped, not failed. */
 var PromptCancelledError = class extends BaseError.extend("PromptCancelledError", "Prompt cancelled before it was sent.") {};
 /**
@@ -117,7 +120,7 @@ var findInCause = (error, predicate) => {
 	}
 };
 //#endregion
-//#region src/processor/prompt.ts
+//#region src/chat-model/prompt.ts
 /**
 * Prompt content for a request: the bare message, or — when the request carries selection context —
 * a synthetic block (system-generated user-turn content, hidden from the summary view) ahead of it.
@@ -142,7 +145,7 @@ var createPromptContent = (request) => {
 	}), ContentBlock.Text.make({ text: request.message })];
 };
 //#endregion
-//#region src/processor/thread.ts
+//#region src/chat-model/thread.ts
 /**
 * Append order for {@link Feed.history}, which walks lineage positionally rather than by time.
 *
@@ -373,8 +376,8 @@ var resolveRewind = (messages, messageId) => {
 	};
 };
 //#endregion
-//#region src/processor/processor.ts
-var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/processor/processor.ts";
+//#region src/chat-model/chat-model.ts
+var __dxlog_file = "/__w/dxos/dxos/packages/plugins/plugin-assistant/src/chat-model/chat-model.ts";
 var defaultOptions = { model: Model.DEFAULT_EDGE };
 /** User-facing message shown when an AI request is rejected for exceeding the account usage quota (HTTP 429). */
 var QUOTA_EXCEEDED_MESSAGE = "You have reached your AI usage limit for this period.";
@@ -410,6 +413,20 @@ var describeAiError = (err) => ("description" in err.reason ? err.reason.descrip
 * which drops nested causes — so detection also reads the message it stringifies to.
 */
 var MODEL_UNAVAILABLE_PATTERN = /AI Model not available:\s*(\S+?):?(?=\s|$)/i;
+/**
+* Matches the first line of a stringified {@link AiError.AiError} ("…AiError: Module.method: detail"), the
+* form a provider failure takes once it has crossed the agent-process boundary.
+*/
+var AI_ERROR_PATTERN = /AiError: [\w$.]+: ([^\n]+)/;
+/** The provider's own description of a failure that arrived stringified, anywhere in the cause chain. */
+var stringifiedAiErrorText = (err) => {
+	const visited = /* @__PURE__ */ new Set();
+	for (let current = err; current && !visited.has(current); current = current instanceof Error ? current.cause : void 0) {
+		visited.add(current);
+		const detail = (typeof current === "string" ? current : current instanceof Error ? current.message : "").match(AI_ERROR_PATTERN)?.[1]?.trim();
+		if (detail) return detail;
+	}
+};
 /** The displayable text of a failure, which reaches the chat either typed or already stringified. */
 var errorText = (err) => typeof err === "string" ? err : err instanceof Error ? err.message : "";
 /** The model of a model-unavailable rejection, by typed context or message text. */
@@ -441,6 +458,7 @@ var parseError = (err) => {
 		const [, model] = err.match(/model\s+'([^']+)'\s+not\s+found/i) || [];
 		if (model) message = `The model is not available: ${model}`;
 	}
+	if (!message) message = stringifiedAiErrorText(err);
 	if (!message) message = "An unexpected error occurred.";
 	return new Error(message, { cause: err });
 };
@@ -448,7 +466,7 @@ var parseError = (err) => {
 * Handles interactions with the AI service.
 * Uses AgentService to spawn a process-backed agent and subscribes to ephemeral trace events for streaming.
 */
-var AiChatProcessor = class {
+var ChatModel = class {
 	_conversation;
 	_runtime;
 	_feed;
@@ -461,9 +479,12 @@ var AiChatProcessor = class {
 	#streaming = Atom.make([]);
 	/** Set of message IDs that have been finalized (non-pending delivered via ephemeral). */
 	#finalizedIds = /* @__PURE__ */ new Set();
+	/** Timestamp of the newest trace event applied this turn, overall and per streamed message. */
+	#appliedAt = 0;
+	#appliedAtByMessage = /* @__PURE__ */ new Map();
 	/** Currently active request fiber. */
 	#requestFiber;
-	/** Fiber following a turn this processor did not issue ({@link adopt}). */
+	/** Fiber following a turn this chat model did not issue ({@link adopt}). */
 	#observeFiber;
 	/** Last request (for retries). */
 	#lastRequest;
@@ -625,6 +646,7 @@ var AiChatProcessor = class {
 			this.#registry.set(this.mcpErrors, []);
 			this.#registry.set(this.activity, { phase: "starting" });
 			this.#registry.set(this.active, true);
+			await this.#ensureTurnReview();
 			const effect = Effect.gen({ self: this }, function* () {
 				log.info("init agent session", {
 					feed: Obj.getURI(this._feed),
@@ -633,25 +655,25 @@ var AiChatProcessor = class {
 				}, {
 					"~LogMeta": "~LogMeta",
 					F: __dxlog_file,
-					L: 439,
+					L: 478,
 					S: this
 				});
 				const session = yield* this.#getSession();
 				markWork("chat.session-ready");
-				yield* this.#forkEphemeralCollector(session);
-				log("chat processor submitting prompt", { length: requestProp.message.length }, {
+				yield* this.#forkEphemeralCollector(session, { replay: false });
+				log("chat model submitting prompt", { length: requestProp.message.length }, {
 					"~LogMeta": "~LogMeta",
 					F: __dxlog_file,
-					L: 448,
+					L: 489,
 					S: this
 				});
 				yield* session.submitPrompt(createPromptContent(requestProp), { sender: this._options.sender });
 				markWork("chat.prompt-submitted");
 				submission?.resolve();
-				log("chat processor submitPrompt returned, waiting for agent", {}, {
+				log("chat model submitPrompt returned, waiting for agent", {}, {
 					"~LogMeta": "~LogMeta",
 					F: __dxlog_file,
-					L: 452,
+					L: 493,
 					S: this
 				});
 				if (!this._options.chat?.target?.name && requestProp.disposition !== "synthetic") yield* this.#updateChatName(requestProp.message);
@@ -659,7 +681,7 @@ var AiChatProcessor = class {
 				log.info("session complete", void 0, {
 					"~LogMeta": "~LogMeta",
 					F: __dxlog_file,
-					L: 462,
+					L: 503,
 					S: this
 				});
 				this.#flushStreaming();
@@ -681,7 +703,7 @@ var AiChatProcessor = class {
 			log.error("request failed", { error: err }, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 489,
+				L: 530,
 				S: this
 			});
 			submission?.reject(err);
@@ -690,7 +712,7 @@ var AiChatProcessor = class {
 			log.info("setting active to false", void 0, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 494,
+				L: 535,
 				S: this
 			});
 			this.#registry.set(this.active, false);
@@ -714,7 +736,7 @@ var AiChatProcessor = class {
 			log.error("enqueue failed", { error: err }, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 514,
+				L: 555,
 				S: this
 			});
 			this.#registry.set(this.error, Option.some(parseError(err)));
@@ -727,8 +749,8 @@ var AiChatProcessor = class {
 		}).pipe(Effect.provide(this._spaceLayer)));
 	}
 	/**
-	* Mirrors turns this processor did not initiate into its own state: active/streaming state is
-	* per-processor ({@link useChatProcessor} builds one per mount) while the agent process outlives
+	* Mirrors turns this chat model did not initiate into its own state: active/streaming state is
+	* per-chat model ({@link useChatModel} builds one per mount) while the agent process outlives
 	* the mount, so a chat remounted mid-turn would otherwise render as idle.
 	*
 	* Returns a disposer that stops observing.
@@ -744,7 +766,7 @@ var AiChatProcessor = class {
 		}).catch((err) => log.warn("failed to attach to agent session", { error: err }, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 557,
+			L: 598,
 			S: this
 		}));
 		return () => {
@@ -759,20 +781,21 @@ var AiChatProcessor = class {
 	}
 	/**
 	* Follows a turn started elsewhere to completion, surfacing its streamed blocks here.
-	* A turn this processor issued is owned by {@link request}, which reports its own errors.
+	* A turn this chat model issued is owned by {@link request}, which reports its own errors.
 	*/
 	async #observe(session) {
 		if (this.#requestFiber || this.#observeFiber || this.#registry.get(this.active)) return;
 		log.info("observing agent turn", { feed: Obj.getURI(this._feed) }, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 581,
+			L: 622,
 			S: this
 		});
 		try {
+			this.#registry.set(this.activity, { phase: "starting" });
 			this.#registry.set(this.active, true);
 			const effect = Effect.gen({ self: this }, function* () {
-				yield* this.#forkEphemeralCollector(session);
+				yield* this.#forkEphemeralCollector(session, { replay: true });
 				yield* session.waitForCompletion();
 				this.#flushStreaming();
 			});
@@ -783,7 +806,7 @@ var AiChatProcessor = class {
 			log.warn("failed to observe agent turn", { error: err }, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 599,
+				L: 643,
 				S: this
 			});
 		} finally {
@@ -799,7 +822,7 @@ var AiChatProcessor = class {
 	#getSession() {
 		return Effect.gen({ self: this }, function* () {
 			const chat = this._options.chat?.target;
-			if (!chat) return yield* Effect.die(/* @__PURE__ */ new Error("Chat processor requires a chat."));
+			if (!chat) return yield* Effect.die(/* @__PURE__ */ new Error("Chat model requires a chat."));
 			const selected = this._options.model;
 			if (!chat.session?.model && selected) Obj.update(chat, (chat) => {
 				chat.session = {
@@ -810,7 +833,7 @@ var AiChatProcessor = class {
 			const model = chat.session?.model ?? selected;
 			return yield* AgentService.getSession(chat, {
 				provider: model ? providerForModel(model, this._options.provider) : this._options.provider,
-				location: chat.remote ? "edge" : "local"
+				location: Agent.chatLocation(chat)
 			});
 		});
 	}
@@ -818,11 +841,16 @@ var AiChatProcessor = class {
 	* Forks the collector for the session's ephemeral trace events (streaming blocks and MCP
 	* failures) as a child of the calling fiber.
 	*/
-	#forkEphemeralCollector(session) {
-		return session.subscribeEphemeral().pipe(Stream.runForEach((message) => Effect.sync(() => {
-			for (const event of message.events) if (Trace.isOfType(Trace.PartialBlock, event)) this.#handleEphemeralMessage(event.data);
-			else if (Trace.isOfType(Trace.RequestPhase, event)) this.#registry.set(this.activity, event.data);
-			else if (Trace.isOfType(Trace.McpServerError, event)) this.#handleMcpError(event.data);
+	#forkEphemeralCollector(session, options) {
+		return session.subscribeEphemeral(options).pipe(Stream.runForEach((message) => Effect.sync(() => {
+			for (const event of message.events) if (Trace.isOfType(Trace.PartialBlock, event)) {
+				const current = event.timestamp >= this.#appliedAt;
+				if (this.#isStale(event.timestamp, event.data.messageId)) continue;
+				this.#handleEphemeralMessage(event.data, current);
+			} else if (Trace.isOfType(Trace.RequestPhase, event)) {
+				if (this.#isStale(event.timestamp)) continue;
+				this.#registry.set(this.activity, event.data);
+			} else if (Trace.isOfType(Trace.McpServerError, event)) this.#handleMcpError(event.data);
 		})), Effect.forkChild, Effect.asVoid);
 	}
 	/**
@@ -833,7 +861,7 @@ var AiChatProcessor = class {
 			log.info("cancelling request", { fiber: this.#requestFiber }, {
 				"~LogMeta": "~LogMeta",
 				F: __dxlog_file,
-				L: 665,
+				L: 723,
 				S: this
 			});
 			if (this.#requestFiber) yield* Fiber.interrupt(this.#requestFiber);
@@ -864,13 +892,23 @@ var AiChatProcessor = class {
 		EffectEx.unwrapExit(await this._runtime.runPromiseExit(Operation.invoke(AssistantOperation.UpdateChatName, { chat }, { spaceId }).pipe(Effect.provide(this._spaceLayer))));
 	}
 	/**
+	* Whether a trace event is older than one already applied (per message for a streamed block, whose
+	* text is the whole reply so far), recording it as the newest when it is not.
+	*/
+	#isStale(timestamp, messageId) {
+		if (timestamp < (messageId === void 0 ? this.#appliedAt : this.#appliedAtByMessage.get(messageId) ?? 0)) return true;
+		this.#appliedAt = Math.max(this.#appliedAt, timestamp);
+		if (messageId !== void 0) this.#appliedAtByMessage.set(messageId, timestamp);
+		return false;
+	}
+	/**
 	* Handles an ephemeral message from the agent process.
 	* Both pending and completed blocks arrive here. Completed blocks are deduped
 	* against messages already written to the feed queue to handle the race between
 	* ephemeral delivery and feed replication.
 	*/
-	#handleEphemeralMessage(event) {
-		this.#registry.set(this.activity, { phase: "generating" });
+	#handleEphemeralMessage(event, current = true) {
+		if (current) this.#registry.set(this.activity, { phase: "generating" });
 		const isPending = event.block.pending;
 		const message = Obj.make(Message.Message, {
 			id: event.messageId,
@@ -906,7 +944,7 @@ var AiChatProcessor = class {
 		log.warn("MCP server error", event, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 765,
+			L: 841,
 			S: this
 		});
 		this.#registry.update(this.mcpErrors, (errors) => {
@@ -921,18 +959,32 @@ var AiChatProcessor = class {
 		this.#registry.set(this.#streaming, []);
 		this.#registry.set(this.activity, void 0);
 		this.#finalizedIds.clear();
+		this.#resetApplied();
 	}
 	/**
 	* Move remaining streaming messages to pending (called when agent completes).
 	*/
 	#flushStreaming() {
-		this.#registry.set(this.activity, void 0);
 		const remaining = this.#registry.get(this.#streaming);
 		if (remaining.length > 0) {
 			this.#registry.update(this.#pending, (pending) => [...pending, ...remaining]);
 			this.#registry.set(this.#streaming, []);
 		}
 		this.#finalizedIds.clear();
+		this.#resetApplied();
+	}
+	#resetApplied() {
+		this.#appliedAt = 0;
+		this.#appliedAtByMessage.clear();
+	}
+	/**
+	* Binds the turn-review skill before a request while the user is opted in; its background
+	* end-request hook does the review, so nothing here waits on it. Left bound after an opt-out,
+	* since the hook re-checks the setting.
+	*/
+	async #ensureTurnReview() {
+		if (!this._options.reportStruggles) return;
+		if (!this.context.getSkills().some((skill) => Obj.getMeta(skill).key === TurnReviewSkill.key)) await this.context.bind({ skills: [Ref.fromURI(Skill.registryURI(TurnReviewSkill.key))] });
 	}
 	/**
 	* Schedule a chat name update as a detached (fire-and-forget) operation.
@@ -946,7 +998,7 @@ var AiChatProcessor = class {
 		log.info("scheduling chat name update", void 0, {
 			"~LogMeta": "~LogMeta",
 			F: __dxlog_file,
-			L: 811,
+			L: 910,
 			S: this
 		});
 		return Operation.schedule(AssistantOperation.UpdateChatName, {
@@ -955,7 +1007,7 @@ var AiChatProcessor = class {
 		}, { spaceId });
 	}
 };
-var idleProcessorState = {
+var idleChatModelState = {
 	streaming: Atom.make(false),
 	active: Atom.make(false),
 	thread: Atom.make(EMPTY_THREAD),
@@ -963,8 +1015,8 @@ var idleProcessorState = {
 	mcpErrors: Atom.make([]),
 	activity: Atom.make(void 0)
 };
-var getProcessorState = (processor) => processor ?? idleProcessorState;
+var getChatModelState = (chatModel) => chatModel ?? idleChatModelState;
 //#endregion
-export { projectSelfWakes as a, projectAlarms as i, AiUsageQuotaError as n, resolveRewind as o, getProcessorState as r, AiChatProcessor as t };
+export { projectSelfWakes as a, projectAlarms as i, ChatModel as n, resolveRewind as o, getChatModelState as r, AiUsageQuotaError as t };
 
-//# sourceMappingURL=chunk-processor.mjs.map
+//# sourceMappingURL=chunk-chat-model.mjs.map