cc-agentic-framework 1.14.1

package/dist/lib/sdk/sub-agents.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Phase-Specialized Sub-Agent Configurations
+ *
+ * These sub-agents are designed for specific phases of the development workflow:
+ * - explore: Read-only codebase discovery
+ * - architect: Design and planning
+ * - reviewer: Quality validation
+ * - implementer: Execute changes
+ */
+import type { SubAgentConfig, SubAgentType, SDKTool, SDKAgentDefinition } from "./types.js";
+/**
+ * Sub-agent configurations keyed by type
+ */
+export declare const SUB_AGENT_CONFIGS: Record<SubAgentType, SubAgentConfig>;
+/**
+ * Get sub-agent configuration by type
+ */
+export declare function getSubAgentConfig(type: SubAgentType): SubAgentConfig;
+/**
+ * Generate SDK AgentDefinition from sub-agent config
+ *
+ * @param config - Sub-agent configuration
+ * @param parentContext - Context from the parent agent to inject
+ * @returns SDK-compatible agent definition
+ */
+export declare function generateSubAgentDefinition(config: SubAgentConfig, parentContext: string): SDKAgentDefinition;
+/**
+ * Generate all sub-agent definitions for a parent agent
+ *
+ * @param types - Array of sub-agent types to generate
+ * @param parentContext - Context from the parent agent
+ * @returns Map of sub-agent type to SDK definition
+ */
+export declare function generateAllSubAgents(types: SubAgentType[], parentContext: string): Map<SubAgentType, SDKAgentDefinition>;
+/**
+ * Get default tools for agents
+ */
+export declare function getDefaultTools(): SDKTool[];
+/**
+ * Get default tools for autonomous mode (no user interaction)
+ */
+export declare function getDefaultToolsAutonomous(): SDKTool[];
+/**
+ * Get default model for agents
+ */
+export declare function getDefaultModel(): "opus" | "sonnet";
+/** @deprecated Use getDefaultTools() instead */
+export declare function getDefaultToolsForVariant(_variant?: string): SDKTool[];
+/** @deprecated Use getDefaultModel() instead */
+export declare function getDefaultModelForVariant(_variant?: string): "opus" | "sonnet";
+//# sourceMappingURL=sub-agents.d.ts.map

package/dist/lib/sdk/sub-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agents.d.ts","sourceRoot":"","sources":["../../../src/lib/sdk/sub-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,OAAO,EACP,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE,cAAc,CA2JlE,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CAEpE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,cAAc,EACtB,aAAa,EAAE,MAAM,GACpB,kBAAkB,CAOpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EAAE,EACrB,aAAa,EAAE,MAAM,GACpB,GAAG,CAAC,YAAY,EAAE,kBAAkB,CAAC,CASvC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,EAAE,CAY3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,QAAQ,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAEtE;AAED,gDAAgD;AAChD,wBAAgB,yBAAyB,CACvC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,QAAQ,CAEnB"}

package/dist/lib/sdk/sub-agents.js

