dsh-pstack 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/host-contract-o47JH_r8.d.mts

@@ -1,527 +0,0 @@
-//#region src/host-contract.d.ts
-/**
- * Structural copies of the `@deepseek-ai/*` 0.2.1-rc.3 declarations this plugin
- * binds to.
- *
- * Runtime modules import nothing from the host packages. A profile install of a
- * workspace directory is a link into this checkout, and the profile's
- * `pnpm-workspace.yaml` sets `autoInstallPeers: false`, so a runtime import of a
- * host package resolves nothing. Restating the contract here keeps that promise
- * and keeps `pnpm typecheck` independent of a machine-local DSH install.
- *
- * This is the only file that restates a host contract for delegation. When DSH
- * changes, re-inspect and update here, then run the delegation tests and the real
- * profile acceptance. Do not grow a second copy in another module.
- *
- * Contract sources (Host Inspect, 0.2.1-rc.3):
- * - `Service.listService({ service: "subagents" })`
- * - `Service.listService({ service: "llm" })`
- * - `Service.listService({ service: "tools" })`
- * - `Service.listService({ service: "agents" })` — `Agent`, `AgentsHost`,
- *   `AgentScope`, and the `agent/request` waterfall below
- * - `Service.listService({ service: "sessionQuery" })`
- *
- * `Agent` is deliberately not minimal. Its `options`, `session.requestHeader()`,
- * and `ctx` are the three seams a child-scoped reasoning-effort control needs, and
- * an `Agent` that stops at `{ id }` cannot express the capability at all. The cost
- * of the wider copy is that every test now has to build a fuller fake; the cost of
- * the narrower one was a documented capability with nowhere to live.
- *
- * Deliberate simplifications, none observable at runtime:
- * - Branded ids (`SessionId`, `MessageId`, `ReasoningEffortId`,
- *   `SessionSeq`, `SessionPersistenceRevision`) are plain `string`/`number`;
- *   the brand is erased and only carried for documentation.
- * - `ContentBlock` names the text variant this plugin emits and leaves the other
- *   variants opaque, because the prompt this tool builds is text only.
- * - `SessionEvent.data` stays `unknown`. Restricted history forwards raw event
- *   payloads unchanged, so naming every event variant here would be a second,
- *   drifting copy of the log format with no reader.
- */
-/**
- * The request header in force after the log's last header event.
- *
- * Only `config` is named, because only `config` is read. `config` is the call
- * configuration the machine would use, i.e. the live route after a model switch,
- * where `Agent.options` describes the creation-time route instead.
- */
-interface RequestEpochHeader {
-  readonly config: LlmCallConfig;
-}
-/** The slice of `Agent.session` used to resolve a live route. */
-interface AgentSession {
-  /** The header in force after the log's last header event; undefined before the first request. */
-  requestHeader(): RequestEpochHeader | undefined;
-}
-/** One `agent/request` waterfall listener. */
-type AgentRequestListener = (payload: {
-  readonly agent: Agent;
-  readonly turn: number;
-  readonly step: number;
-}, next: () => Promise<LlmCallConfig>) => Promise<LlmCallConfig>;
-/**
- * The slice of an agent-scoped context a child-scoped contribution needs.
- *
- * Everything registered here is agent-local: it unwinds on disposal and rejects
- * registration afterward. That is what makes one child's reasoning-effort control
- * invisible to its siblings, and why two concurrent delegations cannot affect each
- * other.
- */
-interface AgentScope {
-  /**
-   * Contribute to the agent-scoped `agent/request` waterfall.
-   *
-   * Dispatch is scope-filtered, so a listener registered on this child's own
-   * context receives only that child's requests. `next()` yields the configuration
-   * the machine would use (agent options on the first request, the logged header
-   * afterwards); returning a replacement switches it. A request already in flight
-   * is never rewritten.
-   *
-   * @returns the disposer, which unwinds with the scope.
-   */
-  on(event: "agent/request", listener: AgentRequestListener): () => void;
-  /** The tool registry, scoped to this agent. */
-  readonly tools: ToolsHost;
-}
-/** The live Agent the tool executes under. */
-interface Agent {
-  readonly id: string;
-  /** The provider route and model this agent's requests use at creation time. */
-  readonly options: AgentOptions;
-  /** The live session this agent drives. */
-  readonly session: AgentSession;
-  /** Agent-scoped context; contributions are agent-local and unwind on disposal. */
-  readonly ctx: AgentScope;
-}
-/**
- * The slice of `ctx.agents` this tool uses to reach a child it has just started.
- *
- * `startActivation` returns the child id and not the child handle, and this tool
- * needs the handle to contribute to the child's own scope.
- */
-interface AgentsHost {
-  /** The live agent with this shared agent/session id, or undefined when none is live. */
-  get(id: string): Agent | undefined;
-}
-/** Adapter-owned child model controls. Omitted fields inherit the parent route. */
-interface AgentOptions {
-  provider?: string;
-  model?: string;
-  reasoningEffort?: string;
-  maxTokens?: number;
-}
-/** One provider/model route plus optional request controls. */
-interface LlmCallConfig {
-  provider: string;
-  model: string;
-  reasoningEffort?: string;
-  temperature?: number;
-  maxTokens?: number;
-  stop?: string[];
-}
-interface LlmProviderInfo {
-  readonly id: string;
-  readonly name: string;
-}
-interface LlmReasoningEffortInfo {
-  readonly id: string;
-  readonly name: string;
-  readonly description?: string;
-}
-interface LlmModelReasoningInfo {
-  readonly efforts: readonly LlmReasoningEffortInfo[];
-  readonly defaultEffort?: string;
-}
-interface LlmModelContext {
-  readonly contextWindow: number;
-}
-/** Detached metadata for one exact route, as the owning adapter reports it. */
-interface LlmResolvedModelInfo {
-  readonly provider: string;
-  readonly id: string;
-  readonly name: string;
-  readonly description?: string;
-  readonly context?: LlmModelContext;
-  readonly reasoning?: LlmModelReasoningInfo;
-}
-/** The slice of `ctx.llm` used to validate a child route before starting it. */
-interface LlmHost {
-  listProviders(): readonly LlmProviderInfo[];
-  resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
-  /**
-   * Validate a call config against the exact model capability and materialize
-   * adapter defaults. An unsupported explicit effort rejects before any provider
-   * I/O; nothing is clamped or aliased.
-   */
-  resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>;
-}
-/** A text content block, the only prompt variant this tool sends. */
-interface TextBlock {
-  readonly type: "text";
-  readonly text: string;
-}
-/** Prompt content; the non-text variants stay opaque here. */
-type ContentBlock = TextBlock | {
-  readonly type: string;
-  readonly [field: string]: unknown;
-};
-/** What one registered backend can enforce, checked before a child starts. */
-interface SubagentCapabilities {
-  readonly agentOptions: boolean;
-  readonly agentPreset: boolean;
-  readonly outputSchema: boolean;
-  readonly depthLimit: boolean;
-}
-/** The registered backend behind a provider name. */
-interface SubagentProvider {
-  readonly name: string;
-  readonly capabilities: SubagentCapabilities;
-  readonly inheritsParentContext: boolean;
-  readonly agentRouteDefaults?: Readonly<{
-    provider: string;
-    model: string;
-  }>;
-}
-/** One child start request, after the activation wrapper supplies label and signal. */
-interface SubagentStartRequest {
-  readonly cwd?: string;
-  readonly agentPreset?: string;
-  readonly label?: string;
-  readonly prompt: ContentBlock[];
-  readonly parent: Agent;
-  readonly signal: AbortSignal;
-  readonly agentOptions?: AgentOptions;
-  readonly outputSchema?: unknown;
-  readonly maxDepth?: number;
-}
-interface SubagentActivationSpec {
-  readonly provider: string;
-  readonly label: string;
-  readonly childId?: string;
-  readonly request: Omit<SubagentStartRequest, "label" | "signal">;
-  readonly signal: AbortSignal;
-  readonly delivery: "parent" | "caller";
-}
-interface SubagentActivation {
-  readonly childId: string;
-  readonly messageId?: string;
-}
-/** The slice of `ctx.subagents` this tool drives. */
-interface SubagentsHost {
-  /** Registered provider names in insertion order. */
-  list(): string[];
-  getProvider(name: string): SubagentProvider | undefined;
-  /**
-   * Resolve this tool's depth policy. A numeric `configured` is returned as-is and
-   * an omitted one reads the Host setting, so the caller owns taking the minimum
-   * against its own cap.
-   */
-  resolveMaxDepth(configured?: number | "provider-managed"): number | undefined;
-  startActivation(spec: SubagentActivationSpec): Promise<SubagentActivation>;
-}
-/**
- * One durable direct-child catalog row.
- *
- * `mode` is the authorization discriminator: only `continuable` children are
- * reviewable. `one-shot` children cannot be resumed, `external` children live in
- * another backend, and `unknown` modes carry no review guarantee.
- */
-type SubagentCatalogEntry = {
-  readonly id: string;
-  readonly createdAt: number;
-} & ({
-  readonly mode: "one-shot";
-  readonly label?: string;
-} | {
-  readonly mode: "external";
-  readonly label?: string;
-} | {
-  readonly mode: "continuable";
-  readonly label: string;
-} | {
-  readonly mode: "unknown";
-  readonly label?: string;
-});
-/**
- * The slice of `ctx.subagents` restricted history reads for authorization.
- *
- * `listChildren` takes a parent session id, not a caller identity, so its result
- * is a naming source and never an authorization boundary on its own. Restricted
- * history pairs it with the observed `header.parentSession`.
- */
-interface SubagentCatalogHost {
-  listChildren(parentSessionId: string, signal?: AbortSignal): Promise<readonly SubagentCatalogEntry[]>;
-}
-/** The last committed log position, or `-1` when the log is empty. */
-type SessionSeqCursor = number;
-/**
- * One raw log event.
- *
- * Only the envelope is named. `data` is forwarded unchanged so an auditor reads
- * the log rather than a projection: this is the reason the tool never returns
- * `deriveMessages()` output in its place.
- */
-interface SessionEvent {
-  readonly type: string;
-  readonly seq: number;
-  readonly time: number;
-  readonly data: unknown;
-  readonly ignorable?: true;
-  readonly surfaceOp?: "append" | {
-    readonly op: "replace";
-    readonly startSeq: number;
-    readonly endSeq: number;
-  };
-  readonly sourceEventSeqs?: readonly number[];
-}
-/** Immutable per-session identity plus its durable delegation position. */
-interface SessionHeader {
-  readonly version: number;
-  readonly id: string;
-  readonly createdAt: number;
-  readonly cwd?: string;
-  readonly parentSession?: string;
-  readonly isSeeded: boolean;
-  readonly origin?: "subagent";
-  readonly delegationDepth?: number;
-  readonly agentPreset?: string;
-}
-/**
- * One caller-owned observation lease.
- *
- * A `live` lease fixes the log position when it is built, so `events` never
- * grows after construction. A `prepared` lease is a detached copy read from
- * persistence; rc.3 appends synthetic interrupted-turn closers to it and marks
- * neither them nor the persisted boundary. `revision` is present only for
- * `prepared`. Both shapes must be released with `[Symbol.dispose]()`.
- */
-interface SessionObservation {
-  readonly source: "live" | "prepared";
-  readonly header: SessionHeader;
-  readonly inheritedEventCount: number;
-  readonly events: readonly SessionEvent[];
-  /** Last seq this snapshot covers; `-1` when the log was empty. */
-  readonly cursor: SessionSeqCursor;
-  /** Persistence revision of a prepared snapshot. Live snapshots omit it. */
-  readonly revision?: string;
-  retain(): SessionObservation;
-  [Symbol.dispose](): void;
-}
-interface SessionObservationOptions {
-  readonly signal?: AbortSignal;
-  readonly projectionMode?: "all" | "none";
-}
-interface SessionRecord {
-  readonly header: SessionHeader;
-  readonly live: boolean;
-  readonly persisted: boolean;
-  readonly formatStatus?: "current" | "migration-required";
-}
-/** Provider-independent session metadata predicate, ANDed with its siblings. */
-type SessionResultFilter = {
-  readonly kind: "id";
-  readonly values: readonly string[];
-} | {
-  readonly kind: "cwd";
-  readonly values: readonly (string | null)[];
-} | {
-  readonly kind: "created-at";
-  readonly from?: number;
-  readonly to?: number;
-} | {
-  readonly kind: "parent";
-  readonly values: readonly (string | null)[];
-} | {
-  readonly kind: "availability";
-  readonly values: readonly ("live" | "persisted")[];
-};
-/**
- * The slice of `ctx.sessionQuery` restricted history reads.
- *
- * `observeSession` is the only raw-event reader used: `listEvents` returns a
- * summary and `readSession` re-reads a detached copy, so neither can page one
- * fixed snapshot. `filterSessions` answers the caller's workspace without
- * materializing its log.
- */
-interface SessionQueryHost {
-  observeSession(sessionId: string, options?: SessionObservationOptions): Promise<SessionObservation>;
-  filterSessions(filters: readonly SessionResultFilter[], signal?: AbortSignal): Promise<readonly SessionRecord[]>;
-}
-type JsonSchemaType = "object" | "array" | "string" | "number" | "integer" | "boolean" | "null";
-/**
- * The JSON Schema subset the Host actually enforces.
- *
- * Exactly `type`/`oneOf`/`properties`/`required`/`additionalProperties`/`items`/
- * `enum`/`const` plus the annotation keys. Nothing else is accepted by
- * `assertSupportedJsonSchema`, and the subset is deliberately narrow here too:
- * `minimum` used to be listed, three tools declared numeric bounds with it, and the
- * Host rejected the whole schema — so `jsonSchemaToTs` and `jsonSchemaToPy` fell back
- * to `"unknown"` and the declared bounds were never enforced. Omitting it from this
- * type makes the same mistake a compile error. Bounds live in each tool's own
- * argument validation and in its `description`.
- */
-interface JsonSchemaNode {
-  type?: JsonSchemaType;
-  oneOf?: JsonSchemaNode[];
-  properties?: Record<string, JsonSchemaNode>;
-  required?: string[];
-  additionalProperties?: boolean;
-  items?: JsonSchemaNode;
-  enum?: readonly (string | number | boolean | null)[];
-  const?: string | number | boolean | null;
-  description?: string;
-  title?: string;
-  default?: unknown;
-}
-/** How one tool's result is projected for the model. */
-interface ToolOutputDefinition {
-  readonly schema: JsonSchemaNode;
-  render(args: unknown, value: unknown): ContentBlock[];
-}
-/** The typed same-process call input the registry supplies to `execute`. */
-interface ToolExecutionInput {
-  readonly name: string;
-  /** Corpus id of this exact call, as written to the `tool/call` event. */
-  readonly callId: string;
-  readonly arguments: unknown;
-  readonly agent?: Agent;
-  readonly signal: AbortSignal;
-}
-/** `exec` inside a tool body. */
-interface ToolRunContext extends ToolExecutionInput {
-  deferContext(context: unknown): void;
-  concludeTurn(): void;
-}
-interface ToolDefinition {
-  name: string;
-  description: string;
-  parameters: Record<string, unknown>;
-  readonly output: ToolOutputDefinition;
-  execute(args: unknown, exec: ToolRunContext): Promise<unknown>;
-  isConcurrencySafe?(args: unknown): boolean;
-  /**
-   * Cooperative tool-call timeout budget in milliseconds; omitted means no deadline.
-   *
-   * Enforced by `@deepseek-ai/dsh-tool-call-timeout-policy`, which wraps
-   * `tools/execute`: it replaces `exec.signal` with a deadline-combined signal for the
-   * duration of the call, and converts the outcome to a timeout when its own timer won.
-   *
-   * The budget covers **only the tool call**, not work the call starts. The wrapper
-   * disposes its timer as soon as `execute` settles, so a background job started by the
-   * call keeps running past the budget — the deadline cannot be used to bound a long
-   * task, and it does not break one either.
-   *
-   * Never sent to the model: `schemas()` whitelists name/description/parameters only.
-   *
-   * Declaring it asserts that the tool forwards `exec.signal` into an implementation
-   * that can reach quiescence when that signal aborts. `pstack_script` does: the
-   * foreground run hands the signal to `spawn`, so an abort kills the child.
-   *
-   * Source: `dsh-tools/lib/types/index.d.ts` (`ToolDefinition.timeoutMs`) in the
-   * installed 0.2.1-rc.3 tree; the npm copy of that file is byte-identical.
-   */
-  timeoutMs?: number;
-}
-/** The slice of `ctx.tools` this tool needs. */
-interface ToolsHost {
-  register(definition: ToolDefinition): () => void;
-}
-/**
- * The slice of `ctx.workingDirectory` a script run needs.
- *
- * `ensure` is the same seam `dsh-tool-bash` uses before it spawns anything
- * (`dsh-tool-bash/lib/index.js:663`): it returns the Session's current directory,
- * creating or restoring it as the Host requires. Reading `process.cwd()` instead
- * would run the script in the Host process's directory — wrong for every Session
- * whose workspace is a checkout or a worktree.
- */
-interface WorkingDirectoryHost {
-  /** The Session's current directory, validated/created as the Host requires. */
-  ensure(agent: Agent, signal?: AbortSignal): Promise<string>;
-}
-/**
- * A registry-issued job id, branded by the Host.
- *
- * Kept as a plain `string` here, like the other branded ids in this file: the brand
- * is erased and only documents that the value is opaque and must not be parsed.
- */
-type JobId = string;
-/**
- * A session id, branded by the Host.
- *
- * Plain `string` for the same reason. A job's `owner` is a session id, so the jobs
- * slice below reuses the name rather than introducing a second spelling.
- */
-type SessionId = string;
-/** The tool call a job was started for. */
-interface JobToolCall {
-  readonly callId: string;
-  readonly rootCallId: string;
-}
-/** One job's lifecycle state. */
-type JobStatus = "running" | "stopping" | "completed" | "killed" | "failed";
-/** One output channel a producer may append to. */
-type JobChannel = "stdout" | "stderr" | "log";
-/** A live handle on a started job. */
-interface JobHandle {
-  readonly id: JobId;
-  append(text: string, options?: {
-    readonly channel?: JobChannel;
-  }): void;
-  updateProgress(line: string): void;
-}
-/** What a producer returns so the registry can cancel it and await its outcome. */
-interface JobHooks {
-  cancel(reason?: string): void;
-  readonly done: Promise<JobOutcome>;
-}
-/** How a job ended, as its producer reports it. */
-interface JobOutcome {
-  readonly status: "completed" | "killed" | "failed";
-  readonly detail?: string;
-  readonly result?: string;
-}
-/** The spec handed to `jobs.start`. */
-interface JobSpec {
-  readonly kind: "bash";
-  readonly label: string;
-  readonly owner?: SessionId;
-  readonly toolCall?: JobToolCall;
-  readonly outputLimitBytes?: number;
-  readonly run: (job: JobHandle) => JobHooks;
-}
-/** A fresh projection of one job. */
-interface JobView {
-  readonly id: JobId;
-  readonly kind: string;
-  readonly label: string;
-  readonly owner?: SessionId;
-  readonly status: JobStatus;
-  readonly progress?: string;
-  readonly detail?: string;
-  readonly startedAt: number;
-  readonly finishedAt?: number;
-  readonly output: {
-    readonly total: number;
-    readonly earliest: number;
-    readonly spillPaths?: readonly string[];
-  };
-}
-/**
- * The slice of `ctx.jobs` a background script run needs.
- *
- * `jobs` is optional in the composition: a profile without a job controller still
- * gets `pstack_script`, and a `background: true` call is then refused with a reason
- * instead of hanging. That is why the access the row uses is `ctx.get("jobs")` —
- * rc.3's optional-service form — and not `ctx.jobs`.
- *
- * Only `start` and `get` are named. `pstack_script` starts one job and reports its
- * id; reading output, waiting, and killing stay with the Host's own job tools, which
- * already own the model cursor and authorization checks.
- */
-interface JobsHost {
-  start(spec: JobSpec): JobId;
-  get(id: JobId, caller?: SessionId): JobView;
-}
-//#endregion
-export { ToolRunContext as _, JobsHost as a, SessionEvent as c, SessionQueryHost as d, SubagentCapabilities as f, ToolDefinition as g, SubagentsHost as h, JobId as i, SessionHeader as l, SubagentCatalogHost as m, AgentOptions as n, JsonSchemaNode as o, SubagentCatalogEntry as p, AgentsHost as r, LlmHost as s, Agent as t, SessionId as u, ToolsHost as v, WorkingDirectoryHost as y };
-//# sourceMappingURL=host-contract-o47JH_r8.d.mts.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/provider.ts","../src/index.ts"],"sourcesContent":["/**\n * The bundled pstack skill provider: one provider over the 55 generated skills\n * that ship inside this package.\n *\n * The provider contract below mirrors `@deepseek-ai/dsh-skill` 0.2.1-rc.3, which\n * was read through the host Inspect provider (`Service.listService` with\n * `service: \"skills\"`) and the installed type declarations. It is restated here\n * as a structural contract instead of imported so the plugin keeps zero runtime\n * imports from the host packages: a workspace-directory bundle is linked from\n * its checkout, where `@deepseek-ai/*` is not resolvable.\n *\n * Design constraints this module enforces, from the port design document §8.1:\n *\n * - The catalog is built once from the package assets and never watched. A\n *   package update is the refresh boundary.\n * - A malformed bundled skill fails the whole index instead of disappearing\n *   from the catalog, so a broken asset is a startup error rather than a skill\n *   users silently cannot see.\n * - `get()` only accepts a locator this provider produced. Directory names are\n *   never joined from caller input.\n */\n\nimport { readFileSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nimport { parseFrontmatter, validateSkillFrontmatter } from \"./frontmatter.ts\";\n\n/**\n * Standard precedence rank for packaged skill providers, re-exported by\n * `@deepseek-ai/dsh-skill` as `BUNDLED_SKILL_RANK`. Restated to keep the package\n * dependency-free; a mismatch only changes which provider wins a name collision.\n */\nexport const BUNDLED_SKILL_RANK = 600;\n\n/** Default provider name used when the row does not override it. */\nexport const DEFAULT_PROVIDER_NAME = \"pstack\";\n\n/** Origin bucket for a skill contribution. */\nexport type SkillSource =\n  | \"project-dsh\"\n  | \"project-agents\"\n  | \"runtime\"\n  | \"user-dsh\"\n  | \"user-agents\"\n  | \"custom\"\n  | \"bundled\"\n  | (string & {});\n\n/** Optional provider-specific base used by loaded skill bodies to resolve relative resources. */\nexport type SkillResourceBase =\n  | { readonly kind: \"directory\"; readonly path: string }\n  | { readonly kind: \"url\"; readonly url: string }\n  | { readonly kind: \"opaque\"; readonly description: string };\n\n/** Invocation controls shared by skill discovery consumers. */\nexport interface SkillInvocationPolicy {\n  /** Whether model-facing catalogs and loaders include this skill. */\n  readonly modelInvocable: boolean;\n  /** Whether human-facing command catalogs and loaders include this skill. */\n  readonly userInvocable: boolean;\n}\n\n/** Invocation-neutral skill metadata returned by `ctx.skills.list()`. */\nexport interface SkillSummary {\n  /** Absolute instruction file path. */\n  readonly path?: string;\n  /** Kebab-case identifier used to address the skill. */\n  readonly name: string;\n  /** Short routing description shown by discovery consumers. */\n  readonly description: string;\n  /** Optional extra routing guidance. */\n  readonly whenToUse?: string;\n  /** Resolved model and user invocation controls. */\n  readonly invocation: SkillInvocationPolicy;\n  /** Discovery source that produced this skill. */\n  readonly source: SkillSource;\n  /** Provider that owns this skill body. */\n  readonly provider: string;\n  /** Provider-specific base for relative resources. */\n  readonly resourceBase?: SkillResourceBase;\n}\n\n/** Provider catalog entry used by the registry to merge and later load skills. */\nexport interface SkillCandidate extends SkillSummary {\n  /** Lower ranks win duplicate skill names. */\n  readonly rank: number;\n  /** Opaque provider-owned handle passed back to `provider.get()`. */\n  readonly locator: unknown;\n  /** Parsed optional metadata object from provider-specific skill frontmatter. */\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\n/** Complete parsed skill definition, including the body loaded by `ctx.skills.get()`. */\nexport interface SkillDefinition extends SkillSummary {\n  /** Markdown instruction body after frontmatter removal. */\n  readonly content: string;\n  /** Parsed optional metadata object from frontmatter. */\n  readonly metadata?: Readonly<Record<string, unknown>>;\n}\n\n/** Caller context used for cwd-sensitive and abortable provider work. */\nexport interface SkillLookupOptions {\n  /** Workspace selector for the current lookup. */\n  readonly cwd?: string | undefined;\n  /** Abort discovery or loading work for the current caller. */\n  readonly signal?: AbortSignal | undefined;\n}\n\n/** Registration-scoped lifecycle capability handed to a provider factory. */\nexport interface SkillProviderControl {\n  /** Aborts when registration fails or the exact provider registration is disposed. */\n  readonly signal: AbortSignal;\n  /** Invalidate completed catalogs and notify consumers. */\n  readonly invalidate: () => void;\n}\n\n/** Provider interface for one source of skills. */\nexport interface SkillProvider {\n  /** Unique provider name in the `ctx.skills` registry. */\n  readonly name: string;\n  /** List available skill candidates for the current lookup context. */\n  readonly list: (options: SkillLookupOptions) => Promise<readonly SkillCandidate[]>;\n  /** Load a complete skill body for a previously listed candidate. */\n  readonly get: (\n    candidate: SkillCandidate,\n    options: SkillLookupOptions,\n  ) => Promise<SkillDefinition | undefined>;\n}\n\n/** Opaque handle this provider hands back to itself; never derived from caller input. */\ninterface BundledSkillLocator {\n  readonly kind: \"bundled-skill\";\n  /** Absolute skill directory that also serves as the resource base. */\n  readonly directory: string;\n  /** Absolute `SKILL.md` path read by `get()`. */\n  readonly instructionFile: string;\n}\n\n/** One validated on-disk bundled skill. */\nexport interface BundledSkill {\n  readonly name: string;\n  readonly description: string;\n  readonly whenToUse?: string;\n  readonly invocation: SkillInvocationPolicy;\n  /** Absolute skill directory; the candidate resource base. */\n  readonly directory: string;\n  /** Absolute `SKILL.md` path. */\n  readonly instructionFile: string;\n}\n\n/** Validated skills keyed by their absolute directory. */\nexport type BundledSkillIndex = ReadonlyMap<string, BundledSkill>;\n\n/** Raised when a bundled asset violates the provider contract. */\nexport class BundledSkillError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"BundledSkillError\";\n  }\n}\n\n/**\n * Read and validate every bundled skill below one directory.\n *\n * This is the startup check: it runs before the provider registers, so a missing\n * `SKILL.md`, an invalid frontmatter block, or a name that disagrees with its\n * directory fails plugin activation with a path-qualified message instead of\n * dropping a skill from the catalog.\n *\n * @param skillsRoot - absolute path of the directory holding the skill directories.\n * @returns validated skills keyed by absolute skill directory, sorted by name.\n * @throws {BundledSkillError} when the tree or any skill in it is malformed.\n */\nexport function loadBundledSkillIndex(skillsRoot: string): BundledSkillIndex {\n  let entries;\n  try {\n    entries = readdirSync(skillsRoot, { withFileTypes: true });\n  } catch (error) {\n    throw new BundledSkillError(\n      `bundled skills: cannot read \"${skillsRoot}\": ${messageOf(error)}`,\n    );\n  }\n\n  const index = new Map<string, BundledSkill>();\n\n  for (const entry of entries.sort((left, right) => (left.name < right.name ? -1 : 1))) {\n    const directory = join(skillsRoot, entry.name);\n    if (!entry.isDirectory()) {\n      throw new BundledSkillError(\n        `bundled skills: \"${directory}\" is not a skill directory; remove it or add a SKILL.md`,\n      );\n    }\n\n    const instructionFile = join(directory, \"SKILL.md\");\n    const text = readSkillFile(instructionFile);\n    const frontmatter = readSkillFrontmatter(text, instructionFile);\n\n    if (frontmatter.name !== entry.name) {\n      throw new BundledSkillError(\n        `${instructionFile}: skill name \"${frontmatter.name}\" does not match its directory \"${entry.name}\"`,\n      );\n    }\n\n    index.set(directory, {\n      name: frontmatter.name,\n      description: frontmatter.description,\n      ...(frontmatter.whenToUse === undefined ? {} : { whenToUse: frontmatter.whenToUse }),\n      invocation: {\n        modelInvocable: !frontmatter.disableModelInvocation,\n        userInvocable: frontmatter.userInvocable,\n      },\n      directory,\n      instructionFile,\n    });\n  }\n\n  if (index.size === 0) {\n    throw new BundledSkillError(`bundled skills: no skill directories under \"${skillsRoot}\"`);\n  }\n\n  return index;\n}\n\n/**\n * Build the provider over an already validated index.\n *\n * @param index - result of {@link loadBundledSkillIndex}.\n * @param providerName - registry name for this provider.\n * @returns a read-only provider whose catalog never changes until the package does.\n */\nexport function createPstackSkillProvider(\n  index: BundledSkillIndex,\n  providerName: string = DEFAULT_PROVIDER_NAME,\n): SkillProvider {\n  const ordered = [...index.values()].sort((left, right) =>\n    left.name < right.name ? -1 : left.name > right.name ? 1 : 0,\n  );\n\n  return {\n    name: providerName,\n\n    async list(options) {\n      throwIfAborted(options?.signal);\n      return ordered.map(\n        (skill): SkillCandidate => ({\n          name: skill.name,\n          description: skill.description,\n          ...(skill.whenToUse === undefined ? {} : { whenToUse: skill.whenToUse }),\n          invocation: skill.invocation,\n          source: \"bundled\",\n          provider: providerName,\n          rank: BUNDLED_SKILL_RANK,\n          locator: {\n            kind: \"bundled-skill\",\n            directory: skill.directory,\n            instructionFile: skill.instructionFile,\n          } satisfies BundledSkillLocator,\n          path: skill.instructionFile,\n          resourceBase: { kind: \"directory\", path: skill.directory },\n        }),\n      );\n    },\n\n    async get(candidate, options) {\n      const locator = asBundledSkillLocator(candidate.locator);\n      if (locator === undefined) return undefined;\n\n      const skill = index.get(locator.directory);\n      if (\n        skill === undefined ||\n        skill.instructionFile !== locator.instructionFile ||\n        skill.name !== candidate.name\n      ) {\n        return undefined;\n      }\n\n      throwIfAborted(options?.signal);\n\n      const text = readOptionalSkillFile(skill.instructionFile);\n      if (text === undefined) return undefined;\n      const { body } = parseFrontmatter(text);\n\n      return {\n        name: skill.name,\n        description: skill.description,\n        ...(skill.whenToUse === undefined ? {} : { whenToUse: skill.whenToUse }),\n        invocation: skill.invocation,\n        source: \"bundled\",\n        provider: providerName,\n        path: skill.instructionFile,\n        resourceBase: { kind: \"directory\", path: skill.directory },\n        content: body,\n      };\n    },\n  };\n}\n\n/**\n * Load the index and build the provider in one step, failing on a malformed tree.\n *\n * `apply()` uses this exact function, so the startup failure path and the\n * provider used in tests are the same code.\n *\n * @param skillsRoot - absolute path of the bundled skill root.\n * @param providerName - registry name for this provider.\n * @returns the provider over the validated index.\n */\nexport function createPstackSkillProviderFromRoot(\n  skillsRoot: string,\n  providerName: string = DEFAULT_PROVIDER_NAME,\n): SkillProvider {\n  return createPstackSkillProvider(loadBundledSkillIndex(skillsRoot), providerName);\n}\n\nfunction asBundledSkillLocator(locator: unknown): BundledSkillLocator | undefined {\n  if (typeof locator !== \"object\" || locator === null) return undefined;\n  const candidate = locator as Partial<BundledSkillLocator>;\n  if (candidate.kind !== \"bundled-skill\") return undefined;\n  if (typeof candidate.directory !== \"string\") return undefined;\n  if (typeof candidate.instructionFile !== \"string\") return undefined;\n  return {\n    kind: \"bundled-skill\",\n    directory: candidate.directory,\n    instructionFile: candidate.instructionFile,\n  };\n}\n\nfunction readSkillFile(instructionFile: string): string {\n  try {\n    return readFileSync(instructionFile, \"utf8\");\n  } catch (error) {\n    throw new BundledSkillError(\n      `bundled skills: cannot read \"${instructionFile}\": ${messageOf(error)}`,\n    );\n  }\n}\n\n/** Parse and validate one skill header, reporting failures as bundled-asset errors. */\nfunction readSkillFrontmatter(\n  text: string,\n  instructionFile: string,\n): ReturnType<typeof validateSkillFrontmatter> {\n  try {\n    const { data } = parseFrontmatter(text);\n    return validateSkillFrontmatter(data, instructionFile);\n  } catch (error) {\n    const message = messageOf(error);\n    throw new BundledSkillError(\n      message.includes(instructionFile) ? message : `${instructionFile}: ${message}`,\n    );\n  }\n}\n\nfunction readOptionalSkillFile(instructionFile: string): string | undefined {\n  try {\n    return readFileSync(instructionFile, \"utf8\");\n  } catch (error) {\n    if (errorCode(error) === \"ENOENT\") return undefined;\n    throw error;\n  }\n}\n\nfunction throwIfAborted(signal: AbortSignal | undefined): void {\n  if (signal?.aborted !== true) return;\n  throw signal.reason ?? new Error(\"skill provider work was aborted\");\n}\n\nfunction errorCode(error: unknown): string | undefined {\n  if (typeof error !== \"object\" || error === null) return undefined;\n  const code = (error as { code?: unknown }).code;\n  return typeof code === \"string\" ? code : undefined;\n}\n\nfunction messageOf(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n","/**\n * dsh-pstack Host entry.\n *\n * Unit 2 ships one minimal capability: a single `ctx.skills` provider over the\n * generated assets in this package. Delegation, restricted history, roles, and\n * the worktree integration are later units and are deliberately absent here.\n *\n * The provider contract types live in `./provider.ts` and are structural copies\n * of the `@deepseek-ai/dsh-skill` 0.2.1-rc.3 declarations, so this module imports\n * nothing from the host packages at runtime.\n */\n\nimport { SKILLS_ROOT } from \"./paths.ts\";\nimport {\n  DEFAULT_PROVIDER_NAME,\n  createPstackSkillProvider,\n  loadBundledSkillIndex,\n} from \"./provider.ts\";\nimport type { SkillProvider, SkillProviderControl } from \"./provider.ts\";\n\n/** Plugin name used by Loader diagnostics for this row. */\nexport const name = \"pstack\";\n\n/** The provider needs the skill registry and nothing else. */\nexport const inject = [\"skills\"];\n\n/** Row configuration. Every field is optional; an omitted `config` is valid. */\nexport interface PstackConfig {\n  /** Registry name for the provider; change it when two rows must coexist. */\n  readonly providerName?: string;\n}\n\ninterface StandardSchemaIssue {\n  readonly message: string;\n  readonly path?: readonly (string | number)[];\n}\n\ntype StandardSchemaResult =\n  | { readonly value: PstackConfig; readonly issues?: undefined }\n  | { readonly issues: readonly StandardSchemaIssue[] };\n\n/**\n * Minimal Standard Schema validator for this plugin's row config.\n *\n * Cordis validates `apply()`'s second argument with `Config[\"~standard\"]` and\n * substitutes the returned `value`, so an omitted row `config` resolves to the\n * documented defaults without a schemastery dependency.\n */\nexport const Config = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"dsh-pstack\",\n    validate(value: unknown): StandardSchemaResult {\n      if (value === undefined || value === null) {\n        return { value: { providerName: DEFAULT_PROVIDER_NAME } };\n      }\n      if (typeof value !== \"object\" || Array.isArray(value)) {\n        return { issues: [{ message: \"config must be a mapping\" }] };\n      }\n\n      const issues: StandardSchemaIssue[] = [];\n      const record = value as Record<string, unknown>;\n      for (const key of Object.keys(record)) {\n        if (key !== \"providerName\") issues.push({ message: `unknown field \"${key}\"`, path: [key] });\n      }\n\n      const providerName = record[\"providerName\"];\n      if (providerName === undefined) {\n        return issues.length > 0\n          ? { issues }\n          : { value: { providerName: DEFAULT_PROVIDER_NAME } };\n      }\n      if (typeof providerName !== \"string\" || providerName.trim() === \"\") {\n        issues.push({ message: \"providerName must be a non-empty string\", path: [\"providerName\"] });\n        return { issues };\n      }\n\n      return issues.length > 0 ? { issues } : { value: { providerName } };\n    },\n  },\n};\n\n/** The slice of the Cordis context this plugin requires. */\nexport interface PstackSkillHost {\n  readonly skills: {\n    registerProvider(create: (control: SkillProviderControl) => SkillProvider): () => void;\n  };\n}\n\n/**\n * Register the bundled pstack skill provider.\n *\n * The bundled tree is validated before the provider registers, so a malformed\n * `SKILL.md` fails plugin activation with a path-qualified error instead of\n * removing one skill from the catalog. Nothing is copied out of the package and\n * nothing is watched: reinstalling the package is the refresh boundary.\n *\n * @param ctx - host context carrying the skill registry.\n * @param config - validated row config.\n * @throws {import(\"./provider.ts\").BundledSkillError} when the bundled tree is malformed.\n */\nexport function apply(ctx: PstackSkillHost, config: PstackConfig = {}): void {\n  const providerName = config.providerName ?? DEFAULT_PROVIDER_NAME;\n  const index = loadBundledSkillIndex(SKILLS_ROOT);\n  ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, providerName));\n}\n\nexport { ASSETS_ROOT, HARNESS_DOC_PATH, PACKAGE_ROOT, SKILLS_ROOT } from \"./paths.ts\";\nexport {\n  BUNDLED_SKILL_RANK,\n  BundledSkillError,\n  DEFAULT_PROVIDER_NAME,\n  createPstackSkillProvider,\n  createPstackSkillProviderFromRoot,\n  loadBundledSkillIndex,\n} from \"./provider.ts\";\nexport type {\n  BundledSkill,\n  BundledSkillIndex,\n  SkillCandidate,\n  SkillDefinition,\n  SkillInvocationPolicy,\n  SkillLookupOptions,\n  SkillProvider,\n  SkillProviderControl,\n  SkillResourceBase,\n  SkillSource,\n  SkillSummary,\n} from \"./provider.ts\";\nexport * from \"./frontmatter.ts\";\n"],"mappings":"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"}

