@agimon-ai/doompi-core 0.0.1-alpha.100

package/dist/src/web/services/testing/slotProps.mjs

@@ -0,0 +1,90 @@
+//#region src/web/services/testing/slotProps.ts
+const DEFAULT_SESSION_ID = "s1";
+function slotPropsFixture(options = {}) {
+	const actions = [];
+	const props = {
+		sessionId: options.sessionId === void 0 ? DEFAULT_SESSION_ID : options.sessionId,
+		statuses: options.statuses ?? {},
+		contextInventory: options.contextInventory ?? [],
+		openTab: (tabId) => {
+			actions.push({
+				action: "openTab",
+				target: tabId
+			});
+		},
+		openTransientTab: (tab) => {
+			actions.push({
+				action: "openTransientTab",
+				target: tab.id
+			});
+		},
+		closeTransientTab: (tabId) => {
+			actions.push({
+				action: "closeTransientTab",
+				target: tabId
+			});
+		},
+		fileTabFor: (path) => options.fileTab?.(path),
+		appendComposerDraft: (text) => {
+			actions.push({
+				action: "appendComposerDraft",
+				target: props.sessionId,
+				text
+			});
+		},
+		attachComposerContext: (context) => {
+			actions.push({
+				action: "attachComposerContext",
+				target: props.sessionId,
+				context
+			});
+		},
+		attachComposerCapture: (capture) => {
+			actions.push({
+				action: "attachComposerCapture",
+				target: props.sessionId,
+				capture
+			});
+		},
+		contextActionsFor: (item) => options.contextActions?.(item) ?? [],
+		sendSessionFrame: (sessionId, frame) => {
+			actions.push({
+				action: "sendSessionFrame",
+				target: sessionId,
+				frame
+			});
+		},
+		renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,
+		...options.sessionTranscript === void 0 ? {} : { renderSessionTranscript: options.sessionTranscript },
+		renderSlot: (slot) => options.slotContent?.[slot] ?? null,
+		slotData: (slot) => options.slotData?.[slot.slot] ?? []
+	};
+	return {
+		props,
+		actions,
+		frames: () => actions.flatMap((entry) => entry.frame ? [entry.frame] : [])
+	};
+}
+const DEFAULT_TOOL_CALL_ID = "call-1";
+/** The props a tool's timeline item receives, in any of its four states. */
+function toolMessagePropsFixture(options) {
+	const base = slotPropsFixture(options);
+	const result = options.result === void 0 ? null : options.result;
+	return {
+		...base,
+		props: {
+			...base.props,
+			toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,
+			toolName: options.toolName,
+			args: options.args ?? {},
+			result,
+			output: options.output ?? "",
+			running: options.running ?? false,
+			isError: options.isError ?? false
+		}
+	};
+}
+//#endregion
+export { slotPropsFixture, toolMessagePropsFixture };
+
+//# sourceMappingURL=slotProps.mjs.map

package/dist/src/web/services/testing/slotProps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotProps.mjs","names":[],"sources":["../../../../../src/web/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport type {\n  ComposerCapture,\n  ContextAction,\n  SlotDataFill,\n  SlotDeclaration,\n  ThreadViewOptions,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginContextItem,\n  WebPluginSlotProps,\n} from '../../types/webPlugin';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action:\n    | 'appendComposerDraft'\n    | 'attachComposerCapture'\n    | 'attachComposerContext'\n    | 'openTab'\n    | 'openTransientTab'\n    | 'closeTransientTab'\n    | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */\n  target: string | null;\n  /** The text passed to `appendComposerDraft`. */\n  text?: string;\n  /** The structured item passed to `attachComposerContext`. */\n  context?: WebPluginContextItem;\n  /** The atomic screenshot and context passed to `attachComposerCapture`. */\n  capture?: ComposerCapture;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  contextInventory?: WebPluginSlotProps['contextInventory'];\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;\n  /** What `renderSessionTranscript` returns; omitted, the prop is absent as in a host that has none. */\n  sessionTranscript?: (sessionId: string, options?: ThreadViewOptions) => ReactNode;\n  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */\n  fileTab?: (path: string) => TransientTab | undefined;\n  /** Context actions installed plugins should offer for the item under test. */\n  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    contextInventory: options.contextInventory ?? [],\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    fileTabFor: (path: string) => options.fileTab?.(path),\n    appendComposerDraft: (text) => {\n      actions.push({ action: 'appendComposerDraft', target: props.sessionId, text });\n    },\n    attachComposerContext: (context) => {\n      actions.push({ action: 'attachComposerContext', target: props.sessionId, context });\n    },\n    attachComposerCapture: (capture) => {\n      actions.push({ action: 'attachComposerCapture', target: props.sessionId, capture });\n    },\n    contextActionsFor: (item) => options.contextActions?.(item) ?? [],\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,\n    ...(options.sessionTranscript === undefined ? {} : { renderSessionTranscript: options.sessionTranscript }),\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":";AAyEA,MAAM,qBAAqB;AAE3B,SAAgB,iBAAiB,UAA4B,CAAC,GAAqB;CACjF,MAAM,UAAgC,CAAC;CACvC,MAAM,QAA4B;EAChC,WAAW,QAAQ,cAAc,KAAA,IAAY,qBAAqB,QAAQ;EAC1E,UAAU,QAAQ,YAAY,CAAC;EAC/B,kBAAkB,QAAQ,oBAAoB,CAAC;EAC/C,UAAU,UAAU;GAClB,QAAQ,KAAK;IAAE,QAAQ;IAAW,QAAQ;GAAM,CAAC;EACnD;EACA,mBAAmB,QAAsB;GACvC,QAAQ,KAAK;IAAE,QAAQ;IAAoB,QAAQ,IAAI;GAAG,CAAC;EAC7D;EACA,oBAAoB,UAAkB;GACpC,QAAQ,KAAK;IAAE,QAAQ;IAAqB,QAAQ;GAAM,CAAC;EAC7D;EACA,aAAa,SAAiB,QAAQ,UAAU,IAAI;EACpD,sBAAsB,SAAS;GAC7B,QAAQ,KAAK;IAAE,QAAQ;IAAuB,QAAQ,MAAM;IAAW;GAAK,CAAC;EAC/E;EACA,wBAAwB,YAAY;GAClC,QAAQ,KAAK;IAAE,QAAQ;IAAyB,QAAQ,MAAM;IAAW;GAAQ,CAAC;EACpF;EACA,wBAAwB,YAAY;GAClC,QAAQ,KAAK;IAAE,QAAQ;IAAyB,QAAQ,MAAM;IAAW;GAAQ,CAAC;EACpF;EACA,oBAAoB,SAAS,QAAQ,iBAAiB,IAAI,KAAK,CAAC;EAChE,mBAAmB,WAAW,UAAU;GACtC,QAAQ,KAAK;IAAE,QAAQ;IAAoB,QAAQ;IAAW;GAAM,CAAC;EACvE;EACA,eAAe,UAAU,kBAAkB,QAAQ,SAAS,UAAU,aAAa,KAAK;EACxF,GAAI,QAAQ,sBAAsB,KAAA,IAAY,CAAC,IAAI,EAAE,yBAAyB,QAAQ,kBAAkB;EACxG,aAAa,SAAS,QAAQ,cAAc,SAAS;EAGrD,WAAiB,SACd,QAAQ,WAAW,KAAK,SAAS,CAAC;CACvC;CAEA,OAAO;EACL;EACA;EACA,cAAc,QAAQ,SAAS,UAAW,MAAM,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAE;CAC7E;AACF;AAkBA,MAAM,uBAAuB;;AAG7B,SAAgB,wBAAwB,SAA2D;CACjG,MAAM,OAAO,iBAAiB,OAAO;CACrC,MAAM,SAAS,QAAQ,WAAW,KAAA,IAAY,OAAO,QAAQ;CAC7D,OAAO;EACL,GAAG;EACH,OAAO;GACL,GAAG,KAAK;GACR,YAAY,QAAQ,cAAc;GAClC,UAAU,QAAQ;GAClB,MAAM,QAAQ,QAAQ,CAAC;GACvB;GACA,QAAQ,QAAQ,UAAU;GAC1B,SAAS,QAAQ,WAAW;GAC5B,SAAS,QAAQ,WAAW;EAC9B;CACF;AACF"}

