cc-agentic-framework 1.14.1

package/dist/lib/schemas/skill.schema.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Zod schema for Skill frontmatter validation
+ *
+ * Validates skill SKILL.md files' YAML frontmatter structure.
+ *
+ * @module schemas/skill
+ */
+import { z } from 'zod';
+/**
+ * CLI command type - common types plus any string for extensibility
+ * Common types: create, validate, sync, export, import, transform, update, migrate, fetch
+ * Also allows: note (documentation), future (planned), and actual command names
+ */
+export declare const CliCommandTypeSchema: z.ZodString;
+/**
+ * Single CLI command definition
+ */
+export declare const CliCommandSchema: z.ZodObject<{
+    command: z.ZodString;
+    description: z.ZodString;
+    template: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * CLI command definition with more fields for array format
+ */
+export declare const CliCommandArrayItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    usage: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * CLI commands - supports multiple formats:
+ * 1. Record format: { create: { command: "...", description: "..." } }
+ * 2. Array format: [{ name: "...", description: "..." }]
+ * 3. Mixed record values: strings for notes, nested objects for future commands
+ *
+ * Due to the variety of formats in use, we use a flexible schema that
+ * accepts any valid structure. Detailed validation can be done separately
+ * when parsing specific command formats.
+ */
+export declare const CliCommandsSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    usage: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>>]>>;
+/**
+ * Skill scope - where the skill applies
+ * Common values: generic, framework, project, project-specific, apmr
+ */
+export declare const SkillScopeSchema: z.ZodOptional<z.ZodString>;
+/**
+ * Main skill schema
+ */
+export declare const SkillSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+    'applicable-projects': z.ZodOptional<z.ZodString>;
+    module: z.ZodOptional<z.ZodString>;
+    'capabilities-provided': z.ZodArray<z.ZodString>;
+    'cli-commands': z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        usage: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>]>>;
+}, z.core.$strip>;
+/**
+ * Loose skill schema for initial parsing (allows unknown fields)
+ */
+export declare const SkillSchemaLoose: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    'applicable-projects': z.ZodOptional<z.ZodString>;
+    module: z.ZodOptional<z.ZodString>;
+    'capabilities-provided': z.ZodOptional<z.ZodArray<z.ZodString>>;
+    'cli-commands': z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$loose>;
+export type CliCommandType = z.infer<typeof CliCommandTypeSchema>;
+export type CliCommand = z.infer<typeof CliCommandSchema>;
+export type SkillScope = z.infer<typeof SkillScopeSchema>;
+export type Skill = z.infer<typeof SkillSchema>;
+//# sourceMappingURL=skill.schema.d.ts.map

package/dist/lib/schemas/skill.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.schema.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/skill.schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,aAAoB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;iBAY3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;qBAKjB,CAAC;AAEd;;;GAGG;AACH,eAAO,MAAM,gBAAgB,4BAAwB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;iBA6BtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;iBASb,CAAC;AAGjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/lib/schemas/skill.schema.js

