@deepseek-ai/dsh-tool-cordis 0.2.1-alpha.3 → 0.2.1-alpha.5

package/lib/types/api-catalog.js

@@ -1708,6 +1708,39 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'pluginMarket',
+        summary: 'Fetches, validates, and caches configured market indexes; annotates entries with the profile\'s installation facts.',
+        description: 'Fetches, validates, and caches configured market indexes; annotates entries with the profile\'s installation facts.',
+        methods: [
+            {
+                signature: '@Remote listIndexes(): MarketIndexSummary[]',
+                description: 'List the configured index sources without fetching them.',
+                parameters: [],
+                returns: 'every source in order, with the title of its last successful read and, when the last read failed, its error.',
+            },
+            {
+                signature: '@Remote async setIndexes(urls: string[]): Promise<void>',
+                description: 'Replace the configured index sources through Settings, without remounting this service. `plugin-market/changed` announces the committed list. A URL already configured is kept as written, so a client can add or remove sources beside one that `listIndexes` reports as unusable.',
+                parameters: [{ name: 'urls', description: 'index URLs in display order.' }],
+                throws: ['{RemoteError} `plugin-market/invalid-index-url` for an invalid new URL or a repeated URL; `plugin-market/settings-unavailable` without Settings or a profile entry.'],
+            },
+            {
+                signature: '@Remote async search(url: string, query: MarketQuery): Promise<MarketSearchResult>',
+                description: 'Return one page of the plugins of a configured index that match a query. Concurrent reads of a URL share one fetch; a successful document is reused for `cacheTtlMs` unless `refresh` is set. Matching and ordering read only the document; installation status and compatibility are computed for the returned page on every call.',
+                parameters: [{ name: 'url', description: 'a configured index URL.' }, { name: 'query', description: 'text, filters, order, page, and whether to bypass the cached document.' }],
+                returns: 'the index header, the page\'s plugins with each plugin\'s default version and installation status and each version\'s compatibility and install arguments, the number of matches, and the next page\'s offset.',
+                throws: ['{RemoteError} `plugin-market/invalid-query`, `plugin-market/unknown-index`, `plugin-market/invalid-index-url`, `plugin-market/fetch-failed`, or `plugin-market/invalid-index`.'],
+            },
+            {
+                signature: 'async entry(url: string, name: string): Promise<MarketListingEntry | undefined>',
+                description: 'Read one plugin of a configured index, using the cached document as `search` does.',
+                parameters: [{ name: 'url', description: 'a configured index URL.' }, { name: 'name', description: 'the plugin\'s package name.' }],
+                returns: 'the plugin with its default version, installation status, and annotated versions; undefined when the index does not list it.',
+                throws: ['{RemoteError} `plugin-market/unknown-index`, `plugin-market/invalid-index-url`, `plugin-market/fetch-failed`, or `plugin-market/invalid-index`.'],
+            },
+        ],
+    },
     {
         key: 'pluginRegistryProbe',
         summary: 'Compares public registry responses on the Host; the Client owns the initial selection.',
@@ -1741,7 +1774,7 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote async report(event: ProductEvent): Promise<void>',
-                description: 'Submit selected Desktop fields; missing identity is omitted and never generated.',
+                description: 'Submit selected Desktop fields with cached static environment and fresh identity. The first intake waits for bounded environment queries; concurrent intakes share them. Missing identity is omitted; failed environment fields carry fixed reasons.',
                 parameters: [{ name: 'event', description: 'typed product event without message contents or credentials.' }],
                 returns: 'after local submission; no delivery or warehouse acknowledgement.',
             },
@@ -4303,6 +4336,14 @@ export const EVENT_API = [
         description: 'An installation moved between its Host phases. `installing` is announced once per registry the installation asks, with the attempt\'s registry and position; `cancelling` and `applying` once.',
         parameters: [{ name: 'progress', description: 'the installation\'s request id and phase, with the attempt while installing.' }],
     },
