npm - dsh-auto-flow - Versions diffs - 0.1.0 - Mend

dsh-auto-flow 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/LICENSE +21 -0
package/README.md +129 -0
package/cordis.patch.yml +33 -0
package/lib/client.js +5820 -0
package/lib/index.d.ts +134 -0
package/lib/index.js +592 -0
package/lib/typert.host.d.ts +3 -0
package/lib/typert.host.js +314 -0
package/lib/typert.remote-client.d.ts +32 -0
package/lib/typert.remote-client.js +201 -0
package/lib/types.d.ts +106 -0
package/lib/types.js +1 -0
package/package.json +133 -0

package/lib/typert.host.js ADDED Viewed

@@ -0,0 +1,314 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+import { z } from 'zod'
+const dsh_auto_flow_autoFlow_exec_parameter_0$schema = z.object({
+  'command': z.string(),
+  'workdir': z.union([z.undefined(), z.string()]).optional(),
+  'timeoutMs': z.union([z.undefined(), z.number()]).optional(),
+  'stdoutMaxBytes': z.union([z.undefined(), z.number()]).optional(),
+  'runInBackground': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
+})
+const dsh_auto_flow_autoFlow_exec_result$schema = z.union([z.object({
+  'kind': z.literal("foreground"),
+  'exitCode': z.union([z.literal(null), z.number()]),
+  'signal': z.union([z.literal(null), z.string()]),
+  'timedOut': z.boolean(),
+  'aborted': z.boolean(),
+  'timeoutMs': z.number(),
+  'stdout': z.object({
+  'text': z.string(),
+  'truncated': z.boolean(),
+  'spillPath': z.union([z.undefined(), z.string()]).optional(),
+}),
+  'stderr': z.object({
+  'text': z.string(),
+  'truncated': z.boolean(),
+  'spillPath': z.union([z.undefined(), z.string()]).optional(),
+}),
+  'sandbox': z.union([z.undefined(), z.object({
+  'mode': z.string(),
+  'denied': z.boolean(),
+  'enforcement': z.union([z.undefined(), z.string()]).optional(),
+  'runnerFailed': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
+})]).optional(),
+}), z.object({
+  'kind': z.literal("background"),
+  'jobId': z.string(),
+})])
+const dsh_auto_flow_autoFlow_execKill_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_execKill_result$schema = z.object({
+  'kind': z.union([z.literal("requested"), z.literal("already-finished")]),
+})
+const dsh_auto_flow_autoFlow_execRead_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_execRead_result$schema = z.object({
+  'text': z.string(),
+  'status': z.string(),
+  'detail': z.union([z.undefined(), z.string()]).optional(),
+})
+const dsh_auto_flow_autoFlow_last_result$schema = z.union([z.literal(null), z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+})])
+const dsh_auto_flow_autoFlow_list_result$schema = z.array(z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+}))
+const dsh_auto_flow_autoFlow_send_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_send_result$schema = z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+})
+export const TYPERT = {
+  package: 'dsh-auto-flow',
+  face: 'host',
+  schemas: [
+  ],
+  invocations: [
+    {
+      id: 'dsh-auto-flow#autoFlow/exec',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'exec',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow/types#ExecRequest',
+            schema: dsh_auto_flow_autoFlow_exec_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecResult',
+        schema: dsh_auto_flow_autoFlow_exec_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":511,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/execKill',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'execKill',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'jobId',
+          wire: 'jobId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/execKill:jobId',
+            schema: dsh_auto_flow_autoFlow_execKill_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecKillResult',
+        schema: dsh_auto_flow_autoFlow_execKill_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":585,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/execRead',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'execRead',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'jobId',
+          wire: 'jobId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/execRead:jobId',
+            schema: dsh_auto_flow_autoFlow_execRead_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecReadResult',
+        schema: dsh_auto_flow_autoFlow_execRead_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":559,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/last',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'last',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow#autoFlow/last:result',
+        schema: dsh_auto_flow_autoFlow_last_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":487,"column":3},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/list',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'list',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow#autoFlow/list:result',
+        schema: dsh_auto_flow_autoFlow_list_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":481,"column":3},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/send',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'send',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'text',
+          wire: 'text',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/send:text',
+            schema: dsh_auto_flow_autoFlow_send_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#Greeting',
+        schema: dsh_auto_flow_autoFlow_send_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":453,"column":9},
+    },
+  ],
+  model: {
+    "services": [
+      {
+        "description": "示例服务：类本身就是插件——static inject / Config 是 Cordis 类插件的约定， 构造器里的注册（工具/事件/设置/命令）随插件卸载自动回收。 平台服务消费方式（跨插件协作走 Cordis 服务、禁止互相 import）： - 必需依赖用 `static inject`（tools）； - 可选依赖用 `ctx.inject([...], cb)`（settings / commands / systemPrompt / autoFlowFormatter）——服务缺失时插件照常加载； - shell / sandboxPolicy 是可选服务：用 `ctx.get(...)` 读取，未组合时 `exec` 报错、插件其余部分照常工作； - 持久层异步打开走 `[Service.init]`（storageDomain 可选：缺省退化为内存态）。",
+        "summary": "示例服务：类本身就是插件——static inject / Config 是 Cordis 类插件的约定， 构造器里的注册（工具/事件/设置/命令）随插件卸载自动回收。 平台服务消费方式（跨插件协作走 Cordis 服务、禁止互相 import）： - 必需依赖用 `static inject`（tools）； - 可选依赖用 `ctx.inject([...], cb)`（settings / commands / systemPrompt / autoFlowFormatter）——服务缺失时插件照常加载； - shell / sandboxPolicy 是可选服务：用 `ctx.get(...)` 读取，未组合时 `exec` 报错、插件其余部分照常工作； - 持久层异步打开走 `[Service.init]`（storageDomain 可选：缺省退化为内存态）。",
+        "tags": [],
+        "jsDoc": "/**\n * 示例服务：类本身就是插件——static inject / Config 是 Cordis 类插件的约定，\n * 构造器里的注册（工具/事件/设置/命令）随插件卸载自动回收。\n *\n * 平台服务消费方式（跨插件协作走 Cordis 服务、禁止互相 import）：\n * - 必需依赖用 `static inject`（tools）；\n * - 可选依赖用 `ctx.inject([...], cb)`（settings / commands / systemPrompt /\n *   autoFlowFormatter）——服务缺失时插件照常加载；\n * - shell / sandboxPolicy 是可选服务：用 `ctx.get(...)` 读取，未组合时\n *   `exec` 报错、插件其余部分照常工作；\n * - 持久层异步打开走 `[Service.init]`（storageDomain 可选：缺省退化为内存态）。\n */",
+        "key": "autoFlow",
+        "exportName": "AutoFlowService",
+        "members": [
+          {
+            "kind": "method",
+            "name": "send",
+            "signature": "@Remote('send') async send(text: string): Promise<Greeting>",
+            "summary": "追加一条问候并返回记录（写透 domain storage；若有第二包则先格式化；提交后发域事件）。 不追加自定义会话事件：harness 的 session 持久化读路径会拒绝 `KNOWN_SESSION_EVENT_TYPES` 之外的事件类型（除非信封标记 `ignorable`，而 `Session.append` 无此参数），把插件 自定义事件写进会话日志会导致该会话在重启后无法打开。",
+            "jsDoc": "/**\n * 追加一条问候并返回记录（写透 domain storage；若有第二包则先格式化；提交后发域事件）。\n *\n * 不追加自定义会话事件：harness 的 session 持久化读路径会拒绝 `KNOWN_SESSION_EVENT_TYPES`\n * 之外的事件类型（除非信封标记 `ignorable`，而 `Session.append` 无此参数），把插件\n * 自定义事件写进会话日志会导致该会话在重启后无法打开。\n */"
+          },
+          {
+            "kind": "method",
+            "name": "list",
+            "signature": "@Remote('list') list(): Promise<Greeting[]>",
+            "summary": "返回全部问候记录（内存视图，已由 domain storage 水合）。",
+            "jsDoc": "/** 返回全部问候记录（内存视图，已由 domain storage 水合）。 */"
+          },
+          {
+            "kind": "method",
+            "name": "last",
+            "signature": "@Remote('last') last(): Promise<Greeting | null>",
+            "summary": "返回最近一次提交的问候（由域事件监听器维护），首次提交前为 null。",
+            "jsDoc": "/** 返回最近一次提交的问候（由域事件监听器维护），首次提交前为 null。 */"
+          },
+          {
+            "kind": "method",
+            "name": "exec",
+            "signature": "@Remote('exec') async exec(request: ExecRequest): Promise<ExecResult>",
+            "summary": "执行一条命令行（宿主内经 ctx.shell，与 bash 工具同一执行器，绝不经过模型）。 输出只回调用方、不进会话日志。@Remote 严格契约保证浏览器端完整类型与校验。 相比模型工具（@deepseek-ai/dsh-tool-bash）的 shell 面，@Remote 轻执行只能拿到 能映射过来的子集：timeoutMs / stdoutMaxBytes / sandboxPolicy / 后台任务 / 结果保真。 模型工具专属的 seam（shellEnv.collect 需要 ToolExecution、sandbox 升级需要 approval + callId、abort 需要 ToolExecution.signal）不适用于",
+            "jsDoc": "/**\n * 执行一条命令行（宿主内经 ctx.shell，与 bash 工具同一执行器，绝不经过模型）。\n * 输出只回调用方、不进会话日志。@Remote 严格契约保证浏览器端完整类型与校验。\n *\n * 相比模型工具（@deepseek-ai/dsh-tool-bash）的 shell 面，@Remote 轻执行只能拿到\n * 能映射过来的子集：timeoutMs / stdoutMaxBytes / sandboxPolicy / 后台任务 / 结果保真。\n * 模型工具专属的 seam（shellEnv.collect 需要 ToolExecution、sandbox 升级需要 approval\n * + callId、abort 需要 ToolExecution.signal）不适用于 @Remote，此处不做。\n *\n * 注意：@Remote 方法不能带 `agent: Agent` 参数——第三方仓库的 typert 生成器无法解析\n * `agent` lookup（其 wire 类型 SessionId 是 branded 类型，官方 monorepo 内才可用）。\n * 因此沙箱策略退化为「部署默认」（`sandboxPolicy.resolve()` 无 session）。\n *\n * 后台执行不走 ctx.jobs（那是给模型工具 job_output/job_kill 用的，需要 agent owner +\n * dsh-tool-jobs 控制器，@Remote 里拿不到）：直接用 `shell.start()` 拿 ShellProcess\n * 句柄，自管在 this.background Map 里，execRead/execKill 直接操作句柄；卸载时统一 kill。\n *\n * shell / sandboxPolicy 是可选依赖：未组合时抛对应 RemoteError，插件其余照常。\n */"
+          },
+          {
+            "kind": "method",
+            "name": "execRead",
+            "signature": "@Remote('execRead') async execRead(jobId: string): Promise<ExecReadResult>",
+            "summary": "读后台进程的下一次增量/终态输出（自管 ShellProcess 句柄，不依赖 ctx.jobs）。",
+            "jsDoc": "/** 读后台进程的下一次增量/终态输出（自管 ShellProcess 句柄，不依赖 ctx.jobs）。 */"
+          },
+          {
+            "kind": "method",
+            "name": "execKill",
+            "signature": "@Remote('execKill') async execKill(jobId: string): Promise<ExecKillResult>",
+            "summary": "请求取消后台进程（自管 ShellProcess 句柄，不依赖 ctx.jobs）。",
+            "jsDoc": "/** 请求取消后台进程（自管 ShellProcess 句柄，不依赖 ctx.jobs）。 */"
+          }
+        ],
+        "types": [
+          {
+            "name": "ExecBackgroundResult",
+            "declaration": "export interface ExecBackgroundResult {\n    kind: 'background';\n    jobId: string;\n}"
+          },
+          {
+            "name": "ExecForegroundResult",
+            "declaration": "export interface ExecForegroundResult {\n    kind: 'foreground';\n    exitCode: number | null;\n    signal: string | null;\n    timedOut: boolean;\n    aborted: boolean;\n    timeoutMs: number;\n    stdout: ExecOutput;\n    stderr: ExecOutput;\n    sandbox?: ExecSandboxInfo;\n}"
+          },
+          {
+            "name": "ExecKillResult",
+            "declaration": "export interface ExecKillResult {\n    kind: 'requested' | 'already-finished';\n}"
+          },
+          {
+            "name": "ExecOutput",
+            "declaration": "export interface ExecOutput {\n    text: string;\n    truncated: boolean;\n    spillPath?: string;\n}"
+          },
+          {
+            "name": "ExecReadResult",
+            "declaration": "export interface ExecReadResult {\n    text: string;\n    status: string;\n    detail?: string;\n}"
+          },
+          {
+            "name": "ExecRequest",
+            "declaration": "export interface ExecRequest {\n    command: string;\n    workdir?: string;\n    timeoutMs?: number;\n    stdoutMaxBytes?: number;\n    runInBackground?: boolean;\n}"
+          },
+          {
+            "name": "ExecResult",
+            "declaration": "export type ExecResult = ExecForegroundResult | ExecBackgroundResult;"
+          },
+          {
+            "name": "ExecSandboxInfo",
+            "declaration": "export interface ExecSandboxInfo {\n    mode: string;\n    denied: boolean;\n    enforcement?: string;\n    runnerFailed?: boolean;\n}"
+          },
+          {
+            "name": "Greeting",
+            "declaration": "export interface Greeting {\n    id: number;\n    text: string;\n    createdAt: number;\n}"
+          }
+        ]
+      }
+    ],
+    "events": [
+      {
+        "description": "一次问候已提交（域事件，跨插件实时通知 seam）。发出方在 `send` 提交后 emit；其它插件可 `ctx.on('autoFlow/recorded', ...)` 订阅。",
+        "summary": "一次问候已提交（域事件，跨插件实时通知 seam）。发出方在 `send` 提交后 emit；其它插件可 `ctx.on('autoFlow/recorded', ...)` 订阅。",
+        "tags": [
+          {
+            "name": "mode",
+            "comment": "emit",
+            "text": "@mode emit"
+          }
+        ],
+        "jsDoc": "/**\n * 一次问候已提交（域事件，跨插件实时通知 seam）。发出方在 `send` 提交后\n * emit；其它插件可 `ctx.on('autoFlow/recorded', ...)` 订阅。\n * @mode emit\n */",
+        "name": "autoFlow/recorded",
+        "mode": "emit",
+        "signature": "'autoFlow/recorded'(payload: { readonly greeting: Greeting; }): void"
+      }
+    ],
+    "objects": []
+  },
+}