package/dist/src/web/services/testing/templateRail.cjs

@@ -0,0 +1,128 @@
+//#region src/web/services/testing/templateRail.ts
+/** A tiny transparent PNG, so avatar markup renders an image without a network request. */
+const AVATAR_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=";
+function railSession(overrides) {
+	return {
+		name: overrides.id,
+		ordinal: 1,
+		active: false,
+		nested: false,
+		status: "idle · done 2m ago",
+		awaitingInput: false,
+		restarting: false,
+		pendingSetups: [],
+		...overrides
+	};
+}
+function defaultRailWorkspaces() {
+	return [{
+		id: "doompi",
+		name: "doompi",
+		root: "/Users/dev/workspace/doompi",
+		available: true,
+		legacy: false,
+		sessions: [railSession({
+			id: "rail",
+			name: "rail redesign",
+			ordinal: 1,
+			active: true,
+			status: "running · 3m",
+			git: {
+				branch: "main",
+				dirty: true
+			},
+			profile: {
+				name: "ponytail",
+				label: "Ponytail",
+				initials: "PO",
+				avatarUrl: AVATAR_URL
+			}
+		}), railSession({
+			id: "rail-worktree",
+			name: "worktree child",
+			ordinal: 2,
+			nested: true,
+			provenance: "worktree",
+			git: {
+				branch: "feature/rail",
+				dirty: false
+			},
+			profile: {
+				name: "reviewer",
+				label: "Reviewer",
+				initials: "RE"
+			},
+			pendingSetups: [{
+				id: "setup",
+				name: "docs worktree",
+				status: "automatic worktree setup failed",
+				failed: true,
+				recovery: "Resolve the Git setup, then retry the authenticated conversation."
+			}]
+		})]
+	}, {
+		id: "notes",
+		name: "Notes",
+		root: "/Users/dev/.pi/.doom/workspace/Notes",
+		available: true,
+		legacy: false,
+		sessions: []
+	}];
+}
+function templateRailStub(options = {}) {
+	const actions = [];
+	const record = (action, result) => (...args) => {
+		actions.push({
+			action,
+			args
+		});
+		return result;
+	};
+	const recorded = {
+		openSession: record("openSession"),
+		renameSession: record("renameSession"),
+		restartSession: record("restartSession"),
+		removeSession: record("removeSession", Promise.resolve(void 0)),
+		resumeSession: record("resumeSession"),
+		createSession: record("createSession"),
+		resumeInWorkspace: record("resumeInWorkspace"),
+		openWorkspaceSettings: record("openWorkspaceSettings"),
+		deleteWorkspace: record("deleteWorkspace", Promise.resolve(void 0)),
+		openAddWorkspace: record("openAddWorkspace"),
+		closeAddWorkspace: record("closeAddWorkspace"),
+		addWorkspace: record("addWorkspace", Promise.resolve(void 0)),
+		searchDirectories: record("searchDirectories", Promise.resolve(["/Users/dev/workspace/doompi", "/Users/dev/workspace/docs"])),
+		listDirectory: record("listDirectory", Promise.resolve({
+			path: "/Users/dev",
+			parent: "/Users",
+			directories: ["/Users/dev/workspace", "/Users/dev/notes"]
+		})),
+		removePendingSetup: record("removePendingSetup", Promise.resolve(void 0)),
+		openSettings: record("openSettings"),
+		openRemoteAccess: record("openRemoteAccess"),
+		turnRemoteAccessOff: record("turnRemoteAccessOff"),
+		renderSessionMenuItems: () => null
+	};
+	return {
+		rail: {
+			workspaces: options.workspaces ?? defaultRailWorkspaces(),
+			remote: options.remote ?? {
+				status: "off",
+				deviceCount: 0
+			},
+			pluginContent: null,
+			...options.addWorkspace === void 0 ? {} : { addWorkspace: options.addWorkspace },
+			actions: {
+				...recorded,
+				...options.actions
+			}
+		},
+		actions
+	};
+}
+//#endregion
+exports.defaultRailWorkspaces = defaultRailWorkspaces;
+exports.railSession = railSession;
+exports.templateRailStub = templateRailStub;
+
+//# sourceMappingURL=templateRail.cjs.map