package/dist/paths-D_JlVmBk.mjs

@@ -1,42 +0,0 @@
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-//#region src/paths.ts
-/**
-* Package-internal resource locations.
-*
-* The provider reads generated assets in place instead of copying them into a
-* user-visible skills directory, so every path here is resolved from this
-* module's own location. The modules run from `src/` in a checkout and from the
-* bundled `dist/index.mjs` in an installed package; both sit one directory below
-* the package root, so the same expression holds in both cases.
-*/
-/** Absolute path of the package root: the repository in a checkout, the install directory after packing. */
-const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-/** Absolute path of the generated, committed assets directory. */
-const ASSETS_ROOT = join(PACKAGE_ROOT, "assets");
-/** Absolute path of the directory holding the 55 bundled skill directories. */
-const SKILLS_ROOT = join(ASSETS_ROOT, "skills");
-/** Absolute path of the directory holding the generated agent preambles. */
-const AGENTS_ROOT = join(ASSETS_ROOT, "agents");
-/**
-* Absolute path of the `poteto-mode` instructions.
-*
-* `pstack_subagent` injects this path into a `poteto-agent` child's prompt, so the
-* child reads the playbook from where it actually is instead of searching a Cursor
-* plugin install for the highest version.
-*/
-const POTETO_MODE_SKILL_PATH = join(SKILLS_ROOT, "poteto-mode", "SKILL.md");
-/** Absolute path of the generated harness mapping document. */
-const HARNESS_DOC_PATH = join(ASSETS_ROOT, "docs", "harness", "dsh.md");
-/**
-* Absolute path of one agent preamble.
-*
-* Returns `undefined` for `general`, which is a plain child and gets no preamble.
-*/
-function agentPreamblePath(agent) {
-	return agent === "general" ? void 0 : join(AGENTS_ROOT, `${agent}.md`);
-}
-//#endregion
-export { SKILLS_ROOT as a, POTETO_MODE_SKILL_PATH as i, HARNESS_DOC_PATH as n, agentPreamblePath as o, PACKAGE_ROOT as r, ASSETS_ROOT as t };
-
-//# sourceMappingURL=paths-D_JlVmBk.mjs.map

