@conciv/protocol 0.0.1

package/dist/ui-types.js

@@ -0,0 +1,136 @@
+import { z } from "zod";
+import { EventType } from "@tanstack/ai";
+//#region src/ui-types.ts
+const renderId = z.string().min(1);
+const UiFormFieldSchema = z.object({
+	name: z.string(),
+	label: z.string(),
+	type: z.enum(["text", "select"]),
+	options: z.array(z.string()).optional()
+});
+const UiChoicesSchema = z.object({
+	kind: z.literal("choices"),
+	renderId,
+	question: z.string(),
+	options: z.array(z.string()).min(1)
+});
+const UiConfirmSchema = z.object({
+	kind: z.literal("confirm"),
+	renderId,
+	question: z.string(),
+	detail: z.string().optional()
+});
+const UiDiffSchema = z.object({
+	kind: z.literal("diff"),
+	renderId,
+	file: z.string(),
+	before: z.string(),
+	after: z.string()
+});
+const UiFormSchema = z.object({
+	kind: z.literal("form"),
+	renderId,
+	title: z.string().optional(),
+	fields: z.array(UiFormFieldSchema).min(1)
+});
+const UiVitestSchema = z.object({
+	kind: z.literal("vitest"),
+	renderId
+});
+const UiSpecSchema = z.discriminatedUnion("kind", [
+	UiChoicesSchema,
+	UiConfirmSchema,
+	UiDiffSchema,
+	UiFormSchema,
+	UiVitestSchema
+]);
+const CONCIV_UI_EVENT = "conciv-ui";
+function aguiCustomFor(spec) {
+	return {
+		type: EventType.CUSTOM,
+		name: CONCIV_UI_EVENT,
+		value: spec
+	};
+}
+const APPROVAL_REQUESTED_EVENT = "approval-requested";
+function aguiApprovalRequestedFor(req) {
+	return {
+		type: EventType.CUSTOM,
+		name: APPROVAL_REQUESTED_EVENT,
+		value: {
+			toolCallId: req.toolCallId,
+			toolName: req.toolName,
+			input: req.input,
+			approval: { id: req.approvalId }
+		}
+	};
+}
+function parseUiSpec(input) {
+	const result = UiSpecSchema.safeParse(input);
+	return result.success ? result.data : null;
+}
+function parseField(raw) {
+	const [name, label, type, opts] = raw.split(":");
+	if (!name || !label) return null;
+	if (type !== "text" && type !== "select") return null;
+	if (type === "select") {
+		const options = (opts ?? "").split(",").filter(Boolean);
+		if (options.length === 0) return null;
+		return {
+			name,
+			label,
+			type,
+			options
+		};
+	}
+	return {
+		name,
+		label,
+		type
+	};
+}
+function buildUiSpec(input, id) {
+	if (input.kind === "choices") {
+		if (!input.question) throw new Error("choices needs a question");
+		if (!input.options?.length) throw new Error("choices needs at least one option");
+		return {
+			kind: "choices",
+			renderId: id,
+			question: input.question,
+			options: input.options
+		};
+	}
+	if (input.kind === "confirm") {
+		if (!input.question) throw new Error("confirm needs a question");
+		return {
+			kind: "confirm",
+			renderId: id,
+			question: input.question,
+			detail: input.detail
+		};
+	}
+	if (input.kind === "diff") {
+		if (input.file === void 0 || input.before === void 0 || input.after === void 0) throw new Error("diff needs file, before, and after");
+		return {
+			kind: "diff",
+			renderId: id,
+			file: input.file,
+			before: input.before,
+			after: input.after
+		};
+	}
+	if (input.kind === "form") {
+		if (!input.fields?.length) throw new Error("form needs at least one field");
+		return {
+			kind: "form",
+			renderId: id,
+			title: input.title,
+			fields: input.fields
+		};
+	}
+	throw new Error(`unknown ui kind: ${input.kind}`);
+}
+//#endregion
+export { APPROVAL_REQUESTED_EVENT, CONCIV_UI_EVENT, UiChoicesSchema, UiConfirmSchema, UiDiffSchema, UiFormFieldSchema, UiFormSchema, UiSpecSchema, UiVitestSchema, aguiApprovalRequestedFor, aguiCustomFor, buildUiSpec, parseField, parseUiSpec };
+
+//# sourceMappingURL=ui-types.js.map

