dsh-capability-panel 1.2.1 → 1.4.0

package/lib/index.d.ts

@@ -35,6 +35,13 @@ interface LoaderEntryLike {
 }
 interface LoaderLike {
   entries(): Iterable<LoaderEntryLike>;
+  /**
+   * Resolves once the initial load of every entry has settled. Optional: it is
+   * how dsh-settings defers its own legacy import, and the temporary recovery
+   * in `legacy-import.ts` probes it the same way; hosts whose loader predates
+   * it simply run the recovery immediately.
+   */
+  await?(): Promise<unknown>;
 }
 interface AgentsService {
   get(sessionId: string): AgentLike | undefined;
@@ -43,15 +50,41 @@ interface AgentsService {
 }
 interface AgentPresetLike {
   readonly id: string;
-  readonly trust: 'system' | 'user';
+  /**
+   * Present on dsh ≤ 0.1.6 (`dsh-agent-preset`); the 0.1.7 registry split
+   * dropped it from `list()` rows, so consumers must treat its absence as
+   * "unknown" rather than a shape violation.
+   */
+  readonly trust?: 'system' | 'user';
+  /** Same story as {@link trust}: the 0.1.7 roster no longer carries paths. */
   readonly path?: string;
   readonly name?: string;
   readonly description?: string;
   readonly broken?: string;
 }
+/**
+ * The revision lease `acquireScope` hands back: the scope key to read with,
+ * plus async disposal that releases the mount's user count. Disposal is part
+ * of the contract — skipping it pins a generation against collection forever.
+ */
+interface ScopeLeaseLike {
+  readonly key: unknown;
+  [Symbol.asyncDispose](): Promise<void>;
+}
 interface AgentPresetsService {
   list(): Promise<AgentPresetLike[]>;
-  standingKeyFor(id?: string): Promise<unknown>;
+  /**
+   * Read one preset's standing scope without starting an agent (dsh ≤ 0.1.6).
+   * Removed in 0.1.7 in favour of {@link acquireScope}; declared optional so
+   * the call site probes whichever the live service offers.
+   */
+  standingKeyFor?(id?: string): Promise<unknown>;
+  /**
+   * 0.1.7 replacement: retain the preset's current generation and hand back
+   * its scope key behind a lease. The caller MUST dispose the lease when the
+   * scoped read completes.
+   */
+  acquireScope?(id?: string): Promise<ScopeLeaseLike>;
   composedPreset(agentCtx: unknown): string | undefined;
 }
 interface SettingsScopeLike<T> {
@@ -63,11 +96,44 @@ interface SettingsScopeLike<T> {
    */
   replace(section: object): Promise<void>;
 }
+/** One row of the 0.1.7 settings form inventory, as far as this plugin reads it. */
+interface SettingsDescriptor {
+  readonly ns?: unknown;
+  readonly value?: unknown;
+}
+/**
+ * The settings service across BOTH host generations.
+ *
+ * `register` is the ≤0.1.6 contract and is still optional here so the type spans
+ * both: 0.1.7 deleted it, and a plugin that hard-required it would fail to
+ * compile against the new host while shipping one bundle that must serve both.
+ * The 0.1.7 trio is likewise optional, since a ≤0.1.6 host has none of it.
+ * Every member is therefore probed at runtime in `bindSection` rather than
+ * assumed, which is also why this stays a structural type with no static import
+ * from `@deepseek-ai/dsh-settings`.
+ */
 interface SettingsService {
-  readonly writable: boolean;
-  register<T>(namespace: string, schema: unknown, options?: {
+  /**
+   * Whether the surface accepts writes. A getter on 0.1.7 (unconditionally
+   * true); read only through the lazy non-strict path, never cached.
+   */
+  readonly writable?: boolean;
+  register?<T>(namespace: string, schema: unknown, options?: {
     applies?: 'live' | 'restart';
   }): SettingsScopeLike<T>;
+  /**
+   * The live form inventory. Only entries whose Config declares a volatile
+   * field appear here, which is precisely why this plugin declares one.
+   */
+  describe?(options?: {
+    redactSecrets?: boolean;
+  }): readonly SettingsDescriptor[];
+  /** Reset every live field of the namespace, then apply `section`. */
+  replace?(namespace: string, section: object, expectedRevision?: number): Promise<void>;
+  /** Recursive merge into the current section; cannot remove a key. */
+  update?(namespace: string, section: object, expectedRevision?: number): Promise<void>;
+  /** Ordered write operations against one namespace. */
+  mutate?(namespace: string, operations: readonly object[], expectedRevision?: number): Promise<void>;
 }
 interface SkillsService {
   list(lookup: {
@@ -100,7 +166,47 @@ interface AgentCreatedPayload {
     };
   };
 }
+/**
+ * The Host's Session controller, as far as this plugin uses it: the two
+ * members that open one path on the user's own desktop. Structural like every
+ * other service here, so nothing static is imported from
+ * `@deepseek-ai/dsh-api-session-controller` — and it spans this plugin's whole
+ * supported range, because both members exist in every generation from
+ * 0.1.2-rc.1 through 0.2.x. The richer members (`workspaceDesktop`,
+ * `workspacePathApplications`) only appear from 0.1.7-rc.2, so they stay unused
+ * rather than optional-by-extra-probing.
+ */
+interface SessionControllerLike {
+  /**
+   * Whether this deployment can hand one path to a native desktop. `false` is
+   * an answer rather than a failure: either the deployment turned native
+   * opening off, or the platform announces no desktop at all.
+   */
+  canOpenWorkspacePath(): boolean;
+  /**
+   * Verify the path through the composed filesystem, then open it natively.
+   * Rejects with the Host's own error when no verified mapping exists, which is
+   * how a sandboxed deployment refuses a path outside its roots.
+   */
+  openWorkspacePath(request: {
+    readonly path: string;
+  }, signal: AbortSignal): Promise<unknown>;
+}
 interface HostServices {
+  /**
+   * This plugin's own cordis fiber, read for the profile entry id that 0.1.7
+   * keys settings by. Optional because a plugin mounted without the Loader (a
+   * bare `ctx.plugin`) has no entry, and because the field is a Loader
+   * decoration rather than part of cordis's own Context type — so it is probed,
+   * never assumed.
+   */
+  readonly fiber?: {
+    readonly entry?: {
+      readonly options?: {
+        readonly id?: unknown;
+      };
+    };
+  };
   readonly webServer?: {
     register(spec: {
       kind: 'prefix';
@@ -108,13 +214,22 @@ interface HostServices {
       handler: (req: IncomingLike$1, res: ServerResponseLike) => Promise<void> | void;
     }): () => void;
   };
-  /** The cordis loader mixin every host context carries (entry inventory + hot-swap). */
-  readonly loader?: LoaderLike;
-  get(name: 'agents'): AgentsService | undefined;
-  get(name: 'agentPresets'): AgentPresetsService | undefined;
-  get(name: 'settings'): SettingsService | undefined;
-  get(name: 'skills'): SkillsService | undefined;
-  get(name: 'tools'): ToolsService | undefined;
+  /** The cordis loader service (entry inventory + hot-swap), read via get(). */
+  /**
+   * The cordis reflect channel. `strict` defaults to true, which only returns
+   * an implementation whose providing fiber is CURRENTLY active: during
+   * startup and HMR windows that reads as absent even though the service
+   * exists. Every lazy root-level read in this plugin passes strict=false so
+   * a provider mid-transition still resolves; a genuinely unmounted service
+   * stays undefined either way.
+   */
+  get(name: 'loader', strict?: boolean): LoaderLike | undefined;
+  get(name: 'agents', strict?: boolean): AgentsService | undefined;
+  get(name: 'agentPresets', strict?: boolean): AgentPresetsService | undefined;
+  get(name: 'settings', strict?: boolean): SettingsService | undefined;
+  get(name: 'sessionController', strict?: boolean): SessionControllerLike | undefined;
+  get(name: 'skills', strict?: boolean): SkillsService | undefined;
+  get(name: 'tools', strict?: boolean): ToolsService | undefined;
   on(event: 'agent/created',
   /**
    * A returned promise is allowed on purpose. Cordis vetoes agent publication
@@ -197,6 +312,12 @@ interface SkillSummary {
     readonly modelInvocable?: unknown;
   };
   readonly resourceBase?: unknown;
+  /**
+   * The absolute instruction file path, when the provider supplies one —
+   * `SKILL.md` for a directory bundle, the file itself for a flat Markdown
+   * skill, absent for a virtual skill registered in memory.
+   */
+  readonly path?: unknown;
 }
 interface SkillDefinitionLike {
   readonly name?: unknown;
@@ -205,6 +326,8 @@ interface SkillDefinitionLike {
   readonly source?: unknown;
   readonly provider?: unknown;
   readonly resourceBase?: unknown;
+  /** The provider's instruction-file path, inherited by the panel's shadow. */
+  readonly path?: unknown;
 }
 interface IncomingLike$1 extends IncomingLike {
   on?(event: 'data', listener: (chunk: unknown) => void): void;
@@ -217,9 +340,25 @@ interface ServerResponseLike {
 }
 //#endregion
 //#region src/index.d.ts
+/**
+ * This plugin's persisted state, declared where dsh 0.1.7 looks for it.
+ *
+ * The settings rewrite re-keyed every configurable namespace to a profile entry
+ * id and moved the values onto the entry's OWN Config, so a plugin that declares
+ * no Config is simply absent from the settings surface — `describe()` emits no
+ * descriptor and any write fails with `No configurable plugin entry`. Exporting
+ * this is what makes the entry configurable at all; the volatile markers inside
+ * (see `settings-schema.ts`) are what make writes apply live.
+ *
+ * It MUST be a named export of the module, not a property of `apply`: the loader
+ * resolves a module-shaped plugin down to its `apply` function and then reads
+ * `Config` off the enclosing module namespace. Attaching it to the function would
+ * be silently ignored.
+ */
+declare const Config: Schemastery<any, any, "plain">;
 /** Host composition root: construct stores/controllers and register the route. */
 declare function apply(ctx: HostServices): void;
 declare const inject: string[];
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/loopback.ts","../src/host/types.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;AACiB,UAAA,YAAA,CAAY;;;oBAGT;ECkBH;AAQjB;AAmBA;AAMA;EASiB,SAAA,MAAA,CAAA,EAAA;IACC,SAAA,aAAA,CAAA,EAAA,MAAA;EAAR,CAAA;;;;;;;AA+BV;AAUA;AAaA;;;AAEwE,UAnGvD,eAAA,CAmGuD;EAAR,SAAA,QAAA,CAAA,EAAA,OAAA;EAAO;EAGtD,SAAA,OAAY,CAAA,EAAA;IAMZ,SAAA,EAAA,CAAA,EAAA,OAAmB;IAOnB,SAAA,IAAY,CAAA,EAAA,OAAA;IAKR,SAAA,MAAA,CAAA,EAAA,OAAA;EAAmB,CAAA;EAAuB,QAAA,EAAA,EApHjD,OAoHiD,CAAA,IAAA,CAAA;EAI3C,OAAA,EAAA,EAvHP,OAuHO,CAAA,IAAA,CAAA;;AAES,UAtHZ,UAAA,CAsHY;EACJ,OAAA,EAAA,EAtHZ,QAsHY,CAtHH,eAsHG,CAAA;;UApGR,aAAA;0BACS;;ECxCV,IAAA,EAAA,ED0CN,SC1CW,EAAM;AA0B3B;UDmBiB,eAAA;;;;;;;;UASA,mBAAA;UACP,QAAQ;+BACa;;;UA8Bd;SACR;;;;;;4BAMmB;;UAGX,eAAA;;;;MAE8E,kBAAkB;;UAWhG,aAAA;;;;MACkC,iBAAiB;;;;MACJ,QAAQ;;UAGvD,YAAA;4BACW;;;;;;;;;;;;UAKX,mBAAA;kBACC;;;0BAEsB;;;;UAIvB,YAAA;;;;;qBAKI,qBAAmB,uBAAuB;;;;oBAI3C;uBACG;6BACM;yBACJ;uBACF;sBACD;;;;;;;;sBASE,+BAA+B;;iGAKS;;mDAKrC;;;;;;;;;;;;;;;;;;;;;;;;iBAcT;;;;SACT;;;;;;;UAqBQ,mBAAA;;;;;UAIA,SAAA;;;;;;;;;;;;;;;;;;;;;;UAiBA,YAAA;;;;;;;;;;UASA,mBAAA;;;;;;;;UASA,cAAA,SAAqB;;;;;UAMrB,kBAAA;qCACoB;;;;;AD3PrC;iBESgB,KAAA,MAAW;cA0Bd"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/loopback.ts","../src/host/types.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;AACiB,UAAA,YAAA,CAAY;;;oBAGT;ECkBH;AAQjB;;;EAQY,SAAA,MAAA,CAAA,EAAA;IAAO,SAAA,aAAA,CAAA,EAAA,MAAA;EAkBF,CAAA;AAMjB;;;;AAAA;AAoBA;AAKA;;;;;AAa8B,UA9Eb,eAAA,CA8Ea;EAAO,SAAA,QAAA,CAAA,EAAA,OAAA;EA8BpB;EAWA,SAAA,OAAA,CAAA,EAAA;IAgBA,SAAA,EAAA,CAAA,EAAe,OAAA;IAMkF,SAAA,IAAA,CAAA,EAAA,OAAA;IAAlB,SAAA,MAAA,CAAA,EAAA,OAAA;EAKnC,CAAA;EAEc,QAAA,EAAA,EAhJ7D,OAgJ6D,CAAA,IAAA,CAAA;EAED,OAAA,EAAA,EAjJ7D,OAiJ6D,CAAA,IAAA,CAAA;;AAEqB,UAhJ9E,UAAA,CAgJ8E;EAW9E,OAAA,EAAA,EA1JJ,QA0JiB,CA1JR,eA0JQ,CAAA;EACsC;;;;;AAIpE;EAMiB,KAAA,GAAA,EA9JL,OA8JK,CAAA,OAAmB,CAAA;AAiBpC;AAmE2B,UAhOV,aAAA,CAgOU;EAcT,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EA7OQ,SA6OR,GAAA,SAAA;EACT;EAAO,IAAA,EAAA,EA5ON,SA4OM,EAAA;AAqBhB;AAIiB,UAlQA,eAAA,CAkQS;EAiBT,SAAA,EAAA,EAAA,MAAY;EAeZ;AAWjB;AAMA;;;;ECvVa;EAGG,SAAK,IAAA,CAAA,EAAA,MAAM;EA6Bd,SAAsB,IAAA,CAAA,EAAA,MAAA;;;;;;;;;UDwBlB,cAAA;;2BAEU;;UAGV,mBAAA;UACP,QAAQ;;;;;;gCAMc;;;;;;8BAMF,QAAQ;;;UA8BrB;SACR;;;;;;4BAMmB;;;UAIX,kBAAA;;;;;;;;;;;;;;;UAgBA,eAAA;;;;;;;;MAM+E,kBAAkB;;;;;;;eAKrD;;2EAEc;;0EAED;;wFAEc;;UAWvE,aAAA;;;;MACkC,iBAAiB;;;;MACJ,QAAQ;;UAGvD,YAAA;4BACW;;;;;;;;;;;;UAKX,mBAAA;kBACC;;;0BAEsB;;;;;;;;;;;;;;UAcvB,qBAAA;;;;;;;;;;;;;;aAY+C,cAAc;;UAG7D,YAAA;;;;;;;;;;;;;;;;;;;qBAeI,qBAAmB,uBAAuB;;;;;;;;;;;;yCAYtB;yCACA;+CACM;2CACJ;oDACS;yCACX;wCACD;;;;;;;;sBAShB,+BAA+B;;iGAKS;;mDAKrC;;;;;;;;;;;;;;;;;;;;;;;;iBAcT;;;;SACT;;;;;;;UAqBQ,mBAAA;;;;;UAIA,SAAA;;;;;;;;;;;;;;;;;;;;;;UAiBA,YAAA;;;;;;;;;;;;;;;;UAeA,mBAAA;;;;;;;;;;UAWA,cAAA,SAAqB;;;;;UAMrB,kBAAA;qCACoB;;;;;ADjXrC;;;;ACqBA;AAQA;;;;;AA0BA;AAMA;AAoBA;AAKA;;AACU,cC9DG,MD8DH,EC9DS,WD8DT,CAAA,GAAA,EAAA,GAAA,EAAA,OAAA,CAAA;;AAY4B,iBCvEtB,KAAA,CDuEsB,GAAA,ECvEX,YDuEW,CAAA,EAAA,IAAA;AAAR,cC1CjB,MD0CiB,EAAA,MAAA,EAAA"}