package/dist/paths-D_JlVmBk.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"paths-D_JlVmBk.mjs","names":[],"sources":["../src/paths.ts"],"sourcesContent":["/**\n * Package-internal resource locations.\n *\n * The provider reads generated assets in place instead of copying them into a\n * user-visible skills directory, so every path here is resolved from this\n * module's own location. The modules run from `src/` in a checkout and from the\n * bundled `dist/index.mjs` in an installed package; both sit one directory below\n * the package root, so the same expression holds in both cases.\n */\n\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n/** Absolute path of the package root: the repository in a checkout, the install directory after packing. */\nexport const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), \"..\");\n\n/** Absolute path of the generated, committed assets directory. */\nexport const ASSETS_ROOT = join(PACKAGE_ROOT, \"assets\");\n\n/** Absolute path of the directory holding the 55 bundled skill directories. */\nexport const SKILLS_ROOT = join(ASSETS_ROOT, \"skills\");\n\n/** Absolute path of the directory holding the generated agent preambles. */\nexport const AGENTS_ROOT = join(ASSETS_ROOT, \"agents\");\n\n/**\n * Absolute path of the `poteto-mode` instructions.\n *\n * `pstack_subagent` injects this path into a `poteto-agent` child's prompt, so the\n * child reads the playbook from where it actually is instead of searching a Cursor\n * plugin install for the highest version.\n */\nexport const POTETO_MODE_SKILL_PATH = join(SKILLS_ROOT, \"poteto-mode\", \"SKILL.md\");\n\n/** Absolute path of the generated harness mapping document. */\nexport const HARNESS_DOC_PATH = join(ASSETS_ROOT, \"docs\", \"harness\", \"dsh.md\");\n\n/**\n * Absolute path of one agent preamble.\n *\n * Returns `undefined` for `general`, which is a plain child and gets no preamble.\n */\nexport function agentPreamblePath(agent: string): string | undefined {\n  return agent === \"general\" ? undefined : join(AGENTS_ROOT, `${agent}.md`);\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,MAAa,eAAe,QAAQ,QAAQ,cAAc,YAAY,GAAG,CAAC,GAAG,IAAI;;AAGjF,MAAa,cAAc,KAAK,cAAc,QAAQ;;AAGtD,MAAa,cAAc,KAAK,aAAa,QAAQ;;AAGrD,MAAa,cAAc,KAAK,aAAa,QAAQ;;;;;;;;AASrD,MAAa,yBAAyB,KAAK,aAAa,eAAe,UAAU;;AAGjF,MAAa,mBAAmB,KAAK,aAAa,QAAQ,WAAW,QAAQ;;;;;;AAO7E,SAAgB,kBAAkB,OAAmC;CACnE,OAAO,UAAU,YAAY,KAAA,IAAY,KAAK,aAAa,GAAG,MAAM,IAAI;AAC1E"}