+    {
+        name: 'plugin-market/changed',
+        mode: 'emit',
+        signature: '\'plugin-market/changed\'(): void',
+        summary: 'The configured index sources changed.',
+        description: 'The configured index sources changed.',
+        parameters: [],
+    },
     {
         name: 'schedule/changed',
         mode: 'emit',
@@ -4552,7 +4593,7 @@ export const TYPE_API = [
     },
     {
         name: 'AccountBonusNotification',
-        declaration: 'export interface AccountBonusNotification {\n    readonly orderId: AccountBonusOrderId;\n    readonly campaign: string;\n    readonly amount: string;\n    readonly currency: \'CNY\' | \'USD\';\n    readonly grantedAt: string;\n    readonly expiresAt: string;\n    readonly message: string;\n}',
+        declaration: 'export interface AccountBonusNotification {\n    readonly title?: string;\n    readonly orderId: AccountBonusOrderId;\n    readonly campaign?: JsonValue;\n    readonly amount?: JsonValue;\n    readonly currency?: JsonValue;\n    readonly grantedAt?: JsonValue;\n    readonly expiresAt: string;\n    readonly message: string;\n}',
     },
     {
         name: 'AccountBonusOrderId',
@@ -5568,7 +5609,7 @@ export const TYPE_API = [
     },
     {
         name: 'IncompatiblePlugin',
-        declaration: 'export interface IncompatiblePlugin {\n    name: string;\n    version: string;\n    runtimeVersion: string;\n    peers: Record<string, string>;\n}',
+        declaration: 'export interface IncompatiblePlugin {\n    name: string;\n    version: string;\n    runtimeVersion: string;\n    requirements: Record<string, string>;\n}',
     },
     {
         name: 'IndexInjection',
@@ -5922,6 +5963,82 @@ export const TYPE_API = [
         name: 'ManualCompactAgentContext',
         declaration: 'export interface ManualCompactAgentContext extends CompactionAgentContext {\n    runMaintenance<T>(task: (signal: AbortSignal) => Promise<T>): Promise<T>;\n}',
     },
+    {
+        name: 'MarketCompatibility',
+        declaration: 'export type MarketCompatibility = {\n    readonly compatible: true;\n} | {\n    readonly compatible: false;\n    readonly runtimeVersion: string;\n    readonly requirements: Readonly<Record<string, string>>;\n    readonly exempted: boolean;\n};',
+    },
+    {
+        name: 'MarketDeclaration',
+        declaration: 'export interface MarketDeclaration {\n    readonly title: LocalizedText;\n}',
+    },
+    {
+        name: 'MarketEngines',
+        declaration: 'export interface MarketEngines {\n    readonly dsh?: string;\n}',
+    },
+    {
+        name: 'MarketIndexMetadata',
+        declaration: 'export interface MarketIndexMetadata {\n    readonly categories: Readonly<Record<string, MarketDeclaration>>;\n    readonly labels: Readonly<Record<string, MarketDeclaration>>;\n    readonly sortKeys: Readonly<Record<string, MarketSortKeyDeclaration>>;\n}',
+    },
+    {
+        name: 'MarketIndexSummary',
+        declaration: 'export interface MarketIndexSummary {\n    readonly url: string;\n    readonly title?: LocalizedText;\n    readonly description?: LocalizedText;\n    readonly error?: string;\n}',
+    },
+    {
+        name: 'MarketInstallation',
+        declaration: 'export interface MarketInstallation {\n    readonly status: MarketInstallationStatus;\n    readonly installedVersion?: string;\n}',
+    },
+    {
+        name: 'MarketInstallationStatus',
+        declaration: 'export type MarketInstallationStatus = \'not-installed\' | \'installed\' | \'update-available\' | \'different-version\' | \'provided\';',
+    },
+    {
+        name: 'MarketInstallTarget',
+        declaration: 'export interface MarketInstallTarget {\n    readonly spec: string;\n    readonly registry?: string;\n}',
+    },
+    {
+        name: 'MarketListingEntry',
+        declaration: 'export interface MarketListingEntry extends Omit<MarketPlugin, \'versions\'> {\n    readonly versions: readonly MarketListingVersion[];\n    readonly defaultVersion?: string;\n    readonly installation: MarketInstallation;\n}',
+    },
+    {
+        name: 'MarketListingVersion',
+        declaration: 'export interface MarketListingVersion extends MarketVersion {\n    readonly install: MarketInstallTarget;\n    readonly compatibility: MarketCompatibility;\n}',
+    },
+    {
+        name: 'MarketPlugin',
+        declaration: 'export interface MarketPlugin {\n    readonly name: string;\n    readonly title?: LocalizedText;\n    readonly description?: LocalizedText;\n    readonly icon?: string;\n    readonly author?: string;\n    readonly homepage?: string;\n    readonly repository?: MarketRepository;\n    readonly metadata: MarketPluginMetadata;\n    readonly versions: readonly MarketVersion[];\n}',
+    },
+    {
+        name: 'MarketPluginMetadata',
+        declaration: 'export interface MarketPluginMetadata {\n    readonly category?: string;\n    readonly keywords: readonly string[];\n    readonly labels: readonly string[];\n    readonly sortKeys: Readonly<Record<string, number>>;\n}',
+    },
+    {
+        name: 'MarketQuery',
+        declaration: 'export interface MarketQuery {\n    readonly text?: string;\n    readonly category?: string;\n    readonly labels?: readonly string[];\n    readonly sort: MarketSort;\n    readonly offset: number;\n    readonly limit: number;\n    readonly refresh?: boolean;\n    readonly fetchedAt?: number;\n}',
+    },
+    {
+        name: 'MarketRepository',
+        declaration: 'export interface MarketRepository {\n    readonly url: string;\n    readonly directory?: string;\n}',
+    },
+    {
+        name: 'MarketSearchResult',
+        declaration: 'export interface MarketSearchResult {\n    readonly url: string;\n    readonly title: LocalizedText;\n    readonly description?: LocalizedText;\n    readonly metadata: MarketIndexMetadata;\n    readonly fetchedAt: number;\n    readonly entries: readonly MarketListingEntry[];\n    readonly total: number;\n    readonly nextOffset: number | null;\n}',
+    },
+    {
+        name: 'MarketSort',
+        declaration: 'export type MarketSort = {\n    readonly kind: \'index\';\n} | {\n    readonly kind: \'relevance\';\n} | {\n    readonly kind: \'published\';\n    readonly direction: \'asc\' | \'desc\';\n} | {\n    readonly kind: \'key\';\n    readonly id: string;\n    readonly direction: \'asc\' | \'desc\';\n};',
+    },
+    {
+        name: 'MarketSortKeyDeclaration',
+        declaration: 'export interface MarketSortKeyDeclaration {\n    readonly title: LocalizedText;\n    readonly order: \'asc\' | \'desc\';\n}',
+    },
+    {
+        name: 'MarketSource',
+        declaration: 'export type MarketSource = {\n    readonly type: \'npm\';\n    readonly registry?: string;\n} | {\n    readonly type: \'git\';\n    readonly url: string;\n    readonly commit: string;\n    readonly path?: string;\n};',
+    },
+    {
+        name: 'MarketVersion',
+        declaration: 'export interface MarketVersion {\n    readonly version: string;\n    readonly publishTimestamp: number;\n    readonly source: MarketSource;\n    readonly engines: MarketEngines;\n}',
+    },
     {
         name: 'MatcherValue',
         declaration: 'export type MatcherValue = string | number | boolean | null | RegExp | readonly (string | number | boolean | null)[];',
@@ -8380,7 +8497,11 @@ export const TYPE_API = [
     },
     {
         name: 'WebBootGraph',
-        declaration: 'export interface WebBootGraph {\n    rev: string;\n    entries: WebBootEntry[];\n    batches: WebBootBatch[];\n}',
+        declaration: 'export interface WebBootGraph {\n    rev: string;\n    release?: WebBootRelease;\n    entries: WebBootEntry[];\n    batches: WebBootBatch[];\n}',
+    },
+    {
+        name: 'WebBootRelease',
+        declaration: 'export interface WebBootRelease {\n    version: string;\n    commit?: string;\n}',
     },
     {
         name: 'WebFetchBody',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Read-only runtime API inspection for Harness plugin development",
-  "version": "0.2.1-alpha.3",
+  "version": "0.2.1-alpha.5",
   "publishConfig": {
     "access": "public"
   },
@@ -38,20 +38,20 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.2",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.3"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.5"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "~4.0.5-alpha.2",
     "@deepseek-ai/cordis-plugin-group": "~1.0.5-alpha.2",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.3",
-    "@deepseek-ai/dsh-tools": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.5",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.5",
     "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   }
 }