@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.12

package/packages/agentsam-queue-control/test/sqlite-adapter.test.mjs

@@ -0,0 +1,91 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { createLocalSqliteDatabase } from '../../../src/local/sqlite.js';
+import { applyRuntimeMigrations } from '../../../src/local/migrations.js';
+import {
+  SqliteQueueAdapter,
+  QueueControl,
+  buildQueueTopology,
+  createJobEnvelope,
+} from '../src/index.js';
+
+async function fixture() {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-queue-sqlite-'));
+  const db = await createLocalSqliteDatabase(path.join(dir, 'agentsam.sqlite'));
+  await applyRuntimeMigrations(db);
+  return { dir, db, close: () => db.close() };
+}
+
+test('SQLite adapter persists delayed work and leases due jobs without polling models', async (t) => {
+  const fx = await fixture();
+  t.after(fx.close);
+  const topology = buildQueueTopology({ namespace: 'test', environment: 'local' });
+  const adapter = new SqliteQueueAdapter({ database: fx.db, leaseOwner: 'worker-a', leaseTtlSeconds: 30 });
+  const control = new QueueControl({ adapter, topology });
+
+  const enqueued = await control.enqueue(
+    { kind: 'repository.index', account_id: 'acct_1' },
+    {
+      account_id: 'acct_1',
+      id: 'job_delayed',
+      available_at: 120,
+      created_at: 100,
+      idempotency_key: 'idx:repo:a',
+    },
+  );
+  const queue = enqueued.plan.physical_queue;
+
+  assert.equal(await adapter.depth(queue), 1);
+  assert.deepEqual(await adapter.pull(queue, 1, { now: 119 }), []);
+
+  const first = await adapter.pull(queue, 1, { now: 120, owner: 'worker-a', ttl_seconds: 30 });
+  assert.equal(first.length, 1);
+  assert.equal(first[0].status, 'claimed');
+  assert.equal(first[0].lease_owner, 'worker-a');
+  assert.equal(first[0].lease_expires_at, 150);
+  assert.equal(first[0].lease_generation, 1);
+
+  assert.deepEqual(await adapter.pull(queue, 1, { now: 149, owner: 'worker-b' }), []);
+
+  const reclaimed = await adapter.pull(queue, 1, { now: 150, owner: 'worker-b', ttl_seconds: 20 });
+  assert.equal(reclaimed.length, 1);
+  assert.equal(reclaimed[0].lease_owner, 'worker-b');
+  assert.equal(reclaimed[0].lease_generation, 2);
+
+  const ack = await adapter.ack(reclaimed[0], { status: 'completed', result: { indexed: 3 }, now: 151 });
+  assert.equal(ack.updated, 1);
+  assert.equal(await adapter.depth(queue), 0);
+  assert.equal((await adapter.get('job_delayed')).status, 'completed');
+});
+
+test('SQLite adapter deduplicates stable idempotency keys across repeated enqueue attempts', async (t) => {
+  const fx = await fixture();
+  t.after(fx.close);
+  const adapter = new SqliteQueueAdapter({ database: fx.db });
+  const queue = 'agentsam-local-jobs';
+
+  const first = createJobEnvelope({
+    id: 'job_a',
+    account_id: 'acct_1',
+    kind: 'deployment.poll',
+    idempotency_key: 'deploy:123',
+    created_at: 10,
+  });
+  const duplicate = createJobEnvelope({
+    id: 'job_b',
+    account_id: 'acct_1',
+    kind: 'deployment.poll',
+    idempotency_key: 'deploy:123',
+    created_at: 11,
+  });
+
+  assert.equal((await adapter.publish(queue, first)).accepted, 1);
+  const second = await adapter.publish(queue, duplicate);
+  assert.equal(second.accepted, 0);
+  assert.equal(second.deduplicated, true);
+  assert.equal(second.existing_job_id, 'job_a');
+  assert.equal(await adapter.depth(queue), 1);
+});

package/packages/agentsam-rapid-rust/README.md