@@ -0,0 +1,234 @@
+/**
+ * Phase-Specialized Sub-Agent Configurations
+ *
+ * These sub-agents are designed for specific phases of the development workflow:
+ * - explore: Read-only codebase discovery
+ * - architect: Design and planning
+ * - reviewer: Quality validation
+ * - implementer: Execute changes
+ */
+/**
+ * Sub-agent configurations keyed by type
+ */
+export const SUB_AGENT_CONFIGS = {
+    explore: {
+        type: "explore",
+        model: "haiku",
+        description: "Read-only codebase exploration and discovery. Use for finding files, understanding code structure, and gathering context without making changes.",
+        tools: ["Read", "Glob", "Grep"],
+        promptTemplate: `You are an Explore sub-agent specialized in codebase discovery.
+
+## Your Role
+You perform read-only exploration to discover relevant files, patterns, and structures.
+
+## Capabilities
+- Search for files by pattern (Glob)
+- Search for content within files (Grep)
+- Read file contents (Read)
+
+## Critical Constraints
+- You have READ-ONLY access
+- Do NOT attempt to modify any files
+- Do NOT use Edit, Write, or Bash tools
+- Report findings to the orchestrating agent
+
+## Task
+Explore the codebase to understand the requested aspect. Return:
+1. List of relevant files discovered
+2. Key patterns or structures found
+3. Summary of findings
+
+{{parentContext}}`,
+    },
+    architect: {
+        type: "architect",
+        model: "sonnet",
+        description: "Design and planning phase agent. Use for creating implementation plans, designing APIs, and proposing architectural changes.",
+        tools: ["Read", "Glob", "Grep", "Bash"],
+        bashRestrictions: [
+            "ls",
+            "git status",
+            "git log",
+            "git diff",
+            "npm list",
+            "tree",
+        ],
+        promptTemplate: `You are an Architect sub-agent specialized in design and planning.
+
+## Your Role
+You design implementation approaches, create technical specifications, and plan file changes.
+
+## Capabilities
+- Read and analyze existing code
+- Search for patterns and dependencies
+- Run read-only commands (git status, npm list, etc.)
+- Create detailed implementation plans
+
+## Critical Constraints
+- You plan changes but do NOT execute them
+- Bash is restricted to read-only commands
+- Do NOT use Edit or Write tools
+- Produce structured design documents
+
+## Output Format
+Provide your design as:
+1. Overview of proposed changes
+2. Files to create or modify (with rationale)
+3. Implementation sequence
+4. Potential risks or considerations
+
+{{parentContext}}`,
+    },
+    reviewer: {
+        type: "reviewer",
+        model: "sonnet",
+        description: "Quality validation and code review agent. Use for reviewing changes, running tests, and validating implementations.",
+        tools: ["Read", "Glob", "Grep", "Bash"],
+        bashRestrictions: [
+            "npm test",
+            "npm run lint",
+            "npm run build",
+            "git diff",
+            "tsc --noEmit",
+            "npx jest",
+        ],
+        promptTemplate: `You are a Reviewer sub-agent specialized in quality validation.
+
+## Your Role
+You validate implementations against requirements, run tests, and identify issues.
+
+## Capabilities
+- Read and analyze code changes
+- Run tests and linting (npm test, npm run lint)
+- Check TypeScript compilation (tsc --noEmit)
+- Review git diffs
+
+## Critical Constraints
+- You validate but do NOT fix issues directly
+- Report issues for the implementer to fix
+- Do NOT use Edit or Write tools
+- Focus on correctness, not style preferences
+
+## Output Format
+Provide your review as:
+1. Summary of validation results
+2. Issues found (if any) with severity
+3. Tests that passed/failed
+4. Recommendations for fixes
+
+{{parentContext}}`,
+    },
+    implementer: {
+        type: "implementer",
+        model: "sonnet",
+        description: "Implementation execution agent. Use for executing planned changes, creating files, and running build commands.",
+        tools: [
+            "Read",
+            "Write",
+            "Edit",
+            "Glob",
+            "Grep",
+            "Bash",
+            "TodoWrite",
+        ],
+        promptTemplate: `You are an Implementer sub-agent specialized in executing changes.
+
+## Your Role
+You execute planned changes according to provided specifications.
+
+## Capabilities
+- Read existing code
+- Write new files
+- Edit existing files
+- Run build and test commands
+- Track progress with TodoWrite
+
+## Critical Constraints
+- Follow the provided design specification exactly
+- Do NOT deviate from the plan without explicit approval
+- Test changes after implementation
+- Report completion status clearly
+
+## Output Format
+After implementation:
+1. List of files created or modified
+2. Commands executed
+3. Test results
+4. Any issues encountered
+
+{{parentContext}}`,
+    },
+};
+/**
+ * Get sub-agent configuration by type
+ */
+export function getSubAgentConfig(type) {
+    return SUB_AGENT_CONFIGS[type];
+}
+/**
+ * Generate SDK AgentDefinition from sub-agent config
+ *
+ * @param config - Sub-agent configuration
+ * @param parentContext - Context from the parent agent to inject
+ * @returns SDK-compatible agent definition
+ */
+export function generateSubAgentDefinition(config, parentContext) {
+    return {
+        description: config.description,
+        prompt: config.promptTemplate.replace("{{parentContext}}", parentContext),
+        tools: config.tools,
+        model: config.model,
+    };
+}
+/**
+ * Generate all sub-agent definitions for a parent agent
+ *
+ * @param types - Array of sub-agent types to generate
+ * @param parentContext - Context from the parent agent
+ * @returns Map of sub-agent type to SDK definition
+ */
+export function generateAllSubAgents(types, parentContext) {
+    const subAgents = new Map();
+    for (const type of types) {
+        const config = getSubAgentConfig(type);
+        subAgents.set(type, generateSubAgentDefinition(config, parentContext));
+    }
+    return subAgents;
+}
+/**
+ * Get default tools for agents
+ */
+export function getDefaultTools() {
+    return [
+        "Read",
+        "Write",
+        "Edit",
+        "Glob",
+        "Grep",
+        "Bash",
+        "Task",
+        "TodoWrite",
+        "AskUserQuestion",
+    ];
+}
+/**
+ * Get default tools for autonomous mode (no user interaction)
+ */
+export function getDefaultToolsAutonomous() {
+    return ["Read", "Write", "Edit", "Glob", "Grep", "Bash", "Task", "TodoWrite"];
+}
+/**
+ * Get default model for agents
+ */
+export function getDefaultModel() {
+    return "sonnet";
+}
+/** @deprecated Use getDefaultTools() instead */
+export function getDefaultToolsForVariant(_variant) {
+    return getDefaultTools();
+}
+/** @deprecated Use getDefaultModel() instead */
+export function getDefaultModelForVariant(_variant) {
+    return getDefaultModel();
+}
+//# sourceMappingURL=sub-agents.js.map

