dsh-capability-panel 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,188 @@
+//#region src/loopback.d.ts
+/** The minimal readable surface of a request object inside a route handler. */
+interface IncomingLike {
+  readonly url?: string;
+  readonly method?: string;
+  readonly headers: Record<string, string | string[] | undefined>;
+  /**
+   * Present on node's http.IncomingMessage. Prefer it for the loopback
+   * decision: the Host and Origin headers are client-controlled and forgeable.
+   */
+  readonly socket?: {
+    readonly remoteAddress?: string;
+  };
+}
+//#endregion
+//#region src/host/types.d.ts
+
+interface AgentsService {
+  get(sessionId: string): AgentLike | undefined;
+}
+interface AgentPresetLike {
+  readonly id: string;
+  readonly trust: 'system' | 'user';
+  readonly name?: string;
+  readonly description?: string;
+  readonly broken?: string;
+}
+interface AgentPresetsService {
+  list(): Promise<AgentPresetLike[]>;
+  standingKeyFor(id?: string): Promise<unknown>;
+  composedPreset(agentCtx: unknown): string | undefined;
+}
+interface SettingsScopeLike<T> {
+  get(): T;
+  /**
+   * Wholesale replacement of this namespace's user section. The merge behind
+   * `update` recurses, so it cannot remove a key; removal is why this is the
+   * write path used here.
+   */
+  replace(section: object): Promise<void>;
+}
+interface SettingsService {
+  readonly writable: boolean;
+  register<T>(namespace: string, schema: unknown, options?: {
+    applies?: 'live' | 'restart';
+  }): SettingsScopeLike<T>;
+}
+interface SkillsService {
+  list(lookup: {
+    cwd?: string;
+    scope?: unknown;
+  }): Promise<readonly SkillSummary[]>;
+  get(name: string, lookup: {
+    cwd?: string;
+    scope?: unknown;
+  }): Promise<SkillDefinitionLike | undefined>;
+}
+interface ToolsService {
+  schemas(scope?: unknown): Iterable<{
+    name?: unknown;
+    description?: unknown;
+  }>;
+  guard?(guard: (execution: {
+    name?: unknown;
+    agent?: {
+      id?: unknown;
+    };
+  }) => string | undefined): () => void;
+}
+/** The `agent/created` payload, named so a listener wrapper can restate it. */
+interface AgentCreatedPayload {
+  readonly agent: AgentLike & {
+    readonly id?: unknown;
+    readonly ctx: {
+      get(name: 'tools'): ScopedToolsRegistry | undefined;
+    };
+  };
+}
+interface HostServices {
+  readonly webServer?: {
+    register(spec: {
+      kind: 'prefix';
+      path: string;
+      handler: (req: IncomingLike$1, res: ServerResponseLike) => Promise<void> | void;
+    }): () => void;
+  };
+  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;
+  on(event: 'agent/created',
+  /**
+   * A returned promise is allowed on purpose. Cordis vetoes agent publication
+   * on a SYNCHRONOUS listener failure but only reports a rejected promise, so
+   * asynchronous work here cannot cost the user their session. The synchronous
+   * part of a listener still has to contain its own failures.
+   */
+  listener: (payload: AgentCreatedPayload) => void | Promise<void>): void;
+  on(event: 'tools/result', listener: (exec: {
+    name?: unknown;
+    arguments?: unknown;
+    agent?: {
+      id?: unknown;
+    };
+  }, result: {
+    isError: boolean;
+    error?: {
+      message?: unknown;
+      info?: {
+        code?: unknown;
+      };
+    };
+  }) => void): void;
+  on(event: 'system-prompt/assemble', listener: (assembly: {
+    tools?: readonly {
+      name?: unknown;
+    }[];
+  }, context: {
+    agent?: {
+      id?: unknown;
+    };
+  }, next: () => Promise<{
+    tools?: readonly {
+      name?: unknown;
+    }[];
+  }>) => Promise<{
+    tools?: readonly {
+      name?: unknown;
+    }[];
+  }>): void;
+  effect(factory: () => (() => void) | void, label?: string): void;
+}
+interface ScopedToolsRegistry {
+  restrict(filter: {
+    deny: readonly string[];
+  }): () => void;
+}
+interface AgentLike {
+  readonly session?: {
+    readonly header?: {
+      readonly cwd?: string;
+    };
+    /**
+     * Live in-memory log view, present on every real Session. Borrowed
+     * references, zero-copy — the panel scans this instead of asking a query
+     * service to clone and replay-validate the whole log.
+     */
+    readonly snapshotEvents?: () => readonly unknown[];
+    /** Incrementally maintained current surface: seqs the model sees now. */
+    readonly surface?: {
+      readonly nodes?: readonly unknown[];
+    };
+  };
+  readonly ctx?: {
+    get(name: string): unknown;
+  };
+}
+interface SkillSummary {
+  readonly name?: unknown;
+  readonly description?: unknown;
+  readonly invocation?: {
+    readonly modelInvocable?: unknown;
+  };
+}
+interface SkillDefinitionLike {
+  readonly name?: unknown;
+  readonly description?: unknown;
+  readonly content?: unknown;
+  readonly resourceBase?: unknown;
+}
+interface IncomingLike$1 extends IncomingLike {
+  on?(event: 'data', listener: (chunk: unknown) => void): void;
+  on?(event: 'end', listener: () => void): void;
+  on?(event: 'error', listener: (error: unknown) => void): void;
+}
+interface ServerResponseLike {
+  writeHead(status: number, headers: Record<string, string>): void;
+  end(body?: string): void;
+}
+//#endregion
+//#region src/index.d.ts
+/** Host composition root: construct stores/controllers and register the route. */
+declare function apply(ctx: HostServices): void;
+declare const inject: string[];
+//#endregion
+export { apply, inject };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +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;ECeH;AAIjB;AAQA;;EACU,SAAA,MAAA,CAAA,EAAA;IACqB,SAAA,aAAA,CAAA,EAAA,MAAA;EAAO,CAAA;AA8BtC;;;;AAwBmD,UApElC,aAAA,CAoEkC;EACqB,GAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EApE9C,SAoE8C,GAAA,SAAA;;AAAD,UAjEtD,eAAA,CAiEsD;EAGtD,SAAA,EAAA,EAAA,MAAY;EAMZ,SAAA,KAAA,EAAA,QAAmB,GAAA,MAAA;EAOnB,SAAA,IAAA,CAAA,EAAY,MAAA;EAKR,SAAA,WAAA,CAAA,EAAA,MAAA;EAAmB,SAAA,MAAA,CAAA,EAAA,MAAA;;AAGjB,UAjFN,mBAAA,CAiFM;EACM,IAAA,EAAA,EAjFnB,OAiFmB,CAjFX,eAiFW,EAAA,CAAA;EACJ,cAAA,CAAA,EAAA,CAAA,EAAA,MAAA,CAAA,EAjFM,OAiFN,CAAA,OAAA,CAAA;EACF,cAAA,CAAA,QAAA,EAAA,OAAA,CAAA,EAAA,MAAA,GAAA,SAAA;;UApDN;SACR;;;;;;4BAMmB;;UAGX,eAAA;;;;MAE8E,kBAAkB;;UAWhG,aAAA;;;;MACkC,iBAAiB;;;;MACJ,QAAQ;;UAGvD,YAAA;4BACW;;;;;;;;;;;;UAKX,mBAAA;kBACC;;;0BAEsB;;;;UAIvB,YAAA;;;;;qBAKI,qBAAmB,uBAAuB;;;uBAGxC;6BACM;yBACJ;uBACF;sBACD;;;;;;;;sBASE,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;iBAcrC;;;;SACT;;;;;;;UAqBQ,mBAAA;;;;;UAIA,SAAA;;;;;;;;;;;;;;;;;;;;UAeA,YAAA;;;;;;;UAMA,mBAAA;;;;;;UAOA,cAAA,SAAqB;;;;;UAMrB,kBAAA;qCACoB;;;;;ADvMrC;iBESgB,KAAA,MAAW;cA0Bd"}