@@ -3,3 +3,6 @@
 Native Rust CLI source for `agentsam rust` / `agentsam-rapid-rust`.
 
 It scaffolds Cloudflare `workers-rs` projects, performs local Wasm checks/builds, runs Wrangler locally, and gates live deployment behind an explicit `--yes`. Compiled binaries are not committed; use `scripts/build_rapid_rust_cli.py` to build/install one.
+
+<!-- agentsam:trademark-notice -->
+> Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).

package/packages/agentsam-repository/README.md

@@ -13,3 +13,6 @@ It owns deterministic repository identity and Merkle behavior that must be reusa
 It does **not** own authenticated account sessions, CLI commands, UI rendering, knowledge retrieval, deployment orchestration, or product application state. Those layers consume this package through explicit imports.
 
 The workspace is private while the extraction stabilizes. Cross-repository consumers should continue using the published `@inneranimalmedia/agentsam-sdk` facade until this package receives its own release policy.
+
+<!-- agentsam:trademark-notice -->
+> Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).

package/packages/agentsam-repository/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-repository",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Portable AgentSam repository identity, Merkle, semantic file metadata, persistence, and repository graph runtime contracts.",
   "type": "module",
   "main": "./src/index.js",

package/packages/agentsam-vault/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-vault",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "type": "module",
   "description": "AgentSam credential vault core — contracts, AES-GCM crypto, provider registry, resolver. UI lives in agentsam-key-manager.",
   "main": "./src/index.js",

package/packages/agentsam-workbench/README.md

@@ -22,3 +22,46 @@ values are withheld. Cross-origin and sandboxed iframe contents are not inspecte
 their host frame may be selected as a contextual resource. Mark semantic ancestors
 with `data-agentsam-resource` and excluded controls with `data-annotation-control`.
 Local Studio stages the annotation in its active conversation draft for review.
+
+
+## Conversation and runtime surfaces
+
+`AgentConversationSurface` is the portable thread + persistent-composer ownership
+boundary. Product apps provide state and actions; the surface guarantees that
+moving between an empty conversation and an active thread does not replace the
+composer DOM ownership.
+
+`AgentRuntimeField` projects `@inneranimalmedia/agentsam-loading-scene` into the
+same surface. A lead thread and each co-worker may bind separate controllers, so
+parallel work can show independent semantic scenes and task narration without
+duplicating renderer code in product apps.
+
+```tsx
+<AgentConversationSurface
+  empty={messages.length === 0}
+  runtime={<AgentRuntimeField controller={runtimeController} />}
+  thread={<AgentThread messages={messages} />}
+  composer={<AgentComposer {...composerProps} />}
+/>
+```
+
+The workbench owns presentation mechanics. The host still owns model/provider
+selection, tool execution, persistence, permissions, runtime events, queueing and
+cancel semantics.
+
+## Widgets
+
+`@inneranimalmedia/agentsam-workbench/widgets` is the shared widget surface:
+`WidgetFrame` (size/state chrome around any widget body), `useCountdown`, and
+`CountdownWidget`. Widget identity — kind, sizes, data source, deep link — comes
+from the framework-neutral contracts in `@inneranimalmedia/agentsam-contracts/widgets`.
+
+Countdown time authority is an absolute deadline, not accumulated interval
+ticks: remaining time is derived from `Date.now()` on every render tick, so a
+sleeping or backgrounded tab cannot corrupt the timer. Import
+`@inneranimalmedia/agentsam-workbench/widgets/widgets.css` once in the host;
+the widget tokens inherit the host theme.
+
+Widgets are app-native primitives, not installable prebuilds — the host decides
+where a widget appears and what its data means. Local Studio's `/widgets`
+utilities surface is the proof consumer.

package/packages/agentsam-workbench/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-workbench",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Reusable AgentSam workbench primitives for agent threads, composer, browser, terminal and resizable work surfaces.",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,16 +36,27 @@
     "./agent/mini-agentsam.css": "./dist/agent/mini-agentsam.css",
     "./agent/contextual-composer.css": "./dist/agent/contextual-composer.css",
     "./agent/tool-permission.css": "./dist/agent/tool-permission.css",
