@appthen/host-sdk 1.0.0 → 1.0.1

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.
@@ -55,6 +55,22 @@ export interface VoiceSpeakParams {
55
55
  /** 可选:语音标识,缺省用系统默认。 */
56
56
  voice?: string;
57
57
  }
58
+ /**
59
+ * 产品语音能力。现有 `voice.speak` / `voice.listen` 只承载系统默认
60
+ * TTS/STT,不能据此声明产品音质或流式能力。
61
+ */
62
+ export declare const voiceProductCapabilities: {
63
+ readonly asrListen: "voice.asr.listen";
64
+ readonly asrStop: "voice.asr.stop";
65
+ readonly asrPartial: "voice.asr.onPartial";
66
+ readonly ttsSpeak: "voice.tts.speak";
67
+ readonly ttsStop: "voice.tts.stop";
68
+ };
69
+ export interface VoiceProductSpeakParams extends VoiceSpeakParams {
70
+ /** 同一语音回合 / 消息的稳定关联号。 */
71
+ requestId?: string;
72
+ source?: string;
73
+ }
58
74
  /** `voice.listen` 入参:开始一段语音听写,识别完返回最终文本(STT)。 */
59
75
  export interface VoiceListenParams {
60
76
  /** BCP-47 语言,缺省用系统默认。 */
package/dist/contract.js CHANGED
@@ -7,7 +7,18 @@
7
7
  * `postMessage`;更不要在本模块暴露任何 RN / Electron 专属对象名。
8
8
  */
9
9
  Object.defineProperty(exports, "__esModule", { value: true });
10
- exports.voiceEventTypes = void 0;
10
+ exports.voiceEventTypes = exports.voiceProductCapabilities = void 0;
11
+ /**
12
+ * 产品语音能力。现有 `voice.speak` / `voice.listen` 只承载系统默认
13
+ * TTS/STT,不能据此声明产品音质或流式能力。
14
+ */
15
+ exports.voiceProductCapabilities = {
16
+ asrListen: 'voice.asr.listen',
17
+ asrStop: 'voice.asr.stop',
18
+ asrPartial: 'voice.asr.onPartial',
19
+ ttsSpeak: 'voice.tts.speak',
20
+ ttsStop: 'voice.tts.stop',
21
+ };
11
22
  /** voice 域对外事件名约定。 */
12
23
  exports.voiceEventTypes = {
13
24
  onInterimTranscript: 'voice.onInterimTranscript',
package/dist/desktop.d.ts CHANGED
@@ -60,10 +60,16 @@ export interface DirectoryPickerResult {
60
60
  canceled: boolean;
61
61
  path?: string;
62
62
  }
63
+ /** `workspace.ensureDefaultDirectory` 出参:桌面端默认工作目录(`~/AppThen`)。 */
64
+ export interface DefaultWorkspaceDirectory {
65
+ path: string;
66
+ }
63
67
  /** 桌面端稳定的设备身份(`device.identity` 出参)。 */
64
68
  export interface DesktopDeviceIdentity {
65
69
  nodeId: string;
66
70
  machineId: string;
71
+ /** 当前电脑名;旧桌面壳可能没有。环境面板用它做主标题,区分多台机器。 */
72
+ hostname?: string;
67
73
  }
68
74
  /** `notifications.show` / `events.publish` 入参。 */
69
75
  export interface DesktopNotification {
@@ -83,6 +89,7 @@ export declare const desktopRpcMethods: {
83
89
  readonly appVersion: "app.version";
84
90
  readonly serverGetUrl: "server.getUrl";
85
91
  readonly dialogChooseDirectory: "dialog.chooseDirectory";
92
+ readonly workspaceEnsureDefaultDirectory: "workspace.ensureDefaultDirectory";
86
93
  readonly daemonStatus: "daemon.status";
87
94
  readonly daemonStatusAll: "daemon.statusAll";
88
95
  readonly daemonStart: "daemon.start";
@@ -103,7 +110,7 @@ export declare const desktopRpcEvents: {
103
110
  readonly updaterState: "updater:state";
104
111
  };
105
112
  /** SDK 声明的桌面能力清单(握手 capabilities 下发,供页面探测宿主能力差异)。 */
106
- export declare const desktopHostCapabilities: readonly ["app.version", "server.getUrl", "dialog.chooseDirectory", "daemon.status", "daemon.statusAll", "daemon.start", "daemon.stop", "daemon.restart", "daemon.logs", "logs.openDirectory", "notifications.show", "events.publish", "updater.check", "updater.download", "updater.install", "navigation.openExternal"];
113
+ export declare const desktopHostCapabilities: readonly ["app.version", "server.getUrl", "dialog.chooseDirectory", "workspace.ensureDefaultDirectory", "daemon.status", "daemon.statusAll", "daemon.start", "daemon.stop", "daemon.restart", "daemon.logs", "logs.openDirectory", "notifications.show", "events.publish", "updater.check", "updater.download", "updater.install", "navigation.openExternal"];
107
114
  export type DesktopRpcMethod = (typeof desktopHostCapabilities)[number];
108
115
  /**
109
116
  * 类型化桌面客户端:Console / Workbench / 扩展统一从这里调用,替代旧
@@ -121,6 +128,10 @@ export declare const desktopClient: {
121
128
  dialog: {
122
129
  chooseDirectory: () => Promise<DirectoryPickerResult>;
123
130
  };
131
+ workspace: {
132
+ /** 确保并返回桌面端默认工作目录(`~/AppThen`),首次调用会创建目录。 */
133
+ ensureDefaultDirectory: () => Promise<DefaultWorkspaceDirectory>;
134
+ };
124
135
  daemon: {
125
136
  status: (target?: DaemonTarget) => Promise<DaemonStatus>;
126
137
  statusAll: () => Promise<DaemonStatus[]>;
package/dist/desktop.js CHANGED
@@ -17,6 +17,7 @@ exports.desktopRpcMethods = {
17
17
  appVersion: 'app.version',
18
18
  serverGetUrl: 'server.getUrl',
19
19
  dialogChooseDirectory: 'dialog.chooseDirectory',
20
+ workspaceEnsureDefaultDirectory: 'workspace.ensureDefaultDirectory',
20
21
  daemonStatus: 'daemon.status',
21
22
  daemonStatusAll: 'daemon.statusAll',
22
23
  daemonStart: 'daemon.start',
@@ -41,6 +42,7 @@ exports.desktopHostCapabilities = [
41
42
  exports.desktopRpcMethods.appVersion,
42
43
  exports.desktopRpcMethods.serverGetUrl,
43
44
  exports.desktopRpcMethods.dialogChooseDirectory,
45
+ exports.desktopRpcMethods.workspaceEnsureDefaultDirectory,
44
46
  exports.desktopRpcMethods.daemonStatus,
45
47
  exports.desktopRpcMethods.daemonStatusAll,
46
48
  exports.desktopRpcMethods.daemonStart,
@@ -71,6 +73,10 @@ exports.desktopClient = {
71
73
  dialog: {
72
74
  chooseDirectory: () => (0, client_1.appthenRequest)(exports.desktopRpcMethods.dialogChooseDirectory),
73
75
  },
76
+ workspace: {
77
+ /** 确保并返回桌面端默认工作目录(`~/AppThen`),首次调用会创建目录。 */
78
+ ensureDefaultDirectory: () => (0, client_1.appthenRequest)(exports.desktopRpcMethods.workspaceEnsureDefaultDirectory),
79
+ },
74
80
  daemon: {
75
81
  status: (target) => (0, client_1.appthenRequest)(exports.desktopRpcMethods.daemonStatus, target),
76
82
  statusAll: () => (0, client_1.appthenRequest)(exports.desktopRpcMethods.daemonStatusAll),
package/dist/index.mjs CHANGED
@@ -1,4 +1,11 @@
1
1
  // src/contract.ts
2
+ var voiceProductCapabilities = {
3
+ asrListen: "voice.asr.listen",
4
+ asrStop: "voice.asr.stop",
5
+ asrPartial: "voice.asr.onPartial",
6
+ ttsSpeak: "voice.tts.speak",
7
+ ttsStop: "voice.tts.stop"
8
+ };
2
9
  var voiceEventTypes = {
3
10
  onInterimTranscript: "voice.onInterimTranscript"
4
11
  };
@@ -292,6 +299,7 @@ var desktopRpcMethods = {
292
299
  appVersion: "app.version",
293
300
  serverGetUrl: "server.getUrl",
294
301
  dialogChooseDirectory: "dialog.chooseDirectory",
302
+ workspaceEnsureDefaultDirectory: "workspace.ensureDefaultDirectory",
295
303
  daemonStatus: "daemon.status",
296
304
  daemonStatusAll: "daemon.statusAll",
297
305
  daemonStart: "daemon.start",
@@ -315,6 +323,7 @@ var desktopHostCapabilities = [
315
323
  desktopRpcMethods.appVersion,
316
324
  desktopRpcMethods.serverGetUrl,
317
325
  desktopRpcMethods.dialogChooseDirectory,
326
+ desktopRpcMethods.workspaceEnsureDefaultDirectory,
318
327
  desktopRpcMethods.daemonStatus,
319
328
  desktopRpcMethods.daemonStatusAll,
320
329
  desktopRpcMethods.daemonStart,
@@ -340,6 +349,10 @@ var desktopClient = {
340
349
  dialog: {
341
350
  chooseDirectory: () => appthenRequest(desktopRpcMethods.dialogChooseDirectory)
342
351
  },
352
+ workspace: {
353
+ /** 确保并返回桌面端默认工作目录(`~/AppThen`),首次调用会创建目录。 */
354
+ ensureDefaultDirectory: () => appthenRequest(desktopRpcMethods.workspaceEnsureDefaultDirectory)
355
+ },
343
356
  daemon: {
344
357
  status: (target) => appthenRequest(desktopRpcMethods.daemonStatus, target),
345
358
  statusAll: () => appthenRequest(desktopRpcMethods.daemonStatusAll),
@@ -561,5 +574,6 @@ export {
561
574
  nextRequestId,
562
575
  setHostMode,
563
576
  voiceEventTypes,
577
+ voiceProductCapabilities,
564
578
  webCapabilityProviders
565
579
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@appthen/host-sdk",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "协同工作台 —— appthenHost 统一桥共享 SDK。桌面端 / 移动端(RN WebView)围绕这一份契约、注入脚本与分发逻辑对齐。",
5
5
  "license": "UNLICENSED",
6
6
  "author": "Appthen",
package/src/contract.ts CHANGED
@@ -67,6 +67,24 @@ export interface VoiceSpeakParams {
67
67
  voice?: string;
68
68
  }
69
69
 
70
+ /**
71
+ * 产品语音能力。现有 `voice.speak` / `voice.listen` 只承载系统默认
72
+ * TTS/STT,不能据此声明产品音质或流式能力。
73
+ */
74
+ export const voiceProductCapabilities = {
75
+ asrListen: 'voice.asr.listen',
76
+ asrStop: 'voice.asr.stop',
77
+ asrPartial: 'voice.asr.onPartial',
78
+ ttsSpeak: 'voice.tts.speak',
79
+ ttsStop: 'voice.tts.stop',
80
+ } as const;
81
+
82
+ export interface VoiceProductSpeakParams extends VoiceSpeakParams {
83
+ /** 同一语音回合 / 消息的稳定关联号。 */
84
+ requestId?: string;
85
+ source?: string;
86
+ }
87
+
70
88
  /** `voice.listen` 入参:开始一段语音听写,识别完返回最终文本(STT)。 */
71
89
  export interface VoiceListenParams {
72
90
  /** BCP-47 语言,缺省用系统默认。 */
@@ -106,4 +124,4 @@ declare global {
106
124
  interface Window {
107
125
  appthenHost?: WindowAppthenHost;
108
126
  }
109
- }
127
+ }
package/src/desktop.ts CHANGED
@@ -76,10 +76,17 @@ export interface DirectoryPickerResult {
76
76
  path?: string;
77
77
  }
78
78
 
79
+ /** `workspace.ensureDefaultDirectory` 出参:桌面端默认工作目录(`~/AppThen`)。 */
80
+ export interface DefaultWorkspaceDirectory {
81
+ path: string;
82
+ }
83
+
79
84
  /** 桌面端稳定的设备身份(`device.identity` 出参)。 */
80
85
  export interface DesktopDeviceIdentity {
81
86
  nodeId: string;
82
87
  machineId: string;
88
+ /** 当前电脑名;旧桌面壳可能没有。环境面板用它做主标题,区分多台机器。 */
89
+ hostname?: string;
83
90
  }
84
91
 
85
92
  /** `notifications.show` / `events.publish` 入参。 */
@@ -106,6 +113,7 @@ export const desktopRpcMethods = {
106
113
  appVersion: 'app.version',
107
114
  serverGetUrl: 'server.getUrl',
108
115
  dialogChooseDirectory: 'dialog.chooseDirectory',
116
+ workspaceEnsureDefaultDirectory: 'workspace.ensureDefaultDirectory',
109
117
  daemonStatus: 'daemon.status',
110
118
  daemonStatusAll: 'daemon.statusAll',
111
119
  daemonStart: 'daemon.start',
@@ -132,6 +140,7 @@ export const desktopHostCapabilities = [
132
140
  desktopRpcMethods.appVersion,
133
141
  desktopRpcMethods.serverGetUrl,
134
142
  desktopRpcMethods.dialogChooseDirectory,
143
+ desktopRpcMethods.workspaceEnsureDefaultDirectory,
135
144
  desktopRpcMethods.daemonStatus,
136
145
  desktopRpcMethods.daemonStatusAll,
137
146
  desktopRpcMethods.daemonStart,
@@ -166,6 +175,11 @@ export const desktopClient = {
166
175
  chooseDirectory: (): Promise<DirectoryPickerResult> =>
167
176
  appthenRequest(desktopRpcMethods.dialogChooseDirectory),
168
177
  },
178
+ workspace: {
179
+ /** 确保并返回桌面端默认工作目录(`~/AppThen`),首次调用会创建目录。 */
180
+ ensureDefaultDirectory: (): Promise<DefaultWorkspaceDirectory> =>
181
+ appthenRequest(desktopRpcMethods.workspaceEnsureDefaultDirectory),
182
+ },
169
183
  daemon: {
170
184
  status: (target?: DaemonTarget): Promise<DaemonStatus> =>
171
185
  appthenRequest(desktopRpcMethods.daemonStatus, target),