package/dist/ui-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-types.js","names":[],"sources":["../src/ui-types.ts"],"sourcesContent":["import {z} from 'zod'\nimport {EventType, type StreamChunk} from '@tanstack/ai'\n\n// Generative-UI specs the chat agent emits via `conciv ui …`, rendered as components in the\n// chat thread and carried to the widget as an AG-UI CUSTOM event. The schemas are the contract;\n// types are inferred from them.\n\nconst renderId = z.string().min(1)\n\nexport const UiFormFieldSchema = z.object({\n  name: z.string(),\n  label: z.string(),\n  type: z.enum(['text', 'select']),\n  options: z.array(z.string()).optional(),\n})\n\nexport const UiChoicesSchema = z.object({\n  kind: z.literal('choices'),\n  renderId,\n  question: z.string(),\n  options: z.array(z.string()).min(1),\n})\nexport const UiConfirmSchema = z.object({\n  kind: z.literal('confirm'),\n  renderId,\n  question: z.string(),\n  detail: z.string().optional(),\n})\nexport const UiDiffSchema = z.object({\n  kind: z.literal('diff'),\n  renderId,\n  file: z.string(),\n  before: z.string(),\n  after: z.string(),\n})\nexport const UiFormSchema = z.object({\n  kind: z.literal('form'),\n  renderId,\n  title: z.string().optional(),\n  fields: z.array(UiFormFieldSchema).min(1),\n})\n// Test-results card injected by the test route. (Kind stays 'vitest' until Plan 3.)\nexport const UiVitestSchema = z.object({kind: z.literal('vitest'), renderId})\n\nexport const UiSpecSchema = z.discriminatedUnion('kind', [\n  UiChoicesSchema,\n  UiConfirmSchema,\n  UiDiffSchema,\n  UiFormSchema,\n  UiVitestSchema,\n])\n\nexport type UiFormField = z.infer<typeof UiFormFieldSchema>\nexport type UiFieldType = UiFormField['type']\nexport type UiSpec = z.infer<typeof UiSpecSchema>\nexport type UiChoices = z.infer<typeof UiChoicesSchema>\nexport type UiConfirm = z.infer<typeof UiConfirmSchema>\nexport type UiDiff = z.infer<typeof UiDiffSchema>\nexport type UiForm = z.infer<typeof UiFormSchema>\nexport type UiVitest = z.infer<typeof UiVitestSchema>\n\n// The CUSTOM event name the widget listens for via useChat({onCustomEvent}).\nexport const CONCIV_UI_EVENT = 'conciv-ui'\n\n// Wrap a spec as the AG-UI CUSTOM StreamChunk injected into the live chat stream.\nexport function aguiCustomFor(spec: UiSpec): StreamChunk {\n  return {type: EventType.CUSTOM, name: CONCIV_UI_EVENT, value: spec}\n}\n\n// tanstack's StreamProcessor consumes this reserved CUSTOM event name to drive a tool-call part into\n// its NATIVE approval-requested state — it sets part.state='approval-requested' and part.approval\n// (see @tanstack/ai processor handleCustomEvent). The risky-Bash gate emits it so approval renders on\n// the tool card itself (no separate GenUi card). The decision returns out-of-band via\n// /api/chat/permission-decision: claude owns the loop and blocks on its PreToolUse hook, so the\n// decision cannot ride the one-way stream back (it would deadlock the live turn).\nexport const APPROVAL_REQUESTED_EVENT = 'approval-requested'\n\n// The value shape the StreamProcessor reads off the approval-requested CUSTOM event. toolCallId MUST\n// equal the streamed tool-call part id (= claude's tool_use_id) so the right part is targeted.\nexport type ApprovalRequest = {toolCallId: string; toolName: string; input: unknown; approvalId: string}\n\nexport function aguiApprovalRequestedFor(req: ApprovalRequest): StreamChunk {\n  return {\n    type: EventType.CUSTOM,\n    name: APPROVAL_REQUESTED_EVENT,\n    value: {toolCallId: req.toolCallId, toolName: req.toolName, input: req.input, approval: {id: req.approvalId}},\n  }\n}\n\n// For non-h3 callers; route handlers use readValidatedBody(event, UiSpecSchema) directly.\nexport function parseUiSpec(input: unknown): UiSpec | null {\n  const result = UiSpecSchema.safeParse(input)\n  return result.success ? result.data : null\n}\n\n// Parse a CLI form-field spec `name:label:type[:opt1,opt2]` into a typed field. null if malformed.\nexport function parseField(raw: string): UiFormField | null {\n  const [name, label, type, opts] = raw.split(':')\n  if (!name || !label) return null\n  if (type !== 'text' && type !== 'select') return null\n  if (type === 'select') {\n    const options = (opts ?? '').split(',').filter(Boolean)\n    if (options.length === 0) return null\n    return {name, label, type, options}\n  }\n  return {name, label, type}\n}\n\n// Normalized builder input — shared by the CLI (`conciv ui`) and the conciv_ui MCP tool. Both\n// normalize their own raw args to this shape, then call buildUiSpec.\nexport type UiBuildInput = {\n  kind: string\n  question?: string\n  detail?: string\n  options?: string[]\n  file?: string\n  before?: string\n  after?: string\n  title?: string\n  fields?: UiFormField[]\n}\n\n// Pure: normalized input + a caller-supplied renderId → a typed UiSpec. Throws on invalid input.\nexport function buildUiSpec(input: UiBuildInput, id: string): UiSpec {\n  if (input.kind === 'choices') {\n    if (!input.question) throw new Error('choices needs a question')\n    if (!input.options?.length) throw new Error('choices needs at least one option')\n    return {kind: 'choices', renderId: id, question: input.question, options: input.options}\n  }\n  if (input.kind === 'confirm') {\n    if (!input.question) throw new Error('confirm needs a question')\n    return {kind: 'confirm', renderId: id, question: input.question, detail: input.detail}\n  }\n  if (input.kind === 'diff') {\n    if (input.file === undefined || input.before === undefined || input.after === undefined) {\n      throw new Error('diff needs file, before, and after')\n    }\n    return {kind: 'diff', renderId: id, file: input.file, before: input.before, after: input.after}\n  }\n  if (input.kind === 'form') {\n    if (!input.fields?.length) throw new Error('form needs at least one field')\n    return {kind: 'form', renderId: id, title: input.title, fields: input.fields}\n  }\n  throw new Error(`unknown ui kind: ${input.kind}`)\n}\n"],"mappings":"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"}