@@ -0,0 +1,98 @@
+/**
+ * Zod schema for Skill frontmatter validation
+ *
+ * Validates skill SKILL.md files' YAML frontmatter structure.
+ *
+ * @module schemas/skill
+ */
+import { z } from 'zod';
+/**
+ * CLI command type - common types plus any string for extensibility
+ * Common types: create, validate, sync, export, import, transform, update, migrate, fetch
+ * Also allows: note (documentation), future (planned), and actual command names
+ */
+export const CliCommandTypeSchema = z.string().min(1);
+/**
+ * Single CLI command definition
+ */
+export const CliCommandSchema = z.object({
+    /** Full CLI command string */
+    command: z.string().min(1, 'Command string is required'),
+    /** Description of what the command does */
+    description: z.string().min(1, 'Command description is required'),
+    /** Template file used by this command (optional) */
+    template: z.string().optional(),
+    /** Schema file used for validation (optional) */
+    schema: z.string().optional(),
+});
+/**
+ * CLI command definition with more fields for array format
+ */
+export const CliCommandArrayItemSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    usage: z.string().optional(),
+    options: z.array(z.string()).optional(),
+    examples: z.array(z.string()).optional(),
+});
+/**
+ * CLI commands - supports multiple formats:
+ * 1. Record format: { create: { command: "...", description: "..." } }
+ * 2. Array format: [{ name: "...", description: "..." }]
+ * 3. Mixed record values: strings for notes, nested objects for future commands
+ *
+ * Due to the variety of formats in use, we use a flexible schema that
+ * accepts any valid structure. Detailed validation can be done separately
+ * when parsing specific command formats.
+ */
+export const CliCommandsSchema = z.union([
+    // Record format (most flexible - accepts any nested structure)
+    z.record(z.string(), z.unknown()),
+    // Array format (list of commands)
+    z.array(CliCommandArrayItemSchema),
+]).optional();
+/**
+ * Skill scope - where the skill applies
+ * Common values: generic, framework, project, project-specific, apmr
+ */
+export const SkillScopeSchema = z.string().optional();
+/**
+ * Main skill schema
+ */
+export const SkillSchema = z.object({
+    /** Unique skill identifier (kebab-case) */
+    id: z.string()
+        .min(1, 'Skill ID is required')
+        .regex(/^[a-z][a-z0-9-]*$/, 'Skill ID must be kebab-case starting with a letter'),
+    /** Human-readable skill name */
+    name: z.string().min(1, 'Skill name is required'),
+    /** Description of when to use this skill */
+    description: z.string()
+        .min(10, 'Description must be at least 10 characters')
+        .max(500, 'Description must not exceed 500 characters'),
+    /** Scope of applicability */
+    scope: SkillScopeSchema,
+    /** Which projects this skill applies to */
+    'applicable-projects': z.string().optional(),
+    /** Module this skill belongs to */
+    module: z.string().optional(),
+    /** Capabilities this skill provides to agents */
+    'capabilities-provided': z.array(z.string())
+        .min(1, 'Skills must provide at least one capability'),
+    /** CLI commands this skill exposes */
+    'cli-commands': CliCommandsSchema,
+});
+/**
+ * Loose skill schema for initial parsing (allows unknown fields)
+ */
+export const SkillSchemaLoose = z.object({
+    id: z.string().optional(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    scope: z.string().optional(),
+    'applicable-projects': z.string().optional(),
+    module: z.string().optional(),
+    'capabilities-provided': z.array(z.string()).optional(),
+    'cli-commands': z.record(z.string(), z.any()).optional(),
+}).passthrough();
+//# sourceMappingURL=skill.schema.js.map

package/dist/lib/schemas/skill.schema.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * SDK Executor
+ *
+ * Wraps the Claude Agent SDK query API and handles agent execution.
+ */
+import type { SDKQueryOptions, SDKExecutionResult, GeneratedSDKAgent, SubAgentType } from "./types.js";
+import { type MessageHandler } from "./message-handler.js";
+/**
+ * Execute an agent using the Claude Agent SDK
+ *
+ * @param generated - Generated SDK agent with sub-agents
+ * @param options - Query options (prompt, model override, etc.)
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result with session info
+ */
+export declare function executeAgent(generated: GeneratedSDKAgent, options: SDKQueryOptions, messageHandler?: MessageHandler): Promise<SDKExecutionResult>;
+/**
+ * Resume a previous agent session
+ *
+ * @param sessionId - Session ID to resume
+ * @param generated - Generated SDK agent
+ * @param prompt - New prompt to continue with
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result
+ */
+export declare function resumeAgentSession(sessionId: string, generated: GeneratedSDKAgent, prompt: string, messageHandler?: MessageHandler): Promise<SDKExecutionResult>;
+/**
+ * Execute a specific phase sub-agent
+ *
+ * @param generated - Generated SDK agent with sub-agents
+ * @param phase - Phase to execute (explore, architect, reviewer, implementer)
+ * @param prompt - Prompt for the sub-agent
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result
+ */
+export declare function executePhase(generated: GeneratedSDKAgent, phase: SubAgentType, prompt: string, messageHandler?: MessageHandler): Promise<SDKExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/lib/sdk/executor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EAEb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,iBAAiB,EAC5B,OAAO,EAAE,eAAe,EACxB,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAuG7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAS7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAS7B"}

package/dist/lib/sdk/executor.js

@@ -0,0 +1,137 @@
+/**
+ * SDK Executor
+ *
+ * Wraps the Claude Agent SDK query API and handles agent execution.
+ */
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { handleStreamMessage } from "./message-handler.js";
+/**
+ * Execute an agent using the Claude Agent SDK
+ *
+ * @param generated - Generated SDK agent with sub-agents
+ * @param options - Query options (prompt, model override, etc.)
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result with session info
+ */
+export async function executeAgent(generated, options, messageHandler) {
+    try {
+        // Determine which agent to execute
+        const agentDef = options.phase
+            ? generated.subAgents.get(options.phase)
+            : generated.definition;
+        if (!agentDef) {
+            throw new Error(`Sub-agent '${options.phase}' not found. Available: ${Array.from(generated.subAgents.keys()).join(", ")}`);
+        }
+        // Apply model override if specified
+        const model = options.model ?? agentDef.model;
+        // Build sub-agents map for SDK (only if not running a phase)
+        const subAgentsForSDK = {};
+        if (!options.phase && generated.subAgents.size > 0) {
+            for (const [type, def] of generated.subAgents) {
+                subAgentsForSDK[type] = def;
+            }
+        }
+        // Filter tools for autonomous mode (remove user interaction)
+        const tools = options.autonomous
+            ? agentDef.tools.filter((t) => t !== "AskUserQuestion")
+            : agentDef.tools;
+        // Prepare SDK query options
+        const sdkOptions = {
+            allowedTools: tools,
+            model,
+            ...(Object.keys(subAgentsForSDK).length > 0 && {
+                agents: subAgentsForSDK,
+            }),
+            ...(options.workingDirectory && {
+                workingDirectory: options.workingDirectory,
+            }),
+            ...(options.sessionId && { sessionId: options.sessionId }),
+            ...(options.permissionMode && { permissionMode: options.permissionMode }),
+        };
+        // Track execution state
+        let finalResult = "";
+        let sessionId;
+        const subAgentsInvoked = [];
+        // Execute query with streaming
+        for await (const message of query({
+            prompt: options.prompt,
+            options: sdkOptions,
+        })) {
+            // Handle message using the message handler
+            const handlerFn = messageHandler ?? handleStreamMessage;
+            const handled = handlerFn(message);
+            // Track session ID if present
+            if (message.session_id) {
+                sessionId = message.session_id;
+            }
+            // Track sub-agent invocations from assistant messages
+            if (message.type === "assistant") {
+                const content = message.message.content;
+                if (Array.isArray(content)) {
+                    for (const block of content) {
+                        if (block.type === "tool_use" && block.name === "Task") {
+                            const toolInput = block.input;
+                            if (toolInput?.subagent_type) {
+                                const subAgentType = toolInput.subagent_type;
+                                if (!subAgentsInvoked.includes(subAgentType)) {
+                                    subAgentsInvoked.push(subAgentType);
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+            // Capture final result
+            if (message.type === "result" && message.subtype === "success") {
+                finalResult = message.result;
+            }
+            // If handler returned false, stop execution
+            if (handled === false) {
+                break;
+            }
+        }
+        return {
+            success: true,
+            sessionId,
+            result: finalResult,
+            subAgentsInvoked,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * Resume a previous agent session
+ *
+ * @param sessionId - Session ID to resume
+ * @param generated - Generated SDK agent
+ * @param prompt - New prompt to continue with
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result
+ */
+export async function resumeAgentSession(sessionId, generated, prompt, messageHandler) {
+    return executeAgent(generated, {
+        prompt,
+        sessionId,
+    }, messageHandler);
+}
+/**
+ * Execute a specific phase sub-agent
+ *
+ * @param generated - Generated SDK agent with sub-agents
+ * @param phase - Phase to execute (explore, architect, reviewer, implementer)
+ * @param prompt - Prompt for the sub-agent
+ * @param messageHandler - Optional custom message handler
+ * @returns Execution result
+ */
+export async function executePhase(generated, phase, prompt, messageHandler) {
+    return executeAgent(generated, {
+        prompt,
+        phase,
+    }, messageHandler);
+}
+//# sourceMappingURL=executor.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * SDK Agent Definition Generator
+ *
+ * Transforms framework agent definitions (markdown + registry) into
+ * Claude Agent SDK AgentDefinition format.
+ */
+import type { GeneratedSDKAgent, SDKModel } from "./types.js";
+/**
+ * SDK Generator for transforming framework agents to SDK format
+ */
+export declare class SDKGenerator {
+    private engine;
+    private projectRoot;
+    private agentsRegistry;
+    constructor(projectRoot: string);
+    /**
+     * Initialize the generator by loading the discovery engine
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load the agents.json registry
+     */
+    private loadAgentsRegistry;
+    /**
+     * Get SDK configuration from registry for an agent
+     */
+    private getSDKConfigFromRegistry;
+    /**
+     * Generate SDK agent definition for a specific agent
+     *
+     * @param agentId - The agent ID to generate for
+     * @returns Generated SDK agent with sub-agents
+     */
+    generateForAgent(agentId: string): Promise<GeneratedSDKAgent>;
+    /**
+     * Parse agent markdown file
+     */
+    private parseAgentMarkdown;
+    /**
+     * Parse YAML-like frontmatter
+     */
+    private parseFrontmatter;
+    /**
+     * Load content from skill files
+     */
+    private loadSkillsContent;
+    /**
+     * Load content from context files
+     */
+    private loadContextContent;
+    /**
+     * Build the complete system prompt for the agent with three-tier skill loading
+     */
+    private buildSystemPrompt;
+    /**
+     * Extract a short description from agent content
+     */
+    private extractDescription;
+    /**
+     * Build context string for sub-agents
+     */
+    private buildParentContext;
+    /**
+     * List all SDK-enabled agents
+     */
+    listSDKEnabledAgents(): Promise<Array<{
+        id: string;
+        model: SDKModel;
+    }>>;
+    /**
+     * Check if an agent is SDK-enabled
+     */
+    isSDKEnabled(agentId: string): Promise<boolean>;
+}
+/**
+ * Create and initialize an SDK generator
+ */
+export declare function createSDKGenerator(projectRoot: string): Promise<SDKGenerator>;
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/lib/sdk/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAGV,iBAAiB,EAIjB,QAAQ,EAET,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAA0C;gBAEpD,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;YACW,kBAAkB;IAahC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwBhC;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+EnE;;OAEG;YACW,kBAAkB;IAmChC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0DzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CACnC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC,CACvC;IAmBD;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAItD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAIvB"}