package/dist/src/web/services/testing/templateRail.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateRail.cjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'doompi',\n      name: 'doompi',\n      root: '/Users/dev/workspace/doompi',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.pi/.doom/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/doompi', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":";;AAkCA,MAAM,aACJ;AAEF,SAAgB,YAAY,WAAqF;CAC/G,OAAO;EACL,MAAM,UAAU;EAChB,SAAS;EACT,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,eAAe;EACf,YAAY;EACZ,eAAe,CAAC;EAChB,GAAG;CACL;AACF;AAEA,SAAgB,wBAAoD;CAClE,OAAO,CACL;EACE,IAAI;EACJ,MAAM;EACN,MAAM;EACN,WAAW;EACX,QAAQ;EACR,UAAU,CACR,YAAY;GACV,IAAI;GACJ,MAAM;GACN,SAAS;GACT,QAAQ;GACR,QAAQ;GACR,KAAK;IAAE,QAAQ;IAAQ,OAAO;GAAK;GACnC,SAAS;IAAE,MAAM;IAAY,OAAO;IAAY,UAAU;IAAM,WAAW;GAAW;EACxF,CAAC,GACD,YAAY;GACV,IAAI;GACJ,MAAM;GACN,SAAS;GACT,QAAQ;GACR,YAAY;GACZ,KAAK;IAAE,QAAQ;IAAgB,OAAO;GAAM;GAC5C,SAAS;IAAE,MAAM;IAAY,OAAO;IAAY,UAAU;GAAK;GAC/D,eAAe,CACb;IACE,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,UAAU;GACZ,CACF;EACF,CAAC,CACH;CACF,GACA;EACE,IAAI;EACJ,MAAM;EACN,MAAM;EACN,WAAW;EACX,QAAQ;EACR,UAAU,CAAC;CACb,CACF;AACF;AAEA,SAAgB,iBAAiB,UAA+B,CAAC,GAAwB;CACvF,MAAM,UAAgC,CAAC;CACvC,MAAM,UACwC,QAAc,YACzD,GAAG,SAAoB;EACtB,QAAQ,KAAK;GAAE;GAAQ;EAAK,CAAC;EAC7B,OAAO;CACT;CACF,MAAM,WAAmC;EACvC,aAAa,OAAO,aAAa;EACjC,eAAe,OAAO,eAAe;EACrC,gBAAgB,OAAO,gBAAgB;EACvC,eAAe,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EACjE,eAAe,OAAO,eAAe;EACrC,eAAe,OAAO,eAAe;EACrC,mBAAmB,OAAO,mBAAmB;EAC7C,uBAAuB,OAAO,uBAAuB;EACrD,iBAAiB,OAAO,mBAAmB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EACrE,kBAAkB,OAAO,kBAAkB;EAC3C,mBAAmB,OAAO,mBAAmB;EAC7C,cAAc,OAAO,gBAAgB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EAC/D,mBAAmB,OACjB,qBACA,QAAQ,QAAQ,CAAC,+BAA+B,2BAA2B,CAAC,CAC9E;EACA,eAAe,OACb,iBACA,QAAQ,QAAQ;GACd,MAAM;GACN,QAAQ;GACR,aAAa,CAAC,wBAAwB,kBAAkB;EAC1D,CAAC,CACH;EACA,oBAAoB,OAClB,sBACA,QAAQ,QAAQ,KAAA,CAAS,CAC3B;EACA,cAAc,OAAO,cAAc;EACnC,kBAAkB,OAAO,kBAAkB;EAC3C,qBAAqB,OAAO,qBAAqB;EACjD,8BAA8B;CAChC;CACA,OAAO;EACL,MAAM;GACJ,YAAY,QAAQ,cAAc,sBAAsB;GACxD,QAAQ,QAAQ,UAAU;IAAE,QAAQ;IAAO,aAAa;GAAE;GAC1D,eAAe;GACf,GAAI,QAAQ,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;GACnF,SAAS;IAAE,GAAG;IAAU,GAAG,QAAQ;GAAQ;EAC7C;EACA;CACF;AACF"}

package/dist/src/web/services/testing/templateRail.d.mts

@@ -0,0 +1,31 @@
+import { WebTemplateRail, WebTemplateRailActions, WebTemplateRailSession, WebTemplateRailWorkspace } from "../../types/template.mjs";
+//#region src/web/services/testing/templateRail.d.ts
+/**
+ * The rail a template receives, built for a test or story.
+ *
+ * Two workspaces with sessions that exercise the card's branches (a branch
+ * with a dirty star, a profile avatar, a nested child, a pending setup), plus
+ * actions that record what the template asked for. Override any part.
+ */
+export interface RecordedRailAction {
+  action: keyof WebTemplateRailActions;
+  args: readonly unknown[];
+}
+export interface TemplateRailFixture {
+  rail: WebTemplateRail;
+  /** Every action the template called, in order. */
+  readonly actions: readonly RecordedRailAction[];
+}
+export interface TemplateRailOptions {
+  workspaces?: readonly WebTemplateRailWorkspace[];
+  addWorkspace?: WebTemplateRail['addWorkspace'];
+  remote?: WebTemplateRail['remote'];
+  actions?: Partial<WebTemplateRailActions>;
+}
+export declare function railSession(overrides: Partial<WebTemplateRailSession> & {
+  id: string;
+}): WebTemplateRailSession;
+export declare function defaultRailWorkspaces(): WebTemplateRailWorkspace[];
+export declare function templateRailStub(options?: TemplateRailOptions): TemplateRailFixture;
+//#endregion
+//# sourceMappingURL=templateRail.d.mts.map