package/lib/typert.remote-client.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import type {
+  RemoteResult,
+  TypertRemoteContribution,
+} from '@deepseek-ai/dsh-typert-protocol'
+import type { ExecKillResult, ExecReadResult, ExecRequest, ExecResult, Greeting } from 'dsh-auto-flow/types'
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface TypertRemoteNamespace$6175746f466c6f77 {
+    exec: (request: ExecRequest) => Promise<RemoteResult<ExecResult>>
+    execKill: (jobId: string) => Promise<RemoteResult<ExecKillResult>>
+    execRead: (jobId: string) => Promise<RemoteResult<ExecReadResult>>
+    last: () => Promise<RemoteResult<Greeting | null>>
+    list: () => Promise<RemoteResult<Greeting[]>>
+    send: (text: string) => Promise<RemoteResult<Greeting>>
+  }
+  interface TypertRemoteMap {
+    'autoFlow/exec': (request: ExecRequest) => Promise<RemoteResult<ExecResult>>
+    'autoFlow/execKill': (jobId: string) => Promise<RemoteResult<ExecKillResult>>
+    'autoFlow/execRead': (jobId: string) => Promise<RemoteResult<ExecReadResult>>
+    'autoFlow/last': () => Promise<RemoteResult<Greeting | null>>
+    'autoFlow/list': () => Promise<RemoteResult<Greeting[]>>
+    'autoFlow/send': (text: string) => Promise<RemoteResult<Greeting>>
+  }
+  interface TypertRemoteNamespaceMap {
+    'autoFlow': TypertRemoteNamespace$6175746f466c6f77
+  }
+}
+export declare const TYPERT_REMOTE: TypertRemoteContribution
+export default TYPERT_REMOTE
+//# sourceMappingURL=typert.remote-client.d.ts.map

