@klarkxy/dsh-deep-view 0.1.0 → 0.2.0

package/lib/client.js

@@ -1033,6 +1033,281 @@ function validateForm(node, values) {
 	return { fields };
 }
 //#endregion
+//#region ../dsh-plugin-kit/src/log-shared.ts
+const PLUGIN_LOG_LEVELS = [
+	"debug",
+	"info",
+	"warn",
+	"error",
+	"fault"
+];
+const DEFAULT_PLUGIN_LOG_LEVEL = "info";
+const PLUGIN_LOG_MAX_MESSAGE_CHARS = 16e3;
+const SOURCE_RE = /^[a-z][a-z0-9-]{0,63}$/;
+const EVENT_RE = /^[a-z][a-z0-9._-]{0,127}$/;
+const CONTEXT_KEY_RE = /^[a-zA-Z][a-zA-Z0-9._-]{0,63}$/;
+const SECRET_KEY_RE = /(?:api[_-]?key|access[_-]?token|refresh[_-]?token|bearer|authorization|cookie|set[_-]?cookie|nonce|credential|private[_-]?key|password|secret|app[_-]?secret|client[_-]?secret|z_c0|d_c0)$/i;
+const CHAT_PAYLOAD_RE = /"role"\s*:\s*"(?:system|user|assistant|tool)"|"(?:messages|content|prompt|input_text|input_image|image_url)"\s*:\s*[\[{"']/i;
+const CREDENTIAL_BODY_RE = /-----BEGIN (?:RSA |EC |OPENSSH |PRIVATE )?PRIVATE KEY-----|"type"\s*:\s*"service_account"|credentials\.json|\.dsh[/\\](?:credentials|auth)/i;
+const AUTH_HEADER_RE = /\b(Authorization|Proxy-Authorization|Cookie|Set-Cookie)\s*:\s*[^\r\n]*/gi;
+const BEARER_RE = /\bBearer\s+[A-Za-z0-9._\-+=/]{8,}/g;
+const SECRET_FIELD_RE = /(["']?(?:api[_-]?key|access[_-]?token|refresh[_-]?token|token|bearer|authorization|cookie|set-cookie|nonce|credential|private[_-]?key|password|secret|app[_-]?secret|client[_-]?secret|password|z_c0|d_c0)["']?\s*[:=]\s*)(?:"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|[^\s,&;}]+)/gi;
+const SECRET_QUERY_RE = /([?&](?:token|api[_-]?key|key|secret|password|bootstrap|code|sig|signature|credential|password)=)[^\s&#"']+/gi;
+const URL_CREDENTIAL_RE = /\b(https?:\/\/)[^\s/:@]+:[^\s/@]+@/gi;
+const BOOTSTRAP_RE = /\/bootstrap\/[^\s"'?&#]+/gi;
+const KNOWN_TOKEN_RE = /\b(?:sk-[A-Za-z0-9_-]{10,}|gh[pousr]_[A-Za-z0-9_]{16,}|github_pat_[A-Za-z0-9_]{20,}|tvly-[A-Za-z0-9_-]{10,}|AKIA[0-9A-Z]{16})\b/g;
+const PATH_RE = /(?:[A-Za-z]:\\|\\\\)[^\s"'`<>|]+|(?:\/(?:home|Users|tmp|var|root)\/|~\/)[^\s"'`<>|]+/g;
+function isPluginLogLevel(value) {
+	return typeof value === "string" && PLUGIN_LOG_LEVELS.includes(value);
+}
+function pluginLogLevelEnabled(level, minimum) {
+	return PLUGIN_LOG_LEVELS.indexOf(level) >= PLUGIN_LOG_LEVELS.indexOf(minimum);
+}
+function normalizePluginLogSource(raw) {
+	const stripped = String(raw || "").trim().replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "");
+	const bounded = (/^[a-z]/.test(stripped) ? stripped : `p-${stripped}`).slice(0, 64).replace(/-+$/g, "");
+	return SOURCE_RE.test(bounded) ? bounded : "dsh-plugin";
+}
+function normalizePluginLogEvent(raw) {
+	const cleaned = String(raw || "").trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^[^a-z]+/, "").slice(0, 128);
+	return EVENT_RE.test(cleaned) ? cleaned : "plugin.event";
+}
+/**
+* Parse a level specification like `debug` or `dsh-zhihu=debug,dsh-dot:warn,info`.
+* Source-specific rules win over a bare fallback level.
+*/
+function parsePluginLogLevel(spec, source, fallback = DEFAULT_PLUGIN_LOG_LEVEL) {
+	if (!spec || typeof spec !== "string") return fallback;
+	const normalizedSource = source ? normalizePluginLogSource(source) : void 0;
+	let wildcard;
+	for (const token of spec.split(",").map((part) => part.trim()).filter(Boolean)) {
+		const lowered = token.toLowerCase();
+		if (isPluginLogLevel(lowered)) {
+			wildcard = lowered;
+			continue;
+		}
+		const match = /^([^=:]+)[=:]([a-z]+)$/i.exec(token);
+		if (!match) continue;
+		const target = match[1].trim();
+		const candidate = match[2].trim().toLowerCase();
+		if (!isPluginLogLevel(candidate)) continue;
+		if (target === "*") {
+			wildcard = candidate;
+			continue;
+		}
+		if (normalizedSource && normalizePluginLogSource(target) === normalizedSource) return candidate;
+	}
+	return wildcard ?? fallback;
+}
+function sanitizePluginLogText(text, maxChars = PLUGIN_LOG_MAX_MESSAGE_CHARS) {
+	if (!text) return "";
+	if (CREDENTIAL_BODY_RE.test(text)) return "[omitted credential material]";
+	if (CHAT_PAYLOAD_RE.test(text)) return "[omitted chat payload]";
+	return truncateLogText(text.replace(AUTH_HEADER_RE, "$1: [redacted]").replace(BEARER_RE, "Bearer [redacted]").replace(SECRET_FIELD_RE, (full, prefix) => {
+		const value = full.slice(prefix.length);
+		if (value.startsWith("\"")) return `${prefix}"[redacted]"`;
+		if (value.startsWith("'")) return `${prefix}'[redacted]'`;
+		return `${prefix}[redacted]`;
+	}).replace(SECRET_QUERY_RE, "$1[redacted]").replace(URL_CREDENTIAL_RE, "$1[redacted]@").replace(BOOTSTRAP_RE, "/bootstrap/[redacted]").replace(KNOWN_TOKEN_RE, "[redacted]").replace(PATH_RE, "[path]"), maxChars);
+}
+function sanitizePluginLogContext(input) {
+	if (!input) return void 0;
+	const output = {};
+	for (const [key, value] of Object.entries(input).slice(0, 32)) {
+		if (value === void 0 || !CONTEXT_KEY_RE.test(key)) continue;
+		if (typeof value === "number" && !Number.isFinite(value)) continue;
+		if (SECRET_KEY_RE.test(key)) {
+			output[key] = "[redacted]";
+			continue;
+		}
+		output[key] = typeof value === "string" ? sanitizePluginLogText(value, 1e3) : value;
+	}
+	if (!Object.keys(output).length) return void 0;
+	if (JSON.stringify(output).length <= 8e3) return output;
+	return {
+		omitted: true,
+		reason: "Diagnostic context exceeded its size limit."
+	};
+}
+function sanitizePluginLogError(error) {
+	if (error === void 0) return void 0;
+	const row = error && typeof error === "object" ? error : {};
+	const rawMessage = typeof row.message === "string" ? row.message : String(error);
+	const result = {
+		name: typeof row.name === "string" && row.name.trim() ? truncateLogText(row.name.trim(), 100) : "Error",
+		message: sanitizePluginLogText(rawMessage) || "Unknown error"
+	};
+	if (typeof row.stack === "string" && row.stack.trim()) result.stack = sanitizePluginLogText(row.stack, 24e3);
+	if (typeof row.code === "string" && /^[A-Za-z0-9_./:-]{1,100}$/.test(row.code)) result.code = row.code;
+	else if (typeof row.code === "number" && Number.isFinite(row.code)) result.code = String(row.code);
+	return result;
+}
+function mergePluginLogContext(base, extra) {
+	if (!base) return extra;
+	if (!extra) return base;
+	return {
+		...base,
+		...extra
+	};
+}
+function buildPluginLogEntry(input, meta) {
+	const entry = {
+		version: 1,
+		at: meta.at.toISOString(),
+		level: isPluginLogLevel(input.level) ? input.level : "info",
+		source: normalizePluginLogSource(meta.source),
+		surface: meta.surface,
+		...meta.profile ? { profile: meta.profile } : {},
+		event: normalizePluginLogEvent(input.event),
+		message: sanitizePluginLogText(input.message || "No diagnostic message was provided.", PLUGIN_LOG_MAX_MESSAGE_CHARS),
+		...meta.pid !== void 0 ? { pid: meta.pid } : {}
+	};
+	const context = sanitizePluginLogContext(mergePluginLogContext(meta.correlation, input.context));
+	if (context) entry.context = context;
+	const error = sanitizePluginLogError(input.error);
+	if (error) entry.error = error;
+	return entry;
+}
+function createChildPluginLogger(parent, bound) {
+	return {
+		get source() {
+			return parent.source;
+		},
+		get file() {
+			return parent.file;
+		},
+		get lastWriteError() {
+			return parent.lastWriteError;
+		},
+		debug: (event, message, context) => parent.debug(event, message, mergePluginLogContext(bound, context)),
+		info: (event, message, context) => parent.info(event, message, mergePluginLogContext(bound, context)),
+		warn: (event, message, error, context) => parent.warn(event, message, error, mergePluginLogContext(bound, context)),
+		error: (event, message, error, context) => parent.error(event, message, error, mergePluginLogContext(bound, context)),
+		fault: (event, message, error, context) => parent.fault(event, message, error, mergePluginLogContext(bound, context)),
+		write: (input) => parent.write({
+			...input,
+			context: mergePluginLogContext(bound, input.context)
+		}),
+		child: (next) => createChildPluginLogger(parent, mergePluginLogContext(bound, next) ?? {})
+	};
+}
+function truncateLogText(text, maxChars) {
+	if (text.length <= maxChars) return text;
+	const marker = "[truncated]\n";
+	if (maxChars <= 12) return text.slice(0, Math.max(0, maxChars));
+	return `${marker}${text.slice(-(maxChars - 12))}`;
+}
+//#endregion
+//#region ../dsh-plugin-kit/src/client-logger.ts
+const CLIENT_PLUGIN_LOG_GLOBAL = "__KLARKXY_PLUGIN_LOGS__";
+function readStorageFlag(key) {
+	try {
+		const value = (globalThis.window?.localStorage)?.getItem?.(key);
+		return typeof value === "string" && value.trim() ? value.trim() : void 0;
+	} catch {
+		return;
+	}
+}
+function sharedClientBuffer(limit) {
+	const carrier = globalThis;
+	if (!Array.isArray(carrier["__KLARKXY_PLUGIN_LOGS__"])) try {
+		carrier[CLIENT_PLUGIN_LOG_GLOBAL] = [];
+	} catch {
+		return [];
+	}
+	const list = carrier[CLIENT_PLUGIN_LOG_GLOBAL];
+	const overflow = list.length - limit;
+	if (overflow > 0) list.splice(0, overflow);
+	return list;
+}
+function createClientPluginLogger(source, ctx, options = {}) {
+	const normalized = normalizePluginLogSource(source);
+	const now = options.now ?? (() => /* @__PURE__ */ new Date());
+	const limit = Math.max(10, options.bufferLimit ?? 500);
+	const browserCtx = ctx && typeof ctx === "object" ? ctx : void 0;
+	const resolveMinimum = () => {
+		if (options.minimumLevel) return options.minimumLevel;
+		return parsePluginLogLevel(readStorageFlag("dsh-plugin-log-level"), normalized, DEFAULT_PLUGIN_LOG_LEVEL);
+	};
+	const logger = {
+		source: normalized,
+		file: null,
+		lastWriteError: null,
+		debug: (event, message, context) => logger.write({
+			level: "debug",
+			event,
+			message,
+			...context ? { context } : {}
+		}),
+		info: (event, message, context) => logger.write({
+			level: "info",
+			event,
+			message,
+			...context ? { context } : {}
+		}),
+		warn: (event, message, error, context) => logger.write({
+			level: "warn",
+			event,
+			message,
+			...error !== void 0 ? { error } : {},
+			...context ? { context } : {}
+		}),
+		error: (event, message, error, context) => logger.write({
+			level: "error",
+			event,
+			message,
+			...error !== void 0 ? { error } : {},
+			...context ? { context } : {}
+		}),
+		fault: (event, message, error, context) => logger.write({
+			level: "fault",
+			event,
+			message,
+			...error !== void 0 ? { error } : {},
+			...context ? { context } : {}
+		}),
+		child: (context) => createChildPluginLogger(logger, context),
+		write(input) {
+			try {
+				if (!pluginLogLevelEnabled(input.level, resolveMinimum())) return false;
+				const entry = buildPluginLogEntry(input, {
+					at: now(),
+					source: normalized,
+					surface: "client"
+				});
+				const buffer = sharedClientBuffer(limit);
+				buffer.push(entry);
+				const overflow = buffer.length - limit;
+				if (overflow > 0) buffer.splice(0, overflow);
+				if (options.forwardToHostLogger !== false && browserCtx?.logger) {
+					const summary = sanitizePluginLogText(`${normalized} [${entry.event}]: ${entry.message}`, 500);
+					if (entry.level === "warn" && typeof browserCtx.logger.warn === "function") browserCtx.logger.warn(summary);
+					else if ((entry.level === "error" || entry.level === "fault") && typeof browserCtx.logger.error === "function") browserCtx.logger.error(summary);
+				}
+				if (readStorageFlag("dsh-plugin-log-console") === "1") {
+					const con = globalThis.console;
+					(entry.level === "debug" ? con?.debug : entry.level === "info" ? con?.info : entry.level === "warn" ? con?.warn : con?.error)?.call(con, `[${normalized}] ${entry.event}: ${entry.message}`, entry);
+				}
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	};
+	return logger;
+}
+function installClientPluginLogger(ctx, source, options = {}) {
+	const logger = createClientPluginLogger(source, ctx, options);
+	logger.info("client.loaded", "Client plugin initialized.", options.loadedContext);
+	const browserCtx = ctx && typeof ctx === "object" ? ctx : void 0;
+	if (typeof browserCtx?.effect === "function") try {
+		browserCtx.effect(() => () => {
+			logger.debug("client.disposed", "Client plugin disposed.");
+		}, `${logger.source}.client-logger`);
+	} catch {}
+	return logger;
+}
+//#endregion
 //#region src/contracts.ts
 const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
 const RPC_CHANNEL = "/dsh-deep-view";
@@ -2699,14 +2974,7 @@ function sameAnswers(left, right) {
 	});
 }
 //#endregion
-//#region src/client.tsx
-const name = "dsh-deep-view-client";
-const inject = [
-	"slots",
-	"connection",
-	"locale"
-];
-const LOCALE = "deep-view";
+//#region src/copy.ts
 const uiZh = {
 	copy: "复制",
 	copied: "已复制",
@@ -2771,6 +3039,15 @@ const uiEn = {
 	send: "Send",
 	selected: "Selected"
 };
+//#endregion
+//#region src/client.tsx
+const name = "dsh-deep-view-client";
+const inject = [
+	"slots",
+	"connection",
+	"locale"
+];
+const LOCALE = "deep-view";
 const viewT = (t) => (key, params) => {
 	const keys = {
 		Copy: "copy",
@@ -2927,15 +3204,29 @@ function ToolCallView(props) {
 			action,
 			values
 		}).then((result) => {
-			if (result?.ok) {
+			const envelope = result;
+			if (envelope?.ok) {
 				setAnswer({
 					id: pending.id,
 					action,
 					values
 				});
 				setPending(null);
-			} else setFailed(true);
-		}).catch(() => setFailed(true)).finally(() => setBusy(false));
+			} else {
+				createClientPluginLogger(PLUGIN_NAME).warn("reply.rejected", "Deep View reply was rejected by host.", void 0, {
+					sessionId: props.sessionId,
+					viewId: pending.id,
+					code: envelope && !envelope.ok ? envelope.error.code : null
+				});
+				setFailed(true);
+			}
+		}).catch((error) => {
+			createClientPluginLogger(PLUGIN_NAME).error("reply.transport-error", "Deep View reply RPC failed.", error, {
+				sessionId: props.sessionId,
+				viewId: pending.id
+			});
+			setFailed(true);
+		}).finally(() => setBusy(false));
 	}, [
 		props.call,
 		props.sessionId,
@@ -2967,7 +3258,7 @@ function ToolCallView(props) {
 			view: shown.view,
 			onSubmit: canAnswer ? submit : void 0,
 			busy,
-			settled: answer !== null || !canAnswer,
+			settled: answer !== null || shown.awaitReply && !canAnswer,
 			answer,
 			t: viewT(t),
 			labels,
@@ -3035,8 +3326,65 @@ function ToolCallStatus(props) {
 		children: props.t(read.isError ? "error" : read.phase === "result" && !read.presentation ? "invalid" : read.phase === "result" ? "prepared" : "preparing")
 	});
 }
+/** Client service name other plugins read to draw show_view cards in their own surfaces. */
+const CARDS_SERVICE = "dshDeepView";
+function staticArgs(values) {
+	return {
+		has: (key) => values[key] !== void 0,
+		complete: (key) => values[key] !== void 0,
+		text: (key) => typeof values[key] === "string" ? values[key] : void 0,
+		value: (key) => values[key]
+	};
+}
+/** One show_view card for a plugin-drawn chat: same card, same answer channel as the host chat. */
+function createCards(call, locale) {
+	const subscribe = (listener) => locale?.subscribe?.(listener) ?? (() => {});
+	const active = () => locale?.getSnapshot?.().active ?? "en";
+	function Card(props) {
+		const language = (0, react.useSyncExternalStore)(subscribe, active);
+		const t = (0, react.useMemo)(() => {
+			const table = language.toLowerCase().startsWith("zh") ? uiZh : uiEn;
+			return (key, params) => (table[key] ?? key).replace(/\{(\w+)\}/g, (_, name) => String(params?.[name] ?? `{${name}}`));
+		}, [language]);
+		const block = (0, react.useMemo)(() => props.presentation !== void 0 ? {
+			callId: props.callId,
+			kind: "tool-result",
+			meta: props.presentation,
+			isError: false
+		} : props.failed ? {
+			callId: props.callId,
+			kind: "tool-result",
+			isError: true
+		} : {
+			callId: props.callId,
+			args: staticArgs({
+				title: props.title,
+				view: props.view
+			})
+		}, [
+			props.callId,
+			props.presentation,
+			props.failed,
+			props.title,
+			props.view
+		]);
+		const phase = props.presentation !== void 0 || props.failed ? "result" : "start";
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ToolCallView, {
+			sessionId: props.sessionId,
+			callId: props.callId,
+			phase,
+			block,
+			t,
+			call,
+			...props.answer ? { restoredAnswer: props.answer } : {}
+		});
+	}
+	return { Card };
+}
 function apply(ctx) {
 	const client = ctx;
+	installClientPluginLogger(ctx, PLUGIN_NAME);
+	client.provide(CARDS_SERVICE, createCards((endpoint, payload) => client.connection.rpc.call(RPC_CHANNEL, endpoint, payload), client.locale));
 	ctx.effect(() => client.locale.register(LOCALE, {
 		zh: { ...uiZh },
 		en: { ...uiEn }
@@ -3063,11 +3411,13 @@ function apply(ctx) {
 	}, ReplyView)), "deep-view.reply");
 }
 //#endregion
+exports.CARDS_SERVICE = CARDS_SERVICE;
 exports.LOCALE = LOCALE;
 exports.ReplyView = ReplyView;
 exports.ToolCallStatus = ToolCallStatus;
 exports.ToolCallView = ToolCallView;
 exports.apply = apply;
+exports.createCards = createCards;
 exports.inject = inject;
 exports.name = name;
 exports.readToolCall = readToolCall;

package/lib/contracts.d.ts

@@ -1,98 +1,2 @@
-import { RpcResult as RpcResult$1 } from "@klarkxy/dsh-plugin-kit/contracts";
-//#region src/contracts.d.ts
-type RpcResult<T = unknown> = RpcResult$1<T>;
-declare const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
-declare const RPC_CHANNEL = "/dsh-deep-view";
-declare const VIEW_OWNER = "dsh-deep-view";
-type Scalar = string | number | boolean;
-type Formula = {
-  '=': string;
-};
-type Value = Scalar | Formula;
-type ChoiceOption = {
-  label: string;
-  value?: Scalar;
-};
-type ViewNode = {
-  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources' | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit';
-  id?: string;
-  children?: ViewNode[];
-  let?: Record<string, string>;
-  text?: Value;
-  label?: string;
-  value?: Value;
-  tone?: Value;
-  caption?: Value;
-  columns?: {
-    key: string;
-    label: string;
-  }[];
-  rows?: Value[][];
-  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut';
-  categories?: Scalar[];
-  series?: {
-    name?: string;
-    values: (number | Formula)[];
-  }[];
-  unit?: string;
-  percent?: Value;
-  max?: Value;
-  valueLabel?: Value;
-  items?: {
-    label: string;
-    url: string;
-  }[];
-  min?: number;
-  step?: number;
-  options?: ChoiceOption[] | {
-    label: string;
-    description?: string;
-  }[];
-  multi?: boolean;
-  confirmLabel?: string;
-  cancelLabel?: string;
-  fields?: {
-    id: string;
-    label: string;
-    placeholder?: string;
-  }[];
-  submitLabel?: string;
-};
-type ShownView = {
-  title: string;
-  view: ViewNode;
-  interactive: boolean;
-};
-type ViewFailure = {
-  error: string;
-};
-type PendingView = {
-  id: string;
-  sessionId: string;
-  callId?: string;
-  title: string;
-  view: ViewNode;
-};
-type ViewAnswer = {
-  id: string;
-  action: string;
-  values: Record<string, unknown>;
-};
-/** Stored on the same user message as its readable answer, outside model text. */
-type ViewAnswerMetadata = {
-  owner: typeof VIEW_OWNER;
-  version: 1;
-  answer: ViewAnswer;
-};
-type ViewPresentation = {
-  owner: typeof VIEW_OWNER;
-  viewId?: string;
-  title: string;
-  view: ViewNode;
-  interactive: boolean;
-  awaitReply: boolean;
-};
-declare function isRecord(value: unknown): value is Record<string, unknown>;
-//#endregion
-export { ChoiceOption, Formula, PLUGIN_NAME, PendingView, RPC_CHANNEL, RpcResult, Scalar, ShownView, VIEW_OWNER, Value, ViewAnswer, ViewAnswerMetadata, ViewFailure, ViewNode, ViewPresentation, isRecord };
-//# sourceMappingURL=contracts.d.ts.map
+import { _ as ViewPresentation, a as PLUGIN_NAME, c as RpcResult, d as VIEW_OWNER, f as Value, g as ViewNode, h as ViewFailure, i as HOST_SERVICE, l as Scalar, m as ViewAnswerMetadata, n as DeepViewHost, o as PendingView, p as ViewAnswer, r as Formula, s as RPC_CHANNEL, t as ChoiceOption, u as ShownView, v as isRecord } from "./contracts2.js";
+export { ChoiceOption, DeepViewHost, Formula, HOST_SERVICE, PLUGIN_NAME, PendingView, RPC_CHANNEL, RpcResult, Scalar, ShownView, VIEW_OWNER, Value, ViewAnswer, ViewAnswerMetadata, ViewFailure, ViewNode, ViewPresentation, isRecord };

package/lib/contracts.js

@@ -2,10 +2,11 @@
 const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
 const RPC_CHANNEL = "/dsh-deep-view";
 const VIEW_OWNER = "dsh-deep-view";
+const HOST_SERVICE = "dshDeepView";
 function isRecord(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 //#endregion
-export { PLUGIN_NAME, RPC_CHANNEL, VIEW_OWNER, isRecord };
+export { HOST_SERVICE, PLUGIN_NAME, RPC_CHANNEL, VIEW_OWNER, isRecord };
 
 //# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["import type { RpcResult as SharedRpcResult } from '@klarkxy/dsh-plugin-kit/contracts'\nexport type RpcResult<T = unknown> = SharedRpcResult<T>\nexport const PLUGIN_NAME = '@klarkxy/dsh-deep-view'\nexport const RPC_CHANNEL = '/dsh-deep-view'\nexport const VIEW_OWNER = 'dsh-deep-view'\n\nexport type Scalar = string | number | boolean\nexport type Formula = { '=': string }\nexport type Value = Scalar | Formula\nexport type ChoiceOption = { label: string; value?: Scalar }\nexport type ViewNode = {\n  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources'\n    | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit'\n  id?: string\n  children?: ViewNode[]\n  let?: Record<string, string>\n  text?: Value\n  label?: string\n  value?: Value\n  tone?: Value\n  caption?: Value\n  columns?: { key: string; label: string }[]\n  rows?: Value[][]\n  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut'\n  categories?: Scalar[]\n  series?: { name?: string; values: (number | Formula)[] }[]\n  unit?: string\n  percent?: Value\n  max?: Value\n  valueLabel?: Value\n  items?: { label: string; url: string }[]\n  min?: number\n  step?: number\n  options?: ChoiceOption[] | { label: string; description?: string }[]\n  multi?: boolean\n  confirmLabel?: string\n  cancelLabel?: string\n  fields?: { id: string; label: string; placeholder?: string }[]\n  submitLabel?: string\n}\nexport type ShownView = { title: string; view: ViewNode; interactive: boolean }\nexport type ViewFailure = { error: string }\nexport type PendingView = { id: string; sessionId: string; callId?: string; title: string; view: ViewNode }\nexport type ViewAnswer = { id: string; action: string; values: Record<string, unknown> }\n/** Stored on the same user message as its readable answer, outside model text. */\nexport type ViewAnswerMetadata = { owner: typeof VIEW_OWNER; version: 1; answer: ViewAnswer }\nexport type ViewPresentation = {\n  owner: typeof VIEW_OWNER\n  viewId?: string\n  title: string\n  view: ViewNode\n  interactive: boolean\n  awaitReply: boolean\n}\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n"],"mappings":";AAEA,MAAa,cAAc;AAC3B,MAAa,cAAc;AAC3B,MAAa,aAAa;AAkD1B,SAAgB,SAAS,OAAkD;CACzE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E"}
+{"version":3,"file":"contracts.js","names":[],"sources":["../src/contracts.ts"],"sourcesContent":["import type { RpcResult as SharedRpcResult } from '@klarkxy/dsh-plugin-kit/contracts'\nexport type RpcResult<T = unknown> = SharedRpcResult<T>\nexport const PLUGIN_NAME = '@klarkxy/dsh-deep-view'\nexport const RPC_CHANNEL = '/dsh-deep-view'\nexport const VIEW_OWNER = 'dsh-deep-view'\nexport const HOST_SERVICE = 'dshDeepView'\nexport type DeepViewHost = {\n  /** Move an open card and route stale session lookups to a replacement root session. */\n  handoffSession(fromSessionId: string, toSessionId: string): boolean\n}\n\nexport type Scalar = string | number | boolean\nexport type Formula = { '=': string }\nexport type Value = Scalar | Formula\nexport type ChoiceOption = { label: string; value?: Scalar }\nexport type ViewNode = {\n  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources'\n    | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit'\n  id?: string\n  children?: ViewNode[]\n  let?: Record<string, string>\n  text?: Value\n  label?: string\n  value?: Value\n  tone?: Value\n  caption?: Value\n  columns?: { key: string; label: string }[]\n  rows?: Value[][]\n  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut'\n  categories?: Scalar[]\n  series?: { name?: string; values: (number | Formula)[] }[]\n  unit?: string\n  percent?: Value\n  max?: Value\n  valueLabel?: Value\n  items?: { label: string; url: string }[]\n  min?: number\n  step?: number\n  options?: ChoiceOption[] | { label: string; description?: string }[]\n  multi?: boolean\n  confirmLabel?: string\n  cancelLabel?: string\n  fields?: { id: string; label: string; placeholder?: string }[]\n  submitLabel?: string\n}\nexport type ShownView = { title: string; view: ViewNode; interactive: boolean }\nexport type ViewFailure = { error: string }\nexport type PendingView = { id: string; sessionId: string; callId?: string; title: string; view: ViewNode }\nexport type ViewAnswer = { id: string; action: string; values: Record<string, unknown> }\n/** Stored on the same user message as its readable answer, outside model text. */\nexport type ViewAnswerMetadata = { owner: typeof VIEW_OWNER; version: 1; answer: ViewAnswer }\nexport type ViewPresentation = {\n  owner: typeof VIEW_OWNER\n  viewId?: string\n  title: string\n  view: ViewNode\n  interactive: boolean\n  awaitReply: boolean\n}\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n"],"mappings":";AAEA,MAAa,cAAc;AAC3B,MAAa,cAAc;AAC3B,MAAa,aAAa;AAC1B,MAAa,eAAe;AAsD5B,SAAgB,SAAS,OAAkD;CACzE,OAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E"}

package/lib/contracts2.d.ts

@@ -0,0 +1,103 @@
+import { RpcResult } from "@klarkxy/dsh-plugin-kit/contracts";
+//#region src/contracts.d.ts
+type RpcResult$1<T = unknown> = RpcResult<T>;
+declare const PLUGIN_NAME = "@klarkxy/dsh-deep-view";
+declare const RPC_CHANNEL = "/dsh-deep-view";
+declare const VIEW_OWNER = "dsh-deep-view";
+declare const HOST_SERVICE = "dshDeepView";
+type DeepViewHost = {
+  /** Move an open card and route stale session lookups to a replacement root session. */
+  handoffSession(fromSessionId: string, toSessionId: string): boolean;
+};
+type Scalar = string | number | boolean;
+type Formula = {
+  '=': string;
+};
+type Value = Scalar | Formula;
+type ChoiceOption = {
+  label: string;
+  value?: Scalar;
+};
+type ViewNode = {
+  type: 'stack' | 'row' | 'text' | 'metric' | 'table' | 'chart' | 'progress' | 'callout' | 'sources' | 'slider' | 'number' | 'choice' | 'toggle' | 'options' | 'confirm' | 'form' | 'submit';
+  id?: string;
+  children?: ViewNode[];
+  let?: Record<string, string>;
+  text?: Value;
+  label?: string;
+  value?: Value;
+  tone?: Value;
+  caption?: Value;
+  columns?: {
+    key: string;
+    label: string;
+  }[];
+  rows?: Value[][];
+  kind?: 'bar' | 'hbar' | 'line' | 'area' | 'donut';
+  categories?: Scalar[];
+  series?: {
+    name?: string;
+    values: (number | Formula)[];
+  }[];
+  unit?: string;
+  percent?: Value;
+  max?: Value;
+  valueLabel?: Value;
+  items?: {
+    label: string;
+    url: string;
+  }[];
+  min?: number;
+  step?: number;
+  options?: ChoiceOption[] | {
+    label: string;
+    description?: string;
+  }[];
+  multi?: boolean;
+  confirmLabel?: string;
+  cancelLabel?: string;
+  fields?: {
+    id: string;
+    label: string;
+    placeholder?: string;
+  }[];
+  submitLabel?: string;
+};
+type ShownView = {
+  title: string;
+  view: ViewNode;
+  interactive: boolean;
+};
+type ViewFailure = {
+  error: string;
+};
+type PendingView = {
+  id: string;
+  sessionId: string;
+  callId?: string;
+  title: string;
+  view: ViewNode;
+};
+type ViewAnswer = {
+  id: string;
+  action: string;
+  values: Record<string, unknown>;
+};
+/** Stored on the same user message as its readable answer, outside model text. */
+type ViewAnswerMetadata = {
+  owner: typeof VIEW_OWNER;
+  version: 1;
+  answer: ViewAnswer;
+};
+type ViewPresentation = {
+  owner: typeof VIEW_OWNER;
+  viewId?: string;
+  title: string;
+  view: ViewNode;
+  interactive: boolean;
+  awaitReply: boolean;
+};
+declare function isRecord(value: unknown): value is Record<string, unknown>;
+//#endregion
+export { ViewPresentation as _, PLUGIN_NAME as a, RpcResult$1 as c, VIEW_OWNER as d, Value as f, ViewNode as g, ViewFailure as h, HOST_SERVICE as i, Scalar as l, ViewAnswerMetadata as m, DeepViewHost as n, PendingView as o, ViewAnswer as p, Formula as r, RPC_CHANNEL as s, ChoiceOption as t, ShownView as u, isRecord as v };
+//# sourceMappingURL=contracts2.d.ts.map