package/dist/src/web/services/testing/templateRail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateRail.d.mts","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"mappings":";;;;;;;;;iBAeiB;EACf,cAAc;EACd;;iBAGe;EACf,MAAM;;WAEG,kBAAkB;;iBAGZ;EACf,sBAAsB;EACtB,eAAe;EACf,SAAS;EACT,UAAU,QAAQ;;wBAOJ,YAAY,WAAW,QAAQ;EAA4B;IAAe;wBAc1E,yBAAyB;wBAiDzB,iBAAiB,UAAS,sBAA2B"}

package/dist/src/web/services/testing/templateRail.mjs

@@ -0,0 +1,126 @@
+//#region src/web/services/testing/templateRail.ts
+/** A tiny transparent PNG, so avatar markup renders an image without a network request. */
+const AVATAR_URL = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=";
+function railSession(overrides) {
+	return {
+		name: overrides.id,
+		ordinal: 1,
+		active: false,
+		nested: false,
+		status: "idle · done 2m ago",
+		awaitingInput: false,
+		restarting: false,
+		pendingSetups: [],
+		...overrides
+	};
+}
+function defaultRailWorkspaces() {
+	return [{
+		id: "doompi",
+		name: "doompi",
+		root: "/Users/dev/workspace/doompi",
+		available: true,
+		legacy: false,
+		sessions: [railSession({
+			id: "rail",
+			name: "rail redesign",
+			ordinal: 1,
+			active: true,
+			status: "running · 3m",
+			git: {
+				branch: "main",
+				dirty: true
+			},
+			profile: {
+				name: "ponytail",
+				label: "Ponytail",
+				initials: "PO",
+				avatarUrl: AVATAR_URL
+			}
+		}), railSession({
+			id: "rail-worktree",
+			name: "worktree child",
+			ordinal: 2,
+			nested: true,
+			provenance: "worktree",
+			git: {
+				branch: "feature/rail",
+				dirty: false
+			},
+			profile: {
+				name: "reviewer",
+				label: "Reviewer",
+				initials: "RE"
+			},
+			pendingSetups: [{
+				id: "setup",
+				name: "docs worktree",
+				status: "automatic worktree setup failed",
+				failed: true,
+				recovery: "Resolve the Git setup, then retry the authenticated conversation."
+			}]
+		})]
+	}, {
+		id: "notes",
+		name: "Notes",
+		root: "/Users/dev/.pi/.doom/workspace/Notes",
+		available: true,
+		legacy: false,
+		sessions: []
+	}];
+}
+function templateRailStub(options = {}) {
+	const actions = [];
+	const record = (action, result) => (...args) => {
+		actions.push({
+			action,
+			args
+		});
+		return result;
+	};
+	const recorded = {
+		openSession: record("openSession"),
+		renameSession: record("renameSession"),
+		restartSession: record("restartSession"),
+		removeSession: record("removeSession", Promise.resolve(void 0)),
+		resumeSession: record("resumeSession"),
+		createSession: record("createSession"),
+		resumeInWorkspace: record("resumeInWorkspace"),
+		openWorkspaceSettings: record("openWorkspaceSettings"),
+		deleteWorkspace: record("deleteWorkspace", Promise.resolve(void 0)),
+		openAddWorkspace: record("openAddWorkspace"),
+		closeAddWorkspace: record("closeAddWorkspace"),
+		addWorkspace: record("addWorkspace", Promise.resolve(void 0)),
+		searchDirectories: record("searchDirectories", Promise.resolve(["/Users/dev/workspace/doompi", "/Users/dev/workspace/docs"])),
+		listDirectory: record("listDirectory", Promise.resolve({
+			path: "/Users/dev",
+			parent: "/Users",
+			directories: ["/Users/dev/workspace", "/Users/dev/notes"]
+		})),
+		removePendingSetup: record("removePendingSetup", Promise.resolve(void 0)),
+		openSettings: record("openSettings"),
+		openRemoteAccess: record("openRemoteAccess"),
+		turnRemoteAccessOff: record("turnRemoteAccessOff"),
+		renderSessionMenuItems: () => null
+	};
+	return {
+		rail: {
+			workspaces: options.workspaces ?? defaultRailWorkspaces(),
+			remote: options.remote ?? {
+				status: "off",
+				deviceCount: 0
+			},
+			pluginContent: null,
+			...options.addWorkspace === void 0 ? {} : { addWorkspace: options.addWorkspace },
+			actions: {
+				...recorded,
+				...options.actions
+			}
+		},
+		actions
+	};
+}
+//#endregion
+export { defaultRailWorkspaces, railSession, templateRailStub };
+
+//# sourceMappingURL=templateRail.mjs.map

