dsh-lcx-codex 0.4.3-pre.3 → 0.4.3

package/lib/web-search-hosted.js

@@ -1,6 +1,6 @@
 import { outputDomains, outputLineRange, parseWebRunOutput } from "./web-run-output.js";
 export const HOSTED_SEARCH_PARAMETERS = { type: "object", properties: { query: { type: "string", description: "Advanced Responses Hosted Web Search query. Use DSH web_search for ordinary searches." }, searchContextSize: { type: "string", enum: ["low", "medium", "high"] }, allowedDomains: { type: "array", items: { type: "string" } }, blockedDomains: { type: "array", items: { type: "string" } }, userLocation: { type: "object", properties: { country: { type: "string" }, city: { type: "string" }, region: { type: "string" }, timezone: { type: "string" } }, additionalProperties: false }, externalWebAccess: { type: "boolean" }, returnTokenBudget: { type: "string", enum: ["default", "unlimited"] }, searchContentTypes: { type: "array", items: { type: "string", enum: ["text", "image"] } }, imageSettings: { type: "object", properties: { maxResults: { type: "integer" }, caption: { type: "boolean" } }, additionalProperties: false } }, required: ["query"], additionalProperties: false };
-export const HOSTED_SEARCH_OUTPUT = { type: "object", properties: { mode: { type: "string", enum: ["hosted"] }, action: { type: "string" }, emulation: { type: "string", enum: ["native"] }, content: { type: "string" }, sources: { type: "array", items: { type: "object" } }, citations: { type: "array", items: { type: "object" } }, images: { type: "array", items: { type: "object" } }, warnings: { type: "array", items: { type: "string" } }, outputBlocks: { type: "array", items: { type: "object" } }, domains: { type: "array", items: { type: "string" } }, lineRange: { type: "object" }, requestId: { type: "string" }, responseId: { type: "string" }, retrievedAt: { type: "string" }, truncated: { type: "boolean" } }, required: ["mode", "action", "emulation", "content", "sources", "citations", "images", "warnings", "requestId", "retrievedAt", "truncated"], additionalProperties: false };
+export const HOSTED_SEARCH_OUTPUT = { type: "object", properties: { mode: { type: "string", enum: ["hosted"] }, action: { type: "string" }, emulation: { type: "string", enum: ["native"] }, content: { type: "string" }, sources: { type: "array", items: { type: "object" } }, citations: { type: "array", items: { type: "object" } }, images: { type: "array", items: { type: "object" } }, warnings: { type: "array", items: { type: "string" } }, outputBlocks: { type: "array", items: { type: "object" } }, domains: { type: "array", items: { type: "string" } }, lineRange: { type: "object" }, requestId: { type: "string" }, responseId: { type: "string" }, retrievedAt: { type: "string" }, truncated: { type: "boolean" }, usage: { type: "object", properties: { inputTokens: { type: "number" }, outputTokens: { type: "number" }, totalTokens: { type: "number" }, cachedInputTokens: { type: "number" }, actionCount: { type: "number" }, serverWebSearchCalls: { type: "number" } }, additionalProperties: false } }, required: ["mode", "action", "emulation", "content", "sources", "citations", "images", "warnings", "requestId", "retrievedAt", "truncated"], additionalProperties: false };
 function failure(message, code = "WEB_INVALID_REQUEST") { return Object.assign(new Error(message), { code }); }
 function isRecord(value) { return value !== null && typeof value === "object" && !Array.isArray(value); }
 function isStringArray(value) { return Array.isArray(value) && value.every((item) => typeof item === "string"); }
@@ -182,6 +182,59 @@ function uniqueByUrl(values) { const result = []; const seen = new Set(); for (c
     seen.add(key);
     result.push(value);
 } return result; }