package/dist/usage-types.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { StreamChunk, TokenUsage } from "@tanstack/ai";
+
+//#region src/usage-types.d.ts
+declare const UsageSnapshotSchema: z.ZodObject<{
+  modelId: z.ZodOptional<z.ZodString>;
+  contextWindow: z.ZodOptional<z.ZodNumber>;
+  inputTokens: z.ZodOptional<z.ZodNumber>;
+  outputTokens: z.ZodOptional<z.ZodNumber>;
+  cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+  cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+  reasoningTokens: z.ZodOptional<z.ZodNumber>;
+  totalCostUsd: z.ZodOptional<z.ZodNumber>;
+  numTurns: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type UsageSnapshot = z.infer<typeof UsageSnapshotSchema>;
+declare function snapshotToTokenUsage(s: UsageSnapshot): TokenUsage;
+declare function tokenUsageToSnapshot(u: TokenUsage): UsageSnapshot;
+declare const CONCIV_USAGE_EVENT = "conciv-usage";
+declare function aguiUsageFor(snapshot: UsageSnapshot): StreamChunk;
+declare function contextUsedTokens(s: UsageSnapshot): number | undefined;
+//#endregion
+export { CONCIV_USAGE_EVENT, UsageSnapshot, UsageSnapshotSchema, aguiUsageFor, contextUsedTokens, snapshotToTokenUsage, tokenUsageToSnapshot };
+//# sourceMappingURL=usage-types.d.ts.map

package/dist/usage-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-types.d.ts","names":[],"sources":["../src/usage-types.ts"],"mappings":";;;;cAIa,mBAAA,EAAmB,CAAA,CAAA,SAAA;;;;;;;;;;;KAWpB,aAAA,GAAgB,CAAA,CAAE,KAAK,QAAQ,mBAAA;AAAA,iBAW3B,oBAAA,CAAqB,CAAA,EAAG,aAAA,GAAgB,UAAU;AAAA,iBAkBlD,oBAAA,CAAqB,CAAA,EAAG,UAAA,GAAa,aAAa;AAAA,cAiBrD,kBAAA;AAAA,iBACG,YAAA,CAAa,QAAA,EAAU,aAAA,GAAgB,WAAW;AAAA,iBAKlD,iBAAA,CAAkB,CAAgB,EAAb,aAAa"}

package/dist/usage-types.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { EventType } from "@tanstack/ai";
+//#region src/usage-types.ts
+const UsageSnapshotSchema = z.object({
+	modelId: z.string().optional(),
+	contextWindow: z.number().int().nonnegative().optional(),
+	inputTokens: z.number().int().nonnegative().optional(),
+	outputTokens: z.number().int().nonnegative().optional(),
+	cacheReadTokens: z.number().int().nonnegative().optional(),
+	cacheWriteTokens: z.number().int().nonnegative().optional(),
+	reasoningTokens: z.number().int().nonnegative().optional(),
+	totalCostUsd: z.number().nonnegative().optional(),
+	numTurns: z.number().int().nonnegative().optional()
+});
+function snapshotToTokenUsage(s) {
+	const provider = {
+		modelId: s.modelId,
+		contextWindow: s.contextWindow,
+		totalCostUsd: s.totalCostUsd,
+		numTurns: s.numTurns
+	};
+	return {
+		promptTokens: s.inputTokens ?? 0,
+		completionTokens: s.outputTokens ?? 0,
+		totalTokens: (s.inputTokens ?? 0) + (s.outputTokens ?? 0),
+		promptTokensDetails: {
+			cachedTokens: s.cacheReadTokens,
+			cacheWriteTokens: s.cacheWriteTokens
+		},
+		completionTokensDetails: { reasoningTokens: s.reasoningTokens },
+		providerUsageDetails: provider
+	};
+}
+function tokenUsageToSnapshot(u) {
+	const p = u.providerUsageDetails ?? {};
+	return {
+		modelId: p.modelId,
+		contextWindow: p.contextWindow,
+		inputTokens: u.promptTokens,
+		outputTokens: u.completionTokens,
+		cacheReadTokens: u.promptTokensDetails?.cachedTokens,
+		cacheWriteTokens: u.promptTokensDetails?.cacheWriteTokens,
+		reasoningTokens: u.completionTokensDetails?.reasoningTokens,
+		totalCostUsd: p.totalCostUsd,
+		numTurns: p.numTurns
+	};
+}
+const CONCIV_USAGE_EVENT = "conciv-usage";
+function aguiUsageFor(snapshot) {
+	return {
+		type: EventType.CUSTOM,
+		name: CONCIV_USAGE_EVENT,
+		value: snapshot
+	};
+}
+function contextUsedTokens(s) {
+	const parts = [
+		s.inputTokens,
+		s.cacheReadTokens,
+		s.cacheWriteTokens
+	];
+	if (parts.every((p) => p === void 0)) return void 0;
+	return parts.reduce((sum, p) => sum + (p ?? 0), 0);
+}
+//#endregion
+export { CONCIV_USAGE_EVENT, UsageSnapshotSchema, aguiUsageFor, contextUsedTokens, snapshotToTokenUsage, tokenUsageToSnapshot };
+
+//# sourceMappingURL=usage-types.js.map

package/dist/usage-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-types.js","names":[],"sources":["../src/usage-types.ts"],"sourcesContent":["import {z} from 'zod'\nimport {EventType, type StreamChunk, type TokenUsage} from '@tanstack/ai'\n\n// Normalized per-session model usage; every field optional so a harness reports only what it has.\nexport const UsageSnapshotSchema = z.object({\n  modelId: z.string().optional(),\n  contextWindow: z.number().int().nonnegative().optional(),\n  inputTokens: z.number().int().nonnegative().optional(),\n  outputTokens: z.number().int().nonnegative().optional(),\n  cacheReadTokens: z.number().int().nonnegative().optional(),\n  cacheWriteTokens: z.number().int().nonnegative().optional(),\n  reasoningTokens: z.number().int().nonnegative().optional(),\n  totalCostUsd: z.number().nonnegative().optional(),\n  numTurns: z.number().int().nonnegative().optional(),\n})\nexport type UsageSnapshot = z.infer<typeof UsageSnapshotSchema>\n\n// Fields with no standard TokenUsage slot ride providerUsageDetails (one type keeps the mappers in sync).\ntype ConcivProviderUsage = {\n  modelId?: string\n  contextWindow?: number\n  totalCostUsd?: number\n  numTurns?: number\n}\n\n// Snapshot → native TokenUsage on RUN_FINISHED (survives chat(); CUSTOM chunks do not).\nexport function snapshotToTokenUsage(s: UsageSnapshot): TokenUsage {\n  const provider: ConcivProviderUsage = {\n    modelId: s.modelId,\n    contextWindow: s.contextWindow,\n    totalCostUsd: s.totalCostUsd,\n    numTurns: s.numTurns,\n  }\n  return {\n    promptTokens: s.inputTokens ?? 0,\n    completionTokens: s.outputTokens ?? 0,\n    totalTokens: (s.inputTokens ?? 0) + (s.outputTokens ?? 0),\n    promptTokensDetails: {cachedTokens: s.cacheReadTokens, cacheWriteTokens: s.cacheWriteTokens},\n    completionTokensDetails: {reasoningTokens: s.reasoningTokens},\n    providerUsageDetails: provider,\n  }\n}\n\n// Inverse of snapshotToTokenUsage: read a RUN_FINISHED usage back into our display shape.\nexport function tokenUsageToSnapshot(u: TokenUsage): UsageSnapshot {\n  const p = (u.providerUsageDetails ?? {}) as ConcivProviderUsage\n  return {\n    modelId: p.modelId,\n    contextWindow: p.contextWindow,\n    inputTokens: u.promptTokens,\n    outputTokens: u.completionTokens,\n    cacheReadTokens: u.promptTokensDetails?.cachedTokens,\n    cacheWriteTokens: u.promptTokensDetails?.cacheWriteTokens,\n    reasoningTokens: u.completionTokensDetails?.reasoningTokens,\n    totalCostUsd: p.totalCostUsd,\n    numTurns: p.numTurns,\n  }\n}\n\n// Live usage carried to the widget mid-turn as an AG-UI CUSTOM event, injected by core post-chat()\n// (the same seam conciv-ui uses). RUN_FINISHED.usage stays the canonical end-of-turn/persist value.\nexport const CONCIV_USAGE_EVENT = 'conciv-usage'\nexport function aguiUsageFor(snapshot: UsageSnapshot): StreamChunk {\n  return {type: EventType.CUSTOM, name: CONCIV_USAGE_EVENT, value: snapshot}\n}\n\n// Context occupancy = prompt resident in the window (input + cache), excluding output; undefined when no tokens.\nexport function contextUsedTokens(s: UsageSnapshot): number | undefined {\n  const parts = [s.inputTokens, s.cacheReadTokens, s.cacheWriteTokens]\n  if (parts.every((p) => p === undefined)) return undefined\n  return parts.reduce<number>((sum, p) => sum + (p ?? 0), 0)\n}\n"],"mappings":";;;AAIA,MAAa,sBAAsB,EAAE,OAAO;CAC1C,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;CAC7B,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CACvD,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CACrD,cAAc,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CACtD,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CACzD,kBAAkB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CAC1D,iBAAiB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CACzD,cAAc,EAAE,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;CAChD,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,CAAC,SAAS;AACpD,CAAC;AAYD,SAAgB,qBAAqB,GAA8B;CACjE,MAAM,WAAgC;EACpC,SAAS,EAAE;EACX,eAAe,EAAE;EACjB,cAAc,EAAE;EAChB,UAAU,EAAE;CACd;CACA,OAAO;EACL,cAAc,EAAE,eAAe;EAC/B,kBAAkB,EAAE,gBAAgB;EACpC,cAAc,EAAE,eAAe,MAAM,EAAE,gBAAgB;EACvD,qBAAqB;GAAC,cAAc,EAAE;GAAiB,kBAAkB,EAAE;EAAgB;EAC3F,yBAAyB,EAAC,iBAAiB,EAAE,gBAAe;EAC5D,sBAAsB;CACxB;AACF;AAGA,SAAgB,qBAAqB,GAA8B;CACjE,MAAM,IAAK,EAAE,wBAAwB,CAAC;CACtC,OAAO;EACL,SAAS,EAAE;EACX,eAAe,EAAE;EACjB,aAAa,EAAE;EACf,cAAc,EAAE;EAChB,iBAAiB,EAAE,qBAAqB;EACxC,kBAAkB,EAAE,qBAAqB;EACzC,iBAAiB,EAAE,yBAAyB;EAC5C,cAAc,EAAE;EAChB,UAAU,EAAE;CACd;AACF;AAIA,MAAa,qBAAqB;AAClC,SAAgB,aAAa,UAAsC;CACjE,OAAO;EAAC,MAAM,UAAU;EAAQ,MAAM;EAAoB,OAAO;CAAQ;AAC3E;AAGA,SAAgB,kBAAkB,GAAsC;CACtE,MAAM,QAAQ;EAAC,EAAE;EAAa,EAAE;EAAiB,EAAE;CAAgB;CACnE,IAAI,MAAM,OAAO,MAAM,MAAM,KAAA,CAAS,GAAG,OAAO,KAAA;CAChD,OAAO,MAAM,QAAgB,KAAK,MAAM,OAAO,KAAK,IAAI,CAAC;AAC3D"}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@conciv/protocol",
+  "version": "0.0.1",
+  "description": "Wire types shared by the conciv vite-plugin and widget.",
+  "keywords": [
+    "ag-ui",
+    "conciv",
+    "protocol",
+    "types"
+  ],
+  "homepage": "https://github.com/conciv-dev/conciv/tree/main/packages/protocol#readme",
+  "bugs": "https://github.com/conciv-dev/conciv/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/conciv-dev/conciv.git",
+    "directory": "packages/protocol"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./chat-types": {
+      "types": "./dist/chat-types.d.ts",
+      "import": "./dist/chat-types.js"
+    },
+    "./ui-types": {
+      "types": "./dist/ui-types.d.ts",
+      "import": "./dist/ui-types.js"
+    },
+    "./done-types": {
+      "types": "./dist/done-types.d.ts",
+      "import": "./dist/done-types.js"
+    },
+    "./editor-types": {
+      "types": "./dist/editor-types.d.ts",
+      "import": "./dist/editor-types.js"
+    },
+    "./harness-types": {
+      "types": "./dist/harness-types.d.ts",
+      "import": "./dist/harness-types.js"
+    },
+    "./bundler-types": {
+      "types": "./dist/bundler-types.d.ts",
+      "import": "./dist/bundler-types.js"
+    },
+    "./config-types": {
+      "types": "./dist/config-types.d.ts",
+      "import": "./dist/config-types.js"
+    },
+    "./page-types": {
+      "types": "./dist/page-types.d.ts",
+      "import": "./dist/page-types.js"
+    },
+    "./page-introspect-types": {
+      "types": "./dist/page-introspect-types.d.ts",
+      "import": "./dist/page-introspect-types.js"
+    },
+    "./usage-types": {
+      "types": "./dist/usage-types.d.ts",
+      "import": "./dist/usage-types.js"
+    },
+    "./tool-view-types": {
+      "types": "./dist/tool-view-types.d.ts",
+      "import": "./dist/tool-view-types.js"
+    },
+    "./tool-timing": {
+      "types": "./dist/tool-timing.d.ts",
+      "import": "./dist/tool-timing.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@tanstack/ai": "^0.28.0",
+    "@tanstack/ai-client": "^0.16.3",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.21",
+    "solid-js": "^1.9.13",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint",
+    "test": "vitest run",
+    "publint": "publint",
+    "attw": "attw --pack . --profile esm-only"
+  }
+}