package/dist/src/web/services/testing/templateRail.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateRail.mjs","names":[],"sources":["../../../../../src/web/services/testing/templateRail.ts"],"sourcesContent":["import type {\n  WebTemplateRail,\n  WebTemplateRailActions,\n  WebTemplateRailSession,\n  WebTemplateRailWorkspace,\n} from '../../types/template';\n\n/**\n * The rail a template receives, built for a test or story.\n *\n * Two workspaces with sessions that exercise the card's branches (a branch\n * with a dirty star, a profile avatar, a nested child, a pending setup), plus\n * actions that record what the template asked for. Override any part.\n */\n\nexport interface RecordedRailAction {\n  action: keyof WebTemplateRailActions;\n  args: readonly unknown[];\n}\n\nexport interface TemplateRailFixture {\n  rail: WebTemplateRail;\n  /** Every action the template called, in order. */\n  readonly actions: readonly RecordedRailAction[];\n}\n\nexport interface TemplateRailOptions {\n  workspaces?: readonly WebTemplateRailWorkspace[];\n  addWorkspace?: WebTemplateRail['addWorkspace'];\n  remote?: WebTemplateRail['remote'];\n  actions?: Partial<WebTemplateRailActions>;\n}\n\n/** A tiny transparent PNG, so avatar markup renders an image without a network request. */\nconst AVATAR_URL =\n  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=';\n\nexport function railSession(overrides: Partial<WebTemplateRailSession> & { id: string }): WebTemplateRailSession {\n  return {\n    name: overrides.id,\n    ordinal: 1,\n    active: false,\n    nested: false,\n    status: 'idle · done 2m ago',\n    awaitingInput: false,\n    restarting: false,\n    pendingSetups: [],\n    ...overrides,\n  };\n}\n\nexport function defaultRailWorkspaces(): WebTemplateRailWorkspace[] {\n  return [\n    {\n      id: 'doompi',\n      name: 'doompi',\n      root: '/Users/dev/workspace/doompi',\n      available: true,\n      legacy: false,\n      sessions: [\n        railSession({\n          id: 'rail',\n          name: 'rail redesign',\n          ordinal: 1,\n          active: true,\n          status: 'running · 3m',\n          git: { branch: 'main', dirty: true },\n          profile: { name: 'ponytail', label: 'Ponytail', initials: 'PO', avatarUrl: AVATAR_URL },\n        }),\n        railSession({\n          id: 'rail-worktree',\n          name: 'worktree child',\n          ordinal: 2,\n          nested: true,\n          provenance: 'worktree',\n          git: { branch: 'feature/rail', dirty: false },\n          profile: { name: 'reviewer', label: 'Reviewer', initials: 'RE' },\n          pendingSetups: [\n            {\n              id: 'setup',\n              name: 'docs worktree',\n              status: 'automatic worktree setup failed',\n              failed: true,\n              recovery: 'Resolve the Git setup, then retry the authenticated conversation.',\n            },\n          ],\n        }),\n      ],\n    },\n    {\n      id: 'notes',\n      name: 'Notes',\n      root: '/Users/dev/.pi/.doom/workspace/Notes',\n      available: true,\n      legacy: false,\n      sessions: [],\n    },\n  ];\n}\n\nexport function templateRailStub(options: TemplateRailOptions = {}): TemplateRailFixture {\n  const actions: RecordedRailAction[] = [];\n  const record =\n    <Name extends keyof WebTemplateRailActions>(action: Name, result?: unknown) =>\n    (...args: unknown[]) => {\n      actions.push({ action, args });\n      return result;\n    };\n  const recorded: WebTemplateRailActions = {\n    openSession: record('openSession'),\n    renameSession: record('renameSession'),\n    restartSession: record('restartSession'),\n    removeSession: record('removeSession', Promise.resolve(undefined)) as WebTemplateRailActions['removeSession'],\n    resumeSession: record('resumeSession'),\n    createSession: record('createSession'),\n    resumeInWorkspace: record('resumeInWorkspace'),\n    openWorkspaceSettings: record('openWorkspaceSettings'),\n    deleteWorkspace: record('deleteWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['deleteWorkspace'],\n    openAddWorkspace: record('openAddWorkspace'),\n    closeAddWorkspace: record('closeAddWorkspace'),\n    addWorkspace: record('addWorkspace', Promise.resolve(undefined)) as WebTemplateRailActions['addWorkspace'],\n    searchDirectories: record(\n      'searchDirectories',\n      Promise.resolve(['/Users/dev/workspace/doompi', '/Users/dev/workspace/docs']),\n    ) as WebTemplateRailActions['searchDirectories'],\n    listDirectory: record(\n      'listDirectory',\n      Promise.resolve({\n        path: '/Users/dev',\n        parent: '/Users',\n        directories: ['/Users/dev/workspace', '/Users/dev/notes'],\n      }),\n    ) as WebTemplateRailActions['listDirectory'],\n    removePendingSetup: record(\n      'removePendingSetup',\n      Promise.resolve(undefined),\n    ) as WebTemplateRailActions['removePendingSetup'],\n    openSettings: record('openSettings'),\n    openRemoteAccess: record('openRemoteAccess'),\n    turnRemoteAccessOff: record('turnRemoteAccessOff'),\n    renderSessionMenuItems: () => null,\n  };\n  return {\n    rail: {\n      workspaces: options.workspaces ?? defaultRailWorkspaces(),\n      remote: options.remote ?? { status: 'off', deviceCount: 0 },\n      pluginContent: null,\n      ...(options.addWorkspace === undefined ? {} : { addWorkspace: options.addWorkspace }),\n      actions: { ...recorded, ...options.actions },\n    },\n    actions,\n  };\n}\n"],"mappings":";;AAkCA,MAAM,aACJ;AAEF,SAAgB,YAAY,WAAqF;CAC/G,OAAO;EACL,MAAM,UAAU;EAChB,SAAS;EACT,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,eAAe;EACf,YAAY;EACZ,eAAe,CAAC;EAChB,GAAG;CACL;AACF;AAEA,SAAgB,wBAAoD;CAClE,OAAO,CACL;EACE,IAAI;EACJ,MAAM;EACN,MAAM;EACN,WAAW;EACX,QAAQ;EACR,UAAU,CACR,YAAY;GACV,IAAI;GACJ,MAAM;GACN,SAAS;GACT,QAAQ;GACR,QAAQ;GACR,KAAK;IAAE,QAAQ;IAAQ,OAAO;GAAK;GACnC,SAAS;IAAE,MAAM;IAAY,OAAO;IAAY,UAAU;IAAM,WAAW;GAAW;EACxF,CAAC,GACD,YAAY;GACV,IAAI;GACJ,MAAM;GACN,SAAS;GACT,QAAQ;GACR,YAAY;GACZ,KAAK;IAAE,QAAQ;IAAgB,OAAO;GAAM;GAC5C,SAAS;IAAE,MAAM;IAAY,OAAO;IAAY,UAAU;GAAK;GAC/D,eAAe,CACb;IACE,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,UAAU;GACZ,CACF;EACF,CAAC,CACH;CACF,GACA;EACE,IAAI;EACJ,MAAM;EACN,MAAM;EACN,WAAW;EACX,QAAQ;EACR,UAAU,CAAC;CACb,CACF;AACF;AAEA,SAAgB,iBAAiB,UAA+B,CAAC,GAAwB;CACvF,MAAM,UAAgC,CAAC;CACvC,MAAM,UACwC,QAAc,YACzD,GAAG,SAAoB;EACtB,QAAQ,KAAK;GAAE;GAAQ;EAAK,CAAC;EAC7B,OAAO;CACT;CACF,MAAM,WAAmC;EACvC,aAAa,OAAO,aAAa;EACjC,eAAe,OAAO,eAAe;EACrC,gBAAgB,OAAO,gBAAgB;EACvC,eAAe,OAAO,iBAAiB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EACjE,eAAe,OAAO,eAAe;EACrC,eAAe,OAAO,eAAe;EACrC,mBAAmB,OAAO,mBAAmB;EAC7C,uBAAuB,OAAO,uBAAuB;EACrD,iBAAiB,OAAO,mBAAmB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EACrE,kBAAkB,OAAO,kBAAkB;EAC3C,mBAAmB,OAAO,mBAAmB;EAC7C,cAAc,OAAO,gBAAgB,QAAQ,QAAQ,KAAA,CAAS,CAAC;EAC/D,mBAAmB,OACjB,qBACA,QAAQ,QAAQ,CAAC,+BAA+B,2BAA2B,CAAC,CAC9E;EACA,eAAe,OACb,iBACA,QAAQ,QAAQ;GACd,MAAM;GACN,QAAQ;GACR,aAAa,CAAC,wBAAwB,kBAAkB;EAC1D,CAAC,CACH;EACA,oBAAoB,OAClB,sBACA,QAAQ,QAAQ,KAAA,CAAS,CAC3B;EACA,cAAc,OAAO,cAAc;EACnC,kBAAkB,OAAO,kBAAkB;EAC3C,qBAAqB,OAAO,qBAAqB;EACjD,8BAA8B;CAChC;CACA,OAAO;EACL,MAAM;GACJ,YAAY,QAAQ,cAAc,sBAAsB;GACxD,QAAQ,QAAQ,UAAU;IAAE,QAAQ;IAAO,aAAa;GAAE;GAC1D,eAAe;GACf,GAAI,QAAQ,iBAAiB,KAAA,IAAY,CAAC,IAAI,EAAE,cAAc,QAAQ,aAAa;GACnF,SAAS;IAAE,GAAG;IAAU,GAAG,QAAQ;GAAQ;EAC7C;EACA;CACF;AACF"}