package/dist/lib/sdk/sub-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agents.js","sourceRoot":"","sources":["../../../src/lib/sdk/sub-agents.ts"],"names":[],"mappings":"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"}

package/dist/lib/sdk/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Claude Agent SDK Integration Types
+ *
+ * These types bridge the framework's agent definitions with the Claude Agent SDK format.
+ */
+/**
+ * SDK model options matching Claude Agent SDK
+ */
+export type SDKModel = "opus" | "sonnet" | "haiku";
+/**
+ * Built-in tools available in Claude Agent SDK
+ */
+export type SDKTool = "Read" | "Write" | "Edit" | "Glob" | "Grep" | "Bash" | "WebSearch" | "WebFetch" | "Task" | "TodoWrite" | "AskUserQuestion" | "NotebookEdit";
+/**
+ * Phase-specialized sub-agent types
+ */
+export type SubAgentType = "explore" | "architect" | "reviewer" | "implementer";
+/**
+ * Execution mode for agents
+ */
+export type ExecutionMode = "interactive" | "autonomous";
+/**
+ * Permission mode for SDK execution
+ */
+export type PermissionMode = "default" | "bypassPermissions" | "acceptEdits";
+/**
+ * SDK permissions configuration
+ */
+export interface SDKPermissions {
+    mode: PermissionMode;
+    allowedBashCommands?: string[];
+}
+/**
+ * SDK configuration block from agents.json
+ */
+export interface SDKConfiguration {
+    enabled: boolean;
+    model: SDKModel;
+    allowedTools: SDKTool[];
+    subAgents: SubAgentType[];
+    executionMode: ExecutionMode;
+    maxTokens?: number;
+    permissions?: SDKPermissions;
+}
+/**
+ * Agent definition from the framework's registry
+ * Extended with SDK configuration
+ */
+export interface FrameworkAgentDefinition {
+    id: string;
+    moduleId: string;
+    capabilityNeeds: string[];
+    contextCategoryNeeds: Record<string, string>;
+    tokenBudget: number;
+    sourcePath: string;
+    variant: "full" | "slim";
+    delegatesTo?: string[];
+    parentAgent?: string;
+    sdk?: SDKConfiguration;
+}
+/**
+ * Claude Agent SDK AgentDefinition format
+ * This is what the SDK expects when defining sub-agents
+ */
+export interface SDKAgentDefinition {
+    /** Natural language description of when to use this agent */
+    description: string;
+    /** System prompt defining the agent's behavior and expertise */
+    prompt: string;
+    /** Array of allowed tool names (empty = all tools) */
+    tools: SDKTool[];
+    /** Model override for this agent */
+    model: SDKModel;
+}
+/**
+ * Sub-agent configuration for phase-specialized agents
+ */
+export interface SubAgentConfig {
+    type: SubAgentType;
+    model: SDKModel;
+    description: string;
+    tools: SDKTool[];
+    bashRestrictions?: string[];
+    promptTemplate: string;
+}
+/**
+ * Generated SDK agent ready for execution
+ */
+export interface GeneratedSDKAgent {
+    /** The main agent definition */
+    definition: SDKAgentDefinition;
+    /** Phase-specialized sub-agents */
+    subAgents: Map<SubAgentType, SDKAgentDefinition>;
+    /** Original framework agent metadata */
+    frameworkAgent: FrameworkAgentDefinition;
+    /** Resolved skills content (all tiers combined - for backward compat) */
+    skillsContent: string[];
+    /** Essential skills content (Tier 1: pre-loaded) */
+    essentialSkillsContent: string[];
+    /** Discovered skills content (Tier 2: auto-discovered) */
+    discoveredSkillsContent: string[];
+    /** Available skill IDs (Tier 3: on-demand reference) */
+    availableSkillIds: string[];
+    /** Resolved context content */
+    contextContent: string[];
+}
+/**
+ * Options for SDK query execution
+ */
+export interface SDKQueryOptions {
+    /** User prompt to send to the agent */
+    prompt: string;
+    /** Override the default model */
+    model?: SDKModel;
+    /** Run a specific phase sub-agent instead of the main agent */
+    phase?: SubAgentType;
+    /** Additional context file paths to include */
+    additionalContext?: string[];
+    /** Working directory for file operations */
+    workingDirectory?: string;
+    /** Session ID for resuming previous sessions */
+    sessionId?: string;
+    /** Dry run mode - generate definition without executing */
+    dryRun?: boolean;
+    /** Run in autonomous mode without permission prompts */
+    autonomous?: boolean;
+    /** Permission mode for SDK execution */
+    permissionMode?: "default" | "acceptEdits" | "bypassPermissions";
+}
+/**
+ * SDK execution result
+ */
+export interface SDKExecutionResult {
+    /** Whether execution completed successfully */
+    success: boolean;
+    /** Session ID for resuming */
+    sessionId?: string;
+    /** Final result text */
+    result?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Sub-agents that were invoked */
+    subAgentsInvoked?: string[];
+}
+/**
+ * Message types from SDK streaming
+ * Re-export from the actual SDK package
+ */
+import type { SDKMessage } from "@anthropic-ai/claude-agent-sdk";
+/**
+ * Alias for SDK message type for our internal use
+ */
+export type SDKStreamMessage = SDKMessage;
+/**
+ * Parsed agent markdown content
+ */
+export interface ParsedAgentContent {
+    /** YAML frontmatter */
+    frontmatter: Record<string, unknown>;
+    /** Agent title from H1 */
+    title: string;
+    /** Purpose section content */
+    purpose: string;
+    /** Full markdown body (excluding frontmatter) */
+    body: string;
+    /** Skill routing table if present */
+    skillRoutingTable?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/sdk/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/sdk/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/sdk/types.js

@@ -0,0 +1,7 @@
+/**
+ * Claude Agent SDK Integration Types
+ *
+ * These types bridge the framework's agent definitions with the Claude Agent SDK format.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/sdk/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/sdk/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/skill-cli-parser.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CLI command configuration from skill frontmatter
+ */
+export interface CliCommandConfig {
+    command: string;
+    description: string;
+    options: string[];
+    template?: string;
+    schema?: string;
+    rules?: string;
+}
+/**
+ * Skill CLI metadata
+ */
+export interface SkillCliMetadata {
+    id: string;
+    module: string;
+    cliCommands?: Record<string, CliCommandConfig>;
+}
+/**
+ * Extended skill metadata with file path
+ */
+export interface SkillMetadata extends SkillCliMetadata {
+    filePath: string;
+    name?: string;
+    description?: string;
+}
+/**
+ * Parse CLI commands from a skill file
+ * @param skillPath - Path to SKILL.md file
+ * @returns Skill CLI metadata
+ */
+export declare function parseSkillCli(skillPath: string): Promise<SkillCliMetadata>;
+/**
+ * Parse full skill metadata including CLI commands
+ * @param skillPath - Path to SKILL.md file
+ * @returns Full skill metadata
+ */
+export declare function parseSkillMetadata(skillPath: string): Promise<SkillMetadata>;
+/**
+ * Get all skills with CLI commands
+ * @param frameworkRoot - Root directory of the framework
+ * @returns Array of skill CLI metadata for skills that have CLI commands
+ */
+export declare function getAllSkillsWithCli(frameworkRoot: string): Promise<SkillCliMetadata[]>;
+/**
+ * Get all skills (including those without CLI commands)
+ * @param frameworkRoot - Root directory of the framework
+ * @returns Array of full skill metadata
+ */
+export declare function getAllSkills(frameworkRoot: string): Promise<SkillMetadata[]>;
+/**
+ * Find a specific skill by ID
+ * @param frameworkRoot - Root directory of the framework
+ * @param skillId - Skill ID to find
+ * @returns Skill metadata or null if not found
+ */
+export declare function findSkillById(frameworkRoot: string, skillId: string): Promise<SkillMetadata | null>;
+/**
+ * Find skills by module
+ * @param frameworkRoot - Root directory of the framework
+ * @param moduleName - Module name to filter by
+ * @returns Array of skill metadata for the module
+ */
+export declare function findSkillsByModule(frameworkRoot: string, moduleName: string): Promise<SkillMetadata[]>;
+/**
+ * Validate CLI command configuration
+ * @param config - CLI command configuration to validate
+ * @returns True if valid, throws error otherwise
+ */
+export declare function validateCliCommand(config: CliCommandConfig): boolean;
+/**
+ * Get CLI command by name from skill
+ * @param skillPath - Path to skill file
+ * @param commandName - Command name to retrieve
+ * @returns CLI command configuration or null if not found
+ */
+export declare function getCliCommand(skillPath: string, commandName: string): Promise<CliCommandConfig | null>;
+//# sourceMappingURL=skill-cli-parser.d.ts.map

package/dist/lib/skill-cli-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-cli-parser.d.ts","sourceRoot":"","sources":["../../src/lib/skill-cli-parser.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,gBAAgB;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2BhF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBlF;AA4BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoB7B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAgBlF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAG/B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAG1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAcpE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAQlC"}