@deepseek-harness-tui/dsh-tui 0.9.2 → 0.9.3
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.
- package/README.md +4 -4
- package/bin/dsh-tui.js +26 -4
- package/dsh-ecosystem-spec/protocols/profile-definitions.d.ts +13 -13
- package/dsh-ecosystem-spec/protocols/profile-definitions.js +59 -59
- package/dsh-ecosystem-spec/protocols/tui-channel-http.d.ts +15 -15
- package/dsh-ecosystem-spec/protocols/tui-channel-http.js +32 -32
- package/dsh-ecosystem-spec/protocols/tui-channel.d.ts +59 -59
- package/dsh-ecosystem-spec/protocols/tui-channel.js +166 -166
- package/dsh-ecosystem-spec/protocols/tui-contributions.d.ts +42 -42
- package/dsh-ecosystem-spec/protocols/tui-contributions.js +143 -143
- package/dsh-ecosystem-spec/registry/README.md +14 -14
- package/dsh-ecosystem-spec/registry/host-descriptor.tui.example.json +56 -56
- package/dsh-ecosystem-spec/registry/permissions-0.1.json +13 -13
- package/dsh-ecosystem-spec/registry/registry-0.15.json +149 -149
- package/lib/types/commands.d.ts.map +1 -1
- package/lib/types/commands.js +7 -8
- package/lib/types/components/BalanceReportRow.d.ts +24 -0
- package/lib/types/components/BalanceReportRow.d.ts.map +1 -0
- package/lib/types/components/BalanceReportRow.js +87 -0
- package/lib/types/components/HistorySearchDialog.js +1 -1
- package/lib/types/components/MessageList.d.ts +3 -1
- package/lib/types/components/MessageList.d.ts.map +1 -1
- package/lib/types/components/MessageList.js +11 -7
- package/lib/types/components/PluginSceneBoundary.d.ts +1 -1
- package/lib/types/components/PluginSceneBoundary.js +1 -1
- package/lib/types/components/PromptInput.d.ts.map +1 -1
- package/lib/types/components/PromptInput.js +16 -0
- package/lib/types/components/Whale.d.ts +15 -4
- package/lib/types/components/Whale.d.ts.map +1 -1
- package/lib/types/components/Whale.js +9 -8
- package/lib/types/components/messages/AssistantToolUseMessage.d.ts +7 -1
- package/lib/types/components/messages/AssistantToolUseMessage.d.ts.map +1 -1
- package/lib/types/components/messages/AssistantToolUseMessage.js +34 -4
- package/lib/types/deepseekBalance.d.ts +53 -0
- package/lib/types/deepseekBalance.d.ts.map +1 -0
- package/lib/types/deepseekBalance.js +86 -0
- package/lib/types/deepseekPricing.d.ts +82 -0
- package/lib/types/deepseekPricing.d.ts.map +1 -0
- package/lib/types/deepseekPricing.js +133 -0
- package/lib/types/dsh-adapter/channel.d.ts +46 -1
- package/lib/types/dsh-adapter/channel.d.ts.map +1 -1
- package/lib/types/dsh-adapter/channel.js +84 -10
- package/lib/types/dsh-adapter/index.d.ts +5 -0
- package/lib/types/dsh-adapter/index.d.ts.map +1 -1
- package/lib/types/dsh-adapter/index.js +1 -0
- package/lib/types/dsh-adapter/packaged-skills.d.ts +9 -0
- package/lib/types/dsh-adapter/packaged-skills.d.ts.map +1 -1
- package/lib/types/dsh-adapter/packaged-skills.js +19 -4
- package/lib/types/dsh-adapter/plugin.d.ts +6 -0
- package/lib/types/dsh-adapter/plugin.d.ts.map +1 -1
- package/lib/types/dsh-adapter/plugin.js +122 -18
- package/lib/types/dsh-adapter/settings-sections.d.ts +1 -0
- package/lib/types/dsh-adapter/settings-sections.d.ts.map +1 -1
- package/lib/types/dsh-adapter/settings-sections.js +35 -2
- package/lib/types/history.d.ts +4 -3
- package/lib/types/history.d.ts.map +1 -1
- package/lib/types/history.js +66 -18
- package/lib/types/i18n.d.ts +122 -55
- package/lib/types/i18n.d.ts.map +1 -1
- package/lib/types/i18n.js +39 -18
- package/lib/types/ink/ink.d.ts.map +1 -1
- package/lib/types/ink/ink.js +67 -17
- package/lib/types/ink/root.d.ts +16 -0
- package/lib/types/ink/root.d.ts.map +1 -1
- package/lib/types/ink/root.js +2 -0
- package/lib/types/ink/terminal-querier.d.ts +8 -0
- package/lib/types/ink/terminal-querier.d.ts.map +1 -1
- package/lib/types/ink/terminal-querier.js +13 -0
- package/lib/types/ink/terminal.d.ts +42 -0
- package/lib/types/ink/terminal.d.ts.map +1 -1
- package/lib/types/ink/terminal.js +52 -2
- package/lib/types/plugin-spec/registry.d.ts +1 -1
- package/lib/types/plugin-spec/registry.js +1 -1
- package/lib/types/screens/Chat.d.ts.map +1 -1
- package/lib/types/screens/Chat.js +72 -37
- package/lib/types/screens/SessionBrowser.d.ts.map +1 -1
- package/lib/types/screens/SessionBrowser.js +28 -13
- package/lib/types/screens/SessionTree.d.ts.map +1 -1
- package/lib/types/screens/SessionTree.js +33 -9
- package/lib/types/screens/Settings.d.ts +7 -5
- package/lib/types/screens/Settings.d.ts.map +1 -1
- package/lib/types/screens/Settings.js +206 -99
- package/lib/types/screens/StatusLine.d.ts.map +1 -1
- package/lib/types/screens/StatusLine.js +32 -1
- package/lib/types/sessionHistory.d.ts +11 -0
- package/lib/types/sessionHistory.d.ts.map +1 -1
- package/lib/types/sessionHistory.js +29 -0
- package/lib/types/sessions/format.d.ts.map +1 -1
- package/lib/types/sessions/format.js +14 -4
- package/lib/types/tips.js +2 -2
- package/lib/types/tuiDisplayPrefs.d.ts +3 -0
- package/lib/types/tuiDisplayPrefs.d.ts.map +1 -1
- package/lib/types/tuiDisplayPrefs.js +1 -0
- package/lib/types/update.d.ts +46 -0
- package/lib/types/update.d.ts.map +1 -1
- package/lib/types/update.js +232 -3
- package/node_modules/@deepseek-harness-tui/dsh-auth/LICENSE +21 -21
- package/node_modules/@deepseek-harness-tui/dsh-auth/dsh-plugin.json +44 -44
- package/node_modules/@dsh-std/command/CHANGELOG.md +8 -8
- package/node_modules/@dsh-std/command/LICENSE +21 -21
- package/node_modules/@dsh-std/command/README.md +26 -26
- package/node_modules/@dsh-std/command/README.zh.md +28 -28
- package/node_modules/@dsh-std/command/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/command/package.json +22 -22
- package/node_modules/@dsh-std/connection/CHANGELOG.md +8 -8
- package/node_modules/@dsh-std/connection/LICENSE +21 -21
- package/node_modules/@dsh-std/connection/README.md +42 -42
- package/node_modules/@dsh-std/connection/README.zh.md +42 -42
- package/node_modules/@dsh-std/connection/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/connection/lib/memory.js.map +1 -1
- package/node_modules/@dsh-std/connection/lib/resolve-3X6ausgz.js.map +1 -1
- package/node_modules/@dsh-std/connection/package.json +20 -20
- package/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/node_modules/@dsh-std/core/LICENSE +21 -21
- package/node_modules/@dsh-std/core/README.md +13 -13
- package/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/core/package.json +21 -21
- package/node_modules/@dsh-std/manifest/CHANGELOG.md +9 -9
- package/node_modules/@dsh-std/manifest/LICENSE +21 -21
- package/node_modules/@dsh-std/manifest/README.md +5 -5
- package/node_modules/@dsh-std/manifest/README.zh.md +5 -5
- package/node_modules/@dsh-std/manifest/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/manifest/package.json +20 -20
- package/node_modules/@dsh-std/manifest/schema/dsh-plugin-0.15.schema.json +144 -144
- package/node_modules/@dsh-std/messages/CHANGELOG.md +8 -8
- package/node_modules/@dsh-std/messages/LICENSE +21 -21
- package/node_modules/@dsh-std/messages/README.md +5 -5
- package/node_modules/@dsh-std/messages/README.zh.md +7 -7
- package/node_modules/@dsh-std/messages/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/messages/package.json +20 -20
- package/node_modules/@dsh-std/messages/schema/message-observer-envelope-0.15.schema.json +54 -54
- package/node_modules/@dsh-std/presentation/CHANGELOG.md +9 -9
- package/node_modules/@dsh-std/presentation/LICENSE +21 -21
- package/node_modules/@dsh-std/presentation/README.md +27 -27
- package/node_modules/@dsh-std/presentation/README.zh.md +29 -29
- package/node_modules/@dsh-std/presentation/lib/callback.js.map +1 -1
- package/node_modules/@dsh-std/presentation/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/presentation/package.json +25 -25
- package/node_modules/@dsh-std/storage/CHANGELOG.md +8 -8
- package/node_modules/@dsh-std/storage/LICENSE +21 -21
- package/node_modules/@dsh-std/storage/README.md +5 -5
- package/node_modules/@dsh-std/storage/README.zh.md +7 -7
- package/node_modules/@dsh-std/storage/lib/index.js.map +1 -1
- package/node_modules/@dsh-std/storage/package.json +20 -20
- package/node_modules/@dsh-std/storage/schema/local-storage-0.15.schema.json +56 -56
- package/package.json +95 -5
- package/skills/pr-comments/SKILL.md +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/LICENSE +21 -21
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/README.md +42 -42
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/README.zh.md +42 -42
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/memory.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/lib/resolve-3X6ausgz.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/connection/package.json +20 -20
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/core/package.json +21 -21
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/CHANGELOG.md +9 -9
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/LICENSE +21 -21
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/README.md +5 -5
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/README.zh.md +5 -5
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/package.json +20 -20
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/manifest/schema/dsh-plugin-0.15.schema.json +144 -144
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/CHANGELOG.md +9 -9
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/LICENSE +21 -21
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/README.md +27 -27
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/README.zh.md +29 -29
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/lib/callback.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/package.json +25 -25
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/connection/node_modules/@dsh-std/core/package.json +21 -21
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/manifest/node_modules/@dsh-std/core/package.json +21 -21
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/messages/node_modules/@dsh-std/core/package.json +21 -21
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/LICENSE +21 -21
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/README.md +42 -42
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/README.zh.md +42 -42
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/lib/memory.js.map +1 -1
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/lib/resolve-3X6ausgz.js.map +1 -1
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/connection/package.json +20 -20
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/presentation/node_modules/@dsh-std/core/package.json +21 -21
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/CHANGELOG.md +8 -8
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/LICENSE +21 -21
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/README.md +13 -13
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/README.zh.md +13 -13
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/lib/index.js.map +1 -1
- package/vendor/dsh-std/packages/storage/node_modules/@dsh-std/core/package.json +21 -21
|
@@ -1,144 +1,144 @@
|
|
|
1
|
-
{
|
|
2
|
-
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
-
"title": "DSH Plugin Manifest Community Draft v0.15",
|
|
4
|
-
"type": "object",
|
|
5
|
-
"additionalProperties": false,
|
|
6
|
-
"required": ["$schema", "manifestVersion", "id", "name", "version", "facets", "requires", "permissions", "contributes", "subscriptions"],
|
|
7
|
-
"properties": {
|
|
8
|
-
"$schema": { "type": "string", "format": "uri" },
|
|
9
|
-
"manifestVersion": { "const": "0.15" },
|
|
10
|
-
"id": { "$ref": "#/$defs/namespacedId" },
|
|
11
|
-
"name": { "type": "string", "minLength": 1 },
|
|
12
|
-
"version": { "type": "string", "minLength": 1 },
|
|
13
|
-
"facets": {
|
|
14
|
-
"type": "object",
|
|
15
|
-
"additionalProperties": false,
|
|
16
|
-
"required": ["host"],
|
|
17
|
-
"properties": {
|
|
18
|
-
"host": {
|
|
19
|
-
"type": "object",
|
|
20
|
-
"additionalProperties": false,
|
|
21
|
-
"required": ["entry", "apiVersion"],
|
|
22
|
-
"properties": {
|
|
23
|
-
"entry": { "type": "string", "minLength": 1, "pattern": "^(?![\\\\/])(?![A-Za-z]:[\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)).+$" },
|
|
24
|
-
"apiVersion": { "type": "string", "pattern": "^v[1-9][0-9]*(?:(?:alpha|beta)[1-9][0-9]*)?$" }
|
|
25
|
-
}
|
|
26
|
-
}
|
|
27
|
-
}
|
|
28
|
-
},
|
|
29
|
-
"requires": {
|
|
30
|
-
"type": "object",
|
|
31
|
-
"additionalProperties": false,
|
|
32
|
-
"required": ["contracts"],
|
|
33
|
-
"properties": {
|
|
34
|
-
"contracts": { "type": "array", "items": { "$ref": "#/$defs/contract" } },
|
|
35
|
-
"services": { "type": "array", "maxItems": 0 }
|
|
36
|
-
}
|
|
37
|
-
},
|
|
38
|
-
"permissions": { "type": "array", "items": { "$ref": "#/$defs/permission" } },
|
|
39
|
-
"contributes": {
|
|
40
|
-
"type": "object",
|
|
41
|
-
"required": ["commands"],
|
|
42
|
-
"properties": {
|
|
43
|
-
"commands": { "type": "array", "items": { "$ref": "#/$defs/command" } },
|
|
44
|
-
"panels": { "type": "array", "maxItems": 0 }
|
|
45
|
-
},
|
|
46
|
-
"patternProperties": { "^x-": { "type": "array" } },
|
|
47
|
-
"additionalProperties": false
|
|
48
|
-
},
|
|
49
|
-
"subscriptions": {
|
|
50
|
-
"type": "array",
|
|
51
|
-
"items": {
|
|
52
|
-
"oneOf": [
|
|
53
|
-
{ "type": "string", "minLength": 1 },
|
|
54
|
-
{ "$ref": "#/$defs/subscription" }
|
|
55
|
-
]
|
|
56
|
-
}
|
|
57
|
-
},
|
|
58
|
-
"license": { "type": "string", "minLength": 1 },
|
|
59
|
-
"source": {
|
|
60
|
-
"type": "object",
|
|
61
|
-
"additionalProperties": false,
|
|
62
|
-
"required": ["repository"],
|
|
63
|
-
"properties": {
|
|
64
|
-
"repository": { "type": "string", "format": "uri" },
|
|
65
|
-
"revision": { "type": "string", "minLength": 1 }
|
|
66
|
-
}
|
|
67
|
-
},
|
|
68
|
-
"artifact": {
|
|
69
|
-
"type": "object",
|
|
70
|
-
"additionalProperties": false,
|
|
71
|
-
"required": ["digest", "algorithm", "path"],
|
|
72
|
-
"properties": {
|
|
73
|
-
"digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
|
|
74
|
-
"algorithm": { "const": "sha256" },
|
|
75
|
-
"path": { "type": "string", "minLength": 1 }
|
|
76
|
-
}
|
|
77
|
-
},
|
|
78
|
-
"compat": {
|
|
79
|
-
"type": "object",
|
|
80
|
-
"additionalProperties": false,
|
|
81
|
-
"properties": { "hosts": { "type": "array", "items": { "type": "string", "minLength": 1 } } }
|
|
82
|
-
},
|
|
83
|
-
"overrides": {
|
|
84
|
-
"type": "array",
|
|
85
|
-
"items": {
|
|
86
|
-
"type": "object",
|
|
87
|
-
"additionalProperties": false,
|
|
88
|
-
"required": ["target", "kind"],
|
|
89
|
-
"properties": {
|
|
90
|
-
"target": { "type": "string", "minLength": 1 },
|
|
91
|
-
"kind": { "enum": ["patch", "native", "build"] },
|
|
92
|
-
"description": { "type": "string", "minLength": 1 }
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
},
|
|
97
|
-
"patternProperties": { "^x-": {} },
|
|
98
|
-
"$defs": {
|
|
99
|
-
"namespacedId": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9][a-z0-9-]*)+$" },
|
|
100
|
-
"apiVersion": { "type": "string", "pattern": "^[a-z][a-z0-9.-]*/v[1-9][0-9]*(?:(?:alpha|beta)[1-9][0-9]*)?$" },
|
|
101
|
-
"kind": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$" },
|
|
102
|
-
"contract": {
|
|
103
|
-
"type": "object",
|
|
104
|
-
"additionalProperties": false,
|
|
105
|
-
"required": ["apiVersion", "kind"],
|
|
106
|
-
"properties": {
|
|
107
|
-
"apiVersion": { "$ref": "#/$defs/apiVersion" },
|
|
108
|
-
"kind": { "$ref": "#/$defs/kind" },
|
|
109
|
-
"optional": { "type": "boolean" },
|
|
110
|
-
"fallback": { "type": "string", "minLength": 1 }
|
|
111
|
-
}
|
|
112
|
-
},
|
|
113
|
-
"permission": {
|
|
114
|
-
"type": "object",
|
|
115
|
-
"additionalProperties": false,
|
|
116
|
-
"required": ["name", "scope"],
|
|
117
|
-
"properties": {
|
|
118
|
-
"name": { "$ref": "#/$defs/namespacedId" },
|
|
119
|
-
"scope": { "type": "string", "minLength": 1 },
|
|
120
|
-
"reason": { "type": "string", "minLength": 1 }
|
|
121
|
-
}
|
|
122
|
-
},
|
|
123
|
-
"command": {
|
|
124
|
-
"type": "object",
|
|
125
|
-
"additionalProperties": false,
|
|
126
|
-
"required": ["id", "title"],
|
|
127
|
-
"properties": {
|
|
128
|
-
"id": { "$ref": "#/$defs/namespacedId" },
|
|
129
|
-
"title": { "type": "string", "minLength": 1 },
|
|
130
|
-
"description": { "type": "string", "minLength": 1 }
|
|
131
|
-
}
|
|
132
|
-
},
|
|
133
|
-
"subscription": {
|
|
134
|
-
"type": "object",
|
|
135
|
-
"additionalProperties": false,
|
|
136
|
-
"required": ["apiVersion", "kind"],
|
|
137
|
-
"properties": {
|
|
138
|
-
"apiVersion": { "$ref": "#/$defs/apiVersion" },
|
|
139
|
-
"kind": { "$ref": "#/$defs/kind" },
|
|
140
|
-
"scope": { "type": "string", "minLength": 1 }
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
}
|
|
144
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"title": "DSH Plugin Manifest Community Draft v0.15",
|
|
4
|
+
"type": "object",
|
|
5
|
+
"additionalProperties": false,
|
|
6
|
+
"required": ["$schema", "manifestVersion", "id", "name", "version", "facets", "requires", "permissions", "contributes", "subscriptions"],
|
|
7
|
+
"properties": {
|
|
8
|
+
"$schema": { "type": "string", "format": "uri" },
|
|
9
|
+
"manifestVersion": { "const": "0.15" },
|
|
10
|
+
"id": { "$ref": "#/$defs/namespacedId" },
|
|
11
|
+
"name": { "type": "string", "minLength": 1 },
|
|
12
|
+
"version": { "type": "string", "minLength": 1 },
|
|
13
|
+
"facets": {
|
|
14
|
+
"type": "object",
|
|
15
|
+
"additionalProperties": false,
|
|
16
|
+
"required": ["host"],
|
|
17
|
+
"properties": {
|
|
18
|
+
"host": {
|
|
19
|
+
"type": "object",
|
|
20
|
+
"additionalProperties": false,
|
|
21
|
+
"required": ["entry", "apiVersion"],
|
|
22
|
+
"properties": {
|
|
23
|
+
"entry": { "type": "string", "minLength": 1, "pattern": "^(?![\\\\/])(?![A-Za-z]:[\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$)).+$" },
|
|
24
|
+
"apiVersion": { "type": "string", "pattern": "^v[1-9][0-9]*(?:(?:alpha|beta)[1-9][0-9]*)?$" }
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
"requires": {
|
|
30
|
+
"type": "object",
|
|
31
|
+
"additionalProperties": false,
|
|
32
|
+
"required": ["contracts"],
|
|
33
|
+
"properties": {
|
|
34
|
+
"contracts": { "type": "array", "items": { "$ref": "#/$defs/contract" } },
|
|
35
|
+
"services": { "type": "array", "maxItems": 0 }
|
|
36
|
+
}
|
|
37
|
+
},
|
|
38
|
+
"permissions": { "type": "array", "items": { "$ref": "#/$defs/permission" } },
|
|
39
|
+
"contributes": {
|
|
40
|
+
"type": "object",
|
|
41
|
+
"required": ["commands"],
|
|
42
|
+
"properties": {
|
|
43
|
+
"commands": { "type": "array", "items": { "$ref": "#/$defs/command" } },
|
|
44
|
+
"panels": { "type": "array", "maxItems": 0 }
|
|
45
|
+
},
|
|
46
|
+
"patternProperties": { "^x-": { "type": "array" } },
|
|
47
|
+
"additionalProperties": false
|
|
48
|
+
},
|
|
49
|
+
"subscriptions": {
|
|
50
|
+
"type": "array",
|
|
51
|
+
"items": {
|
|
52
|
+
"oneOf": [
|
|
53
|
+
{ "type": "string", "minLength": 1 },
|
|
54
|
+
{ "$ref": "#/$defs/subscription" }
|
|
55
|
+
]
|
|
56
|
+
}
|
|
57
|
+
},
|
|
58
|
+
"license": { "type": "string", "minLength": 1 },
|
|
59
|
+
"source": {
|
|
60
|
+
"type": "object",
|
|
61
|
+
"additionalProperties": false,
|
|
62
|
+
"required": ["repository"],
|
|
63
|
+
"properties": {
|
|
64
|
+
"repository": { "type": "string", "format": "uri" },
|
|
65
|
+
"revision": { "type": "string", "minLength": 1 }
|
|
66
|
+
}
|
|
67
|
+
},
|
|
68
|
+
"artifact": {
|
|
69
|
+
"type": "object",
|
|
70
|
+
"additionalProperties": false,
|
|
71
|
+
"required": ["digest", "algorithm", "path"],
|
|
72
|
+
"properties": {
|
|
73
|
+
"digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
|
|
74
|
+
"algorithm": { "const": "sha256" },
|
|
75
|
+
"path": { "type": "string", "minLength": 1 }
|
|
76
|
+
}
|
|
77
|
+
},
|
|
78
|
+
"compat": {
|
|
79
|
+
"type": "object",
|
|
80
|
+
"additionalProperties": false,
|
|
81
|
+
"properties": { "hosts": { "type": "array", "items": { "type": "string", "minLength": 1 } } }
|
|
82
|
+
},
|
|
83
|
+
"overrides": {
|
|
84
|
+
"type": "array",
|
|
85
|
+
"items": {
|
|
86
|
+
"type": "object",
|
|
87
|
+
"additionalProperties": false,
|
|
88
|
+
"required": ["target", "kind"],
|
|
89
|
+
"properties": {
|
|
90
|
+
"target": { "type": "string", "minLength": 1 },
|
|
91
|
+
"kind": { "enum": ["patch", "native", "build"] },
|
|
92
|
+
"description": { "type": "string", "minLength": 1 }
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
},
|
|
97
|
+
"patternProperties": { "^x-": {} },
|
|
98
|
+
"$defs": {
|
|
99
|
+
"namespacedId": { "type": "string", "pattern": "^[a-z][a-z0-9]*(?:[.-][a-z0-9][a-z0-9-]*)+$" },
|
|
100
|
+
"apiVersion": { "type": "string", "pattern": "^[a-z][a-z0-9.-]*/v[1-9][0-9]*(?:(?:alpha|beta)[1-9][0-9]*)?$" },
|
|
101
|
+
"kind": { "type": "string", "pattern": "^[A-Z][A-Za-z0-9]*$" },
|
|
102
|
+
"contract": {
|
|
103
|
+
"type": "object",
|
|
104
|
+
"additionalProperties": false,
|
|
105
|
+
"required": ["apiVersion", "kind"],
|
|
106
|
+
"properties": {
|
|
107
|
+
"apiVersion": { "$ref": "#/$defs/apiVersion" },
|
|
108
|
+
"kind": { "$ref": "#/$defs/kind" },
|
|
109
|
+
"optional": { "type": "boolean" },
|
|
110
|
+
"fallback": { "type": "string", "minLength": 1 }
|
|
111
|
+
}
|
|
112
|
+
},
|
|
113
|
+
"permission": {
|
|
114
|
+
"type": "object",
|
|
115
|
+
"additionalProperties": false,
|
|
116
|
+
"required": ["name", "scope"],
|
|
117
|
+
"properties": {
|
|
118
|
+
"name": { "$ref": "#/$defs/namespacedId" },
|
|
119
|
+
"scope": { "type": "string", "minLength": 1 },
|
|
120
|
+
"reason": { "type": "string", "minLength": 1 }
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
"command": {
|
|
124
|
+
"type": "object",
|
|
125
|
+
"additionalProperties": false,
|
|
126
|
+
"required": ["id", "title"],
|
|
127
|
+
"properties": {
|
|
128
|
+
"id": { "$ref": "#/$defs/namespacedId" },
|
|
129
|
+
"title": { "type": "string", "minLength": 1 },
|
|
130
|
+
"description": { "type": "string", "minLength": 1 }
|
|
131
|
+
}
|
|
132
|
+
},
|
|
133
|
+
"subscription": {
|
|
134
|
+
"type": "object",
|
|
135
|
+
"additionalProperties": false,
|
|
136
|
+
"required": ["apiVersion", "kind"],
|
|
137
|
+
"properties": {
|
|
138
|
+
"apiVersion": { "$ref": "#/$defs/apiVersion" },
|
|
139
|
+
"kind": { "$ref": "#/$defs/kind" },
|
|
140
|
+
"scope": { "type": "string", "minLength": 1 }
|
|
141
|
+
}
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
# Changelog
|
|
2
|
-
|
|
3
|
-
Changes to `@dsh-std/presentation` are recorded here.
|
|
4
|
-
|
|
5
|
-
## 0.1.0 (draft)
|
|
6
|
-
|
|
7
|
-
- Defined invocation-scoped `OpenExternal`, `CopyText`, `Notification`, `UserInteraction`, and `ExternalRedirect` capabilities.
|
|
8
|
-
- Added typed question, approval, secret-input, and one-shot loopback redirect flows.
|
|
9
|
-
- Added optional exact loopback callback URIs with explicit-port validation, no-substitution semantics, and address-in-use failure reporting.
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
Changes to `@dsh-std/presentation` are recorded here.
|
|
4
|
+
|
|
5
|
+
## 0.1.0 (draft)
|
|
6
|
+
|
|
7
|
+
- Defined invocation-scoped `OpenExternal`, `CopyText`, `Notification`, `UserInteraction`, and `ExternalRedirect` capabilities.
|
|
8
|
+
- Added typed question, approval, secret-input, and one-shot loopback redirect flows.
|
|
9
|
+
- Added optional exact loopback callback URIs with explicit-port validation, no-substitution semantics, and address-in-use failure reporting.
|
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 DSH Standard contributors
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 DSH Standard contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
# @dsh-std/presentation
|
|
2
|
-
|
|
3
|
-
English | [中文](README.zh.md)
|
|
4
|
-
|
|
5
|
-
Small, invocation-scoped operations that a runtime facet may request from a connected presentation client.
|
|
6
|
-
|
|
7
|
-
## Contracts
|
|
8
|
-
|
|
9
|
-
`v1alpha1` defines five independent presentation protocols:
|
|
10
|
-
|
|
11
|
-
- `OpenExternal` asks the client to open an HTTP or HTTPS URI.
|
|
12
|
-
- `CopyText` asks the client to copy text to its clipboard.
|
|
13
|
-
- `Notification` asks the client to display informational, warning, or error text.
|
|
14
|
-
- `UserInteraction` carries structured questions, one-invocation approvals, and secret input.
|
|
15
|
-
- `ExternalRedirect` receives a one-shot HTTP redirect on the user side and may reserve an exact loopback URI requested by the consumer.
|
|
16
|
-
|
|
17
|
-
A facet declares each required operation in its manifest. A client advertises only the protocols it can perform for the current connection. The runtime admits the command only when all required presentation protocols are available, and it accepts only operations declared by that facet. Operations belong to the active invocation; they are not a global event bus or a persistent client capability.
|
|
18
|
-
|
|
19
|
-
The package provides protocol definitions, invocation-scoped typed client and implementation binders, and request/result validation. The Host binds request identity and origin when it creates a client; consumers supply only operation-specific input. It does not perform UI work. Native applications, terminals, browsers, editors, and automation clients may implement different subsets.
|
|
20
|
-
|
|
21
|
-
Simple operations are available from `@dsh-std/presentation/operations`, while interaction types are available from `@dsh-std/presentation/interaction`. A Host-provided `PresentationDescriptor` is only a projection of active agreements for the current invocation; it is not a separate Snapshot protocol.
|
|
22
|
-
|
|
23
|
-
## Known Limitations and Deferred Work
|
|
24
|
-
|
|
25
|
-
- `OpenExternal` intentionally rejects non-HTTP(S) URI schemes.
|
|
26
|
-
- Clipboard reads, arbitrary UI trees, and file pickers are not defined.
|
|
27
|
-
- Delivery acknowledgement and durable replay are outside `v1alpha1`.
|
|
1
|
+
# @dsh-std/presentation
|
|
2
|
+
|
|
3
|
+
English | [中文](README.zh.md)
|
|
4
|
+
|
|
5
|
+
Small, invocation-scoped operations that a runtime facet may request from a connected presentation client.
|
|
6
|
+
|
|
7
|
+
## Contracts
|
|
8
|
+
|
|
9
|
+
`v1alpha1` defines five independent presentation protocols:
|
|
10
|
+
|
|
11
|
+
- `OpenExternal` asks the client to open an HTTP or HTTPS URI.
|
|
12
|
+
- `CopyText` asks the client to copy text to its clipboard.
|
|
13
|
+
- `Notification` asks the client to display informational, warning, or error text.
|
|
14
|
+
- `UserInteraction` carries structured questions, one-invocation approvals, and secret input.
|
|
15
|
+
- `ExternalRedirect` receives a one-shot HTTP redirect on the user side and may reserve an exact loopback URI requested by the consumer.
|
|
16
|
+
|
|
17
|
+
A facet declares each required operation in its manifest. A client advertises only the protocols it can perform for the current connection. The runtime admits the command only when all required presentation protocols are available, and it accepts only operations declared by that facet. Operations belong to the active invocation; they are not a global event bus or a persistent client capability.
|
|
18
|
+
|
|
19
|
+
The package provides protocol definitions, invocation-scoped typed client and implementation binders, and request/result validation. The Host binds request identity and origin when it creates a client; consumers supply only operation-specific input. It does not perform UI work. Native applications, terminals, browsers, editors, and automation clients may implement different subsets.
|
|
20
|
+
|
|
21
|
+
Simple operations are available from `@dsh-std/presentation/operations`, while interaction types are available from `@dsh-std/presentation/interaction`. A Host-provided `PresentationDescriptor` is only a projection of active agreements for the current invocation; it is not a separate Snapshot protocol.
|
|
22
|
+
|
|
23
|
+
## Known Limitations and Deferred Work
|
|
24
|
+
|
|
25
|
+
- `OpenExternal` intentionally rejects non-HTTP(S) URI schemes.
|
|
26
|
+
- Clipboard reads, arbitrary UI trees, and file pickers are not defined.
|
|
27
|
+
- Delivery acknowledgement and durable replay are outside `v1alpha1`.
|
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
# @dsh-std/presentation
|
|
2
|
-
|
|
3
|
-
[English](README.md) | 中文
|
|
4
|
-
|
|
5
|
-
拟议设计见 [Presentation Operations](../../docs/proposals/presentation.zh.md)。
|
|
6
|
-
|
|
7
|
-
运行时插件可以向已连接表现客户端请求的小型、调用作用域内操作。
|
|
8
|
-
|
|
9
|
-
## 协议
|
|
10
|
-
|
|
11
|
-
`v1alpha1` 定义五个彼此独立的表现协议:
|
|
12
|
-
|
|
13
|
-
- `OpenExternal` 请求客户端打开 HTTP 或 HTTPS URI;
|
|
14
|
-
- `CopyText` 请求客户端把文本复制到剪贴板;
|
|
15
|
-
- `Notification` 请求客户端显示信息、警告或错误文本;
|
|
16
|
-
- `UserInteraction` 承载结构化 question、单次 approval 和 secret input。
|
|
17
|
-
- `ExternalRedirect` 在用户侧接收一次 HTTP redirect,并可按调用方要求独占精确的 loopback URI。
|
|
18
|
-
|
|
19
|
-
Facet 在清单中声明每项所需操作。客户端只为当前连接声明自己能够执行的协议。仅当全部必需表现协议可用时,运行时才接纳命令;运行时也只接受该 facet 事先声明的操作。操作属于当前调用,不是全局事件总线或持久客户端能力。
|
|
20
|
-
|
|
21
|
-
本包提供 protocol definitions、调用作用域内的类型化 client/implementation binder、请求与结果校验。Host 创建 client 时绑定 request identity 与 origin,Consumer 只提交 operation 自有输入。它不执行 UI 工作;原生应用、终端、浏览器、编辑器和自动化客户端可以实现不同子集。
|
|
22
|
-
|
|
23
|
-
普通操作可以从 `@dsh-std/presentation/operations` 导入,交互协议可以从 `@dsh-std/presentation/interaction` 导入。Host 交给领域调用的 `PresentationDescriptor` 只是当前 invocation active agreements 的投影,不是额外的 Snapshot 协议。
|
|
24
|
-
|
|
25
|
-
## 已知限制与暂缓事项
|
|
26
|
-
|
|
27
|
-
- `OpenExternal` 有意拒绝非 HTTP(S) URI scheme。
|
|
28
|
-
- 协议不定义剪贴板读取、任意 UI tree 或文件选择器。
|
|
29
|
-
- `v1alpha1` 不包含投递确认与持久回放。
|
|
1
|
+
# @dsh-std/presentation
|
|
2
|
+
|
|
3
|
+
[English](README.md) | 中文
|
|
4
|
+
|
|
5
|
+
拟议设计见 [Presentation Operations](../../docs/proposals/presentation.zh.md)。
|
|
6
|
+
|
|
7
|
+
运行时插件可以向已连接表现客户端请求的小型、调用作用域内操作。
|
|
8
|
+
|
|
9
|
+
## 协议
|
|
10
|
+
|
|
11
|
+
`v1alpha1` 定义五个彼此独立的表现协议:
|
|
12
|
+
|
|
13
|
+
- `OpenExternal` 请求客户端打开 HTTP 或 HTTPS URI;
|
|
14
|
+
- `CopyText` 请求客户端把文本复制到剪贴板;
|
|
15
|
+
- `Notification` 请求客户端显示信息、警告或错误文本;
|
|
16
|
+
- `UserInteraction` 承载结构化 question、单次 approval 和 secret input。
|
|
17
|
+
- `ExternalRedirect` 在用户侧接收一次 HTTP redirect,并可按调用方要求独占精确的 loopback URI。
|
|
18
|
+
|
|
19
|
+
Facet 在清单中声明每项所需操作。客户端只为当前连接声明自己能够执行的协议。仅当全部必需表现协议可用时,运行时才接纳命令;运行时也只接受该 facet 事先声明的操作。操作属于当前调用,不是全局事件总线或持久客户端能力。
|
|
20
|
+
|
|
21
|
+
本包提供 protocol definitions、调用作用域内的类型化 client/implementation binder、请求与结果校验。Host 创建 client 时绑定 request identity 与 origin,Consumer 只提交 operation 自有输入。它不执行 UI 工作;原生应用、终端、浏览器、编辑器和自动化客户端可以实现不同子集。
|
|
22
|
+
|
|
23
|
+
普通操作可以从 `@dsh-std/presentation/operations` 导入,交互协议可以从 `@dsh-std/presentation/interaction` 导入。Host 交给领域调用的 `PresentationDescriptor` 只是当前 invocation active agreements 的投影,不是额外的 Snapshot 协议。
|
|
24
|
+
|
|
25
|
+
## 已知限制与暂缓事项
|
|
26
|
+
|
|
27
|
+
- `OpenExternal` 有意拒绝非 HTTP(S) URI scheme。
|
|
28
|
+
- 协议不定义剪贴板读取、任意 UI tree 或文件选择器。
|
|
29
|
+
- `v1alpha1` 不包含投递确认与持久回放。
|
package/vendor/dsh-std/packages/command/node_modules/@dsh-std/presentation/lib/callback.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"callback.js","names":[],"sources":["../src/callback.ts"],"sourcesContent":["import type {\r\n CapabilityClient,\r\n CapabilityHandlerContext,\r\n CapabilityImplementation,\r\n} from '@dsh-std/connection'\r\nimport { defineCapabilityProtocol } from '@dsh-std/connection'\r\nimport type { ProtocolSupport } from '@dsh-std/core'\r\nimport type { PresentationInvocationScope, PresentationRequestContext, PresentationResult } from './index.js'\r\n\r\nexport const EXTERNAL_REDIRECT_KIND = 'ExternalRedirect'\r\n\r\nexport interface ExternalRedirectRequest extends PresentationRequestContext {\r\n readonly mode: 'http-get'\r\n /** Exact loopback URI required by the external provider, including an explicit port. */\r\n readonly exactRedirectUri?: string\r\n}\r\nexport interface ExternalRedirectInput {\r\n readonly mode?: 'http-get'\r\n /** The provider must bind and announce this exact URI or report the request unavailable. */\r\n readonly exactRedirectUri?: string\r\n}\r\n\r\nexport interface ExternalRedirectReady {\r\n readonly type: 'ready'\r\n readonly redirectUri: string\r\n readonly expiresAt?: string\r\n}\r\n\r\nexport interface ExternalRedirectValue {\r\n readonly query: Readonly<Record<string, readonly string[]>>\r\n}\r\n\r\nexport interface ExternalRedirectCall {\r\n readonly invocationId: string\r\n readonly ready: Promise<ExternalRedirectReady>\r\n readonly result: Promise<PresentationResult<ExternalRedirectValue>>\r\n cancel(reason?: string): void\r\n}\r\n\r\nexport interface ExternalRedirectClient {\r\n receive(input?: ExternalRedirectInput, options?: { readonly signal?: AbortSignal }): ExternalRedirectCall\r\n}\r\n\r\nexport interface ExternalRedirectHandler {\r\n receive(\r\n request: ExternalRedirectRequest,\r\n context: CapabilityHandlerContext<ExternalRedirectReady>,\r\n ): PresentationResult<ExternalRedirectValue> | Promise<PresentationResult<ExternalRedirectValue>>\r\n}\r\n\r\nconst emptySpec = (value: unknown): undefined => {\r\n if (value !== undefined) throw new TypeError('ExternalRedirect does not accept spec in v1alpha1')\r\n return undefined\r\n}\r\n\r\nexport const externalRedirectProtocol = defineCapabilityProtocol({\r\n apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\r\n validateRequirement: emptySpec, validateSupport: emptySpec,\r\n})\r\nexport const externalRedirectSupport: ProtocolSupport = Object.freeze({\r\n apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\r\n})\r\n\r\nexport function externalRedirectClient(client: CapabilityClient, scope: PresentationInvocationScope): ExternalRedirectClient {\r\n validateScope(scope)\r\n return Object.freeze({\r\n receive(input: ExternalRedirectInput = {}, options?: { readonly signal?: AbortSignal }) {\r\n const request = Object.freeze({\r\n ...input,\r\n mode: input.mode ?? 'http-get',\r\n requestId: nextRequestId(scope), invocationId: scope.invocationId, origin: scope.origin,\r\n ...(scope.deadline === undefined ? {} : { deadline: scope.deadline }),\r\n })\r\n validateExternalRedirectRequest(request)\r\n const call = client.invoke<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady>(\r\n externalRedirectSupport, 'receive', request, options,\r\n )\r\n return Object.freeze({\r\n invocationId: call.invocationId,\r\n ready: firstReady(call.progress),\r\n result: call.result.then(validateExternalRedirectResult),\r\n cancel: (reason?: string) => call.cancel(reason),\r\n })\r\n },\r\n })\r\n}\r\n\r\nexport function externalRedirectImplementation(\r\n participantId: string,\r\n handler: ExternalRedirectHandler,\r\n): CapabilityImplementation<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady> {\r\n return Object.freeze({\r\n participantId, protocol: externalRedirectSupport,\r\n async handle(operation: string, input: ExternalRedirectRequest, context: CapabilityHandlerContext<ExternalRedirectReady>) {\r\n if (operation !== 'receive') throw new TypeError(`unsupported ExternalRedirect operation ${JSON.stringify(operation)}`)\r\n validateExternalRedirectRequest(input)\r\n let announced = false\r\n const guardedContext: CapabilityHandlerContext<ExternalRedirectReady> = Object.freeze({\r\n ...context,\r\n progress(value: ExternalRedirectReady) {\r\n if (announced) throw new TypeError('ExternalRedirect provider emitted more than one ready event')\r\n validateExternalRedirectReady(value)\r\n if (input.exactRedirectUri !== undefined && value.redirectUri !== input.exactRedirectUri) {\r\n throw new TypeError('ExternalRedirect provider did not announce the exact requested redirect URI')\r\n }\r\n announced = true\r\n context.progress(value)\r\n },\r\n })\r\n const result = validateExternalRedirectResult(await handler.receive(input, guardedContext))\r\n if (result.status === 'submitted' && !announced) {\r\n throw new TypeError('ExternalRedirect provider submitted a result before announcing redirectUri')\r\n }\r\n return result\r\n },\r\n })\r\n}\r\n\r\nexport function validateExternalRedirectRequest(value: unknown): asserts value is ExternalRedirectRequest {\r\n const request = exactRecord(value, ['requestId', 'invocationId', 'origin', 'deadline', 'mode', 'exactRedirectUri'], ['requestId', 'invocationId', 'origin', 'mode'], 'ExternalRedirect request')\r\n nonEmpty(request.requestId, 'ExternalRedirect request.requestId')\r\n nonEmpty(request.invocationId, 'ExternalRedirect request.invocationId')\r\n nonEmpty(request.origin, 'ExternalRedirect request.origin')\r\n if (request.mode !== 'http-get') throw new TypeError('ExternalRedirect request.mode must be \"http-get\"')\r\n if (request.exactRedirectUri !== undefined) validateLoopbackUri(request.exactRedirectUri, 'ExternalRedirect request.exactRedirectUri', true)\r\n dateTime(request.deadline, 'ExternalRedirect request.deadline')\r\n}\r\n\r\nexport function validateExternalRedirectReady(value: unknown): asserts value is ExternalRedirectReady {\r\n const ready = exactRecord(value, ['type', 'redirectUri', 'expiresAt'], ['type', 'redirectUri'], 'ExternalRedirect ready')\r\n if (ready.type !== 'ready') throw new TypeError('ExternalRedirect ready.type must be \"ready\"')\r\n validateLoopbackUri(ready.redirectUri, 'ExternalRedirect ready.redirectUri', false)\r\n dateTime(ready.expiresAt, 'ExternalRedirect ready.expiresAt')\r\n}\r\n\r\nexport function validateExternalRedirectResult(value: unknown): PresentationResult<ExternalRedirectValue> {\r\n if (!record(value)) throw new TypeError('ExternalRedirect result must be an object')\r\n if (value.status === 'submitted') {\r\n const result = exactRecord(value, ['status', 'value'], ['status', 'value'], 'ExternalRedirect result')\r\n const submitted = exactRecord(result.value, ['query'], ['query'], 'ExternalRedirect value')\r\n if (!record(submitted.query)) throw new TypeError('ExternalRedirect value.query must be an object')\r\n const query: Record<string, readonly string[]> = {}\r\n for (const [name, entries] of Object.entries(submitted.query)) {\r\n if (name === '' || !Array.isArray(entries) || entries.some(entry => typeof entry !== 'string')) {\r\n throw new TypeError('ExternalRedirect value.query must map non-empty names to string arrays')\r\n }\r\n query[name] = Object.freeze([...entries])\r\n }\r\n return Object.freeze({ status: 'submitted', value: Object.freeze({ query: Object.freeze(query) }) })\r\n }\r\n if (value.status === 'unavailable') {\r\n const result = exactRecord(value, ['status', 'reason'], ['status'], 'ExternalRedirect result')\r\n if (result.reason !== undefined) nonEmpty(result.reason, 'ExternalRedirect result.reason')\r\n return Object.freeze({ status: 'unavailable', ...(result.reason === undefined ? {} : { reason: result.reason as string }) })\r\n }\r\n if (value.status === 'cancelled' || value.status === 'expired') {\r\n exactRecord(value, ['status'], ['status'], 'ExternalRedirect result')\r\n return Object.freeze({ status: value.status })\r\n }\r\n throw new TypeError('ExternalRedirect result.status is invalid')\r\n}\r\n\r\nasync function firstReady(progress: AsyncIterable<ExternalRedirectReady>): Promise<ExternalRedirectReady> {\r\n for await (const value of progress) {\r\n validateExternalRedirectReady(value)\r\n return Object.freeze({ ...value })\r\n }\r\n throw new TypeError('ExternalRedirect provider completed without announcing redirectUri')\r\n}\r\n\r\nfunction validateScope(scope: PresentationInvocationScope): void {\r\n if (!record(scope)) throw new TypeError('Presentation invocation scope must be an object')\r\n nonEmpty(scope.invocationId, 'Presentation invocation scope.invocationId')\r\n nonEmpty(scope.origin, 'Presentation invocation scope.origin')\r\n dateTime(scope.deadline, 'Presentation invocation scope.deadline')\r\n if (typeof scope.nextRequestId !== 'function') throw new TypeError('Presentation invocation scope.nextRequestId must be a function')\r\n}\r\n\r\nfunction nextRequestId(scope: PresentationInvocationScope): string {\r\n const value = scope.nextRequestId()\r\n nonEmpty(value, 'Presentation requestId')\r\n return value\r\n}\r\n\r\nfunction exactRecord(value: unknown, allowed: readonly string[], required: readonly string[], label: string): Record<string, unknown> {\r\n if (!record(value)) throw new TypeError(`${label} must be an object`)\r\n const unknown = Object.keys(value).filter(key => !allowed.includes(key))\r\n if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)\r\n for (const key of required) if (!Object.hasOwn(value, key)) throw new TypeError(`${label}.${key} is required`)\r\n return value\r\n}\r\nfunction record(value: unknown): value is Record<string, unknown> { return typeof value === 'object' && value !== null && !Array.isArray(value) }\r\nfunction nonEmpty(value: unknown, label: string): asserts value is string {\r\n if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)\r\n}\r\nfunction dateTime(value: unknown, label: string): void {\r\n if (value !== undefined && (typeof value !== 'string' || Number.isNaN(Date.parse(value)))) throw new TypeError(`${label} must be an RFC 3339 date-time`)\r\n}\r\n\r\nfunction validateLoopbackUri(value: unknown, label: string, requireExplicitPort: boolean): asserts value is string {\r\n nonEmpty(value, label)\r\n let uri: URL\r\n try {\r\n uri = new URL(value)\r\n } catch {\r\n throw new TypeError(`${label} must be an absolute URI`)\r\n }\r\n if (uri.protocol !== 'http:') throw new TypeError(`${label} must use HTTP`)\r\n if (uri.hostname !== '127.0.0.1' && uri.hostname !== '[::1]' && uri.hostname !== 'localhost') {\r\n throw new TypeError(`${label} must target a loopback host`)\r\n }\r\n if (uri.username !== '' || uri.password !== '') throw new TypeError(`${label} must not contain user information`)\r\n if (uri.hash !== '') throw new TypeError(`${label} must not contain a fragment`)\r\n if (requireExplicitPort) {\r\n const authority = value.slice(value.indexOf('//') + 2).split(/[/?#]/u, 1)[0]!\r\n const match = /^(?:127\\.0\\.0\\.1|localhost):(\\d+)$|^\\[::1\\]:(\\d+)$/iu.exec(authority)\r\n const port = Number(match?.[1] ?? match?.[2])\r\n if (!Number.isSafeInteger(port) || port < 1 || port > 65_535) {\r\n throw new TypeError(`${label} must include an explicit TCP port`)\r\n }\r\n }\r\n}\r\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"callback.js","names":[],"sources":["../src/callback.ts"],"sourcesContent":["import type {\n CapabilityClient,\n CapabilityHandlerContext,\n CapabilityImplementation,\n} from '@dsh-std/connection'\nimport { defineCapabilityProtocol } from '@dsh-std/connection'\nimport type { ProtocolSupport } from '@dsh-std/core'\nimport type { PresentationInvocationScope, PresentationRequestContext, PresentationResult } from './index.js'\n\nexport const EXTERNAL_REDIRECT_KIND = 'ExternalRedirect'\n\nexport interface ExternalRedirectRequest extends PresentationRequestContext {\n readonly mode: 'http-get'\n /** Exact loopback URI required by the external provider, including an explicit port. */\n readonly exactRedirectUri?: string\n}\nexport interface ExternalRedirectInput {\n readonly mode?: 'http-get'\n /** The provider must bind and announce this exact URI or report the request unavailable. */\n readonly exactRedirectUri?: string\n}\n\nexport interface ExternalRedirectReady {\n readonly type: 'ready'\n readonly redirectUri: string\n readonly expiresAt?: string\n}\n\nexport interface ExternalRedirectValue {\n readonly query: Readonly<Record<string, readonly string[]>>\n}\n\nexport interface ExternalRedirectCall {\n readonly invocationId: string\n readonly ready: Promise<ExternalRedirectReady>\n readonly result: Promise<PresentationResult<ExternalRedirectValue>>\n cancel(reason?: string): void\n}\n\nexport interface ExternalRedirectClient {\n receive(input?: ExternalRedirectInput, options?: { readonly signal?: AbortSignal }): ExternalRedirectCall\n}\n\nexport interface ExternalRedirectHandler {\n receive(\n request: ExternalRedirectRequest,\n context: CapabilityHandlerContext<ExternalRedirectReady>,\n ): PresentationResult<ExternalRedirectValue> | Promise<PresentationResult<ExternalRedirectValue>>\n}\n\nconst emptySpec = (value: unknown): undefined => {\n if (value !== undefined) throw new TypeError('ExternalRedirect does not accept spec in v1alpha1')\n return undefined\n}\n\nexport const externalRedirectProtocol = defineCapabilityProtocol({\n apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\n validateRequirement: emptySpec, validateSupport: emptySpec,\n})\nexport const externalRedirectSupport: ProtocolSupport = Object.freeze({\n apiVersion: 'presentation.dsh/v1alpha1', kind: EXTERNAL_REDIRECT_KIND,\n})\n\nexport function externalRedirectClient(client: CapabilityClient, scope: PresentationInvocationScope): ExternalRedirectClient {\n validateScope(scope)\n return Object.freeze({\n receive(input: ExternalRedirectInput = {}, options?: { readonly signal?: AbortSignal }) {\n const request = Object.freeze({\n ...input,\n mode: input.mode ?? 'http-get',\n requestId: nextRequestId(scope), invocationId: scope.invocationId, origin: scope.origin,\n ...(scope.deadline === undefined ? {} : { deadline: scope.deadline }),\n })\n validateExternalRedirectRequest(request)\n const call = client.invoke<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady>(\n externalRedirectSupport, 'receive', request, options,\n )\n return Object.freeze({\n invocationId: call.invocationId,\n ready: firstReady(call.progress),\n result: call.result.then(validateExternalRedirectResult),\n cancel: (reason?: string) => call.cancel(reason),\n })\n },\n })\n}\n\nexport function externalRedirectImplementation(\n participantId: string,\n handler: ExternalRedirectHandler,\n): CapabilityImplementation<ExternalRedirectRequest, PresentationResult<ExternalRedirectValue>, ExternalRedirectReady> {\n return Object.freeze({\n participantId, protocol: externalRedirectSupport,\n async handle(operation: string, input: ExternalRedirectRequest, context: CapabilityHandlerContext<ExternalRedirectReady>) {\n if (operation !== 'receive') throw new TypeError(`unsupported ExternalRedirect operation ${JSON.stringify(operation)}`)\n validateExternalRedirectRequest(input)\n let announced = false\n const guardedContext: CapabilityHandlerContext<ExternalRedirectReady> = Object.freeze({\n ...context,\n progress(value: ExternalRedirectReady) {\n if (announced) throw new TypeError('ExternalRedirect provider emitted more than one ready event')\n validateExternalRedirectReady(value)\n if (input.exactRedirectUri !== undefined && value.redirectUri !== input.exactRedirectUri) {\n throw new TypeError('ExternalRedirect provider did not announce the exact requested redirect URI')\n }\n announced = true\n context.progress(value)\n },\n })\n const result = validateExternalRedirectResult(await handler.receive(input, guardedContext))\n if (result.status === 'submitted' && !announced) {\n throw new TypeError('ExternalRedirect provider submitted a result before announcing redirectUri')\n }\n return result\n },\n })\n}\n\nexport function validateExternalRedirectRequest(value: unknown): asserts value is ExternalRedirectRequest {\n const request = exactRecord(value, ['requestId', 'invocationId', 'origin', 'deadline', 'mode', 'exactRedirectUri'], ['requestId', 'invocationId', 'origin', 'mode'], 'ExternalRedirect request')\n nonEmpty(request.requestId, 'ExternalRedirect request.requestId')\n nonEmpty(request.invocationId, 'ExternalRedirect request.invocationId')\n nonEmpty(request.origin, 'ExternalRedirect request.origin')\n if (request.mode !== 'http-get') throw new TypeError('ExternalRedirect request.mode must be \"http-get\"')\n if (request.exactRedirectUri !== undefined) validateLoopbackUri(request.exactRedirectUri, 'ExternalRedirect request.exactRedirectUri', true)\n dateTime(request.deadline, 'ExternalRedirect request.deadline')\n}\n\nexport function validateExternalRedirectReady(value: unknown): asserts value is ExternalRedirectReady {\n const ready = exactRecord(value, ['type', 'redirectUri', 'expiresAt'], ['type', 'redirectUri'], 'ExternalRedirect ready')\n if (ready.type !== 'ready') throw new TypeError('ExternalRedirect ready.type must be \"ready\"')\n validateLoopbackUri(ready.redirectUri, 'ExternalRedirect ready.redirectUri', false)\n dateTime(ready.expiresAt, 'ExternalRedirect ready.expiresAt')\n}\n\nexport function validateExternalRedirectResult(value: unknown): PresentationResult<ExternalRedirectValue> {\n if (!record(value)) throw new TypeError('ExternalRedirect result must be an object')\n if (value.status === 'submitted') {\n const result = exactRecord(value, ['status', 'value'], ['status', 'value'], 'ExternalRedirect result')\n const submitted = exactRecord(result.value, ['query'], ['query'], 'ExternalRedirect value')\n if (!record(submitted.query)) throw new TypeError('ExternalRedirect value.query must be an object')\n const query: Record<string, readonly string[]> = {}\n for (const [name, entries] of Object.entries(submitted.query)) {\n if (name === '' || !Array.isArray(entries) || entries.some(entry => typeof entry !== 'string')) {\n throw new TypeError('ExternalRedirect value.query must map non-empty names to string arrays')\n }\n query[name] = Object.freeze([...entries])\n }\n return Object.freeze({ status: 'submitted', value: Object.freeze({ query: Object.freeze(query) }) })\n }\n if (value.status === 'unavailable') {\n const result = exactRecord(value, ['status', 'reason'], ['status'], 'ExternalRedirect result')\n if (result.reason !== undefined) nonEmpty(result.reason, 'ExternalRedirect result.reason')\n return Object.freeze({ status: 'unavailable', ...(result.reason === undefined ? {} : { reason: result.reason as string }) })\n }\n if (value.status === 'cancelled' || value.status === 'expired') {\n exactRecord(value, ['status'], ['status'], 'ExternalRedirect result')\n return Object.freeze({ status: value.status })\n }\n throw new TypeError('ExternalRedirect result.status is invalid')\n}\n\nasync function firstReady(progress: AsyncIterable<ExternalRedirectReady>): Promise<ExternalRedirectReady> {\n for await (const value of progress) {\n validateExternalRedirectReady(value)\n return Object.freeze({ ...value })\n }\n throw new TypeError('ExternalRedirect provider completed without announcing redirectUri')\n}\n\nfunction validateScope(scope: PresentationInvocationScope): void {\n if (!record(scope)) throw new TypeError('Presentation invocation scope must be an object')\n nonEmpty(scope.invocationId, 'Presentation invocation scope.invocationId')\n nonEmpty(scope.origin, 'Presentation invocation scope.origin')\n dateTime(scope.deadline, 'Presentation invocation scope.deadline')\n if (typeof scope.nextRequestId !== 'function') throw new TypeError('Presentation invocation scope.nextRequestId must be a function')\n}\n\nfunction nextRequestId(scope: PresentationInvocationScope): string {\n const value = scope.nextRequestId()\n nonEmpty(value, 'Presentation requestId')\n return value\n}\n\nfunction exactRecord(value: unknown, allowed: readonly string[], required: readonly string[], label: string): Record<string, unknown> {\n if (!record(value)) throw new TypeError(`${label} must be an object`)\n const unknown = Object.keys(value).filter(key => !allowed.includes(key))\n if (unknown.length > 0) throw new TypeError(`${label} contains unknown field ${JSON.stringify(unknown[0])}`)\n for (const key of required) if (!Object.hasOwn(value, key)) throw new TypeError(`${label}.${key} is required`)\n return value\n}\nfunction record(value: unknown): value is Record<string, unknown> { return typeof value === 'object' && value !== null && !Array.isArray(value) }\nfunction nonEmpty(value: unknown, label: string): asserts value is string {\n if (typeof value !== 'string' || value.trim() === '') throw new TypeError(`${label} must be a non-empty string`)\n}\nfunction dateTime(value: unknown, label: string): void {\n if (value !== undefined && (typeof value !== 'string' || Number.isNaN(Date.parse(value)))) throw new TypeError(`${label} must be an RFC 3339 date-time`)\n}\n\nfunction validateLoopbackUri(value: unknown, label: string, requireExplicitPort: boolean): asserts value is string {\n nonEmpty(value, label)\n let uri: URL\n try {\n uri = new URL(value)\n } catch {\n throw new TypeError(`${label} must be an absolute URI`)\n }\n if (uri.protocol !== 'http:') throw new TypeError(`${label} must use HTTP`)\n if (uri.hostname !== '127.0.0.1' && uri.hostname !== '[::1]' && uri.hostname !== 'localhost') {\n throw new TypeError(`${label} must target a loopback host`)\n }\n if (uri.username !== '' || uri.password !== '') throw new TypeError(`${label} must not contain user information`)\n if (uri.hash !== '') throw new TypeError(`${label} must not contain a fragment`)\n if (requireExplicitPort) {\n const authority = value.slice(value.indexOf('//') + 2).split(/[/?#]/u, 1)[0]!\n const match = /^(?:127\\.0\\.0\\.1|localhost):(\\d+)$|^\\[::1\\]:(\\d+)$/iu.exec(authority)\n const port = Number(match?.[1] ?? match?.[2])\n if (!Number.isSafeInteger(port) || port < 1 || port > 65_535) {\n throw new TypeError(`${label} must include an explicit TCP port`)\n }\n }\n}\n"],"mappings":"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"}
|