package/dist/src/web/services/toolResult/index.cjs

@@ -0,0 +1,30 @@
+//#region src/web/services/toolResult/index.ts
+/**
+* The text of a tool result, the way every tool card reads it: the `text`
+* content blocks joined with newlines, non-text blocks (images) dropped.
+*/
+const TAB = "	";
+const TAB_WIDTH = "  ";
+function isTextBlock(block) {
+	return typeof block === "object" && block !== null && block.type === "text" && typeof block.text === "string";
+}
+/** The text blocks of a result's content, joined with newlines. */
+function toolResultText(content) {
+	return content.filter(isTextBlock).map((block) => block.text).join("\n");
+}
+/**
+* toolResultText as lines a card can count and clip: tabs widened, CRLF
+* folded, trailing blank lines dropped, and no lines at all for no text.
+*/
+function toolResultTextLines(content) {
+	const text = toolResultText(content);
+	if (text.length === 0) return [];
+	const lines = text.replaceAll("\r\n", "\n").replaceAll("\r", "\n").replaceAll(TAB, TAB_WIDTH).split("\n");
+	while (lines.length > 0 && lines.at(-1)?.trim() === "") lines.pop();
+	return lines;
+}
+//#endregion
+exports.toolResultText = toolResultText;
+exports.toolResultTextLines = toolResultTextLines;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/web/services/toolResult/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../../../../../src/web/services/toolResult/index.ts"],"sourcesContent":["/**\n * The text of a tool result, the way every tool card reads it: the `text`\n * content blocks joined with newlines, non-text blocks (images) dropped.\n */\n\nconst TAB = '\\t';\nconst TAB_WIDTH = '  ';\n\nfunction isTextBlock(block: unknown): block is { type: 'text'; text: string } {\n  return (\n    typeof block === 'object' &&\n    block !== null &&\n    (block as { type?: unknown }).type === 'text' &&\n    typeof (block as { text?: unknown }).text === 'string'\n  );\n}\n\n/** The text blocks of a result's content, joined with newlines. */\nexport function toolResultText(content: readonly unknown[]): string {\n  return content\n    .filter(isTextBlock)\n    .map((block) => block.text)\n    .join('\\n');\n}\n\n/**\n * toolResultText as lines a card can count and clip: tabs widened, CRLF\n * folded, trailing blank lines dropped, and no lines at all for no text.\n */\nexport function toolResultTextLines(content: readonly unknown[]): string[] {\n  const text = toolResultText(content);\n  if (text.length === 0) return [];\n  const lines = text.replaceAll('\\r\\n', '\\n').replaceAll('\\r', '\\n').replaceAll(TAB, TAB_WIDTH).split('\\n');\n  while (lines.length > 0 && lines.at(-1)?.trim() === '') lines.pop();\n  return lines;\n}\n"],"mappings":";;;;;AAKA,MAAM,MAAM;AACZ,MAAM,YAAY;AAElB,SAAS,YAAY,OAAyD;CAC5E,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAA6B,SAAS,UACvC,OAAQ,MAA6B,SAAS;AAElD;;AAGA,SAAgB,eAAe,SAAqC;CAClE,OAAO,QACJ,OAAO,WAAW,CAAC,CACnB,KAAK,UAAU,MAAM,IAAI,CAAC,CAC1B,KAAK,IAAI;AACd;;;;;AAMA,SAAgB,oBAAoB,SAAuC;CACzE,MAAM,OAAO,eAAe,OAAO;CACnC,IAAI,KAAK,WAAW,GAAG,OAAO,CAAC;CAC/B,MAAM,QAAQ,KAAK,WAAW,QAAQ,IAAI,CAAC,CAAC,WAAW,MAAM,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI;CACxG,OAAO,MAAM,SAAS,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,MAAM,IAAI;CAClE,OAAO;AACT"}

