@xopcai/xopc 0.0.102 → 0.0.104

package/dist/src/agent/session/session-config-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-config-service.js","names":[],"sources":["../../../../src/agent/session/session-config-service.ts"],"sourcesContent":["/**\n * SessionConfigService — owns the \"write side\" of per-session agent settings\n * (model override, thinking level, reasoning level, working directory).\n *\n * Previously these lived as four sibling methods on `AgentService`:\n *   - `patchSessionAgentConfig` (96 lines of validation + persistence)\n *   - `applyCronJobWorkingDirectory` (cron-specific working dir update)\n *   - `clearCronSessionWorkingDirectoryOverride` (private helper)\n *   - `clearSessionModelOverride` (private helper)\n *\n * Extracted so `AgentService` no longer mixes \"session bag\" concerns with\n * \"session config write\" concerns, and so future additions to the patch API\n * (e.g. new per-session overrides) only touch this file.\n */\n\nimport { mkdir } from 'node:fs/promises';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { normalizeWorkingDirectoryInput } from '../../session/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n} from '../transcript/thinking-types.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SessionConfigService');\n\nexport interface SessionConfigServiceOptions {\n  sessionStore: SessionStore;\n  sessionConfigStore: SessionConfigStore;\n  modelManager: ModelManager;\n  agentManager: AgentInstanceGateway;\n  /** Effective config snapshot accessor. */\n  getConfig: () => Config | undefined;\n}\n\nexport interface PatchSessionAgentConfigInput {\n  thinkingLevel?: string;\n  model?: string | null;\n  reasoningLevel?: string;\n  workingDirectory?: string;\n}\n\nexport interface PatchSessionAgentConfigResult {\n  ok: boolean;\n  error?: string;\n}\n\nexport class SessionConfigService {\n  private readonly opts: SessionConfigServiceOptions;\n\n  constructor(opts: SessionConfigServiceOptions) {\n    this.opts = opts;\n  }\n\n  /**\n   * Apply a partial patch (model / thinking / reasoning / working directory) to\n   * a session's persisted config. Returns `{ ok: false, error }` on the first\n   * invalid field — earlier fields that succeeded are NOT rolled back, matching\n   * the previous behaviour.\n   */\n  async patch(\n    sessionKey: string,\n    partial: PatchSessionAgentConfigInput,\n  ): Promise<PatchSessionAgentConfigResult> {\n    if (partial.model !== undefined) {\n      if (partial.model === null || partial.model === '') {\n        await this.clearModelOverride(sessionKey);\n      } else {\n        const ok = await this.opts.modelManager.switchModelForSession(sessionKey, partial.model);\n        if (!ok) {\n          return { ok: false, error: 'Invalid model' };\n        }\n        await this.opts.sessionConfigStore.update(sessionKey, { modelOverride: partial.model });\n        this.opts.agentManager.setModelForSession(sessionKey, partial.model);\n      }\n    }\n\n    if (partial.thinkingLevel !== undefined) {\n      const normalized = normalizeThinkLevel(partial.thinkingLevel);\n      if (!normalized) {\n        return { ok: false, error: 'Invalid thinking level' };\n      }\n      await this.opts.sessionConfigStore.update(sessionKey, { thinkingLevel: normalized });\n      this.opts.agentManager.setThinkingLevel(sessionKey, normalized as ThinkingLevel);\n    }\n\n    if (partial.reasoningLevel !== undefined) {\n      const normalized = normalizeReasoningLevel(partial.reasoningLevel);\n      if (!normalized) {\n        return { ok: false, error: 'Invalid reasoning level' };\n      }\n      await this.opts.sessionConfigStore.update(sessionKey, { reasoningLevel: normalized });\n    }\n\n    if (partial.workingDirectory !== undefined) {\n      const cfg = this.opts.getConfig();\n      if (!cfg) {\n        return { ok: false, error: 'Config not loaded' };\n      }\n      const result = await this.patchWorkingDirectory(sessionKey, partial.workingDirectory);\n      if (!result.ok) return result;\n    }\n\n    return { ok: true };\n  }\n\n  /**\n   * Sync persisted session working directory for an isolated cron run. Runs\n   * may change when the job is edited; an empty/missing input clears the\n   * override so the session uses the effective agent default.\n   */\n  async applyCronJobWorkingDirectory(\n    sessionKey: string,\n    workingDirectory: string | undefined,\n  ): Promise<void> {\n    const raw = workingDirectory?.trim();\n    if (raw) {\n      const wdNorm = normalizeWorkingDirectoryInput(raw);\n      if (wdNorm.ok === false) {\n        log.warn(\n          { sessionKey, error: wdNorm.error },\n          'Cron job working directory invalid; using agent default',\n        );\n        await this.clearCronWorkingDirectoryOverride(sessionKey);\n        return;\n      }\n      await mkdir(wdNorm.path, { recursive: true });\n      await this.opts.sessionConfigStore.update(sessionKey, { workingDirectoryOverride: wdNorm.path });\n      this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, wdNorm.path);\n      return;\n    }\n    await this.clearCronWorkingDirectoryOverride(sessionKey);\n  }\n\n  /**\n   * Clear the session's model override (back to agent default). Used both by\n   * {@link patch} and by `AgentService.resetSessionModelToAgentDefault`.\n   */\n  async clearModelOverride(sessionKey: string): Promise<void> {\n    this.opts.modelManager.clearSessionModelOverride(sessionKey);\n    await this.opts.sessionConfigStore.update(sessionKey, { modelOverride: undefined });\n    const agent = this.opts.agentManager.getAgent(sessionKey);\n    if (agent) {\n      await this.opts.modelManager.applyModelForSession(agent, sessionKey);\n    }\n  }\n\n  // ── Internal helpers ───────────────────────────────────────────────────\n\n  private async clearCronWorkingDirectoryOverride(sessionKey: string): Promise<void> {\n    const existing = await this.opts.sessionConfigStore.get(sessionKey);\n    if (existing?.workingDirectoryOverride) {\n      const { workingDirectoryOverride: _removed, ...rest } = existing;\n      await this.opts.sessionConfigStore.set(sessionKey, rest);\n    }\n    this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, null);\n  }\n\n  /**\n   * Apply the workingDirectory branch of `patch`. Returns the next-step result\n   * (`ok: true` to keep going, `ok: false, error` to short-circuit the patch).\n   *\n   * Working directory has the strictest semantics: once a session has any\n   * messages, it cannot move to a different directory — only re-setting the\n   * same path is idempotent.\n   */\n  private async patchWorkingDirectory(\n    sessionKey: string,\n    workingDirectory: string,\n  ): Promise<PatchSessionAgentConfigResult> {\n    const existing = await this.opts.sessionConfigStore.get(sessionKey);\n    const existingRaw = existing?.workingDirectoryOverride?.trim();\n    const incoming = workingDirectory.trim();\n\n    const priorMessages = await this.opts.sessionStore.load(sessionKey);\n\n    if (priorMessages.length > 0) {\n      if (!incoming) {\n        return { ok: false, error: 'workingDirectory is empty' };\n      }\n      if (!existingRaw) {\n        return {\n          ok: false,\n          error: 'Working directory can only be set before the first message in this conversation',\n        };\n      }\n      const prev = normalizeWorkingDirectoryInput(existingRaw);\n      const next = normalizeWorkingDirectoryInput(incoming);\n      if (prev.ok && next.ok && prev.path === next.path) {\n        // idempotent\n        return { ok: true };\n      }\n      return { ok: false, error: 'Working directory is already set for this session' };\n    }\n\n    if (!incoming) {\n      return { ok: false, error: 'workingDirectory is empty' };\n    }\n    const wdNorm = normalizeWorkingDirectoryInput(incoming);\n    switch (wdNorm.ok) {\n      case true: {\n        if (existingRaw) {\n          const prev = normalizeWorkingDirectoryInput(existingRaw);\n          if (prev.ok && prev.path === wdNorm.path) {\n            return { ok: true };\n          }\n        }\n        await mkdir(wdNorm.path, { recursive: true });\n        await this.opts.sessionConfigStore.update(sessionKey, {\n          workingDirectoryOverride: wdNorm.path,\n        });\n        this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, wdNorm.path);\n        this.opts.agentManager.removeAgent(sessionKey);\n        return { ok: true };\n      }\n      case false:\n        return { ok: false, error: wdNorm.error };\n      default:\n        return { ok: false, error: 'Invalid working directory' };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;aA2BqD;AAErD,MAAM,MAAM,aAAa,uBAAuB;AAuBhD,IAAa,uBAAb,MAAkC;CAChC;CAEA,YAAY,MAAmC;AAC7C,OAAK,OAAO;;;;;;;;CASd,MAAM,MACJ,YACA,SACwC;AACxC,MAAI,QAAQ,UAAU,KAAA,EACpB,KAAI,QAAQ,UAAU,QAAQ,QAAQ,UAAU,GAC9C,OAAM,KAAK,mBAAmB,WAAW;OACpC;AAEL,OAAI,CAAC,MADY,KAAK,KAAK,aAAa,sBAAsB,YAAY,QAAQ,MAAM,CAEtF,QAAO;IAAE,IAAI;IAAO,OAAO;IAAiB;AAE9C,SAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EAAE,eAAe,QAAQ,OAAO,CAAC;AACvF,QAAK,KAAK,aAAa,mBAAmB,YAAY,QAAQ,MAAM;;AAIxE,MAAI,QAAQ,kBAAkB,KAAA,GAAW;GACvC,MAAM,aAAa,oBAAoB,QAAQ,cAAc;AAC7D,OAAI,CAAC,WACH,QAAO;IAAE,IAAI;IAAO,OAAO;IAA0B;AAEvD,SAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EAAE,eAAe,YAAY,CAAC;AACpF,QAAK,KAAK,aAAa,iBAAiB,YAAY,WAA4B;;AAGlF,MAAI,QAAQ,mBAAmB,KAAA,GAAW;GACxC,MAAM,aAAa,wBAAwB,QAAQ,eAAe;AAClE,OAAI,CAAC,WACH,QAAO;IAAE,IAAI;IAAO,OAAO;IAA2B;AAExD,SAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EAAE,gBAAgB,YAAY,CAAC;;AAGvF,MAAI,QAAQ,qBAAqB,KAAA,GAAW;AAE1C,OAAI,CADQ,KAAK,KAAK,WACd,CACN,QAAO;IAAE,IAAI;IAAO,OAAO;IAAqB;GAElD,MAAM,SAAS,MAAM,KAAK,sBAAsB,YAAY,QAAQ,iBAAiB;AACrF,OAAI,CAAC,OAAO,GAAI,QAAO;;AAGzB,SAAO,EAAE,IAAI,MAAM;;;;;;;CAQrB,MAAM,6BACJ,YACA,kBACe;EACf,MAAM,MAAM,kBAAkB,MAAM;AACpC,MAAI,KAAK;GACP,MAAM,SAAS,+BAA+B,IAAI;AAClD,OAAI,OAAO,OAAO,OAAO;AACvB,QAAI,KACF;KAAE;KAAY,OAAO,OAAO;KAAO,EACnC,0DACD;AACD,UAAM,KAAK,kCAAkC,WAAW;AACxD;;AAEF,SAAM,MAAM,OAAO,MAAM,EAAE,WAAW,MAAM,CAAC;AAC7C,SAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EAAE,0BAA0B,OAAO,MAAM,CAAC;AAChG,QAAK,KAAK,aAAa,4BAA4B,YAAY,OAAO,KAAK;AAC3E;;AAEF,QAAM,KAAK,kCAAkC,WAAW;;;;;;CAO1D,MAAM,mBAAmB,YAAmC;AAC1D,OAAK,KAAK,aAAa,0BAA0B,WAAW;AAC5D,QAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EAAE,eAAe,KAAA,GAAW,CAAC;EACnF,MAAM,QAAQ,KAAK,KAAK,aAAa,SAAS,WAAW;AACzD,MAAI,MACF,OAAM,KAAK,KAAK,aAAa,qBAAqB,OAAO,WAAW;;CAMxE,MAAc,kCAAkC,YAAmC;EACjF,MAAM,WAAW,MAAM,KAAK,KAAK,mBAAmB,IAAI,WAAW;AACnE,MAAI,UAAU,0BAA0B;GACtC,MAAM,EAAE,0BAA0B,UAAU,GAAG,SAAS;AACxD,SAAM,KAAK,KAAK,mBAAmB,IAAI,YAAY,KAAK;;AAE1D,OAAK,KAAK,aAAa,4BAA4B,YAAY,KAAK;;;;;;;;;;CAWtE,MAAc,sBACZ,YACA,kBACwC;EAExC,MAAM,eAAc,MADG,KAAK,KAAK,mBAAmB,IAAI,WAAW,GACrC,0BAA0B,MAAM;EAC9D,MAAM,WAAW,iBAAiB,MAAM;AAIxC,OAAI,MAFwB,KAAK,KAAK,aAAa,KAAK,WAAW,EAEjD,SAAS,GAAG;AAC5B,OAAI,CAAC,SACH,QAAO;IAAE,IAAI;IAAO,OAAO;IAA6B;AAE1D,OAAI,CAAC,YACH,QAAO;IACL,IAAI;IACJ,OAAO;IACR;GAEH,MAAM,OAAO,+BAA+B,YAAY;GACxD,MAAM,OAAO,+BAA+B,SAAS;AACrD,OAAI,KAAK,MAAM,KAAK,MAAM,KAAK,SAAS,KAAK,KAE3C,QAAO,EAAE,IAAI,MAAM;AAErB,UAAO;IAAE,IAAI;IAAO,OAAO;IAAqD;;AAGlF,MAAI,CAAC,SACH,QAAO;GAAE,IAAI;GAAO,OAAO;GAA6B;EAE1D,MAAM,SAAS,+BAA+B,SAAS;AACvD,UAAQ,OAAO,IAAf;GACE,KAAK;AACH,QAAI,aAAa;KACf,MAAM,OAAO,+BAA+B,YAAY;AACxD,SAAI,KAAK,MAAM,KAAK,SAAS,OAAO,KAClC,QAAO,EAAE,IAAI,MAAM;;AAGvB,UAAM,MAAM,OAAO,MAAM,EAAE,WAAW,MAAM,CAAC;AAC7C,UAAM,KAAK,KAAK,mBAAmB,OAAO,YAAY,EACpD,0BAA0B,OAAO,MAClC,CAAC;AACF,SAAK,KAAK,aAAa,4BAA4B,YAAY,OAAO,KAAK;AAC3E,SAAK,KAAK,aAAa,YAAY,WAAW;AAC9C,WAAO,EAAE,IAAI,MAAM;GAErB,KAAK,MACH,QAAO;IAAE,IAAI;IAAO,OAAO,OAAO;IAAO;GAC3C,QACE,QAAO;IAAE,IAAI;IAAO,OAAO;IAA6B"}
+{"version":3,"file":"session-config-service.js","names":[],"sources":["../../../../src/agent/session/session-config-service.ts"],"sourcesContent":["/**\n * SessionConfigService — owns the \"write side\" of per-session agent settings\n * (model override, thinking level, reasoning level, working directory).\n *\n * Previously these lived as four sibling methods on `AgentService`:\n *   - `patchSessionAgentConfig` (96 lines of validation + persistence)\n *   - `applyCronJobWorkingDirectory` (cron-specific working dir update)\n *   - `clearCronSessionWorkingDirectoryOverride` (private helper)\n *   - `clearSessionModelOverride` (private helper)\n *\n * Extracted so `AgentService` no longer mixes \"session bag\" concerns with\n * \"session config write\" concerns, and so future additions to the patch API\n * (e.g. new per-session overrides) only touch this file.\n */\n\nimport { mkdir } from 'node:fs/promises';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { normalizeWorkingDirectoryInput } from '../../session/index.js';\nimport type { SessionConfigStore, SessionStore } from '../../session/index.js';\nimport {\n  normalizeThinkLevel,\n  normalizeReasoningLevel,\n  normalizeVerboseLevel,\n} from '../transcript/thinking-types.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport type { ModelManager } from '../models/index.js';\nimport { createLogger } from '../../utils/logger.js';\n\nconst log = createLogger('SessionConfigService');\n\nexport interface SessionConfigServiceOptions {\n  sessionStore: SessionStore;\n  sessionConfigStore: SessionConfigStore;\n  modelManager: ModelManager;\n  agentManager: AgentInstanceGateway;\n  /** Effective config snapshot accessor. */\n  getConfig: () => Config | undefined;\n}\n\nexport interface PatchSessionAgentConfigInput {\n  thinkingLevel?: string;\n  model?: string | null;\n  reasoningLevel?: string;\n  verboseLevel?: string;\n  workingDirectory?: string;\n}\n\nexport interface PatchSessionAgentConfigResult {\n  ok: boolean;\n  error?: string;\n}\n\nexport class SessionConfigService {\n  private readonly opts: SessionConfigServiceOptions;\n\n  constructor(opts: SessionConfigServiceOptions) {\n    this.opts = opts;\n  }\n\n  /**\n   * Apply a partial patch (model / thinking / reasoning / working directory) to\n   * a session's persisted config. Returns `{ ok: false, error }` on the first\n   * invalid field — earlier fields that succeeded are NOT rolled back, matching\n   * the previous behaviour.\n   */\n  async patch(\n    sessionKey: string,\n    partial: PatchSessionAgentConfigInput,\n  ): Promise<PatchSessionAgentConfigResult> {\n    if (partial.model !== undefined) {\n      if (partial.model === null || partial.model === '') {\n        await this.clearModelOverride(sessionKey);\n      } else {\n        const ok = await this.opts.modelManager.switchModelForSession(sessionKey, partial.model);\n        if (!ok) {\n          return { ok: false, error: 'Invalid model' };\n        }\n        await this.opts.sessionConfigStore.update(sessionKey, { modelOverride: partial.model });\n        this.opts.agentManager.setModelForSession(sessionKey, partial.model);\n      }\n    }\n\n    if (partial.thinkingLevel !== undefined) {\n      const normalized = normalizeThinkLevel(partial.thinkingLevel);\n      if (!normalized) {\n        return { ok: false, error: 'Invalid thinking level' };\n      }\n      await this.opts.sessionConfigStore.update(sessionKey, { thinkingLevel: normalized });\n      this.opts.agentManager.setThinkingLevel(sessionKey, normalized as ThinkingLevel);\n    }\n\n    if (partial.reasoningLevel !== undefined) {\n      const normalized = normalizeReasoningLevel(partial.reasoningLevel);\n      if (!normalized) {\n        return { ok: false, error: 'Invalid reasoning level' };\n      }\n      await this.opts.sessionConfigStore.update(sessionKey, { reasoningLevel: normalized });\n    }\n\n    if (partial.verboseLevel !== undefined) {\n      const normalized = normalizeVerboseLevel(partial.verboseLevel);\n      if (!normalized) {\n        return { ok: false, error: 'Invalid verbose level' };\n      }\n      await this.opts.sessionConfigStore.update(sessionKey, { verboseLevel: normalized });\n    }\n\n    if (partial.workingDirectory !== undefined) {\n      const cfg = this.opts.getConfig();\n      if (!cfg) {\n        return { ok: false, error: 'Config not loaded' };\n      }\n      const result = await this.patchWorkingDirectory(sessionKey, partial.workingDirectory);\n      if (!result.ok) return result;\n    }\n\n    return { ok: true };\n  }\n\n  /**\n   * Sync persisted session working directory for an isolated cron run. Runs\n   * may change when the job is edited; an empty/missing input clears the\n   * override so the session uses the effective agent default.\n   */\n  async applyCronJobWorkingDirectory(\n    sessionKey: string,\n    workingDirectory: string | undefined,\n  ): Promise<void> {\n    const raw = workingDirectory?.trim();\n    if (raw) {\n      const wdNorm = normalizeWorkingDirectoryInput(raw);\n      if (wdNorm.ok === false) {\n        log.warn(\n          { sessionKey, error: wdNorm.error },\n          'Cron job working directory invalid; using agent default',\n        );\n        await this.clearCronWorkingDirectoryOverride(sessionKey);\n        return;\n      }\n      await mkdir(wdNorm.path, { recursive: true });\n      await this.opts.sessionConfigStore.update(sessionKey, { workingDirectoryOverride: wdNorm.path });\n      this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, wdNorm.path);\n      return;\n    }\n    await this.clearCronWorkingDirectoryOverride(sessionKey);\n  }\n\n  /**\n   * Clear the session's model override (back to agent default). Used both by\n   * {@link patch} and by `AgentService.resetSessionModelToAgentDefault`.\n   */\n  async clearModelOverride(sessionKey: string): Promise<void> {\n    this.opts.modelManager.clearSessionModelOverride(sessionKey);\n    await this.opts.sessionConfigStore.update(sessionKey, { modelOverride: undefined });\n    const agent = this.opts.agentManager.getAgent(sessionKey);\n    if (agent) {\n      await this.opts.modelManager.applyModelForSession(agent, sessionKey);\n    }\n  }\n\n  // ── Internal helpers ───────────────────────────────────────────────────\n\n  private async clearCronWorkingDirectoryOverride(sessionKey: string): Promise<void> {\n    const existing = await this.opts.sessionConfigStore.get(sessionKey);\n    if (existing?.workingDirectoryOverride) {\n      const { workingDirectoryOverride: _removed, ...rest } = existing;\n      await this.opts.sessionConfigStore.set(sessionKey, rest);\n    }\n    this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, null);\n  }\n\n  /**\n   * Apply the workingDirectory branch of `patch`. Returns the next-step result\n   * (`ok: true` to keep going, `ok: false, error` to short-circuit the patch).\n   *\n   * Working directory has the strictest semantics: once a session has any\n   * messages, it cannot move to a different directory — only re-setting the\n   * same path is idempotent.\n   */\n  private async patchWorkingDirectory(\n    sessionKey: string,\n    workingDirectory: string,\n  ): Promise<PatchSessionAgentConfigResult> {\n    const existing = await this.opts.sessionConfigStore.get(sessionKey);\n    const existingRaw = existing?.workingDirectoryOverride?.trim();\n    const incoming = workingDirectory.trim();\n\n    const priorMessages = await this.opts.sessionStore.load(sessionKey);\n\n    if (priorMessages.length > 0) {\n      if (!incoming) {\n        return { ok: false, error: 'workingDirectory is empty' };\n      }\n      if (!existingRaw) {\n        return {\n          ok: false,\n          error: 'Working directory can only be set before the first message in this conversation',\n        };\n      }\n      const prev = normalizeWorkingDirectoryInput(existingRaw);\n      const next = normalizeWorkingDirectoryInput(incoming);\n      if (prev.ok && next.ok && prev.path === next.path) {\n        // idempotent\n        return { ok: true };\n      }\n      return { ok: false, error: 'Working directory is already set for this session' };\n    }\n\n    if (!incoming) {\n      return { ok: false, error: 'workingDirectory is empty' };\n    }\n    const wdNorm = normalizeWorkingDirectoryInput(incoming);\n    switch (wdNorm.ok) {\n      case true: {\n        if (existingRaw) {\n          const prev = normalizeWorkingDirectoryInput(existingRaw);\n          if (prev.ok && prev.path === wdNorm.path) {\n            return { ok: true };\n          }\n        }\n        await mkdir(wdNorm.path, { recursive: true });\n        await this.opts.sessionConfigStore.update(sessionKey, {\n          workingDirectoryOverride: wdNorm.path,\n        });\n        this.opts.agentManager.setSessionWorkspaceOverride(sessionKey, wdNorm.path);\n        this.opts.agentManager.removeAgent(sessionKey);\n        return { ok: true };\n      }\n      case false:\n        return { ok: false, error: wdNorm.error };\n      default:\n        return { ok: false, error: 'Invalid working directory' };\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/session/session-inspector.d.ts

@@ -20,7 +20,7 @@ import type { SessionStore } from '../../session/store.js';
 import type { CompactionResult } from '../memory/compaction.js';
 import type { ModelManager } from '../models/index.js';
 import type { AgentInstanceGateway } from '../agent-instance-gateway.js';
-import type { ReasoningLevel } from '../transcript/thinking-types.js';
+import type { ReasoningLevel, VerboseLevel } from '../transcript/thinking-types.js';
 import type { SessionHydrator } from './session-hydrator.js';
 export interface SessionInspectorOptions {
     sessionStore: SessionStore;
@@ -45,6 +45,7 @@ export interface SessionAgentConfigView {
     thinkingLevel: ThinkingLevel;
     model: string;
     reasoningLevel: ReasoningLevel;
+    verboseLevel: VerboseLevel;
     effectiveWorkspacePath: string;
     workingDirectoryLocked: boolean;
 }

package/dist/src/agent/session/session-inspector.js

@@ -1,6 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { resolveVerboseLevel } from "../../session/config-store.js";
 import { resolveEffectiveReasoningLevel, resolveEffectiveThinkingLevel } from "../../session/thinking-resolve.js";
 import { effectiveWorkspacePathForSession } from "../../session/session-workspace.js";
 import "../../session/index.js";
@@ -104,10 +105,13 @@ var SessionInspector = class {
 		const level = await resolveEffectiveThinkingLevel(this.opts.sessionConfigStore, sessionKey, null, defThink);
 		const defReason = cfg.agents?.defaults?.reasoningDefault ?? "stream";
 		const reasoningLevel = await resolveEffectiveReasoningLevel(this.opts.sessionConfigStore, sessionKey, defReason);
+		const defVerbose = cfg.agents?.defaults?.verboseDefault ?? "full";
+		const verboseLevel = await resolveVerboseLevel(this.opts.sessionConfigStore, sessionKey, defVerbose);
 		return {
 			thinkingLevel: level,
 			model: this.opts.modelManager.getModelForSession(sessionKey),
 			reasoningLevel,
+			verboseLevel,
 			effectiveWorkspacePath: effectiveWorkspacePathForSession(cfg, sessionKey, sc),
 			workingDirectoryLocked: Boolean(sc?.workingDirectoryOverride?.trim())
 		};

package/dist/src/agent/session/session-inspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-inspector.js","names":[],"sources":["../../../../src/agent/session/session-inspector.ts"],"sourcesContent":["/**\n * SessionInspector — read-only / introspection-oriented operations on a session.\n *\n * Owns the five methods previously scattered across `AgentService` that all\n * compute a \"summary view\" of one session:\n *   - `compact` (manual user-triggered compaction)\n *   - `btwQuery` (one-shot LLM answer with transcript as background)\n *   - `report` (Markdown / JSON `/context` summary)\n *   - `agentConfig` (resolved thinking + model + workspace for the Web UI)\n *   - `contextUsage` (rough token budget vs estimated transcript)\n *\n * The shared helper `computeStats` keeps the three callsites that need\n * `getWindowStats` / `getCompactionStats` / `estimateTokenUsage` in lockstep.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport {\n  effectiveWorkspacePathForSession,\n  resolveEffectiveReasoningLevel,\n  resolveEffectiveThinkingLevel,\n  type SessionConfigStore,\n} from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport { runBtwQuery } from '../service/btw-query.js';\nimport { formatSessionContextReport } from '../service/session-context-report.js';\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SessionHydrator } from './session-hydrator.js';\n\nconst log = createLogger('SessionInspector');\n\nexport interface SessionInspectorOptions {\n  sessionStore: SessionStore;\n  sessionConfigStore: SessionConfigStore;\n  modelManager: ModelManager;\n  agentManager: AgentInstanceGateway;\n  sessionHydrator: SessionHydrator;\n  /** Effective config snapshot accessor (honours runtime overrides). */\n  getConfig: () => Config | undefined;\n  /**\n   * Nominal context window the session is budgeted against. Currently derived\n   * from `agents.defaults.maxTokens * 4`, defaulting to 128k.\n   */\n  getContextWindow: () => number;\n}\n\nexport interface SessionContextUsage {\n  estimatedTokens: number;\n  contextWindow: number;\n  usagePercent: number | null;\n}\n\nexport interface SessionAgentConfigView {\n  thinkingLevel: ThinkingLevel;\n  model: string;\n  reasoningLevel: ReasoningLevel;\n  effectiveWorkspacePath: string;\n  workingDirectoryLocked: boolean;\n}\n\nexport class SessionInspector {\n  private readonly opts: SessionInspectorOptions;\n\n  constructor(opts: SessionInspectorOptions) {\n    this.opts = opts;\n  }\n\n  /**\n   * Manual compaction triggered by a user / API. Always forces a compaction\n   * pass (`force: true` by default) and evicts the in-memory agent so the\n   * next turn reloads from the compacted transcript.\n   */\n  async compact(\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const contextWindow = this.opts.getContextWindow();\n    const result = await this.opts.sessionStore.compact(\n      sessionKey,\n      messages,\n      contextWindow,\n      options?.instructions,\n      options?.force ?? true,\n    );\n    if (result.compacted) {\n      this.opts.agentManager.removeAgent(sessionKey);\n    }\n    log.info({ sessionKey, result }, 'Manual compaction complete');\n    return result;\n  }\n\n  /** One-shot LLM answer for `/btw`: transcript as background, not persisted. */\n  btwQuery(sessionKey: string, question: string): Promise<{ text: string; error?: string }> {\n    return runBtwQuery({\n      sessionKey,\n      question,\n      sessionStore: this.opts.sessionStore,\n      modelForSession: this.opts.modelManager.getModelForSession(sessionKey),\n      log,\n    });\n  }\n\n  /** Cheap stats used by both the report and other callers. */\n  stats(sessionKey: string, messages: AgentMessage[]): {\n    windowStats: ReturnType<SessionStore['getWindowStats']>;\n    compactionStats: ReturnType<SessionStore['getCompactionStats']>;\n    tokenEstimate: ReturnType<SessionStore['estimateTokenUsage']>;\n  } {\n    return {\n      windowStats: this.opts.sessionStore.getWindowStats(messages),\n      compactionStats: this.opts.sessionStore.getCompactionStats(sessionKey),\n      tokenEstimate: this.opts.sessionStore.estimateTokenUsage(sessionKey, messages),\n    };\n  }\n\n  /** Rough context usage for TUI footer (estimated tokens vs nominal budget). */\n  async contextUsage(sessionKey: string): Promise<SessionContextUsage> {\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const contextWindow = this.opts.getContextWindow();\n    const estimatedTokens = await this.opts.sessionStore.estimateTokenUsage(sessionKey, messages);\n    const usagePercent =\n      contextWindow > 0 ? Math.min(100, Math.round((estimatedTokens / contextWindow) * 100)) : null;\n    return { estimatedTokens, contextWindow, usagePercent };\n  }\n\n  /** Markdown or JSON summary for `/context`. */\n  async report(sessionKey: string, mode: 'list' | 'detail' | 'json'): Promise<string> {\n    const cfg = this.opts.getConfig();\n    if (!cfg) {\n      throw new Error('SessionInspector requires a config snapshot to render report');\n    }\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const cw = this.opts.getContextWindow();\n    const computed = this.stats(sessionKey, messages);\n    const model = this.opts.modelManager.getModelForSession(sessionKey);\n    const sc = await this.opts.sessionConfigStore.get(sessionKey);\n    const workspace = effectiveWorkspacePathForSession(cfg, sessionKey, sc);\n    const estTokens = await this.opts.sessionStore.estimateTokenUsage(sessionKey, messages);\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const defaults = cfg.agents?.defaults;\n    const compaction = defaults?.compaction;\n    const tools = defaults?.tools;\n\n    const toolsSummary =\n      tools && typeof tools === 'object'\n        ? Object.entries(tools as Record<string, unknown>)\n            .filter(([, v]) => v === true)\n            .map(([k]) => k)\n            .slice(0, 16)\n            .join(', ') || '(none explicitly true)'\n        : '(see agents.defaults.tools in config)';\n\n    return formatSessionContextReport({\n      sessionKey,\n      mode,\n      model,\n      workspacePath: workspace,\n      agentId: profile.agentId,\n      messageCount: messages.length,\n      contextWindowNominal: cw,\n      estimatedTranscriptTokens: estTokens,\n      thinkingDefault: defaults?.thinkingDefault,\n      reasoningDefault: defaults?.reasoningDefault,\n      verboseDefault: defaults?.verboseDefault,\n      compaction,\n      toolsFlagsSummary: toolsSummary,\n      windowStats: computed.windowStats,\n      compactionRunStats: computed.compactionStats,\n    });\n  }\n\n  /** Resolved thinking / model / workspace for the Web UI. */\n  async agentConfig(sessionKey: string): Promise<SessionAgentConfigView> {\n    await this.opts.sessionHydrator.model(sessionKey);\n    const cfg = this.opts.getConfig();\n    if (!cfg) {\n      throw new Error('SessionInspector requires a config snapshot to resolve agent config');\n    }\n    const sc = await this.opts.sessionConfigStore.get(sessionKey);\n\n    // Ensure model display matches the effective agent profile even before an Agent instance exists.\n    // Otherwise `ModelManager.getModelForSession()` falls back to the global default until the first turn creates the agent.\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const profileModelRef = profile.primaryModelRef?.trim();\n    if (profileModelRef) {\n      this.opts.modelManager.setSessionProfileDefault(sessionKey, profileModelRef);\n    }\n\n    const defThink = cfg.agents?.defaults?.thinkingDefault ?? 'medium';\n    const level = await resolveEffectiveThinkingLevel(this.opts.sessionConfigStore, sessionKey, null, defThink);\n    const defReason = (cfg.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n    const reasoningLevel = await resolveEffectiveReasoningLevel(this.opts.sessionConfigStore, sessionKey, defReason);\n    const model = this.opts.modelManager.getModelForSession(sessionKey);\n    return {\n      thinkingLevel: level,\n      model,\n      reasoningLevel,\n      effectiveWorkspacePath: effectiveWorkspacePathForSession(cfg, sessionKey, sc),\n      workingDirectoryLocked: Boolean(sc?.workingDirectoryOverride?.trim()),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;aAiCqD;AAGrD,MAAM,MAAM,aAAa,mBAAmB;AA+B5C,IAAa,mBAAb,MAA8B;CAC5B;CAEA,YAAY,MAA+B;AACzC,OAAK,OAAO;;;;;;;CAQd,MAAM,QACJ,YACA,SAC2B;EAC3B,MAAM,WAAW,MAAM,KAAK,KAAK,aAAa,KAAK,WAAW;EAC9D,MAAM,gBAAgB,KAAK,KAAK,kBAAkB;EAClD,MAAM,SAAS,MAAM,KAAK,KAAK,aAAa,QAC1C,YACA,UACA,eACA,SAAS,cACT,SAAS,SAAS,KACnB;AACD,MAAI,OAAO,UACT,MAAK,KAAK,aAAa,YAAY,WAAW;AAEhD,MAAI,KAAK;GAAE;GAAY;GAAQ,EAAE,6BAA6B;AAC9D,SAAO;;;CAIT,SAAS,YAAoB,UAA6D;AACxF,SAAO,YAAY;GACjB;GACA;GACA,cAAc,KAAK,KAAK;GACxB,iBAAiB,KAAK,KAAK,aAAa,mBAAmB,WAAW;GACtE;GACD,CAAC;;;CAIJ,MAAM,YAAoB,UAIxB;AACA,SAAO;GACL,aAAa,KAAK,KAAK,aAAa,eAAe,SAAS;GAC5D,iBAAiB,KAAK,KAAK,aAAa,mBAAmB,WAAW;GACtE,eAAe,KAAK,KAAK,aAAa,mBAAmB,YAAY,SAAS;GAC/E;;;CAIH,MAAM,aAAa,YAAkD;EACnE,MAAM,WAAW,MAAM,KAAK,KAAK,aAAa,KAAK,WAAW;EAC9D,MAAM,gBAAgB,KAAK,KAAK,kBAAkB;EAClD,MAAM,kBAAkB,MAAM,KAAK,KAAK,aAAa,mBAAmB,YAAY,SAAS;AAG7F,SAAO;GAAE;GAAiB;GAAe,cADvC,gBAAgB,IAAI,KAAK,IAAI,KAAK,KAAK,MAAO,kBAAkB,gBAAiB,IAAI,CAAC,GAAG;GACpC;;;CAIzD,MAAM,OAAO,YAAoB,MAAmD;EAClF,MAAM,MAAM,KAAK,KAAK,WAAW;AACjC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,+DAA+D;EAEjF,MAAM,WAAW,MAAM,KAAK,KAAK,aAAa,KAAK,WAAW;EAC9D,MAAM,KAAK,KAAK,KAAK,kBAAkB;EACvC,MAAM,WAAW,KAAK,MAAM,YAAY,SAAS;EACjD,MAAM,QAAQ,KAAK,KAAK,aAAa,mBAAmB,WAAW;EAEnE,MAAM,YAAY,iCAAiC,KAAK,YAAY,MADnD,KAAK,KAAK,mBAAmB,IAAI,WAAW,CACU;EACvE,MAAM,YAAY,MAAM,KAAK,KAAK,aAAa,mBAAmB,YAAY,SAAS;EACvF,MAAM,UAAU,uCAAuC,KAAK,WAAW;EACvE,MAAM,WAAW,IAAI,QAAQ;EAC7B,MAAM,aAAa,UAAU;EAC7B,MAAM,QAAQ,UAAU;EAExB,MAAM,eACJ,SAAS,OAAO,UAAU,WACtB,OAAO,QAAQ,MAAiC,CAC7C,QAAQ,GAAG,OAAO,MAAM,KAAK,CAC7B,KAAK,CAAC,OAAO,EAAE,CACf,MAAM,GAAG,GAAG,CACZ,KAAK,KAAK,IAAI,2BACjB;AAEN,SAAO,2BAA2B;GAChC;GACA;GACA;GACA,eAAe;GACf,SAAS,QAAQ;GACjB,cAAc,SAAS;GACvB,sBAAsB;GACtB,2BAA2B;GAC3B,iBAAiB,UAAU;GAC3B,kBAAkB,UAAU;GAC5B,gBAAgB,UAAU;GAC1B;GACA,mBAAmB;GACnB,aAAa,SAAS;GACtB,oBAAoB,SAAS;GAC9B,CAAC;;;CAIJ,MAAM,YAAY,YAAqD;AACrE,QAAM,KAAK,KAAK,gBAAgB,MAAM,WAAW;EACjD,MAAM,MAAM,KAAK,KAAK,WAAW;AACjC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,sEAAsE;EAExF,MAAM,KAAK,MAAM,KAAK,KAAK,mBAAmB,IAAI,WAAW;EAK7D,MAAM,kBADU,uCAAuC,KAAK,WAC7B,CAAC,iBAAiB,MAAM;AACvD,MAAI,gBACF,MAAK,KAAK,aAAa,yBAAyB,YAAY,gBAAgB;EAG9E,MAAM,WAAW,IAAI,QAAQ,UAAU,mBAAmB;EAC1D,MAAM,QAAQ,MAAM,8BAA8B,KAAK,KAAK,oBAAoB,YAAY,MAAM,SAAS;EAC3G,MAAM,YAAa,IAAI,QAAQ,UAAU,oBAAoB;EAC7D,MAAM,iBAAiB,MAAM,+BAA+B,KAAK,KAAK,oBAAoB,YAAY,UAAU;AAEhH,SAAO;GACL,eAAe;GACf,OAHY,KAAK,KAAK,aAAa,mBAAmB,WAGjD;GACL;GACA,wBAAwB,iCAAiC,KAAK,YAAY,GAAG;GAC7E,wBAAwB,QAAQ,IAAI,0BAA0B,MAAM,CAAC;GACtE"}
+{"version":3,"file":"session-inspector.js","names":[],"sources":["../../../../src/agent/session/session-inspector.ts"],"sourcesContent":["/**\n * SessionInspector — read-only / introspection-oriented operations on a session.\n *\n * Owns the five methods previously scattered across `AgentService` that all\n * compute a \"summary view\" of one session:\n *   - `compact` (manual user-triggered compaction)\n *   - `btwQuery` (one-shot LLM answer with transcript as background)\n *   - `report` (Markdown / JSON `/context` summary)\n *   - `agentConfig` (resolved thinking + model + workspace for the Web UI)\n *   - `contextUsage` (rough token budget vs estimated transcript)\n *\n * The shared helper `computeStats` keeps the three callsites that need\n * `getWindowStats` / `getCompactionStats` / `estimateTokenUsage` in lockstep.\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\n\nimport type { Config } from '../../config/schema.js';\nimport { resolveEffectiveAgentProfileForSession } from '../../config/agent-profile.js';\nimport {\n  effectiveWorkspacePathForSession,\n  resolveEffectiveReasoningLevel,\n  resolveEffectiveThinkingLevel,\n  resolveVerboseLevel,\n  type SessionConfigStore,\n} from '../../session/index.js';\nimport type { SessionStore } from '../../session/store.js';\nimport type { CompactionResult } from '../memory/compaction.js';\nimport type { ModelManager } from '../models/index.js';\nimport type { AgentInstanceGateway } from '../agent-instance-gateway.js';\nimport { runBtwQuery } from '../service/btw-query.js';\nimport { formatSessionContextReport } from '../service/session-context-report.js';\nimport type { ReasoningLevel, VerboseLevel } from '../transcript/thinking-types.js';\nimport { createLogger } from '../../utils/logger.js';\nimport type { SessionHydrator } from './session-hydrator.js';\n\nconst log = createLogger('SessionInspector');\n\nexport interface SessionInspectorOptions {\n  sessionStore: SessionStore;\n  sessionConfigStore: SessionConfigStore;\n  modelManager: ModelManager;\n  agentManager: AgentInstanceGateway;\n  sessionHydrator: SessionHydrator;\n  /** Effective config snapshot accessor (honours runtime overrides). */\n  getConfig: () => Config | undefined;\n  /**\n   * Nominal context window the session is budgeted against. Currently derived\n   * from `agents.defaults.maxTokens * 4`, defaulting to 128k.\n   */\n  getContextWindow: () => number;\n}\n\nexport interface SessionContextUsage {\n  estimatedTokens: number;\n  contextWindow: number;\n  usagePercent: number | null;\n}\n\nexport interface SessionAgentConfigView {\n  thinkingLevel: ThinkingLevel;\n  model: string;\n  reasoningLevel: ReasoningLevel;\n  verboseLevel: VerboseLevel;\n  effectiveWorkspacePath: string;\n  workingDirectoryLocked: boolean;\n}\n\nexport class SessionInspector {\n  private readonly opts: SessionInspectorOptions;\n\n  constructor(opts: SessionInspectorOptions) {\n    this.opts = opts;\n  }\n\n  /**\n   * Manual compaction triggered by a user / API. Always forces a compaction\n   * pass (`force: true` by default) and evicts the in-memory agent so the\n   * next turn reloads from the compacted transcript.\n   */\n  async compact(\n    sessionKey: string,\n    options?: { instructions?: string; force?: boolean },\n  ): Promise<CompactionResult> {\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const contextWindow = this.opts.getContextWindow();\n    const result = await this.opts.sessionStore.compact(\n      sessionKey,\n      messages,\n      contextWindow,\n      options?.instructions,\n      options?.force ?? true,\n    );\n    if (result.compacted) {\n      this.opts.agentManager.removeAgent(sessionKey);\n    }\n    log.info({ sessionKey, result }, 'Manual compaction complete');\n    return result;\n  }\n\n  /** One-shot LLM answer for `/btw`: transcript as background, not persisted. */\n  btwQuery(sessionKey: string, question: string): Promise<{ text: string; error?: string }> {\n    return runBtwQuery({\n      sessionKey,\n      question,\n      sessionStore: this.opts.sessionStore,\n      modelForSession: this.opts.modelManager.getModelForSession(sessionKey),\n      log,\n    });\n  }\n\n  /** Cheap stats used by both the report and other callers. */\n  stats(sessionKey: string, messages: AgentMessage[]): {\n    windowStats: ReturnType<SessionStore['getWindowStats']>;\n    compactionStats: ReturnType<SessionStore['getCompactionStats']>;\n    tokenEstimate: ReturnType<SessionStore['estimateTokenUsage']>;\n  } {\n    return {\n      windowStats: this.opts.sessionStore.getWindowStats(messages),\n      compactionStats: this.opts.sessionStore.getCompactionStats(sessionKey),\n      tokenEstimate: this.opts.sessionStore.estimateTokenUsage(sessionKey, messages),\n    };\n  }\n\n  /** Rough context usage for TUI footer (estimated tokens vs nominal budget). */\n  async contextUsage(sessionKey: string): Promise<SessionContextUsage> {\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const contextWindow = this.opts.getContextWindow();\n    const estimatedTokens = await this.opts.sessionStore.estimateTokenUsage(sessionKey, messages);\n    const usagePercent =\n      contextWindow > 0 ? Math.min(100, Math.round((estimatedTokens / contextWindow) * 100)) : null;\n    return { estimatedTokens, contextWindow, usagePercent };\n  }\n\n  /** Markdown or JSON summary for `/context`. */\n  async report(sessionKey: string, mode: 'list' | 'detail' | 'json'): Promise<string> {\n    const cfg = this.opts.getConfig();\n    if (!cfg) {\n      throw new Error('SessionInspector requires a config snapshot to render report');\n    }\n    const messages = await this.opts.sessionStore.load(sessionKey);\n    const cw = this.opts.getContextWindow();\n    const computed = this.stats(sessionKey, messages);\n    const model = this.opts.modelManager.getModelForSession(sessionKey);\n    const sc = await this.opts.sessionConfigStore.get(sessionKey);\n    const workspace = effectiveWorkspacePathForSession(cfg, sessionKey, sc);\n    const estTokens = await this.opts.sessionStore.estimateTokenUsage(sessionKey, messages);\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const defaults = cfg.agents?.defaults;\n    const compaction = defaults?.compaction;\n    const tools = defaults?.tools;\n\n    const toolsSummary =\n      tools && typeof tools === 'object'\n        ? Object.entries(tools as Record<string, unknown>)\n            .filter(([, v]) => v === true)\n            .map(([k]) => k)\n            .slice(0, 16)\n            .join(', ') || '(none explicitly true)'\n        : '(see agents.defaults.tools in config)';\n\n    return formatSessionContextReport({\n      sessionKey,\n      mode,\n      model,\n      workspacePath: workspace,\n      agentId: profile.agentId,\n      messageCount: messages.length,\n      contextWindowNominal: cw,\n      estimatedTranscriptTokens: estTokens,\n      thinkingDefault: defaults?.thinkingDefault,\n      reasoningDefault: defaults?.reasoningDefault,\n      verboseDefault: defaults?.verboseDefault,\n      compaction,\n      toolsFlagsSummary: toolsSummary,\n      windowStats: computed.windowStats,\n      compactionRunStats: computed.compactionStats,\n    });\n  }\n\n  /** Resolved thinking / model / workspace for the Web UI. */\n  async agentConfig(sessionKey: string): Promise<SessionAgentConfigView> {\n    await this.opts.sessionHydrator.model(sessionKey);\n    const cfg = this.opts.getConfig();\n    if (!cfg) {\n      throw new Error('SessionInspector requires a config snapshot to resolve agent config');\n    }\n    const sc = await this.opts.sessionConfigStore.get(sessionKey);\n\n    // Ensure model display matches the effective agent profile even before an Agent instance exists.\n    // Otherwise `ModelManager.getModelForSession()` falls back to the global default until the first turn creates the agent.\n    const profile = resolveEffectiveAgentProfileForSession(cfg, sessionKey);\n    const profileModelRef = profile.primaryModelRef?.trim();\n    if (profileModelRef) {\n      this.opts.modelManager.setSessionProfileDefault(sessionKey, profileModelRef);\n    }\n\n    const defThink = cfg.agents?.defaults?.thinkingDefault ?? 'medium';\n    const level = await resolveEffectiveThinkingLevel(this.opts.sessionConfigStore, sessionKey, null, defThink);\n    const defReason = (cfg.agents?.defaults?.reasoningDefault ?? 'stream') as ReasoningLevel;\n    const reasoningLevel = await resolveEffectiveReasoningLevel(this.opts.sessionConfigStore, sessionKey, defReason);\n    const defVerbose = (cfg.agents?.defaults?.verboseDefault ?? 'full') as VerboseLevel;\n    const verboseLevel = await resolveVerboseLevel(this.opts.sessionConfigStore, sessionKey, defVerbose);\n    const model = this.opts.modelManager.getModelForSession(sessionKey);\n    return {\n      thinkingLevel: level,\n      model,\n      reasoningLevel,\n      verboseLevel,\n      effectiveWorkspacePath: effectiveWorkspacePathForSession(cfg, sessionKey, sc),\n      workingDirectoryLocked: Boolean(sc?.workingDirectoryOverride?.trim()),\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/config.js

@@ -1,8 +1,7 @@
-import { __toCommonJS } from "../../../_virtual/_rolldown/runtime.js";
 import { init_write_file_atomic, writeTextAtomicSync } from "../../infra/write-file-atomic.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { init_installer, installer_exports } from "./installer.js";
+import { hasBinary } from "./installer.js";
 import { join } from "path";
 import { existsSync, readFileSync } from "fs";
 //#region src/agent/skills/config.ts
@@ -148,7 +147,6 @@ function isSkillEnabled(skill, skillsConfig) {
 	if (resolveSkillConfig(skill, skillsConfig).enabled === false) return false;
 	const requires = skill.metadata.xopc?.requires || skill.metadata.requires;
 	if (requires?.bins) {
-		const { hasBinary } = (init_installer(), __toCommonJS(installer_exports));
 		for (const bin of requires.bins) if (!hasBinary(bin)) {
 			log.debug({
 				skill: skill.name,

package/dist/src/agent/skills/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../src/agent/skills/config.ts"],"sourcesContent":["/**\n * Skill Configuration Manager\n * \n * Handles skill-specific configuration and environment variables.\n *\n */\n\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { writeTextAtomicSync } from '../../infra/write-file-atomic.js';\nimport type { SkillConfig, SkillsConfig, Skill } from './types.js';\n\nconst log = createLogger('SkillConfig');\n\n/**\n * Resolve skill configuration from multiple sources\n * \n * Priority (highest to lowest):\n * 1. Environment variable overrides (XOPC_SKILL_<NAME>_<KEY>)\n * 2. Config file entries\n * 3. Skill defaults\n */\nexport function resolveSkillConfig(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): SkillConfig {\n  const config: SkillConfig = {};\n\n  // Start with config file entries\n  const entryConfig = skillsConfig?.entries?.[skill.name];\n  if (entryConfig) {\n    config.enabled = entryConfig.enabled;\n    config.apiKey = entryConfig.apiKey;\n    config.env = entryConfig.env ? { ...entryConfig.env } : undefined;\n    config.config = entryConfig.config ? { ...entryConfig.config } : undefined;\n  }\n\n  // Apply environment variable overrides\n  const envPrefix = `XOPC_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;\n  \n  // Check for enabled override\n  const enabledEnv = process.env[`${envPrefix}_ENABLED`];\n  if (enabledEnv !== undefined) {\n    config.enabled = enabledEnv.toLowerCase() === 'true' || enabledEnv === '1';\n  }\n\n  // Check for API key override\n  const apiKeyEnv = process.env[`${envPrefix}_API_KEY`];\n  if (apiKeyEnv) {\n    config.apiKey = apiKeyEnv;\n  }\n\n  // Check for environment variable overrides\n  for (const [key, value] of Object.entries(process.env)) {\n    if (key.startsWith(`${envPrefix}_ENV_`)) {\n      const envKey = key.slice(`${envPrefix}_ENV_`.length);\n      if (!config.env) {\n        config.env = {};\n      }\n      config.env[envKey] = value;\n    }\n  }\n\n  return config;\n}\n\n/**\n * Apply environment variable overrides to a skill's environment\n */\nexport function applySkillEnvOverrides(\n  skill: Skill,\n  baseEnv: Record<string, string> = {},\n  skillConfig?: SkillConfig\n): Record<string, string> {\n  const env: Record<string, string> = { ...baseEnv };\n\n  // Apply config env\n  if (skillConfig?.env) {\n    for (const [key, value] of Object.entries(skillConfig.env)) {\n      env[key] = value;\n    }\n  }\n\n  // Apply environment variable overrides\n  const envPrefix = `XOPC_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;\n  for (const [key, value] of Object.entries(process.env)) {\n    if (key.startsWith(`${envPrefix}_ENV_`)) {\n      const envKey = key.slice(`${envPrefix}_ENV_`.length);\n      env[envKey] = value;\n    }\n  }\n\n  return env;\n}\n\n/**\n * Get the effective environment for a skill\n */\nexport function getSkillEnvironment(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): Record<string, string> {\n  const config = resolveSkillConfig(skill, skillsConfig);\n  return applySkillEnvOverrides(skill, process.env as Record<string, string>, config);\n}\n\n/**\n * Skill configuration file manager\n */\nexport interface SkillConfigFile {\n  /** Path to the config file */\n  configPath: string;\n  /** Load configuration */\n  load: () => SkillsConfig;\n  /** Save configuration */\n  save: (config: SkillsConfig) => void;\n  /** Get skill-specific config */\n  getSkillConfig: (skillName: string) => SkillConfig | undefined;\n  /** Update skill configuration */\n  updateSkillConfig: (skillName: string, config: Partial<SkillConfig>) => void;\n  /** Enable/disable a skill */\n  setSkillEnabled: (skillName: string, enabled: boolean) => void;\n  /** Set skill API key */\n  setSkillApiKey: (skillName: string, apiKey: string) => void;\n}\n\n/**\n * Create a skill configuration file manager\n */\nexport function createSkillConfigManager(configDir: string): SkillConfigFile {\n  const configPath = join(configDir, 'skills.json');\n\n  function loadConfig(): SkillsConfig {\n    if (!existsSync(configPath)) {\n      return {};\n    }\n\n    try {\n      const content = readFileSync(configPath, 'utf-8');\n      return JSON.parse(content);\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ error: err, errorMessage: em, path: configPath }, `Skills config load failed, using defaults: ${em}`);\n      return {};\n    }\n  }\n\n  function saveConfig(config: SkillsConfig): void {\n    try {\n      writeTextAtomicSync(configPath, JSON.stringify(config, null, 2));\n      log.info('Saved skills config');\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ error: err, errorMessage: em, path: configPath }, `Failed to save skills config: ${em}`);\n    }\n  }\n\n  return {\n    configPath,\n\n    load: loadConfig,\n\n    save: saveConfig,\n\n    getSkillConfig: (skillName: string) => {\n      const config = loadConfig();\n      return config.entries?.[skillName];\n    },\n\n    updateSkillConfig: (skillName: string, updates: Partial<SkillConfig>) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        ...updates,\n      };\n\n      saveConfig(config);\n    },\n\n    setSkillEnabled: (skillName: string, enabled: boolean) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        enabled,\n      };\n\n      saveConfig(config);\n      log.info({ skillName, enabled }, 'Updated skill enabled state');\n    },\n\n    setSkillApiKey: (skillName: string, apiKey: string) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        apiKey,\n      };\n\n      saveConfig(config);\n      log.info({ skillName }, 'Updated skill API key');\n    },\n  };\n}\n\n/**\n * Check if a skill is enabled\n */\nexport function isSkillEnabled(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): boolean {\n  const config = resolveSkillConfig(skill, skillsConfig);\n  \n  // Explicitly disabled\n  if (config.enabled === false) {\n    return false;\n  }\n\n  // Check if skill has requirements that are not met\n  const requires = skill.metadata.xopc?.requires || skill.metadata.requires;\n  if (requires?.bins) {\n    const { hasBinary } = require('./installer.js');\n    for (const bin of requires.bins) {\n      if (!hasBinary(bin)) {\n        log.debug({ skill: skill.name, bin }, 'Skill requirement not met');\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Validate skill configuration\n */\nexport function validateSkillConfig(config: SkillsConfig): {\n  valid: boolean;\n  errors: string[];\n} {\n  const errors: string[] = [];\n\n  if (config.toolGating !== undefined && typeof config.toolGating !== 'boolean') {\n    errors.push('toolGating must be a boolean');\n  }\n\n  if (\n    config.agentWritePolicy !== undefined &&\n    config.agentWritePolicy !== 'global' &&\n    config.agentWritePolicy !== 'workspace' &&\n    config.agentWritePolicy !== 'both'\n  ) {\n    errors.push('agentWritePolicy must be \"global\", \"workspace\", or \"both\"');\n  }\n\n  // Validate limits\n  const limits = config.limits;\n  if (limits) {\n    if (limits.maxCandidatesPerRoot !== undefined && limits.maxCandidatesPerRoot < 1) {\n      errors.push('limits.maxCandidatesPerRoot must be at least 1');\n    }\n    if (limits.maxSkillsLoadedPerSource !== undefined && limits.maxSkillsLoadedPerSource < 1) {\n      errors.push('limits.maxSkillsLoadedPerSource must be at least 1');\n    }\n    if (limits.maxSkillsInPrompt !== undefined && limits.maxSkillsInPrompt < 1) {\n      errors.push('limits.maxSkillsInPrompt must be at least 1');\n    }\n  }\n\n  // Validate entries\n  if (config.entries) {\n    for (const [skillName, skillConfig] of Object.entries(config.entries)) {\n      if (skillConfig.apiKey && typeof skillConfig.apiKey !== 'string') {\n        errors.push(`entries.${skillName}.apiKey must be a string`);\n      }\n      if (skillConfig.env && typeof skillConfig.env !== 'object') {\n        errors.push(`entries.${skillName}.env must be an object`);\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/agent/skills/config.ts"],"sourcesContent":["/**\n * Skill Configuration Manager\n * \n * Handles skill-specific configuration and environment variables.\n *\n */\n\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { writeTextAtomicSync } from '../../infra/write-file-atomic.js';\nimport { hasBinary } from './installer.js';\nimport type { SkillConfig, SkillsConfig, Skill } from './types.js';\n\nconst log = createLogger('SkillConfig');\n\n/**\n * Resolve skill configuration from multiple sources\n * \n * Priority (highest to lowest):\n * 1. Environment variable overrides (XOPC_SKILL_<NAME>_<KEY>)\n * 2. Config file entries\n * 3. Skill defaults\n */\nexport function resolveSkillConfig(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): SkillConfig {\n  const config: SkillConfig = {};\n\n  // Start with config file entries\n  const entryConfig = skillsConfig?.entries?.[skill.name];\n  if (entryConfig) {\n    config.enabled = entryConfig.enabled;\n    config.apiKey = entryConfig.apiKey;\n    config.env = entryConfig.env ? { ...entryConfig.env } : undefined;\n    config.config = entryConfig.config ? { ...entryConfig.config } : undefined;\n  }\n\n  // Apply environment variable overrides\n  const envPrefix = `XOPC_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;\n  \n  // Check for enabled override\n  const enabledEnv = process.env[`${envPrefix}_ENABLED`];\n  if (enabledEnv !== undefined) {\n    config.enabled = enabledEnv.toLowerCase() === 'true' || enabledEnv === '1';\n  }\n\n  // Check for API key override\n  const apiKeyEnv = process.env[`${envPrefix}_API_KEY`];\n  if (apiKeyEnv) {\n    config.apiKey = apiKeyEnv;\n  }\n\n  // Check for environment variable overrides\n  for (const [key, value] of Object.entries(process.env)) {\n    if (key.startsWith(`${envPrefix}_ENV_`)) {\n      const envKey = key.slice(`${envPrefix}_ENV_`.length);\n      if (!config.env) {\n        config.env = {};\n      }\n      config.env[envKey] = value;\n    }\n  }\n\n  return config;\n}\n\n/**\n * Apply environment variable overrides to a skill's environment\n */\nexport function applySkillEnvOverrides(\n  skill: Skill,\n  baseEnv: Record<string, string> = {},\n  skillConfig?: SkillConfig\n): Record<string, string> {\n  const env: Record<string, string> = { ...baseEnv };\n\n  // Apply config env\n  if (skillConfig?.env) {\n    for (const [key, value] of Object.entries(skillConfig.env)) {\n      env[key] = value;\n    }\n  }\n\n  // Apply environment variable overrides\n  const envPrefix = `XOPC_SKILL_${skill.name.toUpperCase().replace(/-/g, '_')}`;\n  for (const [key, value] of Object.entries(process.env)) {\n    if (key.startsWith(`${envPrefix}_ENV_`)) {\n      const envKey = key.slice(`${envPrefix}_ENV_`.length);\n      env[envKey] = value;\n    }\n  }\n\n  return env;\n}\n\n/**\n * Get the effective environment for a skill\n */\nexport function getSkillEnvironment(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): Record<string, string> {\n  const config = resolveSkillConfig(skill, skillsConfig);\n  return applySkillEnvOverrides(skill, process.env as Record<string, string>, config);\n}\n\n/**\n * Skill configuration file manager\n */\nexport interface SkillConfigFile {\n  /** Path to the config file */\n  configPath: string;\n  /** Load configuration */\n  load: () => SkillsConfig;\n  /** Save configuration */\n  save: (config: SkillsConfig) => void;\n  /** Get skill-specific config */\n  getSkillConfig: (skillName: string) => SkillConfig | undefined;\n  /** Update skill configuration */\n  updateSkillConfig: (skillName: string, config: Partial<SkillConfig>) => void;\n  /** Enable/disable a skill */\n  setSkillEnabled: (skillName: string, enabled: boolean) => void;\n  /** Set skill API key */\n  setSkillApiKey: (skillName: string, apiKey: string) => void;\n}\n\n/**\n * Create a skill configuration file manager\n */\nexport function createSkillConfigManager(configDir: string): SkillConfigFile {\n  const configPath = join(configDir, 'skills.json');\n\n  function loadConfig(): SkillsConfig {\n    if (!existsSync(configPath)) {\n      return {};\n    }\n\n    try {\n      const content = readFileSync(configPath, 'utf-8');\n      return JSON.parse(content);\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.warn({ error: err, errorMessage: em, path: configPath }, `Skills config load failed, using defaults: ${em}`);\n      return {};\n    }\n  }\n\n  function saveConfig(config: SkillsConfig): void {\n    try {\n      writeTextAtomicSync(configPath, JSON.stringify(config, null, 2));\n      log.info('Saved skills config');\n    } catch (err) {\n      const em = err instanceof Error ? err.message : String(err);\n      log.error({ error: err, errorMessage: em, path: configPath }, `Failed to save skills config: ${em}`);\n    }\n  }\n\n  return {\n    configPath,\n\n    load: loadConfig,\n\n    save: saveConfig,\n\n    getSkillConfig: (skillName: string) => {\n      const config = loadConfig();\n      return config.entries?.[skillName];\n    },\n\n    updateSkillConfig: (skillName: string, updates: Partial<SkillConfig>) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        ...updates,\n      };\n\n      saveConfig(config);\n    },\n\n    setSkillEnabled: (skillName: string, enabled: boolean) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        enabled,\n      };\n\n      saveConfig(config);\n      log.info({ skillName, enabled }, 'Updated skill enabled state');\n    },\n\n    setSkillApiKey: (skillName: string, apiKey: string) => {\n      const config = loadConfig();\n      \n      if (!config.entries) {\n        config.entries = {};\n      }\n\n      const existing = config.entries[skillName] || {};\n      config.entries[skillName] = {\n        ...existing,\n        apiKey,\n      };\n\n      saveConfig(config);\n      log.info({ skillName }, 'Updated skill API key');\n    },\n  };\n}\n\n/**\n * Check if a skill is enabled\n */\nexport function isSkillEnabled(\n  skill: Skill,\n  skillsConfig?: SkillsConfig\n): boolean {\n  const config = resolveSkillConfig(skill, skillsConfig);\n  \n  // Explicitly disabled\n  if (config.enabled === false) {\n    return false;\n  }\n\n  // Check if skill has requirements that are not met\n  const requires = skill.metadata.xopc?.requires || skill.metadata.requires;\n  if (requires?.bins) {\n    for (const bin of requires.bins) {\n      if (!hasBinary(bin)) {\n        log.debug({ skill: skill.name, bin }, 'Skill requirement not met');\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Validate skill configuration\n */\nexport function validateSkillConfig(config: SkillsConfig): {\n  valid: boolean;\n  errors: string[];\n} {\n  const errors: string[] = [];\n\n  if (config.toolGating !== undefined && typeof config.toolGating !== 'boolean') {\n    errors.push('toolGating must be a boolean');\n  }\n\n  if (\n    config.agentWritePolicy !== undefined &&\n    config.agentWritePolicy !== 'global' &&\n    config.agentWritePolicy !== 'workspace' &&\n    config.agentWritePolicy !== 'both'\n  ) {\n    errors.push('agentWritePolicy must be \"global\", \"workspace\", or \"both\"');\n  }\n\n  // Validate limits\n  const limits = config.limits;\n  if (limits) {\n    if (limits.maxCandidatesPerRoot !== undefined && limits.maxCandidatesPerRoot < 1) {\n      errors.push('limits.maxCandidatesPerRoot must be at least 1');\n    }\n    if (limits.maxSkillsLoadedPerSource !== undefined && limits.maxSkillsLoadedPerSource < 1) {\n      errors.push('limits.maxSkillsLoadedPerSource must be at least 1');\n    }\n    if (limits.maxSkillsInPrompt !== undefined && limits.maxSkillsInPrompt < 1) {\n      errors.push('limits.maxSkillsInPrompt must be at least 1');\n    }\n  }\n\n  // Validate entries\n  if (config.entries) {\n    for (const [skillName, skillConfig] of Object.entries(config.entries)) {\n      if (skillConfig.apiKey && typeof skillConfig.apiKey !== 'string') {\n        errors.push(`entries.${skillName}.apiKey must be a string`);\n      }\n      if (skillConfig.env && typeof skillConfig.env !== 'object') {\n        errors.push(`entries.${skillName}.env must be an object`);\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/format-skills-prompt.d.ts

@@ -4,6 +4,7 @@
 import type { Skill } from './types.js';
 import type { SkillsConfig } from './types.js';
 export interface FormatSkillsForPromptOptions {
+    /** Explicit skill names visible in this context. Omitted means all enabled skills; empty means no visible skills. */
     skillAllowlist?: string[];
     /** When set (including empty array), applies tool gating from skill frontmatter. */
     registeredToolNames?: string[];

package/dist/src/agent/skills/format-skills-prompt.js

@@ -6,10 +6,11 @@ import { skillVisibleForRegisteredTools } from "./skill-tool-gating.js";
 */
 function selectSkillsVisibleInPrompt(skills, skillsConfig, options) {
 	let list = skills;
-	if (options?.skillAllowlist?.length) {
+	if (options?.skillAllowlist !== void 0) {
+		if (options.skillAllowlist.length === 0) return [];
 		const allow = new Set(options.skillAllowlist.map((s) => s.toLowerCase()));
 		list = list.filter((s) => allow.has(s.name.toLowerCase()));
-	} else if (options?.skillAllowlist?.length === 0) return [];
+	}
 	list = list.filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig));
 	if (skillsConfig?.toolGating !== false && options?.registeredToolNames !== void 0) {
 		const at = new Set(options.registeredToolNames);

package/dist/src/agent/skills/format-skills-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-skills-prompt.js","names":[],"sources":["../../../../src/agent/skills/format-skills-prompt.ts"],"sourcesContent":["/**\n * Build `<available_skills>` XML block for the system prompt.\n */\n\nimport { isSkillEnabled } from './config.js';\nimport { skillVisibleForRegisteredTools } from './skill-tool-gating.js';\nimport type { Skill } from './types.js';\nimport type { SkillsConfig } from './types.js';\n\nexport interface FormatSkillsForPromptOptions {\n  skillAllowlist?: string[];\n  /** When set (including empty array), applies tool gating from skill frontmatter. */\n  registeredToolNames?: string[];\n}\n\nexport function selectSkillsVisibleInPrompt(\n  skills: Skill[],\n  skillsConfig?: SkillsConfig,\n  options?: FormatSkillsForPromptOptions,\n): Skill[] {\n  let list = skills;\n\n  if (options?.skillAllowlist?.length) {\n    const allow = new Set(options.skillAllowlist.map((s) => s.toLowerCase()));\n    list = list.filter((s) => allow.has(s.name.toLowerCase()));\n  } else if (options?.skillAllowlist?.length === 0) {\n    return [];\n  }\n\n  list = list.filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig));\n\n  if (skillsConfig?.toolGating !== false && options?.registeredToolNames !== undefined) {\n    const at = new Set(options.registeredToolNames);\n    list = list.filter((s) => skillVisibleForRegisteredTools(s, at));\n  }\n\n  return list;\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\nfunction formatSkillXmlMetadataOnly(skill: Skill): string {\n  const emoji = skill.metadata.emoji || '';\n  const emojiStr = emoji ? `${emoji} ` : '';\n\n  return [\n    '  <skill>',\n    `    <name>${escapeXml(skill.name)}</name>`,\n    `    <description>${emojiStr}${escapeXml(skill.description)}</description>`,\n    '  </skill>',\n  ].join('\\n');\n}\n\nexport function formatSkillsForPrompt(\n  skills: Skill[],\n  skillsConfig?: SkillsConfig,\n  options?: FormatSkillsForPromptOptions,\n): string {\n  const visibleSkills = selectSkillsVisibleInPrompt(skills, skillsConfig, options);\n  if (visibleSkills.length === 0) return '';\n\n  const lines = [\n    '\\n\\n<available_skills>',\n    'Skills are folders of instructions, scripts, and resources.',\n    'Use skills_list to browse; use skill_view(name) for SKILL.md or skill_view(name, path) for references/, templates/, scripts/, or assets/.',\n    '',\n  ];\n\n  for (const skill of visibleSkills) {\n    lines.push(formatSkillXmlMetadataOnly(skill));\n  }\n\n  lines.push('</available_skills>');\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;AAeA,SAAgB,4BACd,QACA,cACA,SACS;CACT,IAAI,OAAO;AAEX,KAAI,SAAS,gBAAgB,QAAQ;EACnC,MAAM,QAAQ,IAAI,IAAI,QAAQ,eAAe,KAAK,MAAM,EAAE,aAAa,CAAC,CAAC;AACzE,SAAO,KAAK,QAAQ,MAAM,MAAM,IAAI,EAAE,KAAK,aAAa,CAAC,CAAC;YACjD,SAAS,gBAAgB,WAAW,EAC7C,QAAO,EAAE;AAGX,QAAO,KAAK,QAAQ,MAAM,CAAC,EAAE,0BAA0B,eAAe,GAAG,aAAa,CAAC;AAEvF,KAAI,cAAc,eAAe,SAAS,SAAS,wBAAwB,KAAA,GAAW;EACpF,MAAM,KAAK,IAAI,IAAI,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,QAAQ,MAAM,+BAA+B,GAAG,GAAG,CAAC;;AAGlE,QAAO;;AAGT,SAAS,UAAU,KAAqB;AACtC,QAAO,IACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS,CACvB,QAAQ,MAAM,SAAS;;AAG5B,SAAS,2BAA2B,OAAsB;CACxD,MAAM,QAAQ,MAAM,SAAS,SAAS;CACtC,MAAM,WAAW,QAAQ,GAAG,MAAM,KAAK;AAEvC,QAAO;EACL;EACA,aAAa,UAAU,MAAM,KAAK,CAAC;EACnC,oBAAoB,WAAW,UAAU,MAAM,YAAY,CAAC;EAC5D;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,sBACd,QACA,cACA,SACQ;CACR,MAAM,gBAAgB,4BAA4B,QAAQ,cAAc,QAAQ;AAChF,KAAI,cAAc,WAAW,EAAG,QAAO;CAEvC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACD;AAED,MAAK,MAAM,SAAS,cAClB,OAAM,KAAK,2BAA2B,MAAM,CAAC;AAG/C,OAAM,KAAK,sBAAsB;AACjC,QAAO,MAAM,KAAK,KAAK"}
+{"version":3,"file":"format-skills-prompt.js","names":[],"sources":["../../../../src/agent/skills/format-skills-prompt.ts"],"sourcesContent":["/**\n * Build `<available_skills>` XML block for the system prompt.\n */\n\nimport { isSkillEnabled } from './config.js';\nimport { skillVisibleForRegisteredTools } from './skill-tool-gating.js';\nimport type { Skill } from './types.js';\nimport type { SkillsConfig } from './types.js';\n\nexport interface FormatSkillsForPromptOptions {\n  /** Explicit skill names visible in this context. Omitted means all enabled skills; empty means no visible skills. */\n  skillAllowlist?: string[];\n  /** When set (including empty array), applies tool gating from skill frontmatter. */\n  registeredToolNames?: string[];\n}\n\nexport function selectSkillsVisibleInPrompt(\n  skills: Skill[],\n  skillsConfig?: SkillsConfig,\n  options?: FormatSkillsForPromptOptions,\n): Skill[] {\n  let list = skills;\n\n  if (options?.skillAllowlist !== undefined) {\n    if (options.skillAllowlist.length === 0) {\n      return [];\n    }\n    const allow = new Set(options.skillAllowlist.map((s) => s.toLowerCase()));\n    list = list.filter((s) => allow.has(s.name.toLowerCase()));\n  }\n\n  list = list.filter((s) => !s.disableModelInvocation && isSkillEnabled(s, skillsConfig));\n\n  if (skillsConfig?.toolGating !== false && options?.registeredToolNames !== undefined) {\n    const at = new Set(options.registeredToolNames);\n    list = list.filter((s) => skillVisibleForRegisteredTools(s, at));\n  }\n\n  return list;\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&apos;');\n}\n\nfunction formatSkillXmlMetadataOnly(skill: Skill): string {\n  const emoji = skill.metadata.emoji || '';\n  const emojiStr = emoji ? `${emoji} ` : '';\n\n  return [\n    '  <skill>',\n    `    <name>${escapeXml(skill.name)}</name>`,\n    `    <description>${emojiStr}${escapeXml(skill.description)}</description>`,\n    '  </skill>',\n  ].join('\\n');\n}\n\nexport function formatSkillsForPrompt(\n  skills: Skill[],\n  skillsConfig?: SkillsConfig,\n  options?: FormatSkillsForPromptOptions,\n): string {\n  const visibleSkills = selectSkillsVisibleInPrompt(skills, skillsConfig, options);\n  if (visibleSkills.length === 0) return '';\n\n  const lines = [\n    '\\n\\n<available_skills>',\n    'Skills are folders of instructions, scripts, and resources.',\n    'Use skills_list to browse; use skill_view(name) for SKILL.md or skill_view(name, path) for references/, templates/, scripts/, or assets/.',\n    '',\n  ];\n\n  for (const skill of visibleSkills) {\n    lines.push(formatSkillXmlMetadataOnly(skill));\n  }\n\n  lines.push('</available_skills>');\n  return lines.join('\\n');\n}\n"],"mappings":";;;;;;AAgBA,SAAgB,4BACd,QACA,cACA,SACS;CACT,IAAI,OAAO;AAEX,KAAI,SAAS,mBAAmB,KAAA,GAAW;AACzC,MAAI,QAAQ,eAAe,WAAW,EACpC,QAAO,EAAE;EAEX,MAAM,QAAQ,IAAI,IAAI,QAAQ,eAAe,KAAK,MAAM,EAAE,aAAa,CAAC,CAAC;AACzE,SAAO,KAAK,QAAQ,MAAM,MAAM,IAAI,EAAE,KAAK,aAAa,CAAC,CAAC;;AAG5D,QAAO,KAAK,QAAQ,MAAM,CAAC,EAAE,0BAA0B,eAAe,GAAG,aAAa,CAAC;AAEvF,KAAI,cAAc,eAAe,SAAS,SAAS,wBAAwB,KAAA,GAAW;EACpF,MAAM,KAAK,IAAI,IAAI,QAAQ,oBAAoB;AAC/C,SAAO,KAAK,QAAQ,MAAM,+BAA+B,GAAG,GAAG,CAAC;;AAGlE,QAAO;;AAGT,SAAS,UAAU,KAAqB;AACtC,QAAO,IACJ,QAAQ,MAAM,QAAQ,CACtB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,OAAO,CACrB,QAAQ,MAAM,SAAS,CACvB,QAAQ,MAAM,SAAS;;AAG5B,SAAS,2BAA2B,OAAsB;CACxD,MAAM,QAAQ,MAAM,SAAS,SAAS;CACtC,MAAM,WAAW,QAAQ,GAAG,MAAM,KAAK;AAEvC,QAAO;EACL;EACA,aAAa,UAAU,MAAM,KAAK,CAAC;EACnC,oBAAoB,WAAW,UAAU,MAAM,YAAY,CAAC;EAC5D;EACD,CAAC,KAAK,KAAK;;AAGd,SAAgB,sBACd,QACA,cACA,SACQ;CACR,MAAM,gBAAgB,4BAA4B,QAAQ,cAAc,QAAQ;AAChF,KAAI,cAAc,WAAW,EAAG,QAAO;CAEvC,MAAM,QAAQ;EACZ;EACA;EACA;EACA;EACD;AAED,MAAK,MAAM,SAAS,cAClB,OAAM,KAAK,2BAA2B,MAAM,CAAC;AAG/C,OAAM,KAAK,sBAAsB;AACjC,QAAO,MAAM,KAAK,KAAK"}

package/dist/src/agent/skills/hub-pull.js

@@ -7,8 +7,8 @@ import { computeSkillTreeHashSync } from "./hub-hash.js";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { basename, join, normalize, resolve, sep } from "node:path";
 import { tmpdir } from "node:os";
-import { fileURLToPath } from "node:url";
 import { execFileSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
 import { fetch } from "undici";
 //#region src/agent/skills/hub-pull.ts
 /**

package/dist/src/agent/skills/index.js

@@ -3,20 +3,19 @@ import { init_logger } from "../../utils/logger.js";
 import { resolveStateDir } from "../../config/paths-state.js";
 import { init_paths } from "../../config/paths.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
-import { findInstallSpec, getDefaultInstallerPreferences, hasBinary, init_installer, installSkill } from "./installer.js";
+import { findInstallSpec, getDefaultInstallerPreferences, hasBinary, installSkill } from "./installer.js";
 import { applySkillEnvOverrides, createSkillConfigManager, getSkillEnvironment, isSkillEnabled, resolveSkillConfig, validateSkillConfig } from "./config.js";
+import { collectSkillInstallWarnings, formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { parseSkillToolConditions } from "./skill-tool-gating.js";
 import { parseRequiredEnvVarNames } from "./required-env-vars.js";
-import { parseSkillMetadata } from "./parse-skill-metadata.js";
-import { collectSkillInstallWarnings, formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { formatSkillsForPrompt } from "./format-skills-prompt.js";
+import { parseSkillMetadata } from "./parse-skill-metadata.js";
 import { SkillTestFramework, SkillTestRunner, formatTestResults, formatTestResultsJson, formatTestResultsTap } from "./test-framework.js";
 import { basename, dirname, join, relative, sep } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
 //#region src/agent/skills/index.ts
 init_paths();
 init_logger();
-init_installer();
 const log = createLogger("SkillLoader");
 const IGNORE_FILES = [
 	".gitignore",
@@ -98,13 +97,27 @@ function discoverSkills(dir, source) {
 	scan(dir, loadIgnoreRules(dir, dir));
 	return skills;
 }
+function deriveDescriptionFromMarkdown(content) {
+	let fallbackHeading = "";
+	for (const rawLine of content.split(/\r?\n/)) {
+		const line = rawLine.trim();
+		if (!line) continue;
+		const heading = line.match(/^#{1,6}\s+(.+)$/);
+		if (heading) {
+			fallbackHeading ||= heading[1]?.trim() ?? "";
+			continue;
+		}
+		return line.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1").replace(/[*_`~]/g, "").trim() || void 0;
+	}
+	return fallbackHeading || void 0;
+}
 function loadSkillFromFile(filePath, source, rootDir) {
 	try {
 		const { frontmatter, content } = parseFrontmatter(readFileSync(filePath, "utf-8"));
 		const skillDir = dirname(filePath);
 		const parentDirName = basename(skillDir);
 		const name = frontmatter.name || parentDirName;
-		const description = frontmatter.description;
+		const description = frontmatter.description?.trim() || deriveDescriptionFromMarkdown(content);
 		if (!description?.trim()) return null;
 		let category;
 		if (rootDir) {
@@ -112,6 +125,8 @@ function loadSkillFromFile(filePath, source, rootDir) {
 			if (segments.length > 1) category = segments[0];
 		}
 		const metadata = parseSkillMetadata(frontmatter);
+		metadata.name ||= name;
+		metadata.description ||= description.trim();
 		const toolConditions = parseSkillToolConditions(frontmatter);
 		const requiredEnvVarNames = parseRequiredEnvVarNames(frontmatter);
 		return {

package/dist/src/agent/skills/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../src/agent/skills/index.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'fs';\nimport { basename, dirname, join, relative, sep } from 'path';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt } from './format-skills-prompt.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillDiagnostic, LoadSkillsResult, SkillConfig, SkillsConfig } from './types.js';\n\nconst log = createLogger('SkillLoader');\n\nconst IGNORE_FILES = ['.gitignore', '.ignore', '.fdignore'];\n\nfunction toPosixPath(p: string): string {\n  return p.split(sep).join('/');\n}\n\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n  if (trimmed.startsWith('#') && !trimmed.startsWith('\\\\#')) return null;\n\n  let pattern = line;\n  let negated = false;\n\n  if (pattern.startsWith('!')) {\n    negated = true;\n    pattern = pattern.slice(1);\n  } else if (pattern.startsWith('\\\\!')) {\n    pattern = pattern.slice(1);\n  }\n\n  if (pattern.startsWith('/')) {\n    pattern = pattern.slice(1);\n  }\n\n  const prefixed = prefix ? `${prefix}${pattern}` : pattern;\n  return negated ? `!${prefixed}` : prefixed;\n}\n\nfunction loadIgnoreRules(dir: string, rootDir: string): Set<string> {\n  const ignoredPaths = new Set<string>();\n  const relativeDir = relative(rootDir, dir);\n  const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : '';\n\n  for (const filename of IGNORE_FILES) {\n    const ignorePath = join(dir, filename);\n    if (!existsSync(ignorePath)) continue;\n\n    try {\n      const content = readFileSync(ignorePath, 'utf-8');\n      for (const line of content.split(/\\r?\\n/)) {\n        const pattern = prefixIgnorePattern(line, prefix);\n        if (pattern) {\n          const fullPattern = pattern.startsWith('!')\n            ? `!${prefix}${pattern.slice(1)}`\n            : `${prefix}${pattern}`;\n          ignoredPaths.add(fullPattern);\n        }\n      }\n    } catch {}\n  }\n\n  return ignoredPaths;\n}\n\nfunction shouldIgnore(path: string, ignoredPaths: Set<string>): boolean {\n  for (const pattern of ignoredPaths) {\n    if (pattern.startsWith('!')) {\n      const positive = pattern.slice(1);\n      if (path === positive || path.startsWith(`${positive}/`)) {\n        return false;\n      }\n    } else {\n      if (path === pattern || path.startsWith(`${pattern}/`)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nfunction discoverSkills(dir: string, source: 'builtin' | 'workspace' | 'global'): Skill[] {\n  const skills: Skill[] = [];\n  if (!existsSync(dir)) return skills;\n\n  function scan(currentDir: string, currentIgnoredPaths: Set<string>) {\n    try {\n      const entries = readdirSync(currentDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n\n        const fullPath = join(currentDir, entry.name);\n        const relPath = toPosixPath(relative(dir, fullPath));\n\n        if (shouldIgnore(relPath, currentIgnoredPaths)) continue;\n\n        if (entry.isDirectory()) {\n          const skillMdPath = join(fullPath, 'SKILL.md');\n          const skillRelPath = `${relPath}/`;\n\n          const subIgnoredPaths = new Set(currentIgnoredPaths);\n          const subIgnoreFile = join(fullPath, '.gitignore');\n          if (existsSync(subIgnoreFile)) {\n            const subRules = loadIgnoreRules(fullPath, dir);\n            for (const rule of subRules) {\n              subIgnoredPaths.add(`${skillRelPath}${rule}`);\n            }\n          }\n\n          if (existsSync(skillMdPath) && !shouldIgnore(skillRelPath, currentIgnoredPaths)) {\n            const skill = loadSkillFromFile(skillMdPath, source, dir);\n            if (skill) skills.push(skill);\n          }\n\n          scan(fullPath, subIgnoredPaths);\n        }\n      }\n    } catch {}\n  }\n\n  scan(dir, loadIgnoreRules(dir, dir));\n  return skills;\n}\n\nfunction loadSkillFromFile(filePath: string, source: 'builtin' | 'workspace' | 'global', rootDir?: string): Skill | null {\n  try {\n    const rawContent = readFileSync(filePath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const skillDir = dirname(filePath);\n    const parentDirName = basename(skillDir);\n\n    const name = (frontmatter.name as string | undefined) || parentDirName;\n    const description = frontmatter.description as string | undefined;\n    if (!description?.trim()) return null;\n\n    // Derive category from directory path: skills/creative/algorithmic-art → 'creative'\n    // Only assign a category when the skill is nested at least two levels below rootDir.\n    let category: string | undefined;\n    if (rootDir) {\n      const relDir = toPosixPath(relative(rootDir, skillDir));\n      const segments = relDir.split('/');\n      if (segments.length > 1) {\n        category = segments[0];\n      }\n    }\n\n    const metadata = parseSkillMetadata(frontmatter);\n    const toolConditions = parseSkillToolConditions(frontmatter);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(frontmatter);\n\n    return {\n      name,\n      description: description.trim(),\n      category,\n      filePath,\n      baseDir: skillDir,\n      source,\n      disableModelInvocation: frontmatter['disable-model-invocation'] === true,\n      metadata,\n      toolConditions,\n      requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n      content,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function loadSkills(options: {\n  workspaceDir?: string;\n  globalDir?: string;\n  builtinDir?: string;\n  extraDirs?: string[];\n}): LoadSkillsResult {\n  const { workspaceDir, builtinDir, extraDirs = [] } = options;\n\n  const skillMap = new Map<string, Skill>();\n  const diagnostics: SkillDiagnostic[] = [];\n\n  if (builtinDir) {\n    for (const skill of discoverSkills(builtinDir, 'builtin')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n          path: skill.filePath,\n        });\n      } else {\n        skillMap.set(skill.name, skill);\n      }\n    }\n  }\n\n  const globalDirs = [\n    options.globalDir,\n    join(resolveStateDir(), 'skills'),\n  ].filter((d): d is string => !!d && existsSync(d));\n\n  for (const dir of globalDirs) {\n    for (const skill of discoverSkills(dir, 'global')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      // Global must win over bundled when names match (Workspace > Global > Bundled).\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  if (workspaceDir) {\n    const workspaceSkills = discoverSkills(join(workspaceDir, 'skills'), 'workspace');\n    for (const skill of workspaceSkills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  // Scan extra directories\n  for (const extraDir of extraDirs) {\n    if (existsSync(extraDir)) {\n      for (const skill of discoverSkills(extraDir, 'global')) {\n        const existing = skillMap.get(skill.name);\n        if (existing) {\n          diagnostics.push({\n            type: 'collision',\n            skillName: skill.name,\n            message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n            path: skill.filePath,\n          });\n        } else {\n          skillMap.set(skill.name, skill);\n        }\n      }\n    }\n  }\n\n  const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n  const merged = Array.from(skillMap.values());\n\n  return {\n    skills: merged,\n    prompt: formatSkillsForPrompt(merged, skillsConfig),\n    diagnostics,\n  };\n}\n\nexport interface SkillLoader {\n  init: (workspace: string, builtin: string | null) => LoadSkillsResult;\n  load: () => LoadSkillsResult;\n  reload: () => LoadSkillsResult;\n  /** Recompute `<available_skills>` from disk-loaded skills and current ~/.xopc/skills.json (no filesystem rescan). */\n  refreshPromptFromConfig: () => void;\n  getSkills: () => Skill[];\n  getPrompt: () => string;\n  getDiagnostics: () => SkillDiagnostic[];\n  getLastLoadTime: () => number;\n  getSkillByName: (name: string) => Skill | undefined;\n  getEnabledSkills: (config?: Record<string, SkillConfig>) => Skill[];\n}\n\nexport function createSkillLoader(): SkillLoader {\n  let cachedSkills: Skill[] = [];\n  let cachedPrompt: string = '';\n  let cachedDiagnostics: SkillDiagnostic[] = [];\n  let lastLoadTime = 0;\n  let workspaceDir: string | undefined;\n  let builtinDir: string | undefined;\n  let extraDirs: string[] = [];\n\n  function updateCache(result: LoadSkillsResult): LoadSkillsResult {\n    cachedSkills = result.skills;\n    cachedPrompt = result.prompt;\n    cachedDiagnostics = result.diagnostics;\n    lastLoadTime = Date.now();\n    return result;\n  }\n\n  return {\n    init: (workspace: string, builtin: string | null) => {\n      workspaceDir = workspace;\n      builtinDir = builtin || undefined;\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    load: () => {\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    reload: () => {\n      log.info('Reloading skills');\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n\n    refreshPromptFromConfig: () => {\n      const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n      cachedPrompt = formatSkillsForPrompt(cachedSkills, skillsConfig);\n      lastLoadTime = Date.now();\n    },\n\n    getSkills: () => cachedSkills,\n    getPrompt: () => cachedPrompt,\n    getDiagnostics: () => cachedDiagnostics,\n    getLastLoadTime: () => lastLoadTime,\n    \n    getSkillByName: (name: string) => {\n      return cachedSkills.find(s => s.name === name);\n    },\n    \n    getEnabledSkills: (entries?: Record<string, SkillConfig>) => {\n      const skillsConfig: SkillsConfig =\n        entries !== undefined ? { entries } : createSkillConfigManager(resolveStateDir()).load();\n      return cachedSkills.filter(\n        (skill) => !skill.disableModelInvocation && isSkillEnabled(skill, skillsConfig),\n      );\n    },\n  };\n}\n\n// `SkillManager` + sibling types removed from this barrel — `skill-manager.ts`\n// imports `createSkillLoader` from THIS file, so re-exporting it back here\n// formed a circular cycle. External callers should import directly from\n// `./skill-manager.js`.\n\n// Re-export types for convenience\nexport type { \n  Skill, \n  SkillMetadata, \n  SkillConfig,\n  SkillInstallSpec,\n  SkillInstallResult,\n  SkillInstallRequest,\n  LoadSkillsResult,\n  // Note: SkillDiagnostic is re-exported from skill-manager.ts above\n  SkillSnapshot,\n} from './types.js';\n\n// Re-export installer\nexport { \n  installSkill, \n  findInstallSpec,\n  hasBinary,\n  getDefaultInstallerPreferences,\n  type InstallerPreferences,\n  type InstallContext,\n} from './installer.js';\n\n// Re-export scanner\nexport {\n  scanSkillDirectory,\n  formatScanSummary,\n  collectSkillInstallWarnings,\n  type ScanSummary,\n  type SecurityFinding,\n  type Severity,\n} from './scanner.js';\n\n// Re-export config manager\nexport {\n  resolveSkillConfig,\n  applySkillEnvOverrides,\n  getSkillEnvironment,\n  createSkillConfigManager,\n  isSkillEnabled,\n  validateSkillConfig,\n  type SkillConfigFile,\n} from './config.js';\n\n// `watcher.ts` re-exports removed — it imports `SkillLoader` from THIS file, so\n// re-exporting back here formed a circular cycle. External callers should\n// import directly from `./watcher.js`.\n\n// Re-export test framework\nexport {\n  SkillTestFramework,\n  SkillTestRunner,\n  formatTestResults,\n  formatTestResultsJson,\n  formatTestResultsTap,\n  type TestResult,\n  type TestStatus,\n  type SkillTestReport,\n  type TestOptions,\n  type TestRunnerOptions,\n} from './test-framework.js';\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/agent/skills/index.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'fs';\nimport { basename, dirname, join, relative, sep } from 'path';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { resolveStateDir } from '../../config/paths.js';\nimport { createLogger } from '../../utils/logger.js';\nimport { createSkillConfigManager, isSkillEnabled } from './config.js';\nimport { formatSkillsForPrompt } from './format-skills-prompt.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillDiagnostic, LoadSkillsResult, SkillConfig, SkillsConfig } from './types.js';\n\nconst log = createLogger('SkillLoader');\n\nconst IGNORE_FILES = ['.gitignore', '.ignore', '.fdignore'];\n\nfunction toPosixPath(p: string): string {\n  return p.split(sep).join('/');\n}\n\nfunction prefixIgnorePattern(line: string, prefix: string): string | null {\n  const trimmed = line.trim();\n  if (!trimmed) return null;\n  if (trimmed.startsWith('#') && !trimmed.startsWith('\\\\#')) return null;\n\n  let pattern = line;\n  let negated = false;\n\n  if (pattern.startsWith('!')) {\n    negated = true;\n    pattern = pattern.slice(1);\n  } else if (pattern.startsWith('\\\\!')) {\n    pattern = pattern.slice(1);\n  }\n\n  if (pattern.startsWith('/')) {\n    pattern = pattern.slice(1);\n  }\n\n  const prefixed = prefix ? `${prefix}${pattern}` : pattern;\n  return negated ? `!${prefixed}` : prefixed;\n}\n\nfunction loadIgnoreRules(dir: string, rootDir: string): Set<string> {\n  const ignoredPaths = new Set<string>();\n  const relativeDir = relative(rootDir, dir);\n  const prefix = relativeDir ? `${toPosixPath(relativeDir)}/` : '';\n\n  for (const filename of IGNORE_FILES) {\n    const ignorePath = join(dir, filename);\n    if (!existsSync(ignorePath)) continue;\n\n    try {\n      const content = readFileSync(ignorePath, 'utf-8');\n      for (const line of content.split(/\\r?\\n/)) {\n        const pattern = prefixIgnorePattern(line, prefix);\n        if (pattern) {\n          const fullPattern = pattern.startsWith('!')\n            ? `!${prefix}${pattern.slice(1)}`\n            : `${prefix}${pattern}`;\n          ignoredPaths.add(fullPattern);\n        }\n      }\n    } catch {}\n  }\n\n  return ignoredPaths;\n}\n\nfunction shouldIgnore(path: string, ignoredPaths: Set<string>): boolean {\n  for (const pattern of ignoredPaths) {\n    if (pattern.startsWith('!')) {\n      const positive = pattern.slice(1);\n      if (path === positive || path.startsWith(`${positive}/`)) {\n        return false;\n      }\n    } else {\n      if (path === pattern || path.startsWith(`${pattern}/`)) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nfunction discoverSkills(dir: string, source: 'builtin' | 'workspace' | 'global'): Skill[] {\n  const skills: Skill[] = [];\n  if (!existsSync(dir)) return skills;\n\n  function scan(currentDir: string, currentIgnoredPaths: Set<string>) {\n    try {\n      const entries = readdirSync(currentDir, { withFileTypes: true });\n\n      for (const entry of entries) {\n        if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n\n        const fullPath = join(currentDir, entry.name);\n        const relPath = toPosixPath(relative(dir, fullPath));\n\n        if (shouldIgnore(relPath, currentIgnoredPaths)) continue;\n\n        if (entry.isDirectory()) {\n          const skillMdPath = join(fullPath, 'SKILL.md');\n          const skillRelPath = `${relPath}/`;\n\n          const subIgnoredPaths = new Set(currentIgnoredPaths);\n          const subIgnoreFile = join(fullPath, '.gitignore');\n          if (existsSync(subIgnoreFile)) {\n            const subRules = loadIgnoreRules(fullPath, dir);\n            for (const rule of subRules) {\n              subIgnoredPaths.add(`${skillRelPath}${rule}`);\n            }\n          }\n\n          if (existsSync(skillMdPath) && !shouldIgnore(skillRelPath, currentIgnoredPaths)) {\n            const skill = loadSkillFromFile(skillMdPath, source, dir);\n            if (skill) skills.push(skill);\n          }\n\n          scan(fullPath, subIgnoredPaths);\n        }\n      }\n    } catch {}\n  }\n\n  scan(dir, loadIgnoreRules(dir, dir));\n  return skills;\n}\n\nfunction deriveDescriptionFromMarkdown(content: string): string | undefined {\n  let fallbackHeading = '';\n\n  for (const rawLine of content.split(/\\r?\\n/)) {\n    const line = rawLine.trim();\n    if (!line) continue;\n\n    const heading = line.match(/^#{1,6}\\s+(.+)$/);\n    if (heading) {\n      fallbackHeading ||= heading[1]?.trim() ?? '';\n      continue;\n    }\n\n    return line\n      .replace(/\\[([^\\]]+)\\]\\([^)]*\\)/g, '$1')\n      .replace(/[*_`~]/g, '')\n      .trim() || undefined;\n  }\n\n  return fallbackHeading || undefined;\n}\n\nfunction loadSkillFromFile(filePath: string, source: 'builtin' | 'workspace' | 'global', rootDir?: string): Skill | null {\n  try {\n    const rawContent = readFileSync(filePath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const skillDir = dirname(filePath);\n    const parentDirName = basename(skillDir);\n\n    const name = (frontmatter.name as string | undefined) || parentDirName;\n    const description =\n      (frontmatter.description as string | undefined)?.trim() || deriveDescriptionFromMarkdown(content);\n    if (!description?.trim()) return null;\n\n    // Derive category from directory path: skills/creative/algorithmic-art → 'creative'\n    // Only assign a category when the skill is nested at least two levels below rootDir.\n    let category: string | undefined;\n    if (rootDir) {\n      const relDir = toPosixPath(relative(rootDir, skillDir));\n      const segments = relDir.split('/');\n      if (segments.length > 1) {\n        category = segments[0];\n      }\n    }\n\n    const metadata = parseSkillMetadata(frontmatter);\n    metadata.name ||= name;\n    metadata.description ||= description.trim();\n    const toolConditions = parseSkillToolConditions(frontmatter);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(frontmatter);\n\n    return {\n      name,\n      description: description.trim(),\n      category,\n      filePath,\n      baseDir: skillDir,\n      source,\n      disableModelInvocation: frontmatter['disable-model-invocation'] === true,\n      metadata,\n      toolConditions,\n      requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n      content,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function loadSkills(options: {\n  workspaceDir?: string;\n  globalDir?: string;\n  builtinDir?: string;\n  extraDirs?: string[];\n}): LoadSkillsResult {\n  const { workspaceDir, builtinDir, extraDirs = [] } = options;\n\n  const skillMap = new Map<string, Skill>();\n  const diagnostics: SkillDiagnostic[] = [];\n\n  if (builtinDir) {\n    for (const skill of discoverSkills(builtinDir, 'builtin')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n          path: skill.filePath,\n        });\n      } else {\n        skillMap.set(skill.name, skill);\n      }\n    }\n  }\n\n  const globalDirs = [\n    options.globalDir,\n    join(resolveStateDir(), 'skills'),\n  ].filter((d): d is string => !!d && existsSync(d));\n\n  for (const dir of globalDirs) {\n    for (const skill of discoverSkills(dir, 'global')) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      // Global must win over bundled when names match (Workspace > Global > Bundled).\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  if (workspaceDir) {\n    const workspaceSkills = discoverSkills(join(workspaceDir, 'skills'), 'workspace');\n    for (const skill of workspaceSkills) {\n      const existing = skillMap.get(skill.name);\n      if (existing) {\n        diagnostics.push({\n          type: 'collision',\n          skillName: skill.name,\n          message: `Skill \"${skill.name}\" collision: ${skill.source} overrides ${existing.source}`,\n          path: skill.filePath,\n        });\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  // Scan extra directories\n  for (const extraDir of extraDirs) {\n    if (existsSync(extraDir)) {\n      for (const skill of discoverSkills(extraDir, 'global')) {\n        const existing = skillMap.get(skill.name);\n        if (existing) {\n          diagnostics.push({\n            type: 'collision',\n            skillName: skill.name,\n            message: `Skill \"${skill.name}\" collision: ${existing.source} overrides ${skill.source}`,\n            path: skill.filePath,\n          });\n        } else {\n          skillMap.set(skill.name, skill);\n        }\n      }\n    }\n  }\n\n  const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n  const merged = Array.from(skillMap.values());\n\n  return {\n    skills: merged,\n    prompt: formatSkillsForPrompt(merged, skillsConfig),\n    diagnostics,\n  };\n}\n\nexport interface SkillLoader {\n  init: (workspace: string, builtin: string | null) => LoadSkillsResult;\n  load: () => LoadSkillsResult;\n  reload: () => LoadSkillsResult;\n  /** Recompute `<available_skills>` from disk-loaded skills and current ~/.xopc/skills.json (no filesystem rescan). */\n  refreshPromptFromConfig: () => void;\n  getSkills: () => Skill[];\n  getPrompt: () => string;\n  getDiagnostics: () => SkillDiagnostic[];\n  getLastLoadTime: () => number;\n  getSkillByName: (name: string) => Skill | undefined;\n  getEnabledSkills: (config?: Record<string, SkillConfig>) => Skill[];\n}\n\nexport function createSkillLoader(): SkillLoader {\n  let cachedSkills: Skill[] = [];\n  let cachedPrompt: string = '';\n  let cachedDiagnostics: SkillDiagnostic[] = [];\n  let lastLoadTime = 0;\n  let workspaceDir: string | undefined;\n  let builtinDir: string | undefined;\n  let extraDirs: string[] = [];\n\n  function updateCache(result: LoadSkillsResult): LoadSkillsResult {\n    cachedSkills = result.skills;\n    cachedPrompt = result.prompt;\n    cachedDiagnostics = result.diagnostics;\n    lastLoadTime = Date.now();\n    return result;\n  }\n\n  return {\n    init: (workspace: string, builtin: string | null) => {\n      workspaceDir = workspace;\n      builtinDir = builtin || undefined;\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    load: () => {\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n    \n    reload: () => {\n      log.info('Reloading skills');\n      return updateCache(loadSkills({ workspaceDir, builtinDir, extraDirs }));\n    },\n\n    refreshPromptFromConfig: () => {\n      const skillsConfig = createSkillConfigManager(resolveStateDir()).load();\n      cachedPrompt = formatSkillsForPrompt(cachedSkills, skillsConfig);\n      lastLoadTime = Date.now();\n    },\n\n    getSkills: () => cachedSkills,\n    getPrompt: () => cachedPrompt,\n    getDiagnostics: () => cachedDiagnostics,\n    getLastLoadTime: () => lastLoadTime,\n    \n    getSkillByName: (name: string) => {\n      return cachedSkills.find(s => s.name === name);\n    },\n    \n    getEnabledSkills: (entries?: Record<string, SkillConfig>) => {\n      const skillsConfig: SkillsConfig =\n        entries !== undefined ? { entries } : createSkillConfigManager(resolveStateDir()).load();\n      return cachedSkills.filter(\n        (skill) => !skill.disableModelInvocation && isSkillEnabled(skill, skillsConfig),\n      );\n    },\n  };\n}\n\n// `SkillManager` + sibling types removed from this barrel — `skill-manager.ts`\n// imports `createSkillLoader` from THIS file, so re-exporting it back here\n// formed a circular cycle. External callers should import directly from\n// `./skill-manager.js`.\n\n// Re-export types for convenience\nexport type { \n  Skill, \n  SkillMetadata, \n  SkillConfig,\n  SkillInstallSpec,\n  SkillInstallResult,\n  SkillInstallRequest,\n  LoadSkillsResult,\n  // Note: SkillDiagnostic is re-exported from skill-manager.ts above\n  SkillSnapshot,\n} from './types.js';\n\n// Re-export installer\nexport { \n  installSkill, \n  findInstallSpec,\n  hasBinary,\n  getDefaultInstallerPreferences,\n  type InstallerPreferences,\n  type InstallContext,\n} from './installer.js';\n\n// Re-export scanner\nexport {\n  scanSkillDirectory,\n  formatScanSummary,\n  collectSkillInstallWarnings,\n  type ScanSummary,\n  type SecurityFinding,\n  type Severity,\n} from './scanner.js';\n\n// Re-export config manager\nexport {\n  resolveSkillConfig,\n  applySkillEnvOverrides,\n  getSkillEnvironment,\n  createSkillConfigManager,\n  isSkillEnabled,\n  validateSkillConfig,\n  type SkillConfigFile,\n} from './config.js';\n\n// `watcher.ts` re-exports removed — it imports `SkillLoader` from THIS file, so\n// re-exporting back here formed a circular cycle. External callers should\n// import directly from `./watcher.js`.\n\n// Re-export test framework\nexport {\n  SkillTestFramework,\n  SkillTestRunner,\n  formatTestResults,\n  formatTestResultsJson,\n  formatTestResultsTap,\n  type TestResult,\n  type TestStatus,\n  type SkillTestReport,\n  type TestOptions,\n  type TestRunnerOptions,\n} from './test-framework.js';\n"],"mappings":"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"}

package/dist/src/agent/skills/installer.js

@@ -1,8 +1,7 @@
-import { __esmMin, __exportAll, __require } from "../../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { join } from "path";
-import { existsSync } from "fs";
+import { delimiter, join } from "path";
+import { accessSync, constants, existsSync } from "fs";
 import { promisify } from "util";
 import { exec } from "child_process";
 //#region src/agent/skills/installer.ts
@@ -12,29 +11,24 @@ import { exec } from "child_process";
 * Handles installation of skill dependencies via various package managers.
 *
 */
-var installer_exports = /* @__PURE__ */ __exportAll({
-	findInstallSpec: () => findInstallSpec,
-	getDefaultInstallerPreferences: () => getDefaultInstallerPreferences,
-	hasBinary: () => hasBinary,
-	installSkill: () => installSkill,
-	resolveBrewExecutable: () => resolveBrewExecutable
-});
+init_logger();
+const execAsync = promisify(exec);
+const log = createLogger("SkillInstaller");
 /**
 * Check if a binary exists
 */
 function hasBinary(name) {
-	try {
-		const { which } = __require("which");
-		return !!which.sync(name, { nothrow: true });
-	} catch {
+	if (!name || name.includes("/") || name.includes("\\")) return false;
+	const pathEntries = (process.env.PATH || "").split(delimiter).filter(Boolean);
+	const extensions = process.platform === "win32" ? (process.env.PATHEXT || ".EXE;.CMD;.BAT;.COM").split(";").filter(Boolean) : [""];
+	for (const dir of pathEntries) for (const ext of extensions) {
+		const candidate = join(dir, `${name}${ext}`);
 		try {
-			const { execSync } = __require("child_process");
-			execSync(`which ${name}`, { stdio: "ignore" });
+			accessSync(candidate, constants.X_OK);
 			return true;
-		} catch {
-			return false;
-		}
+		} catch {}
 	}
+	return false;
 }
 /**
 * Resolve brew executable path
@@ -347,14 +341,7 @@ function getDefaultInstallerPreferences() {
 		nodeManager: "pnpm"
 	};
 }
-var execAsync, log;
-var init_installer = __esmMin((() => {
-	init_logger();
-	execAsync = promisify(exec);
-	log = createLogger("SkillInstaller");
-}));
 //#endregion
-init_installer();
-export { findInstallSpec, getDefaultInstallerPreferences, hasBinary, init_installer, installSkill, installer_exports, resolveBrewExecutable };
+export { findInstallSpec, getDefaultInstallerPreferences, hasBinary, installSkill, resolveBrewExecutable };
 
 //# sourceMappingURL=installer.js.map