@klarkxy/dsh-deep-view 0.0.0-stage → 0.1.0

package/lib/contracts.d.ts

@@ -0,0 +1,98 @@
+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

package/lib/contracts.js

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

package/lib/contracts.js.map

@@ -0,0 +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"}

package/lib/index.d.ts

@@ -0,0 +1,73 @@
+import { PendingView, RpcResult } from "./contracts.js";
+import { ContextFormed, createUserMessage } from "@deepseek-ai/dsh-llm";
+import { Context } from "@deepseek-ai/cordis";
+import { IncomingMessage, ServerResponse } from "node:http";
+//#region ../dsh-plugin-kit/src/contracts.d.ts
+/** Public, browser-safe contracts. Host implementations stay in their owning packages. */
+type ProducerSourceKind = `plugin:${string}`;
+type ProducerMessageSource = {
+  kind: ProducerSourceKind;
+  plugin: string;
+} & ContextFormed;
+/**
+ * V4 sessions persist the producing extension in `kind`; the retired generic
+ * `plugin` wrapper is not admitted. Each feature plugin declares its own kind.
+ */
+declare module '@deepseek-ai/dsh-llm' {
+  interface MessageSourceMap {
+    [kind: ProducerSourceKind]: ProducerMessageSource;
+  }
+}
+//#endregion
+//#region ../dsh-plugin-kit/src/host-rpc.d.ts
+interface HostRpcContext {
+  webServer: {
+    register(route: {
+      kind: 'prefix';
+      path: string;
+      handler(req: IncomingMessage, res: ServerResponse): void | Promise<void>;
+    }): () => void;
+  };
+  connection: {
+    requestRejection?: (request: IncomingMessage) => number | undefined;
+  };
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "deep-view";
+declare const inject: readonly ["tools", "sessionController", "sessions", "agents", "connection", "webServer"];
+type AgentLike = {
+  id: string;
+  session: unknown;
+  followup(message: ReturnType<typeof createUserMessage>): void;
+};
+type Host = Context & HostRpcContext & {
+  tools: {
+    get(name: string, scope?: object): unknown;
+    register(definition: Record<string, unknown>): () => void;
+  };
+  agents: {
+    get(id: string): AgentLike | undefined;
+    roots(): AgentLike[];
+  };
+  sessionController: {
+    resolveAgent(id: string): Promise<{
+      agent?: AgentLike;
+      error?: {
+        message?: string;
+      };
+    }>;
+  };
+  sessions: {
+    flush(session: unknown): Promise<boolean>;
+  };
+  logger?: {
+    warn(message: string, ...args: unknown[]): void;
+  };
+};
+declare function createShowViewTool(host: Host, pending: Map<string, PendingView>, makeId?: () => string): Record<string, unknown>;
+declare function createRpc(host: Host, pending: Map<string, PendingView>): (endpoint: string, payload: unknown, signal: AbortSignal) => Promise<RpcResult>;
+declare function apply(ctx: Context): Promise<void>;
+//#endregion
+export { apply, createRpc, createShowViewTool, inject, name };
+//# sourceMappingURL=index.d.ts.map