package/dist/src/web/services/toolResult/index.d.mts

@@ -0,0 +1,14 @@
+//#region src/web/services/toolResult/index.d.ts
+/**
+ * The text of a tool result, the way every tool card reads it: the `text`
+ * content blocks joined with newlines, non-text blocks (images) dropped.
+ */
+/** The text blocks of a result's content, joined with newlines. */
+export declare function toolResultText(content: readonly unknown[]): string;
+/**
+ * toolResultText as lines a card can count and clip: tabs widened, CRLF
+ * folded, trailing blank lines dropped, and no lines at all for no text.
+ */
+export declare function toolResultTextLines(content: readonly unknown[]): string[];
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/web/services/toolResult/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/web/services/toolResult/index.ts"],"mappings":";;;;;;wBAkBgB,eAAe;;;;;wBAWf,oBAAoB"}

package/dist/src/web/services/toolResult/index.mjs

@@ -0,0 +1,29 @@
+//#region src/web/services/toolResult/index.ts
+/**
+* The text of a tool result, the way every tool card reads it: the `text`
+* content blocks joined with newlines, non-text blocks (images) dropped.
+*/
+const TAB = "	";
+const TAB_WIDTH = "  ";
+function isTextBlock(block) {
+	return typeof block === "object" && block !== null && block.type === "text" && typeof block.text === "string";
+}
+/** The text blocks of a result's content, joined with newlines. */
+function toolResultText(content) {
+	return content.filter(isTextBlock).map((block) => block.text).join("\n");
+}
+/**
+* toolResultText as lines a card can count and clip: tabs widened, CRLF
+* folded, trailing blank lines dropped, and no lines at all for no text.
+*/
+function toolResultTextLines(content) {
+	const text = toolResultText(content);
+	if (text.length === 0) return [];
+	const lines = text.replaceAll("\r\n", "\n").replaceAll("\r", "\n").replaceAll(TAB, TAB_WIDTH).split("\n");
+	while (lines.length > 0 && lines.at(-1)?.trim() === "") lines.pop();
+	return lines;
+}
+//#endregion
+export { toolResultText, toolResultTextLines };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/web/services/toolResult/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/web/services/toolResult/index.ts"],"sourcesContent":["/**\n * The text of a tool result, the way every tool card reads it: the `text`\n * content blocks joined with newlines, non-text blocks (images) dropped.\n */\n\nconst TAB = '\\t';\nconst TAB_WIDTH = '  ';\n\nfunction isTextBlock(block: unknown): block is { type: 'text'; text: string } {\n  return (\n    typeof block === 'object' &&\n    block !== null &&\n    (block as { type?: unknown }).type === 'text' &&\n    typeof (block as { text?: unknown }).text === 'string'\n  );\n}\n\n/** The text blocks of a result's content, joined with newlines. */\nexport function toolResultText(content: readonly unknown[]): string {\n  return content\n    .filter(isTextBlock)\n    .map((block) => block.text)\n    .join('\\n');\n}\n\n/**\n * toolResultText as lines a card can count and clip: tabs widened, CRLF\n * folded, trailing blank lines dropped, and no lines at all for no text.\n */\nexport function toolResultTextLines(content: readonly unknown[]): string[] {\n  const text = toolResultText(content);\n  if (text.length === 0) return [];\n  const lines = text.replaceAll('\\r\\n', '\\n').replaceAll('\\r', '\\n').replaceAll(TAB, TAB_WIDTH).split('\\n');\n  while (lines.length > 0 && lines.at(-1)?.trim() === '') lines.pop();\n  return lines;\n}\n"],"mappings":";;;;;AAKA,MAAM,MAAM;AACZ,MAAM,YAAY;AAElB,SAAS,YAAY,OAAyD;CAC5E,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAA6B,SAAS,UACvC,OAAQ,MAA6B,SAAS;AAElD;;AAGA,SAAgB,eAAe,SAAqC;CAClE,OAAO,QACJ,OAAO,WAAW,CAAC,CACnB,KAAK,UAAU,MAAM,IAAI,CAAC,CAC1B,KAAK,IAAI;AACd;;;;;AAMA,SAAgB,oBAAoB,SAAuC;CACzE,MAAM,OAAO,eAAe,OAAO;CACnC,IAAI,KAAK,WAAW,GAAG,OAAO,CAAC;CAC/B,MAAM,QAAQ,KAAK,WAAW,QAAQ,IAAI,CAAC,CAAC,WAAW,MAAM,IAAI,CAAC,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,MAAM,IAAI;CACxG,OAAO,MAAM,SAAS,KAAK,MAAM,GAAG,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,MAAM,IAAI;CAClE,OAAO;AACT"}

package/dist/src/web/types/extensionFile.d.mts

