@cleocode/core 2026.3.76 → 2026.4.0

package/dist/signaldock/signaldock-transport.js

@@ -0,0 +1,122 @@
+/**
+ * SignalDock HTTP transport — provider-neutral agent messaging via SignalDock REST API.
+ *
+ * This transport enables CLEO agents to communicate through SignalDock's
+ * infrastructure regardless of which AI coding tool hosts them.
+ *
+ * IMPORTANT: This is a TypeScript HTTP client. No SignalDock source code
+ * has been copied. All interactions use the public REST API.
+ *
+ * @task T5671
+ */
+/**
+ * SignalDock HTTP transport implementation.
+ *
+ * Communicates with a SignalDock server via its REST API to provide
+ * provider-neutral inter-agent messaging with delivery guarantees.
+ */
+export class SignalDockTransport {
+    name = 'signaldock';
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async register(name, agentClass, privacyTier) {
+        const prefixedName = `${this.config.agentPrefix}${name}`;
+        const body = {
+            name: prefixedName,
+            agentClass,
+            privacyTier,
+        };
+        const response = await this.request('POST', '/agents', body);
+        return {
+            agentId: response.id,
+            name: response.name,
+            agentClass: response.agentClass,
+            privacyTier: response.privacyTier,
+        };
+    }
+    async deregister(agentId) {
+        await this.request('DELETE', `/agents/${encodeURIComponent(agentId)}`);
+    }
+    async send(fromAgentId, toAgentId, content, conversationId) {
+        let convId = conversationId;
+        if (!convId) {
+            const conversation = await this.createConversation([fromAgentId, toAgentId], 'private');
+            convId = conversation.id;
+        }
+        const body = {
+            conversationId: convId,
+            fromAgentId,
+            toAgentId,
+            content,
+            contentType: 'text',
+        };
+        const message = await this.request('POST', '/messages', body, fromAgentId);
+        return {
+            messageId: message.id,
+            conversationId: message.conversationId,
+            status: message.status === 'delivered' ? 'delivered' : 'pending',
+        };
+    }
+    async poll(agentId, since) {
+        const path = since
+            ? `/messages/poll/new?since=${encodeURIComponent(since)}`
+            : '/messages/poll/new';
+        const messages = await this.request('GET', path, undefined, agentId);
+        return messages;
+    }
+    async heartbeat(agentId) {
+        await this.request('POST', `/agents/${encodeURIComponent(agentId)}/heartbeat`, undefined, agentId);
+    }
+    async createConversation(participants, visibility = 'private') {
+        const body = {
+            participants: [...participants].sort(),
+            visibility,
+        };
+        return this.request('POST', '/conversations', body);
+    }
+    async getAgent(agentId) {
+        try {
+            return await this.request('GET', `/agents/${encodeURIComponent(agentId)}`);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Make an HTTP request to the SignalDock API.
+     */
+    async request(method, path, body, agentId) {
+        const url = `${this.config.endpoint}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (agentId) {
+            headers['X-Agent-Id'] = agentId;
+        }
+        const init = {
+            method,
+            headers,
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`SignalDock API error: ${method} ${path} returned ${response.status}: ${text}`);
+        }
+        // DELETE may return no content
+        if (response.status === 204) {
+            return undefined;
+        }
+        const envelope = (await response.json());
+        if (!envelope.success && envelope.error) {
+            throw new Error(`SignalDock error [${envelope.error.code}]: ${envelope.error.message}`);
+        }
+        return envelope.data;
+    }
+}
+//# sourceMappingURL=signaldock-transport.js.map

package/dist/signaldock/signaldock-transport.js.map

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

package/dist/signaldock/transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * AgentTransport interface — provider-neutral abstraction for inter-agent communication.
+ *
+ * This interface enables CLEO's multi-tier orchestration to work with any
+ * agent messaging backend: SignalDock (provider-neutral), Claude Code SDK
+ * (provider-specific), or future Conduit implementations.
+ *
+ * @task T5671
+ */
+import type { Agent, AgentClass, Conversation, ConversationVisibility, Message, PrivacyTier } from './types.js';
+/** Result of agent registration. */
+export interface AgentRegistration {
+    agentId: string;
+    name: string;
+    agentClass: AgentClass;
+    privacyTier: PrivacyTier;
+}
+/** Result of sending a message. */
+export interface MessageResult {
+    messageId: string;
+    conversationId: string;
+    status: 'pending' | 'delivered';
+}
+/**
+ * Provider-neutral interface for inter-agent communication.
+ *
+ * Implementations:
+ * - SignalDockTransport: HTTP client for SignalDock REST API (provider-neutral)
+ * - ClaudeCodeTransport: Wrapper around Claude Code SDK SendMessage (provider-specific)
+ */
+export interface AgentTransport {
+    /** Transport name for logging and diagnostics. */
+    readonly name: string;
+    /** Register an agent with the transport layer. */
+    register(name: string, agentClass: AgentClass, privacyTier: PrivacyTier): Promise<AgentRegistration>;
+    /** Deregister an agent from the transport layer. */
+    deregister(agentId: string): Promise<void>;
+    /** Send a message to another agent. */
+    send(fromAgentId: string, toAgentId: string, content: string, conversationId?: string): Promise<MessageResult>;
+    /** Poll for new messages addressed to this agent. */
+    poll(agentId: string, since?: string): Promise<Message[]>;
+    /** Send a heartbeat to keep the agent connection alive. */
+    heartbeat(agentId: string): Promise<void>;
+    /** Create a conversation between agents. */
+    createConversation(participants: string[], visibility?: ConversationVisibility): Promise<Conversation>;
+    /** Get agent info by ID. */
+    getAgent(agentId: string): Promise<Agent | null>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/signaldock/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/signaldock/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,oCAAoC;AACpC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kDAAkD;IAClD,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,UAAU,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B,oDAAoD;IACpD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,uCAAuC;IACvC,IAAI,CACF,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B,qDAAqD;IACrD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE1D,2DAA2D;IAC3D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,4CAA4C;IAC5C,kBAAkB,CAChB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,CAAC,EAAE,sBAAsB,GAClC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzB,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;CAClD"}

package/dist/signaldock/transport.js

@@ -0,0 +1,11 @@
+/**
+ * AgentTransport interface — provider-neutral abstraction for inter-agent communication.
+ *
+ * This interface enables CLEO's multi-tier orchestration to work with any
+ * agent messaging backend: SignalDock (provider-neutral), Claude Code SDK
+ * (provider-specific), or future Conduit implementations.
+ *
+ * @task T5671
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/signaldock/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/signaldock/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/signaldock/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * TypeScript types for SignalDock protocol integration.
+ * These mirror the public API surface of SignalDock-core.
+ *
+ * IMPORTANT: These types are derived from SignalDock's public REST API.
+ * No proprietary source code has been copied.
+ *
+ * @task T5671
+ */
+/** Functional classification of an agent. */
+export type AgentClass = 'personal_assistant' | 'code_dev' | 'research' | 'utility_bot' | 'custom';
+/** Visibility tier controlling agent discoverability. */
+export type PrivacyTier = 'public' | 'discoverable' | 'private';
+/** Current online status of an agent. */
+export type AgentStatus = 'online' | 'offline' | 'busy';
+/** Delivery status of a message. */
+export type MessageStatus = 'pending' | 'delivered' | 'read';
+/** Content type for message payloads. */
+export type ContentType = 'text';
+/** Visibility setting for a conversation. */
+export type ConversationVisibility = 'private' | 'public' | 'shared';
+/** A registered agent. */
+export interface Agent {
+    id: string;
+    name: string;
+    agentClass: AgentClass;
+    privacyTier: PrivacyTier;
+    status: AgentStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for registering a new agent. */
+export interface NewAgent {
+    name: string;
+    agentClass: AgentClass;
+    privacyTier: PrivacyTier;
+}
+/** A message exchanged between two agents. */
+export interface Message {
+    id: string;
+    conversationId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    content: string;
+    contentType: ContentType;
+    status: MessageStatus;
+    createdAt: string;
+    deliveredAt?: string;
+    readAt?: string;
+}
+/** Payload for creating a new message. */
+export interface NewMessage {
+    conversationId: string;
+    fromAgentId: string;
+    toAgentId: string;
+    content: string;
+    contentType: ContentType;
+}
+/** A conversation between agents. */
+export interface Conversation {
+    id: string;
+    participants: string[];
+    visibility: ConversationVisibility;
+    messageCount: number;
+    lastMessageAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Payload for creating a new conversation. */
+export interface NewConversation {
+    participants: string[];
+    visibility: ConversationVisibility;
+}
+/** Standard API response envelope. */
+export interface ApiResponse<T> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+    meta?: {
+        page?: number;
+        pageSize?: number;
+        total?: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/signaldock/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/signaldock/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEnG,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AAEhE,yCAAyC;AACzC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,oCAAoC;AACpC,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7D,yCAAyC;AACzC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,6CAA6C;AAC7C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErE,0BAA0B;AAC1B,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,2CAA2C;AAC3C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,sBAAsB,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,sBAAsB,CAAC;CACpC;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH"}

package/dist/signaldock/types.js

@@ -0,0 +1,11 @@
+/**
+ * TypeScript types for SignalDock protocol integration.
+ * These mirror the public API surface of SignalDock-core.
+ *
+ * IMPORTANT: These types are derived from SignalDock's public REST API.
+ * No proprietary source code has been copied.
+ *
+ * @task T5671
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/signaldock/types.js.map

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

package/dist/skills/agents/config.js

@@ -0,0 +1,94 @@
+/**
+ * Agent configuration management.
+ * Ports lib/skills/agent-config.sh.
+ *
+ * Reads agent definitions from AGENT.md files (YAML frontmatter)
+ * and provides configuration accessors.
+ *
+ * @epic T4454
+ * @task T4518
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { getProjectRoot } from '../../paths.js';
+import { parseFrontmatter } from '../discovery.js';
+// ============================================================================
+// Agent Config Resolution
+// ============================================================================
+/**
+ * Get the agents directory path.
+ * @task T4518
+ */
+export function getAgentsDir(cwd) {
+    return join(getProjectRoot(cwd), 'agents');
+}
+/**
+ * Parse an AGENT.md file into an AgentConfig.
+ * AGENT.md uses the same YAML frontmatter format as SKILL.md.
+ * @task T4518
+ */
+export function parseAgentConfig(agentDir) {
+    const agentMdPath = join(agentDir, 'AGENT.md');
+    if (!existsSync(agentMdPath)) {
+        return null;
+    }
+    const content = readFileSync(agentMdPath, 'utf-8');
+    const fm = parseFrontmatter(content);
+    return {
+        name: fm.name || basename(agentDir),
+        description: fm.description || '',
+        model: fm.model,
+        allowedTools: fm.allowedTools,
+        customInstructions: extractBody(content),
+    };
+}
+/**
+ * Load agent configuration by name.
+ * Searches in the agents/ directory.
+ * @task T4518
+ */
+export function loadAgentConfig(agentName, cwd) {
+    const agentsDir = getAgentsDir(cwd);
+    const agentDir = join(agentsDir, agentName);
+    return parseAgentConfig(agentDir);
+}
+/**
+ * Get the cleo-subagent configuration (universal executor).
+ * @task T4518
+ */
+export function getSubagentConfig(cwd) {
+    return loadAgentConfig('cleo-subagent', cwd);
+}
+/**
+ * Check if an agent definition exists.
+ * @task T4518
+ */
+export function agentExists(agentName, cwd) {
+    const agentsDir = getAgentsDir(cwd);
+    const agentMdPath = join(agentsDir, agentName, 'AGENT.md');
+    return existsSync(agentMdPath);
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Extract the body content after frontmatter.
+ */
+function extractBody(content) {
+    const lines = content.split('\n');
+    let inFrontmatter = false;
+    let bodyStart = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === '---') {
+            if (!inFrontmatter) {
+                inFrontmatter = true;
+            }
+            else {
+                bodyStart = i + 1;
+                break;
+            }
+        }
+    }
+    return lines.slice(bodyStart).join('\n').trim();
+}
+//# sourceMappingURL=config.js.map

package/dist/skills/agents/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/skills/agents/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGnD,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAErC,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,QAAQ,CAAC,QAAQ,CAAC;QACnC,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;QACjC,KAAK,EAAE,EAAE,CAAC,KAAK;QACf,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,GAAY;IAC7D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAE5C,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,eAAe,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,GAAY;IACzD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/skills/agents/install.js

@@ -0,0 +1,116 @@
+/**
+ * Agent installation functions.
+ * Ports lib/skills/agents-install.sh.
+ *
+ * Installs agent configurations to the appropriate locations.
+ *
+ * @epic T4454
+ * @task T4518
+ */
+import { existsSync, mkdirSync, readdirSync, readlinkSync, symlinkSync, unlinkSync } from 'node:fs';
+import { platform } from 'node:os';
+import { basename, join } from 'node:path';
+import { getClaudeAgentsDir } from '../../paths.js';
+import { getAgentsDir } from './config.js';
+/**
+ * Symlink type for directory symlinks.
+ * On Windows, use 'junction' (no admin privileges required).
+ * On Unix, use 'dir'.
+ */
+const DIR_SYMLINK_TYPE = platform() === 'win32' ? 'junction' : 'dir';
+// ============================================================================
+// Agent Installation
+// ============================================================================
+/** Installation target directory. */
+function getAgentInstallDir() {
+    return getClaudeAgentsDir();
+}
+/**
+ * Install a single agent via symlink.
+ * @task T4518
+ */
+export function installAgent(agentDir) {
+    const targetDir = getAgentInstallDir();
+    const agentName = basename(agentDir);
+    const targetPath = join(targetDir, agentName);
+    // Ensure target directory exists
+    if (!existsSync(targetDir)) {
+        mkdirSync(targetDir, { recursive: true });
+    }
+    // Check source exists
+    if (!existsSync(agentDir)) {
+        return { installed: false, path: targetPath, error: `Source not found: ${agentDir}` };
+    }
+    // Handle existing entry
+    if (existsSync(targetPath)) {
+        try {
+            const existing = readlinkSync(targetPath);
+            if (existing === agentDir) {
+                return { installed: true, path: targetPath }; // Already correct
+            }
+            // Different target, remove and re-link
+            unlinkSync(targetPath);
+        }
+        catch {
+            // Not a symlink, skip
+            return {
+                installed: false,
+                path: targetPath,
+                error: `Target exists and is not a symlink: ${targetPath}`,
+            };
+        }
+    }
+    try {
+        symlinkSync(agentDir, targetPath, DIR_SYMLINK_TYPE);
+        return { installed: true, path: targetPath };
+    }
+    catch (err) {
+        return { installed: false, path: targetPath, error: `Symlink failed: ${err}` };
+    }
+}
+/**
+ * Install all agents from the project agents/ directory.
+ * @task T4518
+ */
+export function installAllAgents(cwd) {
+    const agentsDir = getAgentsDir(cwd);
+    const results = [];
+    if (!existsSync(agentsDir)) {
+        return results;
+    }
+    const entries = readdirSync(agentsDir);
+    for (const entry of entries) {
+        if (entry.startsWith('.'))
+            continue;
+        const agentDir = join(agentsDir, entry);
+        const agentMdPath = join(agentDir, 'AGENT.md');
+        if (!existsSync(agentMdPath))
+            continue;
+        const result = installAgent(agentDir);
+        results.push({
+            name: entry,
+            installed: result.installed,
+            error: result.error,
+        });
+    }
+    return results;
+}
+/**
+ * Uninstall a single agent by removing its symlink.
+ * @task T4518
+ */
+export function uninstallAgent(agentName) {
+    const targetDir = getAgentInstallDir();
+    const targetPath = join(targetDir, agentName);
+    if (!existsSync(targetPath)) {
+        return false;
+    }
+    try {
+        unlinkSync(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/skills/agents/install.js.map

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