package/lib/typert.remote-client.js ADDED Viewed

@@ -0,0 +1,201 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+const dsh_auto_flow_autoFlow_exec_parameter_0$schema = z.object({
+  'command': z.string(),
+  'workdir': z.union([z.undefined(), z.string()]).optional(),
+  'timeoutMs': z.union([z.undefined(), z.number()]).optional(),
+  'stdoutMaxBytes': z.union([z.undefined(), z.number()]).optional(),
+  'runInBackground': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
+})
+const dsh_auto_flow_autoFlow_exec_result$schema = z.union([z.object({
+  'kind': z.literal("foreground"),
+  'exitCode': z.union([z.literal(null), z.number()]),
+  'signal': z.union([z.literal(null), z.string()]),
+  'timedOut': z.boolean(),
+  'aborted': z.boolean(),
+  'timeoutMs': z.number(),
+  'stdout': z.object({
+  'text': z.string(),
+  'truncated': z.boolean(),
+  'spillPath': z.union([z.undefined(), z.string()]).optional(),
+}),
+  'stderr': z.object({
+  'text': z.string(),
+  'truncated': z.boolean(),
+  'spillPath': z.union([z.undefined(), z.string()]).optional(),
+}),
+  'sandbox': z.union([z.undefined(), z.object({
+  'mode': z.string(),
+  'denied': z.boolean(),
+  'enforcement': z.union([z.undefined(), z.string()]).optional(),
+  'runnerFailed': z.union([z.undefined(), z.literal(false), z.literal(true)]).optional(),
+})]).optional(),
+}), z.object({
+  'kind': z.literal("background"),
+  'jobId': z.string(),
+})])
+const dsh_auto_flow_autoFlow_execKill_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_execKill_result$schema = z.object({
+  'kind': z.union([z.literal("requested"), z.literal("already-finished")]),
+})
+const dsh_auto_flow_autoFlow_execRead_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_execRead_result$schema = z.object({
+  'text': z.string(),
+  'status': z.string(),
+  'detail': z.union([z.undefined(), z.string()]).optional(),
+})
+const dsh_auto_flow_autoFlow_last_result$schema = z.union([z.literal(null), z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+})])
+const dsh_auto_flow_autoFlow_list_result$schema = z.array(z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+}))
+const dsh_auto_flow_autoFlow_send_parameter_0$schema = z.string()
+const dsh_auto_flow_autoFlow_send_result$schema = z.object({
+  'id': z.number(),
+  'text': z.string(),
+  'createdAt': z.number(),
+})
+export const TYPERT_REMOTE = {
+  package: 'dsh-auto-flow',
+  descriptors: [
+    {
+      id: 'dsh-auto-flow#autoFlow/exec',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'exec',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow/types#ExecRequest',
+            schema: dsh_auto_flow_autoFlow_exec_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecResult',
+        schema: dsh_auto_flow_autoFlow_exec_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":511,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/execKill',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'execKill',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'jobId',
+          wire: 'jobId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/execKill:jobId',
+            schema: dsh_auto_flow_autoFlow_execKill_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecKillResult',
+        schema: dsh_auto_flow_autoFlow_execKill_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":585,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/execRead',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'execRead',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'jobId',
+          wire: 'jobId',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/execRead:jobId',
+            schema: dsh_auto_flow_autoFlow_execRead_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#ExecReadResult',
+        schema: dsh_auto_flow_autoFlow_execRead_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":559,"column":9},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/last',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'last',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow#autoFlow/last:result',
+        schema: dsh_auto_flow_autoFlow_last_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":487,"column":3},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/list',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'list',
+      invocation: { kind: 'direct' },
+      parameters: [
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow#autoFlow/list:result',
+        schema: dsh_auto_flow_autoFlow_list_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":481,"column":3},
+    },
+    {
+      id: 'dsh-auto-flow#autoFlow/send',
+      service: 'autoFlow',
+      namespace: 'autoFlow',
+      method: 'send',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'text',
+          wire: 'text',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'dsh-auto-flow#autoFlow/send:text',
+            schema: dsh_auto_flow_autoFlow_send_parameter_0$schema,
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: 'dsh-auto-flow/types#Greeting',
+        schema: dsh_auto_flow_autoFlow_send_result$schema,
+      },
+      sourceLocation: {"file":"packages/dsh-auto-flow/src/index.ts","line":453,"column":9},
+    },
+  ],
+}
+export default TYPERT_REMOTE

