@dsh-cc/claude-code-agents 0.5.0

package/lib/types.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Shared vocabulary for loading Claude Code's `.claude/agents/*.md` and
+ * `*.json` sub-agent definitions into the harness. The loader is a pure,
+ * filesystem-only translation: it produces one {@link AgentDefinition} per
+ * dispatched agent file, computing the effective tool restriction and the
+ * system prompt exactly as the source frontmatter declares them, so a later
+ * consumer (an agent preset row, a subagent driver) can mount them without
+ * re-reading agent semantics.
+ *
+ * Fields deliberately mirror the Claude Code agent schema so an existing
+ * `.claude/agents` tree ports without rewriting. Unknown frontmatter keys are
+ * ignored, not forwarded, so a definition authored against a newer Claude
+ * Code release degrades to the supported subset rather than failing to load.
+ *
+ * @module @dsh-cc/claude-code-agents/types
+ */
+/**
+ * The layer an agent definition was discovered under; the precedence is
+ * `bundled` < `user` < `project` — a user-layer agent shadows its bundled
+ * namesake, and a project-layer agent shadows both.
+ */
+export type AgentSource = 'user' | 'project' | 'bundled';
+/**
+ * The per-scope tool filter the loader computes from `tools` and
+ * `disallowedTools`. Structurally matches `@dsh-cc/tools`'s
+ * `ToolRestriction` (an `allow`/`deny` pair that intersects with sibling
+ * restrictions), so the value can be handed to a scoped `ctx.tools.restrict()`
+ * without translation. The loader declares it locally to stay dependency-free.
+ */
+export interface ToolRestriction {
+    /** Global tool names that stay visible; everything else is removed. */
+    readonly allow?: readonly string[];
+    /** Global tool names removed from visibility. */
+    readonly deny?: readonly string[];
+}
+/** Effort level accepted from frontmatter, modelled on CC's effort levels. */
+export declare const EFFORT_LEVELS: readonly ["low", "medium", "high"];
+/** A valid `effort` is one of the named levels or a positive integer. */
+export type Effort = (typeof EFFORT_LEVELS)[number] | number;
+/** Permission mode the agent demands, mirrored from CC's permission modes. */
+export declare const PERMISSION_MODES: readonly ["default", "acceptEdits", "bypassPermissions", "plan"];
+/** A valid `permissionMode`. */
+export type PermissionMode = (typeof PERMISSION_MODES)[number];
+/** Persistent memory scope an agent carries across sessions. */
+export declare const MEMORY_SCOPES: readonly ["user", "project", "local"];
+/** A valid `memory` scope. */
+export type MemoryScope = (typeof MEMORY_SCOPES)[number];
+/** The isolation modes the loader accepts; only `worktree` is portable. */
+export declare const ISOLATION_MODES: readonly ["worktree"];
+/** A valid `isolation`. */
+export type IsolationMode = (typeof ISOLATION_MODES)[number];
+/**
+ * One loaded Claude Code agent definition: the validated, translated record
+ * the loader returns and a consumer mounts.
+ */
+export interface AgentDefinition {
+    /** Unique agent type name, taken from the file's basename without extension. */
+    readonly agentType: string;
+    /** The frontmatter `description`, surfaced as the model's when-to-use guide. */
+    readonly whenToUse: string;
+    /** The system prompt: the markdown body, or the frontmatter `prompt` override. */
+    readonly systemPrompt: string;
+    /** The layer this definition was discovered under. */
+    readonly source: AgentSource;
+    /** The agent's own parent directory (the `.claude/agents` dir that held it). */
+    readonly baseDir: string;
+    /** Original file basename without extension (`{agentType}` for `.md`). */
+    readonly filename: string;
+    /** Effective tool restriction; present when `tools` and/or `disallowedTools` were. */
+    readonly toolRestriction?: ToolRestriction;
+    /** Skill names to preload, in declaration order. */
+    readonly skills?: readonly string[];
+    /** MCP server names this agent requires, referenced by name only. */
+    readonly mcpServers?: readonly string[];
+    /** Hooks declarations, passed through unmodified. */
+    readonly hooks?: Record<string, unknown>;
+    /** `model` as written, normalized lowercased-and-trimmed; `'inherit'` is literal. */
+    readonly model?: string;
+    /** Reasoning effort overrides, when declared. */
+    readonly effort?: Effort;
+    /** Permission mode the agent selects when it starts. */
+    readonly permissionMode?: PermissionMode;
+    /** Maximum agentic turns before stopping. */
+    readonly maxTurns?: number;
+    /** Initial prompt delivered as the first inbox message. */
+    readonly initialPrompt?: string;
+    /** Whether spawned runs should default to the background. */
+    readonly background?: boolean;
+    /** Persistent memory scope. */
+    readonly memory?: MemoryScope;
+    /** Isolation mode; `worktree` requires a provider that supports it. */
+    readonly isolation?: IsolationMode;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,8EAA8E;AAC9E,eAAO,MAAM,aAAa,oCAIhB,CAAA;AAEV,yEAAyE;AACzE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;AAE5D,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,kEAKnB,CAAA;AAEV,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,gEAAgE;AAChE,eAAO,MAAM,aAAa,uCAAwC,CAAA;AAElE,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,uBAAwB,CAAA;AAEpD,2BAA2B;AAC3B,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,sFAAsF;IACtF,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAA;IAC1C,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,qEAAqE;IACrE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAA;IACxC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAA;CACnC"}

package/lib/types.js

@@ -0,0 +1,34 @@
+/**
+ * Shared vocabulary for loading Claude Code's `.claude/agents/*.md` and
+ * `*.json` sub-agent definitions into the harness. The loader is a pure,
+ * filesystem-only translation: it produces one {@link AgentDefinition} per
+ * dispatched agent file, computing the effective tool restriction and the
+ * system prompt exactly as the source frontmatter declares them, so a later
+ * consumer (an agent preset row, a subagent driver) can mount them without
+ * re-reading agent semantics.
+ *
+ * Fields deliberately mirror the Claude Code agent schema so an existing
+ * `.claude/agents` tree ports without rewriting. Unknown frontmatter keys are
+ * ignored, not forwarded, so a definition authored against a newer Claude
+ * Code release degrades to the supported subset rather than failing to load.
+ *
+ * @module @dsh-cc/claude-code-agents/types
+ */
+/** Effort level accepted from frontmatter, modelled on CC's effort levels. */
+export const EFFORT_LEVELS = [
+    'low',
+    'medium',
+    'high',
+];
+/** Permission mode the agent demands, mirrored from CC's permission modes. */
+export const PERMISSION_MODES = [
+    'default',
+    'acceptEdits',
+    'bypassPermissions',
+    'plan',
+];
+/** Persistent memory scope an agent carries across sessions. */
+export const MEMORY_SCOPES = ['user', 'project', 'local'];
+/** The isolation modes the loader accepts; only `worktree` is portable. */
+export const ISOLATION_MODES = ['worktree'];
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAuBH,8EAA8E;AAC9E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK;IACL,QAAQ;IACR,MAAM;CACE,CAAA;AAKV,8EAA8E;AAC9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,SAAS;IACT,aAAa;IACb,mBAAmB;IACnB,MAAM;CACE,CAAA;AAKV,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAKlE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,CAAU,CAAA"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@dsh-cc/claude-code-agents",
+  "description": "Load Claude Code `.claude/agents` definitions as agent presets for the DeepSeek Harness",
+  "version": "0.5.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-cc/dsh-cc.git",
+    "directory": "packages/preset/claude-code-agents"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./parse": {
+      "types": "./lib/parse.d.ts",
+      "default": "./lib/parse.js"
+    },
+    "./restrict": {
+      "types": "./lib/restrict.d.ts",
+      "default": "./lib/restrict.js"
+    },
+    "./discovery": {
+      "types": "./lib/discovery.d.ts",
+      "default": "./lib/discovery.js"
+    },
+    "./types": {
+      "types": "./lib/types.d.ts",
+      "default": "./lib/types.js"
+    },
+    "./invariant": {
+      "types": "./lib/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.1.1-rc.2",
+    "@dsh-cc/tools": "^0.5.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
+    "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
+    "@dsh-cc/tools": "^0.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}