@@ -0,0 +1,59 @@
+import { WebTemplateContribution } from "./template.mjs";
+import { ActivityGroupContribution, ContextActionContribution, DockFaceContribution, LeaderBindingContribution, MinorModeContribution, PaletteCommandContribution, SelectionAxisContribution, SessionChannelContribution, SettingsPanelContribution, SettingsSectionContribution, SlotDeclaration, SlotFillContribution, TabContribution, ToolRendererContribution, UserMessageActionContribution } from "./webPlugin.mjs";
+//#region src/web/types/extensionFile.d.ts
+/**
+ * What a folder-routed frontend file may export, per surface.
+ *
+ * The path-derived keys are optional rather than absent, because the
+ * generated entry spreads the authored value over the derived identity: a file
+ * that states its own id keeps it. See docs/extension-layout.md for which
+ * folder produces which of these.
+ *
+ * There is no factory form here. The cockpit builds its plugin definition as
+ * data and starts it separately, so a frontend contribution has no mount
+ * context to receive.
+ */
+/** The host contract with the keys a path derives made optional. */
+export type PathSupplied<TContribution, TKeys extends keyof TContribution> = Omit<TContribution, TKeys> & Partial<Pick<TContribution, TKeys>>;
+/** `tool/<name>.tsx`. The filename names the tool this renders, in snake case. */
+export type ToolRendererFile = PathSupplied<ToolRendererContribution, 'tools'>;
+/** `command/<name>.tsx`. The filename becomes the palette command id, in kebab case. */
+export type PaletteCommandFile = PathSupplied<PaletteCommandContribution, 'id'>;
+/** `tab/<Name>.tsx`. The filename becomes the tab id, in kebab case. */
+export type TabFile = PathSupplied<TabContribution, 'id'>;
+/** `template/<name>.web.ts`. The filename becomes the stable template id. */
+export type WebTemplateFile = PathSupplied<WebTemplateContribution, 'id'>;
+/** `dock/<Name>.tsx`. The filename becomes the dock face id, in kebab case. */
+export type DockFaceFile = PathSupplied<DockFaceContribution, 'id'>;
+/** `setting/<name>.tsx` exporting fields. The filename becomes the section id. */
+export type SettingsSectionFile = PathSupplied<SettingsSectionContribution, 'id'>;
+/** `setting/<name>.tsx` exporting a component. The filename becomes the panel id. */
+export type SettingsPanelFile = PathSupplied<SettingsPanelContribution, 'id'>;
+/** `slot/<name>.ts`. The slot is namespaced as `<pluginId>.<name>`. */
+export type SlotFile<TData = unknown> = PathSupplied<SlotDeclaration<TData>, 'slot'>;
+/** `fill/<Name>.<target>.tsx`. The target is the slot; the name becomes the fill id. */
+export type FillFile = PathSupplied<SlotFillContribution, 'slot' | 'id'>;
+/** `action/<name>.ts` offering an action for a context item kind. */
+export type ContextActionFile = PathSupplied<ContextActionContribution, 'id'>;
+/** `action/<name>.ts` offering an action on a user timeline message. */
+export type UserMessageActionFile = PathSupplied<UserMessageActionContribution, 'id'>;
+/** `activity-group/<name>.ts`. The filename is the group name and its slot. */
+export type ActivityGroupFile = PathSupplied<ActivityGroupContribution, 'name'>;
+/** `selection-axis/<name>.ts`. The filename becomes the axis name. */
+export type SelectionAxisFile = PathSupplied<SelectionAxisContribution, 'name'>;
+/**
+ * `leader/<name>.ts`. The filename is the binding's local name, namespaced
+ * under the plugin id, because the key tree is shared across plugins.
+ */
+export type LeaderBindingFile = LeaderBindingContribution extends (infer Binding) ? Binding extends {
+  id: string;
+} ? Omit<Binding, 'id'> & Partial<Pick<Binding, 'id'>> : never : never;
+/** `mode/<name>/mode.ts`. The gate folder names the mode, in kebab case. */
+export type MinorModeFile = PathSupplied<MinorModeContribution, 'name'>;
+/**
+ * `channel/<frameType>.ts`. Usually the result of a session store's `channel`,
+ * which already names the frame type, so the derived one is only a default.
+ */
+export type ChannelFile<TPayload = unknown> = PathSupplied<SessionChannelContribution<TPayload>, 'channel'>;
+//#endregion
+//# sourceMappingURL=extensionFile.d.mts.map

package/dist/src/web/types/extensionFile.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../../src/web/types/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;YAiCY,aAAa,eAAe,oBAAoB,iBAAiB,KAAK,eAAe,SAC/F,QAAQ,KAAK,eAAe;;YAGlB,mBAAmB,aAAa;;YAGhC,qBAAqB,aAAa;;YAGlC,UAAU,aAAa;;YAGvB,kBAAkB,aAAa;;YAE/B,eAAe,aAAa;;YAG5B,sBAAsB,aAAa;;YAGnC,oBAAoB,aAAa;;YAGjC,SAAS,mBAAmB,aAAa,gBAAgB;;YAGzD,WAAW,aAAa;;YAGxB,oBAAoB,aAAa;;YAGjC,wBAAwB,aAAa;;YAGrC,oBAAoB,aAAa;;YAGjC,oBAAoB,aAAa;;;;;YAMjC,oBAAoB,yCAAwC,WACpE;EAAkB;IAChB,KAAK,iBAAiB,QAAQ,KAAK;;YAK7B,gBAAgB,aAAa;;;;;YAM7B,YAAY,sBAAsB,aAAa,2BAA2B"}

package/dist/src/web/types/mcpWidget.d.mts

@@ -0,0 +1,14 @@
+import { CallToolResult } from "@modelcontextprotocol/server";
+//#region src/web/types/mcpWidget.d.ts
+/** The MCP host supplies invocation data. Widgets never receive host services or credentials. */
+export interface DoomMcpWidgetProps {
+  readonly toolName: string;
+  readonly args: Readonly<Record<string, unknown>>;
+  readonly result: CallToolResult | null;
+  readonly phase: 'connecting' | 'preparing' | 'running' | 'result' | 'cancelled' | 'error';
+  readonly error?: string;
+  /** Only available when this tool explicitly allows app calls and the host supports them. */
+  readonly refresh?: () => Promise<CallToolResult>;
+}
+//#endregion
+//# sourceMappingURL=mcpWidget.d.mts.map

package/dist/src/web/types/mcpWidget.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpWidget.d.mts","names":[],"sources":["../../../../src/web/types/mcpWidget.ts"],"mappings":";;;iBAGiB;WACN;WACA,MAAM,SAAS;WACf,QAAQ;WACR;WACA;;WAEA,gBAAgB,QAAQ"}