+function nonNegativeInt(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+function hostedUsageFrom(response, actionCount) {
+    const usage = isRecord(response) && isRecord(response.usage) ? response.usage : undefined;
+    const inputDetails = usage && isRecord(usage.input_tokens_details)
+        ? usage.input_tokens_details
+        : usage && isRecord(usage.prompt_tokens_details)
+            ? usage.prompt_tokens_details
+            : undefined;
+    const serverDetails = usage && isRecord(usage.server_side_tool_usage_details)
+        ? usage.server_side_tool_usage_details
+        : undefined;
+    const result = {};
+    const inputTokens = usage ? nonNegativeInt(usage.input_tokens ?? usage.prompt_tokens) : undefined;
+    const outputTokens = usage ? nonNegativeInt(usage.output_tokens ?? usage.completion_tokens) : undefined;
+    const totalTokens = usage ? nonNegativeInt(usage.total_tokens) : undefined;
+    const cachedInputTokens = inputDetails ? nonNegativeInt(inputDetails.cached_tokens) : undefined;
+    const serverWebSearchCalls = serverDetails ? nonNegativeInt(serverDetails.web_search_calls) : undefined;
+    if (inputTokens !== undefined)
+        result.inputTokens = inputTokens;
+    if (outputTokens !== undefined)
+        result.outputTokens = outputTokens;
+    if (totalTokens !== undefined)
+        result.totalTokens = totalTokens;
+    // cachedInputTokens is a subset of inputTokens (cache hits), not an extra addend.
+    if (cachedInputTokens !== undefined)
+        result.cachedInputTokens = cachedInputTokens;
+    if (actionCount > 0)
+        result.actionCount = actionCount;
+    if (serverWebSearchCalls !== undefined)
+        result.serverWebSearchCalls = serverWebSearchCalls;
+    return Object.keys(result).length ? result : undefined;
+}
+function sourceLine(source) {
+    return `- [${String(source.title ?? source.url ?? "")}](${String(source.url ?? "")})${source.snippet ? ` — ${String(source.snippet)}` : ""}`;
+}
+function usageLine(usage) {
+    const parts = [];
+    if (usage.inputTokens !== undefined)
+        parts.push(`input=${String(usage.inputTokens)}`);
+    if (usage.outputTokens !== undefined)
+        parts.push(`output=${String(usage.outputTokens)}`);
+    if (usage.totalTokens !== undefined)
+        parts.push(`total=${String(usage.totalTokens)}`);
+    if (usage.cachedInputTokens !== undefined)
+        parts.push(`cachedInput=${String(usage.cachedInputTokens)}`);
+    if (usage.actionCount !== undefined)
+        parts.push(`actionCount=${String(usage.actionCount)}`);
+    if (usage.serverWebSearchCalls !== undefined)
+        parts.push(`serverWebSearchCalls=${String(usage.serverWebSearchCalls)}`);
+    return parts.length ? `用量：${parts.join(" ")}` : "";
+}
 export function parseHostedSearchResponse(response, requestId, maxResults = 8, retrievedAt = new Date().toISOString()) {
     if (!isRecord(response))
         throw failure("Hosted Web Search returned an invalid response", "WEB_RESPONSE_INCOMPLETE");
@@ -196,16 +249,73 @@ export function parseHostedSearchResponse(response, requestId, maxResults = 8, r
     const artifacts = responseArtifacts(response);
     if (!artifacts.actions.length)
         throw failure("Hosted Web Search completed without web_search", "WEB_SEARCH_NOT_EXECUTED");
-    const sources = uniqueByUrl([...artifacts.sources, ...outputBlocks.flatMap((block) => block.url ? [{ url: block.url, ...(block.title ? { title: block.title } : {}) }] : [])]);
     const citations = uniqueByUrl(artifacts.citations);
-    const limited = sources.slice(0, Math.max(1, maxResults));
+    const discovered = uniqueByUrl([...artifacts.sources, ...outputBlocks.flatMap((block) => block.url ? [{ url: block.url, ...(block.title ? { title: block.title } : {}) }] : [])]);
+    const ranked = uniqueByUrl([...citations, ...discovered]);
+    const limited = ranked.slice(0, Math.max(1, maxResults));
     const images = artifacts.images.slice(0, Math.max(1, maxResults));
+    const usage = hostedUsageFrom(response, artifacts.actions.length);
     if (!output && !limited.length && !images.length)
         throw failure("Hosted Web Search returned no output", "WEB_NO_SOURCES");
-    return { mode: "hosted", action: artifacts.actions[0], emulation: "native", content: output, sources: limited, citations, images, warnings: artifacts.actions.length > 1 ? [`Multiple hosted search actions were returned: ${artifacts.actions.join(", ")}`] : [], outputBlocks, domains: outputDomains(outputBlocks), ...(outputLineRange(outputBlocks) ? { lineRange: outputLineRange(outputBlocks) } : {}), requestId, ...(typeof response.id === "string" ? { responseId: response.id } : {}), retrievedAt, truncated: sources.length > limited.length || artifacts.images.length > images.length };
+    return { mode: "hosted", action: artifacts.actions[0], emulation: "native", content: output, sources: limited, citations, images, warnings: artifacts.actions.length > 1 ? [`Multiple hosted search actions were returned: ${artifacts.actions.join(", ")}`] : [], outputBlocks, domains: outputDomains(outputBlocks), ...(outputLineRange(outputBlocks) ? { lineRange: outputLineRange(outputBlocks) } : {}), requestId, ...(typeof response.id === "string" ? { responseId: response.id } : {}), retrievedAt, truncated: ranked.length > limited.length || artifacts.images.length > images.length, ...(usage ? { usage } : {}) };
+}
+/** Project Hosted image results into LCX-owned, tool-private, replayable UI metadata. */
+export function hostedMediaPresentationMeta(value, tool, base = {}) {
+    const inherited = base !== null && typeof base === "object" && !Array.isArray(base) ? base : {};
+    if (!isRecord(value) || !Array.isArray(value.images))
+        return inherited;
+    const candidates = value.images.flatMap((entry) => {
+        if (!isRecord(entry))
+            return [];
+        const imageUrl = httpUrl(entry.imageUrl);
+        if (!imageUrl)
+            return [];
+        const previewUrl = httpUrl(entry.thumbnailUrl);
+        const sourceUrl = httpUrl(entry.sourceWebsiteUrl);
+        return [{
+                kind: "image",
+                url: imageUrl.toString(),
+                ...(previewUrl ? { previewUrl: previewUrl.toString() } : {}),
+                ...(sourceUrl ? { sourceUrl: sourceUrl.toString() } : {}),
+                ...(typeof entry.caption === "string" && entry.caption ? { caption: entry.caption } : {}),
+                structured: true,
+            }];
+    });
+    return candidates.length
+        ? { ...inherited, lcxHostedMedia: { version: 1, tool, candidates } }
+        : inherited;
+}
+export function renderHostedSearchResult(value) {
+    const data = isRecord(value) ? value : {};
+    const parts = [];
+    if (typeof data.content === "string" && data.content)
+        parts.push(data.content);
+    const citations = Array.isArray(data.citations) ? data.citations.filter(isRecord) : [];
+    const citationUrls = new Set(citations.map((source) => String(source.url ?? "")).filter(Boolean));
+    if (citations.length)
+        parts.push(`引用：\n${citations.map(sourceLine).join("\n")}`);
+    const extraSources = Array.isArray(data.sources)
+        ? data.sources.filter(isRecord).filter((source) => !citationUrls.has(String(source.url ?? "")))
+        : [];
+    if (extraSources.length)
+        parts.push(`来源：\n${extraSources.map(sourceLine).join("\n")}`);
+    if (Array.isArray(data.images) && data.images.length) {
+        parts.push(`图片：\n${data.images.filter(isRecord).map((image) => {
+            const caption = String(image.caption ?? image.imageUrl ?? "");
+            const imageUrl = String(image.imageUrl ?? "");
+            const sourcePage = typeof image.sourceWebsiteUrl === "string" && image.sourceWebsiteUrl
+                ? ` 来源页: ${image.sourceWebsiteUrl}`
+                : "";
+            return `- [${caption}](${imageUrl})${sourcePage}`;
+        }).join("\n")}`);
+    }
+    if (Array.isArray(data.warnings) && data.warnings.length)
+        parts.push(data.warnings.map((warning) => `警告：${String(warning)}`).join("\n"));
+    if (isRecord(data.usage)) {
+        const renderedUsage = usageLine(data.usage);
+        if (renderedUsage)
+            parts.push(renderedUsage);
+    }
+    parts.push(`检索时间：${String(data.retrievedAt ?? "")}`);
+    return [{ type: "text", text: parts.filter(Boolean).join("\n\n") }];
 }
-export function renderHostedSearchResult(value) { const data = isRecord(value) ? value : {}; const parts = []; if (typeof data.content === "string" && data.content)
-    parts.push(data.content); if (Array.isArray(data.sources) && data.sources.length)
-    parts.push(`来源：\n${data.sources.filter(isRecord).map((source) => `- [${String(source.title ?? source.url ?? "")}](${String(source.url ?? "")})${source.snippet ? ` — ${String(source.snippet)}` : ""}`).join("\n")}`); if (Array.isArray(data.images) && data.images.length)
-    parts.push(`图片：\n${data.images.filter(isRecord).map((image) => `- [${String(image.caption ?? image.imageUrl ?? "")}](${String(image.imageUrl ?? "")})`).join("\n")}`); if (Array.isArray(data.warnings) && data.warnings.length)
-    parts.push(data.warnings.map((warning) => `警告：${String(warning)}`).join("\n")); parts.push(`检索时间：${String(data.retrievedAt ?? "")}`); return [{ type: "text", text: parts.filter(Boolean).join("\n\n") }]; }

package/lib/web-search-ref-store.js

@@ -1,5 +1,6 @@
+import { createHash } from "node:crypto";
 import { JsonStore } from "./json-store.js";
-const VERSION = 1;
+const VERSION = 2;
 function isRecord(value) {
     return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -15,8 +16,18 @@ function validHttpUrl(value) {
         return false;
     }
 }
+function validFingerprint(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/u.test(value);
+}
+function validProvenance(value) {
+    return isRecord(value) &&
+        typeof value.action === "string" && value.action.length > 0 &&
+        (value.originKind === "response" || value.originKind === "request" || value.originKind === "legacy-unattributed") &&
+        validFingerprint(value.originFingerprint) &&
+        (value.artifactFingerprint === undefined || validFingerprint(value.artifactFingerprint));
+}
 function validRef(refId, value) {
-    return isRecord(value) && value.refId === refId && validHttpUrl(value.url);
+    return isRecord(value) && value.refId === refId && validHttpUrl(value.url) && validProvenance(value.provenance);
 }
 function validSession(value) {
     return isRecord(value) &&
@@ -28,15 +39,65 @@ function validData(data) {
     return isRecord(data) && data.version === VERSION && isRecord(data.sessions) &&
         Object.entries(data.sessions).every(([sessionId, session]) => sessionId.length > 0 && validSession(session));
 }
+function validLegacyRef(refId, value) {
+    return isRecord(value) && value.refId === refId && validHttpUrl(value.url);
+}
+function validLegacySession(value) {
+    return isRecord(value) &&
+        typeof value.routeFingerprint === "string" && value.routeFingerprint.length > 0 &&
+        typeof value.updatedAt === "string" && !Number.isNaN(Date.parse(value.updatedAt)) &&
+        isRecord(value.refs) && Object.entries(value.refs).every(([refId, ref]) => refId.length > 0 && validLegacyRef(refId, ref));
+}
+function validLegacyData(data) {
+    return isRecord(data) && data.version === 1 && isRecord(data.sessions) &&
+        Object.entries(data.sessions).every(([sessionId, session]) => sessionId.length > 0 && validLegacySession(session));
+}
+function legacyFingerprint(sessionId, routeFingerprint, ref) {
+    return createHash("sha256")
+        .update(JSON.stringify([sessionId, routeFingerprint, ref.refId, ref.url ?? null]))
+        .digest("hex");
+}
+function migrateLegacyData(data) {
+    if (!validLegacyData(data))
+        return undefined;
+    return {
+        version: VERSION,
+        sessions: Object.fromEntries(Object.entries(data.sessions).map(([sessionId, session]) => [sessionId, {
+                routeFingerprint: session.routeFingerprint,
+                updatedAt: session.updatedAt,
+                refs: Object.fromEntries(Object.entries(session.refs).map(([refId, ref]) => [refId, {
+                        refId,
+                        ...(ref.url ? { url: ref.url } : {}),
+                        provenance: {
+                            action: "legacy-unattributed",
+                            originKind: "legacy-unattributed",
+                            originFingerprint: legacyFingerprint(sessionId, session.routeFingerprint, ref),
+                        },
+                    }])),
+            }])),
+    };
+}
 function unavailable(refId) {
     return Object.assign(new Error(`Alpha reference is unavailable in this session and route: ${refId}`), {
         code: "LCX_ALPHA_REF_UNAVAILABLE",
     });
 }
+function collision(refId) {
+    return Object.assign(new Error(`Alpha reference collision in this session and route: ${refId}`), {
+        code: "LCX_ALPHA_REF_COLLISION",
+    });
+}
+function sameObservation(left, right) {
+    return left.refId === right.refId && left.url === right.url &&
+        left.provenance.action === right.provenance.action &&
+        left.provenance.originKind === right.provenance.originKind &&
+        left.provenance.originFingerprint === right.provenance.originFingerprint &&
+        left.provenance.artifactFingerprint === right.provenance.artifactFingerprint;
+}
 export class AlphaRefStore {
     store;
     constructor(file) {
-        this.store = new JsonStore(file, () => ({ version: VERSION, sessions: {} }), validData, "LCX_ALPHA_REF_STORE_CORRUPT");
+        this.store = new JsonStore(file, () => ({ version: VERSION, sessions: {} }), validData, "LCX_ALPHA_REF_STORE_CORRUPT", migrateLegacyData);
     }
     record(sessionId, routeFingerprint, refs) {
         if (typeof sessionId !== "string" || !sessionId || typeof routeFingerprint !== "string" || !routeFingerprint || !Array.isArray(refs)) {
@@ -44,13 +105,33 @@ export class AlphaRefStore {
         }
         this.store.update((current) => {
             const previous = current.sessions[sessionId];
-            const previousRefs = previous?.routeFingerprint === routeFingerprint ? previous.refs : {};
-            const nextRefs = { ...previousRefs };
+            const sameRoute = previous?.routeFingerprint === routeFingerprint;
+            const nextRefs = { ...(sameRoute ? previous.refs : {}) };
+            let changed = !sameRoute;
             for (const value of refs) {
-                if (!isRecord(value) || typeof value.refId !== "string" || !value.refId || !validHttpUrl(value.url))
+                if (!isRecord(value) || typeof value.refId !== "string" || !value.refId)
+                    throw unavailable("invalid-record");
+                const accepted = nextRefs[value.refId];
+                if (!validHttpUrl(value.url) || !validProvenance(value.provenance)) {
+                    if (accepted)
+                        throw collision(value.refId);
+                    throw unavailable("invalid-record");
+                }
+                const observation = {
+                    refId: value.refId,
+                    ...(value.url ? { url: value.url } : {}),
+                    provenance: { ...value.provenance },
+                };
+                if (accepted) {
+                    if (!sameObservation(accepted, observation))
+                        throw collision(observation.refId);
                     continue;
-                nextRefs[value.refId] = { refId: value.refId, ...(value.url ? { url: value.url } : {}) };
+                }
+                nextRefs[observation.refId] = observation;
+                changed = true;
             }
+            if (!changed && previous)
+                return current;
             const sessions = {
                 ...current.sessions,
                 [sessionId]: { routeFingerprint, refs: nextRefs, updatedAt: new Date().toISOString() },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-lcx-codex",
-  "version": "0.4.3-pre.3",
-  "description": "DSH GPT Responses lifecycle owner with Native V2 compaction/replay and Hosted/Alpha Search capabilities",
+  "version": "0.4.3",
+  "description": "Model-scoped DSH plugin: GPT Responses lifecycle, Native V2 compaction and Hosted/Alpha Search; Grok native Web/X Search",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -11,7 +11,10 @@
     "openai-responses",
     "sub2api",
     "newapi",
-    "compaction"
+    "compaction",
+    "grok",
+    "xai",
+    "x-search"
   ],
   "repository": {
     "type": "git",
@@ -38,8 +41,11 @@
   },
   "files": [
     "lib/*.js",
-    "lib/types/**/*.d.ts",
-    "cordis.patch.yml"
+    "lib/types/index.d.ts",
+    "lib/types/client/index.d.ts",
+    "lib/types/client/search-media.d.ts",
+    "cordis.patch.yml",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "dsh": {
     "bundle": {
@@ -48,39 +54,46 @@
     "client": {
       "platform": "web",
       "inject": [
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings-plugins"
       ]
     }
   },
-  "dependencies": {
-    "@earendil-works/pi-ai": "0.85.1"
-  },
   "devDependencies": {
+    "@deepseek-ai/dsh": "0.1.5-rc.1",
+    "@earendil-works/pi-ai": "0.85.1",
     "@deepseek-ai/schemastery": "^3.18.2",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "esbuild": "^0.28.2",
+    "linkedom": "^0.18.13",
     "typescript": "7.0.2"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-modules": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-store": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-compaction": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-credentials": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-fs": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-tool-web": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.3-alpha.2",
-    "@deepseek-ai/dsh-web": "0.1.3-alpha.2",
+    "@deepseek-ai/dsh-agent": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-attachment": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-modules": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-store": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-ui-chat": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-compaction": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-credentials": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-fs": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-session": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-settings": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-tool-web": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-web": ">=0.1.5-rc.1 <0.1.6",
     "@deepseek-ai/schemastery": "^3.18.2",
-    "react": "^18.2.0"
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-token-meter": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.5-rc.1 <0.1.6",
+    "zod": "^4.5.4"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-locale": {
@@ -98,6 +111,12 @@
     "@deepseek-ai/dsh-client-store": {
       "optional": true
     },
+    "@deepseek-ai/dsh-client-ui-chat": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-client-ui-settings-plugins": {
       "optional": true
     },
@@ -131,7 +150,7 @@
   },
   "scripts": {
     "build": "npm run build:host && npm run build:client",
-    "build:host": "tsc -p tsconfig.json",
+    "build:host": "tsc -p tsconfig.json && node scripts/build-pi-runtime.mjs",
     "build:client": "tsc -p tsconfig.client.json && node scripts/build-client.mjs",
     "test": "node --test tests/*.test.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
@@ -145,5 +164,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "lcxCompatibility": {
+    "dshInstallRange": ">=0.1.5-rc.1 <0.1.6",
+    "verifiedDsh": "0.1.5-rc.1",
+    "verifiedHostPi": "0.85.1"
+  }
 }

package/lib/types/compact-v2.d.ts

@@ -1,104 +0,0 @@
-import { buildCompactionResponsesBody } from "./responses-request.js";
-type HeaderMap = Record<string, string>;
-type CompactionItem = {
-    type: "compaction";
-    encrypted_content: string;
-};
-type FunctionCallItem = {
-    type: "function_call";
-    call_id: string;
-};
-type FunctionCallOutputItem = {
-    type: "function_call_output";
-    call_id: string;
-};
-type ValidatedOutputItem = CompactionItem | FunctionCallItem | FunctionCallOutputItem | {
-    type: string;
-};
-type CanonicalUsage = {
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens?: number;
-    cacheWriteTokens?: number;
-    reasoningTokens?: number;
-};
-type GenerationControls = {
-    reasoningEffort?: unknown;
-    temperature?: unknown;
-    maxTokens?: unknown;
-};
-type GenerationEnvelope = {
-    reasoning?: {
-        effort: string;
-        summary: "auto";
-    };
-    include?: string[];
-    temperature?: number;
-    max_output_tokens?: number;
-};
-type NativeCompactionBodyOptions = GenerationControls & {
-    model: string;
-    modelDescriptor?: Exclude<Parameters<typeof buildCompactionResponsesBody>[0]["model"], string>;
-    input: unknown[];
-    tools?: unknown;
-    promptCacheKey?: string;
-    promptCacheRetention?: string;
-    cacheRetention?: "none" | "short" | "long";
-};
-type NativeCompactionRequestOptions = NativeCompactionBodyOptions & {
-    baseURL: string;
-    idempotencyKey?: string;
-    headers?: HeaderMap;
-    signal?: AbortSignal;
-    timeoutMs?: number;
-    maxAttempts?: number;
-    maxResponseBytes?: number;
-};
-type SseParseOptions = {
-    signal?: AbortSignal;
-    maxResponseBytes?: number;
-};
-type NativeCompactionResult = {
-    object: unknown;
-    id?: string;
-    output: ValidatedOutputItem[];
-    compaction: CompactionItem;
-    usage?: CanonicalUsage;
-};
-export declare const REMOTE_COMPACTION_V2_FEATURE = "remote_compaction_v2";
-/**
- * @param {HeaderMap} [headers]
- * @returns {HeaderMap}
- */
-export declare function mergeFeatureHeader(headers?: HeaderMap): HeaderMap;
-/**
- * @param {GenerationControls} [controls]
- * @returns {GenerationEnvelope}
- */
-export declare function responsesGenerationEnvelope(controls?: GenerationControls): GenerationEnvelope;
-/**
- * @param {NativeCompactionBodyOptions} options
- * @returns {NativeCompactionBody}
- */
-export declare function buildNativeCompactionBody({ model, modelDescriptor, input, tools, promptCacheKey, promptCacheRetention, cacheRetention, reasoningEffort, temperature, maxTokens, }: NativeCompactionBodyOptions): {
-    [x: string]: unknown;
-} & {
-    model: string;
-    input: unknown[];
-    stream: boolean;
-    store: boolean;
-    tool_choice?: string;
-    parallel_tool_calls?: boolean;
-};
-/**
- * Provider SSE events enter as unknown; response.completed remains authoritative.
- * @param {Response} response
- * @param {SseParseOptions} [options]
- * @returns {Promise<NativeCompactionResult>}
- */
-export declare function parseNativeCompactionSse(response: Response, options?: SseParseOptions): Promise<NativeCompactionResult>;
-/**
- * @param {NativeCompactionRequestOptions} options
- */
-export declare function requestNativeCompaction({ baseURL, model, modelDescriptor, input, tools, promptCacheKey, promptCacheRetention, cacheRetention, reasoningEffort, temperature, maxTokens, idempotencyKey, headers, signal, timeoutMs, maxAttempts, maxResponseBytes, }: NativeCompactionRequestOptions): Promise<NativeCompactionResult>;
-export {};

package/lib/types/dsh-compat.d.ts

@@ -1,78 +0,0 @@
-import { Session, type SessionStore } from "@deepseek-ai/dsh-session";
-import type { ToolRuntime } from "@deepseek-ai/dsh-tools";
-import { ServiceMutex } from "./service-mutex.js";
-type CompatMethod = (this: object, agent: unknown, trigger: string, signal: AbortSignal) => Promise<unknown>;
-type PrunerMethod = (...args: unknown[]) => unknown;
-type MutableService = Record<PropertyKey, unknown>;
-interface CompactionService extends MutableService {
-    compactIfNeeded: CompatMethod;
-}
-export interface CompactionPatchRecord {
-    compaction: CompactionService;
-    original: CompatMethod;
-    wrapper: CompatMethod;
-    mutex: ServiceMutex;
-    lifecycle: AbortController;
-}
-export type CompactionPatchRecords = Map<object, CompactionPatchRecord>;
-export type CompactionPatchBehavior = (agent: unknown, trigger: string, signal: AbortSignal, callOriginal: (signal: AbortSignal) => Promise<unknown>) => Promise<unknown>;
-interface PrunerService extends MutableService {
-    pruneSession: unknown;
-}
-export interface PrunerPatchRecord {
-    pruner: PrunerService;
-    original: unknown;
-    replacement: PrunerMethod;
-}
-interface ConfigService extends MutableService {
-    config: unknown;
-}
-export interface ConfigPatchRecord {
-    service: ConfigService;
-    original: unknown;
-    installed: unknown;
-}
-export declare function agentSessionId(agent: unknown): string;
-export declare function agentUsesSession(agent: unknown, session: Session): boolean;
-export declare function sessionFromAgent(agent: unknown): Session | undefined;
-export declare function readAgentRouteState(agent: unknown): {
-    requestConfig: unknown;
-    options: unknown;
-    sessionId: string;
-};
-export declare function scopedToolRuntime(agent: unknown): (Pick<ToolRuntime, "register"> & Partial<Pick<ToolRuntime, "get">>) | undefined;
-export declare function tokenMeterTotal(value: unknown, session: Session): number | undefined;
-export declare function sessionsService(ctx: unknown): Pick<SessionStore, "get"> | undefined;
-export declare function sessionFor(ctx: unknown, sessionId: string): Session | undefined;
-export declare function readWebSearchProvider(ctx: unknown): unknown;
-export declare function writeWebSearchProvider(ctx: unknown, providerId: unknown): boolean;
-export declare function contextService(ctx: unknown, name: string): unknown;
-export declare function resolveContextService(ctx: unknown, name: string): unknown;
-export declare function resolveScopedService(agent: unknown, name: string): unknown;
-export declare function resolveAgentService(ctx: unknown, agent: unknown, name: string): unknown;
-export declare function concreteService(value: unknown): unknown;
-export declare function compactionPatchCandidate(value: unknown, records: ReadonlyMap<object, CompactionPatchRecord>): Pick<CompactionPatchRecord, "compaction" | "original"> | undefined;
-export declare function installCompactionPatch(records: CompactionPatchRecords, candidate: Pick<CompactionPatchRecord, "compaction" | "original">, mutex: ServiceMutex, lifecycle: AbortController, behavior: CompactionPatchBehavior): boolean;
-export declare function restoreCompactionPatches(records: Map<object, CompactionPatchRecord>, entries?: Iterable<CompactionPatchRecord>): void;
-export declare function toolResultPrunerState(value: unknown): {
-    pruner: PrunerService | undefined;
-    original: unknown;
-};
-export declare function patchToolResultPruner(state: {
-    pruner: PrunerService | undefined;
-    original: unknown;
-}, replacement: PrunerMethod): PrunerPatchRecord | undefined;
-export declare function restoreToolResultPruner(record: PrunerPatchRecord | undefined): void;
-export declare function compactionConfigState(service: unknown): {
-    service: ConfigService | undefined;
-    original: unknown;
-};
-export declare function patchCompactionConfig(state: {
-    service: ConfigService | undefined;
-    original: unknown;
-}, createConfig: (originalConfig: unknown) => unknown): ConfigPatchRecord | undefined;
-export declare function restoreCompactionConfig(record: ConfigPatchRecord | undefined): void;
-export declare function patchVisibleWebSearchTimeout(agent: unknown, getTimeoutMs: () => number | undefined, patchedDefinitions: Map<MutableService, unknown>): void;
-export declare function refreshVisibleWebSearchTimeouts(patchedDefinitions: ReadonlyMap<MutableService, unknown>, timeoutMs: number | undefined): void;
-export declare function restoreVisibleWebSearchTimeouts(patchedDefinitions: Map<MutableService, unknown>): void;
-export {};