package/lib/types.d.ts ADDED Viewed

@@ -0,0 +1,106 @@
+//#region src/types.d.ts
+/**
+ * dsh-auto-flow 的共享业务类型；Host 与 Client 都从这里取（经本包 ./types 出口）。
+ * 本文件必须保持「浏览器安全」：只含纯 JSON 可序列化的载荷与类型词汇，
+ * 不 import 任何 Host 专属值（Agent / HarnessError 等只在 Host 半 src/index.ts 用）。
+ */
+/** 一条问候记录。 */
+interface Greeting {
+  /** 记录 id（自增）。 */
+  id: number;
+  /** 问候内容（含前缀）。 */
+  text: string;
+  /** 创建时间戳（毫秒）。 */
+  createdAt: number;
+}
+/** 一次运行捕获的一路输出（CollectedOutput 的客户端安全投影）。 */
+interface ExecOutput {
+  /** 已捕获文本。 */
+  text: string;
+  /** 捕获是否被截断（完整输出在 spillPath）。 */
+  truncated: boolean;
+  /** 截断时的完整输出文件路径。 */
+  spillPath?: string;
+}
+/** 一次运行附带的沙箱事实（ShellSandboxInfo 的客户端安全投影，mode 字符串化）。 */
+interface ExecSandboxInfo {
+  /** 命令实际运行的模式（read-only / workspace-write / danger-full-access）。 */
+  mode: string;
+  /** 沙箱是否拒绝了某次文件操作。 */
+  denied: boolean;
+  /** 选定 runner 对请求模式的执行完整度。 */
+  enforcement?: string;
+  /** 沙箱 runner 是否在命令运行前就失败（命令未运行）。 */
+  runnerFailed?: boolean;
+}
+/**
+ * exec Remote 方法的请求（经 ctx.shell seam，与 bash 工具同一执行器、绝不经过模型）。
+ * 轻执行：输出只回调用方，不进会话日志。
+ */
+interface ExecRequest {
+  /** 通过 Host 默认 shell 执行的命令行。 */
+  command: string;
+  /** 工作目录；缺省用执行器的已配置工作目录。 */
+  workdir?: string;
+  /** 超时（毫秒）；执行器会应用其默认值并封顶。后台执行忽略。 */
+  timeoutMs?: number;
+  /** 前台 stdout 捕获预算（字节）；需要完整解析 stdout 的进程内消费者用。 */
+  stdoutMaxBytes?: number;
+  /** 置 true 走后台（立即返回 jobId，经 execRead/execKill 消费），不设超时。 */
+  runInBackground?: boolean;
+}
+/** 前台执行的完成结果（从 ctx.shell 的 ShellRunResult 映射，保留截断/沙箱事实）。 */
+interface ExecForegroundResult {
+  kind: 'foreground';
+  /** 退出码；被信号杀死时为 null。 */
+  exitCode: number | null;
+  /** 终止信号（如 'SIGTERM'）；正常退出为 null。 */
+  signal: string | null;
+  /** 执行器自身超时是否先终止了命令。 */
+  timedOut: boolean;
+  /** 调用方取消是否先终止了命令。 */
+  aborted: boolean;
+  /** 本次实际生效的超时（默认/封顶之后）。 */
+  timeoutMs: number;
+  stdout: ExecOutput;
+  stderr: ExecOutput;
+  /** 沙箱执行事实；未沙箱化的执行器缺省。 */
+  sandbox?: ExecSandboxInfo;
+}
+/** 后台执行的确认：立即返回 job id，客户端经 execRead/execKill 消费。 */
+interface ExecBackgroundResult {
+  kind: 'background';
+  jobId: string;
+}
+/** exec Remote 方法的结果：前台完整输出，或后台 job id。 */
+type ExecResult = ExecForegroundResult | ExecBackgroundResult;
+/** 后台进程的一次增量读取（经 shell.start 句柄 readOutput，客户端安全）。 */
+interface ExecReadResult {
+  /** 本次增量（流式）或终态输出（final-output）。 */
+  text: string;
+  /** job 当前状态：running | stopping | completed | killed | failed。 */
+  status: string;
+  /** 终态详情（如 'exit code: 0'），未终态缺省。 */
+  detail?: string;
+}
+/** execKill 的返回。 */
+interface ExecKillResult {
+  /** requested：已请求取消；already-finished：已终态。 */
+  kind: 'requested' | 'already-finished';
+}
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface RemoteErrorDetailsMap {
+    /** exec 命令超过配置的 UTF-8 字节上界。 */
+    'autoFlow/command-too-long': {
+      readonly maxBytes: number;
+      readonly actualBytes: number;
+    };
+    /** 组合未提供 ctx.shell 提供方（@deepseek-ai/dsh-shell）。 */
+    'autoFlow/shell-missing': {};
+    /** 后台 job 不存在或已结束。 */
+    'autoFlow/job-not-found': {};
+  }
+}
+//#endregion
+export { ExecBackgroundResult, ExecForegroundResult, ExecKillResult, ExecOutput, ExecReadResult, ExecRequest, ExecResult, ExecSandboxInfo, Greeting };
+//# sourceMappingURL=types.d.ts.map

package/lib/types.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};