@deepseek-ai/dsh-tool-cordis 0.1.7-rc.2 → 0.2.0-rc.2

package/README.i18n.yaml

@@ -39,8 +39,8 @@
   en: f57a20cd4e76d13c
   zh: 7b673116422bee87
 /deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work:
-  en: ffe15dd1fd333dbf
-  zh: b256afc74a1782cb
+  en: 3c135d9cb67790d2
+  zh: ff2d0a444f55d28f
 /deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work/dev-note:
   en: 0a1253c6f7b5e8b9
   zh: 9f56528562c7c914

package/README.md

@@ -68,7 +68,7 @@ Unchanged tool schemas remain prefix-stable. Query results append to history; en
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- Client queries wait for a responding page or cancellation. Inspection cannot invoke service methods, configure plugins, or execute generated code.
+- Client queries need a responding page and use the Host runner's [bounded wait and retry policy](../cordis-host-runner/README.md#client-inspection). Inspection cannot invoke service methods, configure plugins, or execute generated code.
 - `Config.listConfigs` walks the profile Loader tree only. Agent preset `plugins` lists mount in detached preset trees, so a plugin present only inside a preset declaration is not listed unless the profile tree also mounts it.
 
 <a id="dev-note"></a>

package/README.zh.md

@@ -68,7 +68,7 @@ Host provider 结合生成的 Service/Event 目录、经 app-boot Config 投影
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- Client 查询等待页面响应或取消。检查不能调用服务方法、配置插件或执行生成代码。
+- Client 查询需要页面响应，并采用 Host runner 的[有界等待与重试策略](../cordis-host-runner/README.zh.md#client-inspection)。检查不能调用服务方法、配置插件或执行生成代码。
 - `Config.listConfigs` 只遍历 profile 的 Loader 树。Agent preset 的 `plugins` 列表挂载在独立的 preset 树中，所以只出现在 preset 声明里的插件不会被列出，除非 profile 树也挂载了它。
 
 <a id="dev-note"></a>

package/lib/index.js

@@ -54,7 +54,7 @@ function apply(ctx) {
 	}));
 	ctx.tools.register(defineTool({
 		name: "cordis_inspect_query",
-		description: "Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from cordis_inspect_list, and input must satisfy that method's schema. Use this Tool before writing plugin code to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live Slot trees and props. Host queries run locally. A Client query waits for the first valid page response and remains pending until a page answers or the Tool is cancelled. This Tool cannot invoke business Service methods or modify the runtime.",
+		description: "Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from cordis_inspect_list, and input must satisfy that method's schema. Use this Tool before writing plugin code to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live Slot trees and props. Host queries run locally. A Client query waits for the first valid page response within the configured timeout; otherwise it reports a Client failure or asks you to reconnect and retry. This Tool cannot invoke business Service methods or modify the runtime.",
 		parameters: {
 			platform: {
 				type: "string",

package/lib/types/api-catalog.js

@@ -851,6 +851,12 @@ export const SERVICE_API = [
                 parameters: [],
                 returns: 'a Host-only snapshot, or null while signed out or when the credential changed during the read.',
             },
+            {
+                signature: 'abstract getDeviceIdentity(): Promise<{ deviceId?: string; userId?: AccountUserId; osVersion: string }>',
+                description: 'Read existing login identity without creating a device or returning credentials.',
+                parameters: [],
+                returns: 'optional device/account identifiers and the provider\'s OS version string.',
+            },
         ],
     },
     {
@@ -1473,6 +1479,25 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'otel',
+        summary: 'Shared transport provider.',
+        description: 'Shared transport provider. Mounting creates no queue, identity, or network connection.',
+        methods: [
+            {
+                signature: 'createEventReporter(options: EventLogOptions): EventLogReporter',
+                description: 'Create an independent ordinary-event channel with count-based batching. The injected consumer must drain it during its fiber disposal.',
+                parameters: [{ name: 'options', description: 'transport, scope, resource, queue, and diagnostic settings selected by the consumer.' }],
+                returns: 'the caller-owned channel; no state is shared with other channels.',
+            },
+            {
+                signature: 'createSessionLogReporter(options: SessionLogOptions): SessionLogReporter',
+                description: 'Create an independent byte-bounded Session-log channel. Authorization and redaction precede reporting; the consumer owns shutdown and its outer deadline.',
+                parameters: [{ name: 'options', description: 'transport, scope, resource, queue, and diagnostic settings selected by the consumer.' }],
+                returns: 'the caller-owned channel, preserving complete accepted events within the request byte ceiling.',
+            },
+        ],
+    },
     {
         key: 'permissionPresets',
         summary: 'Owns the deployment\'s configured permission presets, the fixed Auto integration hook, and their write path.',
@@ -1629,6 +1654,31 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'productAnalytics',
+        summary: 'Authenticated event intake; disabled instances do not inspect identity or accept new events.',
+        description: 'Authenticated event intake; disabled instances do not inspect identity or accept new events.',
+        methods: [
+            {
+                signature: '@Remote enabled(): boolean',
+                description: 'Read the collection policy.',
+                parameters: [],
+                returns: 'whether this Host currently accepts Desktop analytics.',
+            },
+            {
+                signature: '@Remote({ mode: \'stream\' }) async *watchPolicy(signal: AbortSignal): AsyncIterable<boolean>',
+                description: 'Stream the effective policy initially and after live configuration edits.',
+                parameters: [{ name: 'signal', description: 'subscriber lifetime.' }],
+                returns: 'current policy values until cancellation or service disposal.',
+            },
+            {
+                signature: '@Remote async report(event: ProductEvent): Promise<void>',
+                description: 'Submit selected Desktop fields; missing identity is omitted and never generated.',
+                parameters: [{ name: 'event', description: 'typed product event without message contents or credentials.' }],
+                returns: 'after local submission; no delivery or warehouse acknowledgement.',
+            },
+        ],
+    },
     {
         key: 'productTelemetry',
         summary: 'Host analytics sender.',
@@ -3258,6 +3308,12 @@ export const SERVICE_API = [
                 description: 'Carrier adapter shared by the WebSocket mux and local Host transports.',
                 parameters: [],
             },
+            {
+                signature: 'hasLiveClient(): boolean',
+                description: 'Check for an active Client event stream.',
+                parameters: [],
+                returns: 'whether a stream is open and has not been cancelled.',
+            },
             {
                 signature: 'registerRemoteEvents( source: TypertRemoteEventSource, host: RemoteEventHostInfo, ): () => Promise<void>',
                 description: 'Register the sole application-selected forwarded-event source.',
@@ -3284,6 +3340,26 @@ export const SERVICE_API = [
         summary: '`ctx.userQuestions`: validation plus the scoped answerer waterfall.',
         description: '`ctx.userQuestions`: validation plus the scoped answerer waterfall.',
         methods: [
+            {
+                signature: '@Remote answer(agent: Agent, callId: ToolCallId, answer: AskUserQuestionAnswer): boolean',
+                description: 'Answer a continued question. The reply is steered into the agent as a user message whose source names the call; that message is also the record that closes the question in the projection.',
+                parameters: [{ name: 'agent', description: 'Live root agent for the owning Session.' }, { name: 'callId', description: 'Continued question identity.' }, { name: 'answer', description: 'Complete structured answer batch, one item per question of the call.' }],
+                returns: 'Whether the question is still continued; an accepted reply stays queued until the agent admits its user message.',
+                throws: ['{UserQuestionError} `BAD_ANSWER` when the batch does not name each question of the call exactly once, or `REPLY_QUEUED` when a reply is already waiting for admission.'],
+            },
+            {
+                signature: '@Remote({ mode: \'stream\' }) async *attachWait(agent: Agent, callId: ToolCallId, signal: AbortSignal): AsyncIterable<{ remainingMs: number }>',
+                description: 'Let one answer UI hold a live timed wait. Closing the stream releases its claim.',
+                parameters: [{ name: 'agent', description: 'Live root agent owning the question.' }, { name: 'callId', description: 'Foreground tool call to attach to.' }, { name: 'signal', description: 'Remote stream cancellation, including Client disconnect.' }],
+                returns: 'One Host-computed remaining duration, or no frames once the wait ended.',
+            },
+            {
+                signature: 'async askTimed( request: AskUserQuestionRequest & { agent: Agent }, callId: ToolCallId, timeoutMs: number, ): Promise<TimedUserQuestionResult>',
+                description: 'Foreground wait whose first settlement the Client decides: the Client rejects with `ASK_TIMED_OUT` when its countdown ends, and this method maps that code to the pending result.',
+                parameters: [{ name: 'request', description: 'Questions, live owner agent, and abort signal.' }, { name: 'callId', description: 'Tool call identity the Client card is keyed by.' }, { name: 'timeoutMs', description: 'Positive foreground wait in milliseconds.' }],
+                returns: 'The answer when it arrives inside the window, otherwise a pending result, also when no connected Client claimed the request by the deadline.',
+                throws: ['{UserQuestionError} `BAD_TIMEOUT` for a non-integer, non-positive, or oversized wait.'],
+            },
             {
                 signature: 'async ask(request: AskUserQuestionRequest): Promise<AskUserQuestionAnswer>',
                 description: 'Ask the scoped answerer waterfall and wait for the user\'s answer.\n\nWhen a caller supplies an agent, human interaction is valid only for the exact live runtime root. Runtime ownership, not durable session lineage, decides this boundary: an owned child has no human answerer and would block forever, while a lineage-bearing session resumed as a new runtime root may ask normally.',
@@ -4429,7 +4505,7 @@ export const TYPE_API = [
     },
     {
         name: 'AskUserQuestionRequestEvent',
-        declaration: 'export interface AskUserQuestionRequestEvent {\n    questions: AskUserQuestionItem[];\n    agent?: Agent;\n    signal?: AbortSignal;\n}',
+        declaration: 'export interface AskUserQuestionRequestEvent {\n    questions: AskUserQuestionItem[];\n    agent?: Agent;\n    signal?: AbortSignal;\n    wait?: {\n        callId: ToolCallId;\n        timed?: boolean;\n    };\n}',
     },
     {
         name: 'AssembleContext',
@@ -5011,6 +5087,14 @@ export const TYPE_API = [
         name: 'EpochHeader',
         declaration: 'export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n    system?: never;\n}',
     },
+    {
+        name: 'EventLogOptions',
+        declaration: 'export interface EventLogOptions {\n    exporter: SessionLogOptions[\'exporter\'];\n    resourceAttributes: Attributes;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    processor: Omit<BatchLogRecordProcessorOptions, \'exporter\'>;\n    onFailure: SessionLogOptions[\'onFailure\'];\n}',
+    },
+    {
+        name: 'EventLogReporter',
+        declaration: 'export class EventLogReporter {\n    constructor(options: EventLogOptions);\n    emit(record: OTelEventRecord): void;\n    async shutdown(signal?: AbortSignal): Promise<void>;\n}',
+    },
     {
         name: 'EveryScheduleRecord',
         declaration: 'export interface EveryScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'every\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly everySeconds: number;\n    readonly scheduledAt: string;\n}',
@@ -5719,6 +5803,10 @@ export const TYPE_API = [
         name: 'OfficeToPdfResult',
         declaration: 'export interface OfficeToPdfResult {\n    readonly pdf: Uint8Array;\n    readonly missingFonts: string[];\n    readonly cacheKey: OfficeToPdfKey;\n    readonly generation: OfficeToPdfGeneration;\n}',
     },
+    {
+        name: 'OnboardingPage',
+        declaration: 'export type OnboardingPage = \'onboarding_welcome\' | \'onboarding_recharge\' | \'onboarding_use_case\' | \'onboarding_process\';',
+    },
     {
         name: 'OneShotScheduleRecord',
         declaration: 'export type OneShotScheduleRecord = AfterScheduleRecord | AtScheduleRecord;',
@@ -5731,6 +5819,14 @@ export const TYPE_API = [
         name: 'OptionalSessionSeq',
         declaration: 'export type OptionalSessionSeq = SessionSeq | null;',
     },
+    {
+        name: 'OTelEventRecord',
+        declaration: 'export interface OTelEventRecord {\n    eventName: string;\n    body: string;\n    timestamp: number;\n    severityNumber?: SeverityNumber;\n    attributes?: Record<string, OTelEventScalar | Record<string, OTelEventScalar>>;\n}',
+    },
+    {
+        name: 'OTelEventScalar',
+        declaration: 'export type OTelEventScalar = string | number | boolean;',
+    },
     {
         name: 'PackageResult',
         declaration: 'export interface PackageResult {\n    exitCode: number;\n    output: string;\n    truncated: boolean;\n    logPath: string;\n    kind?: PluginInstallFailureKind;\n    timedOut?: boolean;\n    incompatible?: IncompatiblePlugin[];\n}',
@@ -5860,12 +5956,16 @@ export const TYPE_API = [
         declaration: 'export type PreToolDecision = {\n    kind: \'allow\';\n} | {\n    kind: \'deny\';\n    reason: string;\n    info?: ToolErrorInfo;\n} | {\n    kind: \'cancel\';\n} | {\n    kind: \'ask\';\n    reason?: string;\n    displayReason?: {\n        readonly en: string;\n        readonly [locale: string]: string;\n    };\n};',
     },
     {
-        name: 'ProductTelemetryRecord',
-        declaration: 'export interface ProductTelemetryRecord {\n    eventName: string;\n    body: string;\n    timestamp: number;\n    severityNumber?: SeverityNumber;\n    attributes?: Record<string, ProductTelemetryScalar | Record<string, ProductTelemetryScalar>>;\n}',
+        name: 'ProductEvent',
+        declaration: 'export type ProductEvent = {\n    [K in keyof ProductEventMap]: {\n        eventName: K;\n        attributes: ProductEventMap[K];\n        timestamp: number;\n    };\n}[keyof ProductEventMap];',
     },
     {
-        name: 'ProductTelemetryScalar',
-        declaration: 'export type ProductTelemetryScalar = string | number | boolean;',
+        name: 'ProductEventMap',
+        declaration: 'export interface ProductEventMap {\n    desktop_app_launch: Record<string, never>;\n    auth_page_view: Record<string, never>;\n    auth_page_click: {\n        button_name: \'sign_in\' | \'api-key\';\n    };\n    api_key_save_click: Record<string, never>;\n    onboarding_page_view: {\n        page_name: OnboardingPage;\n    };\n    onboarding_page_click: {\n        page_name: OnboardingPage;\n        button_name: \'next\' | \'back\' | \'skip\' | \'charge\' | \'later\' | \'continue\';\n        selected_content?: \'office\' | \'code\' | \'code_office\' | \'focus_result\' | \'key_detail\' | \'full_process\';\n    };\n    onboarding_popup_view: {\n        popup_name: \'skip_charge\' | \'skip_setting\';\n    };\n    onboarding_popup_click: {\n        popup_name: \'skip_charge\' | \'skip_setting\';\n        button_name: \'charge\' | \'know\' | \'enter\' | \'setting\' | \'close\';\n    };\n    desktop_upgrade_click: Record<string, never>;\n    desktop_upgrade_download_result: {\n        is_success: boolean;\n        error_reason?: string;\n    };\n    desktop_upgrade_install_restart_click: Record<string, never>;\n    send_button_click: {\n        session_id?: SessionId;\n        model_name?: string;\n        thinking_effort?: string;\n        run_mode: \'plan\' | \'goal\' | \'default\';\n        msg_type: \'default\' | \'steer\' | \'queue\';\n    };\n    model_switch: {\n        session_id?: SessionId;\n        switch_from: string;\n        switch_to: string;\n    };\n    thinking_level_switch: {\n        session_id?: SessionId;\n        switch_from: string;\n        switch_to: str /* …truncated — full shape in source */',
+    },
+    {
+        name: 'ProductTelemetryRecord',
+        declaration: 'export type ProductTelemetryRecord = OTelEventRecord;',
     },
     {
         name: 'ProfilePnpmInvocation',
@@ -6491,6 +6591,18 @@ export const TYPE_API = [
         name: 'SessionLogOffset',
         declaration: 'export type SessionLogOffset = BrandedNumber<\'SessionLogOffset\'>;',
     },
+    {
+        name: 'SessionLogOptions',
+        declaration: 'export interface SessionLogOptions {\n    exporter: OTLPExporterNodeConfigBase & {\n        url: string;\n    };\n    processor?: Omit<BatchLogRecordProcessorOptions, \'exporter\'>;\n    maxRequestBytes?: number;\n    scope: {\n        name: string;\n        version?: string;\n    };\n    resourceAttributes: Attributes;\n    onFailure: (message: string, error?: Error) => void;\n}',
+    },
+    {
+        name: 'SessionLogRecord',
+        declaration: 'export interface SessionLogRecord {\n    sessionId: SessionId;\n    event: Omit<SessionEvent, \'data\'> & {\n        data: unknown;\n    };\n    attributes?: Attributes;\n    severityNumber?: SeverityNumber;\n}',
+    },
+    {
+        name: 'SessionLogReporter',
+        declaration: 'export class SessionLogReporter {\n    constructor(options: SessionLogOptions);\n    reportSessionLog(record: SessionLogRecord): void;\n    stopPending(): void;\n    shutdown(): Promise<void>;\n}',
+    },
     {
         name: 'SessionLogSnapshot',
         declaration: 'export interface SessionLogSnapshot {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    events: SessionEvent[];\n}',
@@ -6697,7 +6809,7 @@ export const TYPE_API = [
     },
     {
         name: 'SessionTelemetryRecord',
-        declaration: 'export interface SessionTelemetryRecord {\n    channel: \'ledger\' | \'ops\';\n    time: number;\n    severity: SessionTelemetrySeverity;\n    attributes: Record<string, string | number>;\n    body: unknown;\n}',
+        declaration: 'export interface SessionTelemetryRecord {\n    sourceEvent?: {\n        sessionId: SessionId;\n        envelope: Omit<SessionEvent, \'data\'>;\n    };\n    channel: \'ledger\' | \'ops\';\n    time: number;\n    severity: SessionTelemetrySeverity;\n    attributes: Record<string, string | number>;\n    body: unknown;\n}',
     },
     {
         name: 'SessionTelemetrySeverity',
@@ -7371,6 +7483,10 @@ export const TYPE_API = [
         name: 'TerminalWaitReason',
         declaration: 'export type TerminalWaitReason = \'stdin_read\' | \'inferred_idle\' | \'timeout\' | \'session_exit\';',
     },
+    {
+        name: 'TimedUserQuestionResult',
+        declaration: 'export type TimedUserQuestionResult = AskUserQuestionAnswer | {\n    pending: true;\n    callId: ToolCallId;\n};',
+    },
     {
         name: 'TimeOutOfRangeError',
         declaration: 'export interface TimeOutOfRangeError {\n    readonly code: \'time_out_of_range\';\n    readonly message: string;\n}',

package/lib/types/index.js

@@ -34,9 +34,9 @@ export function apply(ctx) {
         description: 'Run a read-only query declared by an Inspect Provider. platform, provider, and method must come from '
             + 'cordis_inspect_list, and input must satisfy that method\'s schema. Use this Tool before writing plugin code '
             + 'to read exact Service methods, Event modes, plugin Config schemas, Tool schemas, theme tokens, or live '
-            + 'Slot trees and props. Host queries run locally. A Client query waits for the first valid page response and '
-            + 'remains pending until a page answers or the Tool is cancelled. This Tool cannot invoke business Service '
-            + 'methods or modify the runtime.',
+            + 'Slot trees and props. Host queries run locally. A Client query waits for the first valid page response '
+            + 'within the configured timeout; otherwise it reports a Client failure or asks you to reconnect and retry. '
+            + 'This Tool cannot invoke business Service methods or modify the runtime.',
         parameters: {
             platform: { type: 'string', required: true, enum: ['host', 'client'], description: 'Runtime platform that owns the Provider.' },
             provider: { type: 'string', required: true, description: 'Exact Provider ID returned by cordis_inspect_list.' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Read-only runtime API inspection for Harness plugin development",
-  "version": "0.1.7-rc.2",
+  "version": "0.2.0-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -32,22 +32,22 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-group": "~1.0.4",
     "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/cordis-plugin-group": "~1.0.4",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.0-rc.2",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
-    "@deepseek-ai/schemastery": "~3.18.4",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4"
   }
 }