-    "./project-control.css": "./dist/project-control.css"
+    "./project-control.css": "./dist/project-control.css",
+    "./manufacturing": {
+      "types": "./dist/manufacturing/index.d.ts",
+      "import": "./dist/manufacturing/index.js"
+    },
+    "./widgets": {
+      "types": "./dist/widgets/index.d.ts",
+      "import": "./dist/widgets/index.js"
+    },
+    "./widgets/widgets.css": "./dist/widgets/widgets.css"
   },
   "scripts": {
     "typecheck": "node scripts/ensure-local-deps.mjs && tsc --noEmit -p tsconfig.json",
-    "test": "node --test test/*.test.mjs",
+    "test": "npm run build && node --test test/*.test.mjs",
     "build": "node scripts/build.mjs",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@inneranimalmedia/agentsam-contracts": "2.6.10"
+    "@inneranimalmedia/agentsam-contracts": "2.6.12",
+    "@inneranimalmedia/agentsam-loading-scene": "2.6.12",
+    "lucide-react": "^0.510.0"
   },
   "peerDependencies": {
     "react": ">=18",

package/packages/agentsam-workbench/src/agent/AgentConversationSurface.tsx

@@ -0,0 +1,108 @@
+import type { CSSProperties, ReactNode } from 'react';
+
+export type AgentConversationSurfaceProps = {
+  empty?: boolean;
+  thread: ReactNode;
+  composer: ReactNode;
+  emptyState?: ReactNode;
+  runtime?: ReactNode;
+  status?: ReactNode;
+  className?: string;
+  bodyClassName?: string;
+  composerClassName?: string;
+  style?: CSSProperties;
+};
+
+/**
+ * Portable thread + persistent composer surface.
+ *
+ * The composer slot is never conditionally removed when a conversation moves
+ * from empty/startup to active. Hosts can restyle the surface, but the DOM
+ * ownership contract remains stable across web/desktop/product adapters.
+ */
+export function AgentConversationSurface({
+  empty = false,
+  thread,
+  composer,
+  emptyState,
+  runtime,
+  status,
+  className,
+  bodyClassName,
+  composerClassName,
+  style,
+}: AgentConversationSurfaceProps) {
+  return (
+    <section
+      className={className}
+      data-agent-conversation-surface=""
+      data-agent-conversation-empty={empty ? 'true' : 'false'}
+      style={{
+        position: 'relative',
+        display: 'flex',
+        minWidth: 0,
+        minHeight: 0,
+        flex: 1,
+        flexDirection: 'column',
+        overflow: 'hidden',
+        ...style,
+      }}
+    >
+      {runtime}
+
+      <div
+        className={bodyClassName}
+        data-agent-conversation-body=""
+        data-agent-conversation-body-empty={empty ? 'true' : 'false'}
+        style={{
+          display: 'flex',
+          minWidth: 0,
+          minHeight: 0,
+          flex: '1 1 auto',
+          flexDirection: 'column',
+          overflow: 'hidden',
+        }}
+      >
+        {empty ? (
+          emptyState ? (
+            <div
+              data-agent-conversation-empty-state=""
+              style={{
+                display: 'flex',
+                minWidth: 0,
+                minHeight: 0,
+                flex: '1 1 auto',
+                alignItems: 'center',
+                justifyContent: 'center',
+              }}
+            >
+              {emptyState}
+            </div>
+          ) : null
+        ) : (
+          thread
+        )}
+      </div>
+
+      {status ? (
+        <div data-agent-conversation-status="" style={{ flexShrink: 0 }}>
+          {status}
+        </div>
+      ) : null}
+
+      <div
+        className={composerClassName}
+        data-agent-conversation-composer=""
+        style={{
+          position: 'relative',
+          zIndex: 2,
+          width: '100%',
+          flexShrink: 0,
+        }}
+      >
+        {composer}
+      </div>
+
+    </section>
+  );
+}

package/packages/agentsam-workbench/src/agent/AgentPanel.tsx

@@ -3,6 +3,7 @@ import type { AgentMessage, ModelOption } from '@inneranimalmedia/agentsam-contr
 import { AgentThread } from './Thread';
 import { AgentComposer } from './Composer';
 import { AgentModelSelect } from './ModelSelect';
+import { AgentConversationSurface } from './AgentConversationSurface';
 
 export interface AgentPanelProps {
   messages: AgentMessage[];
@@ -24,17 +25,33 @@ export function AgentPanel(props: AgentPanelProps) {
   const modelControl = props.models?.length && props.selectedModelId && props.onModelChange
     ? <AgentModelSelect value={props.selectedModelId} models={props.models} onChange={props.onModelChange} />
     : null;
+  const thread = (
+    <AgentThread
+      messages={props.messages}
+      streaming={props.streaming}
+      renderMessage={props.renderMessage}
+      empty={props.empty}
+    />
+  );
+  const composer = (
+    <AgentComposer
+      value={props.draft}
+      onChange={props.onDraftChange}
+      onSend={props.onSend}
+      onCancel={props.onCancel}
+      streaming={props.streaming}
+      toolbarStart={modelControl}
+    />
+  );
+
   return (
     <section className={props.className} data-agent-panel="">
       {props.header}
-      <AgentThread messages={props.messages} streaming={props.streaming} renderMessage={props.renderMessage} empty={props.empty} />
-      <AgentComposer
-        value={props.draft}
-        onChange={props.onDraftChange}
-        onSend={props.onSend}
-        onCancel={props.onCancel}
-        streaming={props.streaming}
-        toolbarStart={modelControl}
+      <AgentConversationSurface
+        empty={props.messages.length === 0}
+        thread={thread}
+        composer={composer}
+        emptyState={props.empty}
       />
     </section>
   );

package/packages/agentsam-workbench/src/agent/AgentRuntimeField.tsx

@@ -0,0 +1,152 @@
+import { useEffect, useRef, type CSSProperties } from 'react';
+import type {
+  LoadingSceneController,
+  ScenePreset,
+} from '@inneranimalmedia/agentsam-loading-scene';
+import {
+  HyperspaceRenderer,
+  computationalHyperspace,
+} from '@inneranimalmedia/agentsam-loading-scene';
+import {
+  LoadingSceneNarration,
+  useLoadingScene,
+} from '@inneranimalmedia/agentsam-loading-scene/react';
+
+export type AgentRuntimeFieldProps = {
+  controller: LoadingSceneController;
+  preset?: ScenePreset;
+  blocking?: boolean;
+  className?: string;
+  style?: CSSProperties;
+  activeOpacity?: number;
+  passiveOpacity?: number;
+  narration?: boolean;
+  narrationStyle?: CSSProperties;
+};
+
+/**
+ * Reusable workbench runtime surface.
+ *
+ * Product apps own runtime state and event production. This primitive owns the
+ * presentation contract: one persistent semantic scene, task-aware narration,
+ * resize handling and blocking/non-blocking composition.
+ */
+export function AgentRuntimeField({
+  controller,
+  preset = computationalHyperspace,
+  blocking = false,
+  className,
+  style,
+  activeOpacity = 1,
+  passiveOpacity = 0.34,
+  narration = true,
+  narrationStyle,
+}: AgentRuntimeFieldProps) {
+  const scene = useLoadingScene(controller);
+  const hostRef = useRef<HTMLDivElement | null>(null);
+  const canvasRef = useRef<HTMLCanvasElement | null>(null);
+  const rendererRef = useRef<HyperspaceRenderer | null>(null);
+
+  useEffect(() => {
+    const host = hostRef.current;
+    const canvas = canvasRef.current;
+    if (!host || !canvas) return;
+
+    const renderer = new HyperspaceRenderer(preset, {
+      canvas,
+      reducedMotion: 'auto',
+    });
+    rendererRef.current = renderer;
+
+    const fit = () => renderer.setSize(host.clientWidth, host.clientHeight);
+    fit();
+
+    const observer =
+      typeof ResizeObserver !== 'undefined' ? new ResizeObserver(fit) : null;
+    observer?.observe(host);
+    renderer.setScene(controller.getScene());
+
+    return () => {
+      observer?.disconnect();
+      renderer.dispose();
+      rendererRef.current = null;
+    };
+  }, [controller, preset]);
+
+  useEffect(() => {
+    const renderer = rendererRef.current;
+    if (!renderer) return;
+
+    renderer.setScene(scene);
+    if (
+      scene.status === 'running' ||
+      scene.status === 'waiting' ||
+      scene.status === 'error'
+    ) {
+      renderer.resume();
+      return;
+    }
+
+    const timeout = window.setTimeout(
+      () => renderer.suspend(),
+      preset.transition.settleMs + 300,
+    );
+    return () => window.clearTimeout(timeout);
+  }, [scene, preset]);
+
+  const active =
+    blocking ||
+    scene.status === 'running' ||
+    scene.status === 'waiting' ||
+    scene.status === 'error';
+
+  return (
+    <div
+      ref={hostRef}
+      data-agent-runtime-field=""
+      aria-hidden={active ? undefined : true}
+      className={className}
+      style={{
+        position: 'absolute',
+        inset: 0,
+        overflow: 'hidden',
+        pointerEvents: blocking ? 'auto' : 'none',
+        opacity: active ? 1 : 0,
+        transition: 'opacity 500ms ease',
+        background: blocking ? preset.palette.canvas : 'transparent',
+        ...style,
+      }}
+    >
+      <canvas
+        ref={canvasRef}
+        aria-hidden="true"
+        style={{
+          position: 'absolute',
+          inset: 0,
+          width: '100%',
+          height: '100%',
+          opacity: blocking ? activeOpacity : passiveOpacity,
+        }}
+      />
+
+      {active && narration ? (
+        <LoadingSceneNarration
+          controller={controller}
+          preset={preset}
+          align={blocking ? 'center' : 'start'}
+          showStudy
+          showMeta
+          style={{
+            position: 'absolute',
+            left: blocking ? '50%' : 18,
+            top: blocking ? '50%' : 'auto',
+            bottom: blocking ? 'auto' : 18,
+            transform: blocking ? 'translate(-50%, -50%)' : undefined,
+            pointerEvents: 'none',
+            ...narrationStyle,
+          }}
+        />
+      ) : null}
+    </div>
+  );
+}

package/packages/agentsam-workbench/src/agent/Composer.tsx

@@ -1,4 +1,5 @@
 import { useRef, type KeyboardEvent, type ReactNode, type TextareaHTMLAttributes } from 'react';
+import type { AgentRunMode } from '@inneranimalmedia/agentsam-contracts';
 
 export interface AgentComposerProps {
   value: string;
@@ -17,6 +18,8 @@ export interface AgentComposerProps {
   toolbarClassName?: string;
   textareaProps?: Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'onChange' | 'placeholder'>;
   maxHeight?: number;
+  /** Semantic run mode. Hosts own behavior; the primitive exposes it for accessible styling. */
+  runMode?: AgentRunMode;
 }
 
 /**
@@ -43,6 +46,7 @@ export function AgentComposer({
   toolbarClassName,
   textareaProps,
   maxHeight = 220,
+  runMode = 'agent',
 }: AgentComposerProps) {
   const areaRef = useRef<HTMLTextAreaElement>(null);
 
@@ -66,7 +70,12 @@ export function AgentComposer({
   const defaultStop = <button type="button" onClick={() => void onCancel?.()}>Stop</button>;
 
   return (
-    <div className={containerClassName} data-agent-composer="" aria-busy={streaming || undefined}>
+    <div
+      className={containerClassName}
+      data-agent-composer=""
+      data-agent-mode={runMode}
+      aria-busy={streaming || undefined}
+    >
       <textarea
         {...textareaProps}
         ref={areaRef}

package/packages/agentsam-workbench/src/agent/MiniAgentSam.tsx

@@ -1,3 +1,4 @@
+import { ArrowUp, Maximize2, Minimize2, X } from 'lucide-react';
 import { useEffect, useRef, useState, type ReactNode, type CSSProperties } from 'react';
 
 export interface AnnotationSelection {
@@ -11,7 +12,7 @@ export interface MiniAgentSamProps {
   selecting: boolean;
   onSelectingChange: (value: boolean) => void;
   onSubmit: (prompt: string, selection: AnnotationSelection) => void | Promise<void>;
-  renderComposer?: (props: { value: string; onChange: (value: string) => void; onSend: () => void; busy: boolean }) => ReactNode;
+  renderComposer?: (props: { value: string; onChange: (value: string) => void; onSend: () => void; busy: boolean; expanded: boolean }) => ReactNode;
   scope?: () => HTMLElement | null;
 }
 
@@ -24,6 +25,8 @@ export function MiniAgentSam({ selecting, onSelectingChange, onSubmit, renderCom
   const [value, setValue] = useState('');
   const [busy, setBusy] = useState(false);
   const [status, setStatus] = useState('');
+  const [expanded, setExpanded] = useState(false);
+  const lastTouch = useRef(0);
   const target = useRef<Element | null>(null);
   const panel = useRef<HTMLElement>(null);
   const [panelHeight, setPanelHeight] = useState(200);
@@ -66,6 +69,22 @@ export function MiniAgentSam({ selecting, onSelectingChange, onSubmit, renderCom
     return () => { observer.disconnect(); window.removeEventListener('scroll', update, true); window.removeEventListener('resize', update); window.removeEventListener('keydown', escape); };
   }, [onSelectingChange]);
   useEffect(() => { if (!panel.current) return; const observer = new ResizeObserver(() => setPanelHeight(panel.current?.offsetHeight || 200)); observer.observe(panel.current); return () => observer.disconnect(); }, [selection]);
+  useEffect(() => {
+    if (!expanded || !selection) return;
+    const previous = document.activeElement as HTMLElement | null;
+    const area = panel.current?.querySelector('textarea');
+    area?.focus();
+    const trap = (event: KeyboardEvent) => {
+      if (event.key === 'Escape') { event.preventDefault(); event.stopImmediatePropagation(); setExpanded(false); return; }
+      if (event.key !== 'Tab') return;
+      const nodes = Array.from(panel.current?.querySelectorAll<HTMLElement>('button:not(:disabled), textarea, input, [tabindex="0"]') || []);
+      const first = nodes[0], last = nodes[nodes.length - 1];
+      if (event.shiftKey && document.activeElement === first) { event.preventDefault(); last?.focus(); }
+      else if (!event.shiftKey && document.activeElement === last) { event.preventDefault(); first?.focus(); }
+    };
+    window.addEventListener('keydown', trap, true);
+    return () => { window.removeEventListener('keydown', trap, true); previous?.focus(); };
+  }, [expanded, selection]);
   async function submit() {
     if (!value.trim() || !selection || busy) return;
     setBusy(true); setStatus('');
@@ -77,10 +96,15 @@ export function MiniAgentSam({ selecting, onSelectingChange, onSubmit, renderCom
   return <div data-mini-agentsam="" style={{ pointerEvents: 'none' }}>
     {selecting && <div className="mini-agentsam-hint" role="status">Select an element to annotate · Esc to cancel</div>}
     {bounds && (selecting || selection) && <div className="mini-agentsam-outline" style={{ left: bounds.left, top: bounds.top, width: bounds.width, height: bounds.height }} />}
-    {selection && <section ref={panel} className="mini-agentsam-panel" aria-label="miniAgentSam" style={style}>
-      <div className="mini-agentsam-heading"><span title={selection.label}>{selection.label || selection.tag}</span><button type="button" aria-label="Close miniAgentSam" onClick={() => { setSelection(null); setBounds(null); }}>×</button></div>
-      {renderComposer ? renderComposer({ value, onChange: setValue, onSend: () => void submit(), busy }) : <><textarea aria-label="Annotation instructions" placeholder="Ask about this…" value={value} onChange={(event) => setValue(event.target.value)} /><button type="button" disabled={busy || !value.trim()} onClick={() => void submit()}>Send</button></>}
+    {selection && expanded && <div className="mini-agentsam-review-backdrop" onClick={() => setExpanded(false)} />}
+    {selection && <section ref={panel} className="mini-agentsam-panel" data-expanded={expanded ? 'true' : 'false'} role={expanded ? 'dialog' : undefined} aria-modal={expanded ? true : undefined} aria-label={expanded ? 'Review annotation message' : 'miniAgentSam'} style={expanded ? undefined : style}
+      onDoubleClick={(event) => { if (!(event.target as Element).closest('button')) setExpanded(true); }}
+      onPointerUp={(event) => { if (event.pointerType !== 'touch' || (event.target as Element).closest('button')) return; const now = Date.now(); if (now - lastTouch.current < 300) setExpanded(true); lastTouch.current = now; }}>
+
+      <div className="mini-agentsam-heading"><span title={selection.label}>{selection.label || selection.tag}</span><button type="button" aria-label={expanded ? "Collapse message" : "Expand message"} title={expanded ? "Collapse message" : "Review entire message"} aria-expanded={expanded} onClick={() => setExpanded((value) => !value)}>{expanded ? <Minimize2 size={16} /> : <Maximize2 size={16} />}</button><button type="button" aria-label="Close miniAgentSam" onClick={() => { setSelection(null); setBounds(null); setExpanded(false); }}><X size={18} /></button></div>
+      {renderComposer ? renderComposer({ value, onChange: setValue, onSend: () => void submit(), busy, expanded }) : <><textarea aria-label="Annotation instructions" placeholder="Ask about this…" value={value} onChange={(event) => setValue(event.target.value)} /><button type="button" disabled={busy || !value.trim()} className="mini-agentsam-send" aria-label="Send annotation" onClick={() => void submit()}><ArrowUp size={18} /></button></>}
       {status && <p role="status">{status}</p>}
     </section>}
   </div>;
 }
+

package/packages/agentsam-workbench/src/agent/RunMode.ts

@@ -0,0 +1,26 @@
+import type { AgentRunMode } from '@inneranimalmedia/agentsam-contracts';
+
+export type AgentRunModeTone = 'blue' | 'yellow' | 'red' | 'multicolor' | 'green';
+
+export type AgentRunModeProfile = Readonly<{
+  id: AgentRunMode;
+  label: string;
+  description: string;
+  tone: AgentRunModeTone;
+}>;
+
+/**
+ * Presentation metadata for the canonical AgentSam run modes.
+ * Runtime meaning remains owned by @inneranimalmedia/agentsam-contracts.
+ */
+export const AGENT_RUN_MODE_PROFILES: readonly AgentRunModeProfile[] = Object.freeze([
+  { id: 'agent', label: 'Agent', description: 'Execute and open surfaces', tone: 'blue' },
+  { id: 'plan', label: 'Plan', description: 'Design technical plans', tone: 'yellow' },
+  { id: 'debug', label: 'Debug', description: 'Inspect, prove, and fix', tone: 'red' },
+  { id: 'multitask', label: 'Multitask', description: 'Coordinate managed workflows', tone: 'multicolor' },
+  { id: 'ask', label: 'Ask', description: 'Talk and answer questions', tone: 'green' },
+]);
+
+export function agentRunModeProfile(mode: AgentRunMode): AgentRunModeProfile {
+  return AGENT_RUN_MODE_PROFILES.find((profile) => profile.id === mode) ?? AGENT_RUN_MODE_PROFILES[0]!;
+}