@actant/shared 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,1096 @@
+import pino from 'pino';
+
+interface DomainContextConfig {
+    skills?: string[];
+    prompts?: string[];
+    mcpServers?: McpServerRef[];
+    workflow?: string;
+    subAgents?: string[];
+    plugins?: string[];
+    /** Extension point for custom component types (#54). */
+    extensions?: Record<string, unknown[]>;
+}
+interface McpServerRef {
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+
+/**
+ * Domain Context Component definitions.
+ * These are the resolved, concrete forms of components referenced by name in templates.
+ */
+/** Tracks where a component came from. */
+type ComponentOriginType = "builtin" | "source" | "local";
+interface ComponentOrigin {
+    type: ComponentOriginType;
+    /** For source-originated components: the source package name */
+    sourceName?: string;
+    /** Hash at the time of last sync */
+    syncHash?: string;
+    syncedAt?: string;
+    /** Whether the user has locally modified the synced copy */
+    modified?: boolean;
+}
+/**
+ * Base interface for all shareable components.
+ * All component types extend this to get version tracking and origin metadata.
+ */
+interface VersionedComponent {
+    name: string;
+    /** Semver version string. Optional for backward compatibility; unset defaults to "0.0.0". */
+    version?: string;
+    description?: string;
+    /** Component type discriminator for manifest.json envelope (#58) */
+    $type?: string;
+    /** Manifest schema version (#58) */
+    $version?: number;
+    /** Tracks where this component originated from */
+    origin?: ComponentOrigin;
+    tags?: string[];
+}
+/** A Skill = a set of rules/knowledge an Agent should follow. */
+interface SkillDefinition extends VersionedComponent {
+    /** The actual skill content (markdown/text rules) */
+    content: string;
+}
+/** A Prompt = a system prompt or instruction set. */
+interface PromptDefinition extends VersionedComponent {
+    /** The prompt content, may contain {{variable}} placeholders */
+    content: string;
+    /** Variable names expected in the content */
+    variables?: string[];
+}
+/** A Workflow = a development workflow template (directory-based). */
+interface WorkflowDefinition extends VersionedComponent {
+    /** The workflow content (e.g. workflow.md contents) */
+    content: string;
+}
+/** MCP Server configuration (resolved form, same structure as McpServerRef). */
+interface McpServerDefinition extends VersionedComponent {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * A Plugin = an agent-side capability extension.
+ * Examples: Claude Code plugins, Cursor extensions, custom tool integrations.
+ * Distinct from Actant system-level plugins (Phase 4 #13).
+ */
+interface PluginDefinition extends VersionedComponent {
+    /** Plugin type: npm package, local file, or JSON config */
+    type: "npm" | "file" | "config";
+    /** For npm: package specifier (e.g. "@anthropic/memory"). For file: relative path. */
+    source?: string;
+    /** Plugin-specific configuration */
+    config?: Record<string, unknown>;
+    /** Whether this plugin is enabled by default */
+    enabled?: boolean;
+}
+
+type PermissionMode = "default" | "acceptEdits" | "plan" | "dontAsk" | "bypassPermissions";
+type PermissionPreset = "permissive" | "standard" | "restricted" | "readonly";
+interface SandboxNetworkConfig {
+    allowedDomains?: string[];
+    allowLocalBinding?: boolean;
+}
+interface SandboxConfig {
+    enabled?: boolean;
+    autoAllowBashIfSandboxed?: boolean;
+    network?: SandboxNetworkConfig;
+}
+interface PermissionsConfig {
+    allow?: string[];
+    deny?: string[];
+    ask?: string[];
+    defaultMode?: PermissionMode;
+    sandbox?: SandboxConfig;
+    additionalDirectories?: string[];
+}
+/** Permissions field on a template: either a preset name or full config. */
+type PermissionsInput = PermissionPreset | PermissionsConfig;
+interface AgentTemplate extends VersionedComponent {
+    /** Required override: templates must have an explicit semver version. */
+    version: string;
+    backend: AgentBackendConfig;
+    provider: ModelProviderConfig;
+    domainContext: DomainContextConfig;
+    /** Tool/file/network permission control, aligned with Claude Code permissions. */
+    permissions?: PermissionsInput;
+    initializer?: InitializerConfig;
+    schedule?: {
+        heartbeat?: {
+            intervalMs: number;
+            prompt: string;
+            priority?: string;
+        };
+        cron?: Array<{
+            pattern: string;
+            prompt: string;
+            timezone?: string;
+            priority?: string;
+        }>;
+        hooks?: Array<{
+            eventName: string;
+            prompt: string;
+            priority?: string;
+        }>;
+    };
+    metadata?: Record<string, string>;
+}
+interface AgentBackendConfig {
+    type: AgentBackendType;
+    /** Optional backend-specific config (e.g. executablePath for launcher). Used in materialization and persisted on instance. */
+    config?: Record<string, unknown>;
+}
+type AgentBackendType = "cursor" | "claude-code" | "custom";
+interface ModelProviderConfig {
+    type: ModelProviderType;
+    config?: Record<string, unknown>;
+}
+type ModelProviderType = "anthropic" | "openai" | "custom";
+interface InitializerConfig {
+    steps: InitializerStep[];
+}
+interface InitializerStep {
+    type: string;
+    config?: Record<string, unknown>;
+}
+
+/**
+ * Agent Instance = a workspace directory.
+ * `.actant.json` is the metadata descriptor of that directory.
+ * The directory itself IS the instance — containing materialized Domain Context files.
+ */
+interface AgentInstanceMeta {
+    id: string;
+    name: string;
+    templateName: string;
+    templateVersion: string;
+    /** Backend type (cursor / claude-code / custom). Set from template when instance is created. */
+    backendType: AgentBackendType;
+    /** Backend config from template (e.g. executablePath). Persisted so launcher can use without template registry. */
+    backendConfig?: Record<string, unknown>;
+    status: AgentStatus;
+    launchMode: LaunchMode;
+    /** Workspace lifecycle policy. "persistent" survives across spawns; "ephemeral" can be cleaned up after task. */
+    workspacePolicy: WorkspacePolicy;
+    /** Who owns/manages the agent process. "managed" = Actant, "external" = caller. */
+    processOwnership: ProcessOwnership;
+    createdAt: string;
+    updatedAt: string;
+    pid?: number;
+    /** Resolved permissions for this instance (after template + override resolution). */
+    effectivePermissions?: PermissionsConfig;
+    metadata?: Record<string, string>;
+}
+type AgentStatus = "created" | "starting" | "running" | "stopping" | "stopped" | "error" | "crashed";
+type LaunchMode = "direct" | "acp-background" | "acp-service" | "one-shot";
+type ProcessOwnership = "managed" | "external";
+/** Workspace filesystem lifecycle policy, independent of process lifecycle. */
+type WorkspacePolicy = "persistent" | "ephemeral";
+/** Information needed to spawn an agent process externally. */
+interface ResolveResult {
+    workspaceDir: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    instanceName: string;
+    backendType: AgentBackendType;
+    /** Whether a new instance was created by this resolve call. */
+    created: boolean;
+}
+/** Result of detaching an externally-managed process. */
+interface DetachResult {
+    ok: boolean;
+    workspaceCleaned: boolean;
+}
+
+/**
+ * Unified configuration validation result types (#119).
+ * Used across all config validators (templates, domain components, sub-configs).
+ */
+type ValidationSeverity = "error" | "warning" | "info";
+/** A single validation issue with path, message, and severity. */
+interface ValidationIssue {
+    /** Dot-separated path to the problematic field (e.g. "domainContext.skills") */
+    path: string;
+    message: string;
+    severity: ValidationSeverity;
+    /** Machine-readable code for programmatic handling (e.g. "DUPLICATE_NAME", "DEPRECATED_FIELD") */
+    code?: string;
+}
+/**
+ * Structured result from any config validation.
+ * @template T The validated configuration type
+ */
+interface ConfigValidationResult<T = unknown> {
+    valid: boolean;
+    data?: T;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+
+/** Discriminated union for source configurations. New source types extend this. */
+type SourceConfig = GitHubSourceConfig | LocalSourceConfig;
+interface GitHubSourceConfig {
+    type: "github";
+    url: string;
+    branch?: string;
+}
+interface LocalSourceConfig {
+    type: "local";
+    path: string;
+}
+/** Persisted source entry (stored in sources.json). */
+interface SourceEntry {
+    name: string;
+    config: SourceConfig;
+    syncedAt?: string;
+}
+interface PackageManifest {
+    name: string;
+    version?: string;
+    description?: string;
+    components?: {
+        skills?: string[];
+        prompts?: string[];
+        mcp?: string[];
+        workflows?: string[];
+        templates?: string[];
+    };
+    presets?: string[];
+}
+interface PresetDefinition {
+    name: string;
+    version?: string;
+    description?: string;
+    skills?: string[];
+    prompts?: string[];
+    mcpServers?: string[];
+    workflows?: string[];
+    templates?: string[];
+}
+
+interface RpcRequest {
+    jsonrpc: "2.0";
+    id: number | string;
+    method: string;
+    params?: Record<string, unknown>;
+}
+interface RpcResponse {
+    jsonrpc: "2.0";
+    id: number | string;
+    result?: unknown;
+    error?: RpcError;
+}
+interface RpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+declare const RPC_ERROR_CODES: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly TEMPLATE_NOT_FOUND: -32001;
+    readonly CONFIG_VALIDATION: -32002;
+    readonly AGENT_NOT_FOUND: -32003;
+    readonly AGENT_ALREADY_RUNNING: -32004;
+    readonly WORKSPACE_INIT: -32005;
+    readonly COMPONENT_REFERENCE: -32006;
+    readonly INSTANCE_CORRUPTED: -32007;
+    readonly AGENT_LAUNCH: -32008;
+    readonly AGENT_ALREADY_ATTACHED: -32009;
+    readonly AGENT_NOT_ATTACHED: -32010;
+    readonly GENERIC_BUSINESS: -32000;
+};
+type RpcErrorCode = (typeof RPC_ERROR_CODES)[keyof typeof RPC_ERROR_CODES];
+type TemplateListParams = Record<string, never>;
+type TemplateListResult = AgentTemplate[];
+interface TemplateGetParams {
+    name: string;
+}
+type TemplateGetResult = AgentTemplate;
+interface TemplateLoadParams {
+    filePath: string;
+}
+type TemplateLoadResult = AgentTemplate;
+interface TemplateUnloadParams {
+    name: string;
+}
+interface TemplateUnloadResult {
+    success: boolean;
+}
+interface TemplateValidateParams {
+    filePath: string;
+}
+interface TemplateValidateResult {
+    valid: boolean;
+    template?: AgentTemplate;
+    errors?: Array<{
+        path: string;
+        message: string;
+    }>;
+    /** Warnings that don't prevent loading but indicate potential issues (#119) */
+    warnings?: Array<{
+        path: string;
+        message: string;
+    }>;
+}
+type WorkDirConflict = "error" | "overwrite" | "append";
+interface AgentCreateParams {
+    name: string;
+    template: string;
+    overrides?: {
+        launchMode?: LaunchMode;
+        workspacePolicy?: WorkspacePolicy;
+        /** Absolute path to use as workspace directory instead of the default {instancesDir}/{name}. */
+        workDir?: string;
+        /** Behavior when workDir already exists. Default: "error". */
+        workDirConflict?: WorkDirConflict;
+        /** Override template permissions. Completely replaces template.permissions when set. */
+        permissions?: PermissionsInput;
+        metadata?: Record<string, string>;
+    };
+}
+type AgentCreateResult = AgentInstanceMeta;
+interface AgentStartParams {
+    name: string;
+}
+type AgentStartResult = AgentInstanceMeta;
+interface AgentStopParams {
+    name: string;
+}
+type AgentStopResult = AgentInstanceMeta;
+interface AgentDestroyParams {
+    name: string;
+}
+interface AgentDestroyResult {
+    success: boolean;
+}
+interface AgentStatusParams {
+    name: string;
+}
+type AgentStatusResult = AgentInstanceMeta;
+type AgentListParams = Record<string, never>;
+type AgentListResult = AgentInstanceMeta[];
+interface AgentUpdatePermissionsParams {
+    name: string;
+    permissions: PermissionsInput;
+}
+interface AgentUpdatePermissionsResult {
+    effectivePermissions: PermissionsConfig;
+}
+interface AgentAdoptParams {
+    path: string;
+    rename?: string;
+}
+interface AgentAdoptResult {
+    name: string;
+    template: string;
+    workspacePath: string;
+    location: "builtin" | "external";
+    createdAt: string;
+    status: "stopped" | "running" | "orphaned";
+}
+interface AgentResolveParams {
+    name: string;
+    template?: string;
+    overrides?: {
+        launchMode?: LaunchMode;
+        workspacePolicy?: WorkspacePolicy;
+        metadata?: Record<string, string>;
+    };
+}
+type AgentResolveResult = ResolveResult;
+interface AgentAttachParams {
+    name: string;
+    pid: number;
+    metadata?: Record<string, string>;
+}
+type AgentAttachResult = AgentInstanceMeta;
+interface AgentDetachParams {
+    name: string;
+    cleanup?: boolean;
+}
+type AgentDetachResult = DetachResult;
+interface AgentRunParams {
+    name: string;
+    prompt: string;
+    options?: {
+        systemPromptFile?: string;
+        appendSystemPrompt?: string;
+        sessionId?: string;
+        timeoutMs?: number;
+        maxTurns?: number;
+        model?: string;
+    };
+}
+interface AgentRunResult {
+    text: string;
+    sessionId?: string;
+}
+interface AgentDispatchParams {
+    name: string;
+    prompt: string;
+    priority?: string;
+}
+interface AgentDispatchResult {
+    queued: boolean;
+}
+interface AgentTasksParams {
+    name: string;
+}
+interface AgentTasksResult {
+    queued: number;
+    processing: boolean;
+    tasks: unknown[];
+}
+interface AgentLogsParams {
+    name: string;
+    limit?: number;
+}
+type AgentLogsResult = unknown[];
+interface ScheduleListParams {
+    name: string;
+}
+interface ScheduleListResult {
+    sources: Array<{
+        id: string;
+        type: string;
+        active: boolean;
+    }>;
+    running: boolean;
+}
+interface AgentPromptParams {
+    name: string;
+    message: string;
+    sessionId?: string;
+}
+interface AgentPromptResult {
+    response: string;
+    sessionId: string;
+}
+interface SessionCreateParams {
+    agentName: string;
+    clientId: string;
+    idleTtlMs?: number;
+}
+interface SessionLeaseInfo {
+    sessionId: string;
+    agentName: string;
+    clientId: string | null;
+    state: "active" | "idle" | "expired";
+    createdAt: string;
+    lastActivityAt: string;
+    idleTtlMs: number;
+}
+type SessionCreateResult = SessionLeaseInfo;
+interface SessionPromptParams {
+    sessionId: string;
+    text: string;
+}
+interface SessionPromptResult {
+    stopReason: string;
+    text: string;
+}
+interface SessionCancelParams {
+    sessionId: string;
+}
+interface SessionCancelResult {
+    ok: boolean;
+}
+interface SessionCloseParams {
+    sessionId: string;
+}
+interface SessionCloseResult {
+    ok: boolean;
+}
+interface SessionListParams {
+    agentName?: string;
+}
+type SessionListResult = SessionLeaseInfo[];
+interface ProxyConnectParams {
+    agentName: string;
+    envPassthrough?: boolean;
+}
+interface ProxySession {
+    sessionId: string;
+    agentName: string;
+    envPassthrough: boolean;
+    connectedAt: string;
+}
+type ProxyConnectResult = ProxySession;
+interface ProxyDisconnectParams {
+    sessionId: string;
+}
+interface ProxyDisconnectResult {
+    ok: boolean;
+}
+interface ProxyForwardParams {
+    sessionId: string;
+    acpMessage: Record<string, unknown>;
+}
+type ProxyForwardResult = Record<string, unknown>;
+type SkillListParams = Record<string, never>;
+type SkillListResult = SkillDefinition[];
+interface SkillGetParams {
+    name: string;
+}
+type SkillGetResult = SkillDefinition;
+type PromptListParams = Record<string, never>;
+type PromptListResult = PromptDefinition[];
+interface PromptGetParams {
+    name: string;
+}
+type PromptGetResult = PromptDefinition;
+type McpListParams = Record<string, never>;
+type McpListResult = McpServerDefinition[];
+interface McpGetParams {
+    name: string;
+}
+type McpGetResult = McpServerDefinition;
+type WorkflowListParams = Record<string, never>;
+type WorkflowListResult = WorkflowDefinition[];
+interface WorkflowGetParams {
+    name: string;
+}
+type WorkflowGetResult = WorkflowDefinition;
+type PluginListParams = Record<string, never>;
+type PluginListResult = PluginDefinition[];
+interface PluginGetParams {
+    name: string;
+}
+type PluginGetResult = PluginDefinition;
+type DaemonPingParams = Record<string, never>;
+interface DaemonPingResult {
+    version: string;
+    uptime: number;
+    agents: number;
+}
+type DaemonShutdownParams = Record<string, never>;
+interface DaemonShutdownResult {
+    success: boolean;
+}
+interface GatewayLeaseParams {
+    agentName: string;
+}
+interface GatewayLeaseResult {
+    socketPath: string;
+}
+interface ComponentAddParams {
+    component: Record<string, unknown>;
+}
+interface ComponentAddResult {
+    name: string;
+}
+interface ComponentUpdateParams {
+    name: string;
+    patch: Record<string, unknown>;
+}
+interface ComponentUpdateResult {
+    name: string;
+}
+interface ComponentRemoveParams {
+    name: string;
+}
+interface ComponentRemoveResult {
+    success: boolean;
+}
+interface ComponentImportParams {
+    filePath: string;
+}
+interface ComponentImportResult {
+    name: string;
+}
+interface ComponentExportParams {
+    name: string;
+    filePath: string;
+}
+interface ComponentExportResult {
+    success: boolean;
+}
+type SourceListParams = Record<string, never>;
+type SourceListResult = SourceEntry[];
+interface SourceAddParams {
+    name: string;
+    config: SourceConfig;
+}
+interface SourceAddResult {
+    name: string;
+    components: {
+        skills: number;
+        prompts: number;
+        mcp: number;
+        workflows: number;
+        presets: number;
+    };
+}
+interface SourceRemoveParams {
+    name: string;
+}
+interface SourceRemoveResult {
+    success: boolean;
+}
+interface SourceSyncParams {
+    name?: string;
+}
+interface SourceSyncResult {
+    synced: string[];
+    /** Sync report summary (aggregated when syncing multiple sources). */
+    report?: {
+        addedCount: number;
+        updatedCount: number;
+        removedCount: number;
+        hasBreakingChanges: boolean;
+    };
+}
+interface PresetListParams {
+    packageName?: string;
+}
+type PresetListResult = PresetDefinition[];
+interface PresetShowParams {
+    qualifiedName: string;
+}
+type PresetShowResult = PresetDefinition;
+interface PresetApplyParams {
+    qualifiedName: string;
+    templateName: string;
+}
+type PresetApplyResult = AgentTemplate;
+interface RpcMethodMap {
+    "template.list": {
+        params: TemplateListParams;
+        result: TemplateListResult;
+    };
+    "template.get": {
+        params: TemplateGetParams;
+        result: TemplateGetResult;
+    };
+    "template.load": {
+        params: TemplateLoadParams;
+        result: TemplateLoadResult;
+    };
+    "template.unload": {
+        params: TemplateUnloadParams;
+        result: TemplateUnloadResult;
+    };
+    "template.validate": {
+        params: TemplateValidateParams;
+        result: TemplateValidateResult;
+    };
+    "agent.create": {
+        params: AgentCreateParams;
+        result: AgentCreateResult;
+    };
+    "agent.start": {
+        params: AgentStartParams;
+        result: AgentStartResult;
+    };
+    "agent.stop": {
+        params: AgentStopParams;
+        result: AgentStopResult;
+    };
+    "agent.destroy": {
+        params: AgentDestroyParams;
+        result: AgentDestroyResult;
+    };
+    "agent.status": {
+        params: AgentStatusParams;
+        result: AgentStatusResult;
+    };
+    "agent.list": {
+        params: AgentListParams;
+        result: AgentListResult;
+    };
+    "agent.updatePermissions": {
+        params: AgentUpdatePermissionsParams;
+        result: AgentUpdatePermissionsResult;
+    };
+    "agent.adopt": {
+        params: AgentAdoptParams;
+        result: AgentAdoptResult;
+    };
+    "agent.resolve": {
+        params: AgentResolveParams;
+        result: AgentResolveResult;
+    };
+    "agent.attach": {
+        params: AgentAttachParams;
+        result: AgentAttachResult;
+    };
+    "agent.detach": {
+        params: AgentDetachParams;
+        result: AgentDetachResult;
+    };
+    "agent.run": {
+        params: AgentRunParams;
+        result: AgentRunResult;
+    };
+    "agent.prompt": {
+        params: AgentPromptParams;
+        result: AgentPromptResult;
+    };
+    "agent.dispatch": {
+        params: AgentDispatchParams;
+        result: AgentDispatchResult;
+    };
+    "agent.tasks": {
+        params: AgentTasksParams;
+        result: AgentTasksResult;
+    };
+    "agent.logs": {
+        params: AgentLogsParams;
+        result: AgentLogsResult;
+    };
+    "schedule.list": {
+        params: ScheduleListParams;
+        result: ScheduleListResult;
+    };
+    "session.create": {
+        params: SessionCreateParams;
+        result: SessionCreateResult;
+    };
+    "session.prompt": {
+        params: SessionPromptParams;
+        result: SessionPromptResult;
+    };
+    "session.cancel": {
+        params: SessionCancelParams;
+        result: SessionCancelResult;
+    };
+    "session.close": {
+        params: SessionCloseParams;
+        result: SessionCloseResult;
+    };
+    "session.list": {
+        params: SessionListParams;
+        result: SessionListResult;
+    };
+    "proxy.connect": {
+        params: ProxyConnectParams;
+        result: ProxyConnectResult;
+    };
+    "proxy.disconnect": {
+        params: ProxyDisconnectParams;
+        result: ProxyDisconnectResult;
+    };
+    "proxy.forward": {
+        params: ProxyForwardParams;
+        result: ProxyForwardResult;
+    };
+    "skill.list": {
+        params: SkillListParams;
+        result: SkillListResult;
+    };
+    "skill.get": {
+        params: SkillGetParams;
+        result: SkillGetResult;
+    };
+    "skill.add": {
+        params: ComponentAddParams;
+        result: ComponentAddResult;
+    };
+    "skill.update": {
+        params: ComponentUpdateParams;
+        result: ComponentUpdateResult;
+    };
+    "skill.remove": {
+        params: ComponentRemoveParams;
+        result: ComponentRemoveResult;
+    };
+    "skill.import": {
+        params: ComponentImportParams;
+        result: ComponentImportResult;
+    };
+    "skill.export": {
+        params: ComponentExportParams;
+        result: ComponentExportResult;
+    };
+    "prompt.list": {
+        params: PromptListParams;
+        result: PromptListResult;
+    };
+    "prompt.get": {
+        params: PromptGetParams;
+        result: PromptGetResult;
+    };
+    "prompt.add": {
+        params: ComponentAddParams;
+        result: ComponentAddResult;
+    };
+    "prompt.update": {
+        params: ComponentUpdateParams;
+        result: ComponentUpdateResult;
+    };
+    "prompt.remove": {
+        params: ComponentRemoveParams;
+        result: ComponentRemoveResult;
+    };
+    "prompt.import": {
+        params: ComponentImportParams;
+        result: ComponentImportResult;
+    };
+    "prompt.export": {
+        params: ComponentExportParams;
+        result: ComponentExportResult;
+    };
+    "mcp.list": {
+        params: McpListParams;
+        result: McpListResult;
+    };
+    "mcp.get": {
+        params: McpGetParams;
+        result: McpGetResult;
+    };
+    "mcp.add": {
+        params: ComponentAddParams;
+        result: ComponentAddResult;
+    };
+    "mcp.update": {
+        params: ComponentUpdateParams;
+        result: ComponentUpdateResult;
+    };
+    "mcp.remove": {
+        params: ComponentRemoveParams;
+        result: ComponentRemoveResult;
+    };
+    "mcp.import": {
+        params: ComponentImportParams;
+        result: ComponentImportResult;
+    };
+    "mcp.export": {
+        params: ComponentExportParams;
+        result: ComponentExportResult;
+    };
+    "workflow.list": {
+        params: WorkflowListParams;
+        result: WorkflowListResult;
+    };
+    "workflow.get": {
+        params: WorkflowGetParams;
+        result: WorkflowGetResult;
+    };
+    "workflow.add": {
+        params: ComponentAddParams;
+        result: ComponentAddResult;
+    };
+    "workflow.update": {
+        params: ComponentUpdateParams;
+        result: ComponentUpdateResult;
+    };
+    "workflow.remove": {
+        params: ComponentRemoveParams;
+        result: ComponentRemoveResult;
+    };
+    "workflow.import": {
+        params: ComponentImportParams;
+        result: ComponentImportResult;
+    };
+    "workflow.export": {
+        params: ComponentExportParams;
+        result: ComponentExportResult;
+    };
+    "plugin.list": {
+        params: PluginListParams;
+        result: PluginListResult;
+    };
+    "plugin.get": {
+        params: PluginGetParams;
+        result: PluginGetResult;
+    };
+    "plugin.add": {
+        params: ComponentAddParams;
+        result: ComponentAddResult;
+    };
+    "plugin.update": {
+        params: ComponentUpdateParams;
+        result: ComponentUpdateResult;
+    };
+    "plugin.remove": {
+        params: ComponentRemoveParams;
+        result: ComponentRemoveResult;
+    };
+    "plugin.import": {
+        params: ComponentImportParams;
+        result: ComponentImportResult;
+    };
+    "plugin.export": {
+        params: ComponentExportParams;
+        result: ComponentExportResult;
+    };
+    "source.list": {
+        params: SourceListParams;
+        result: SourceListResult;
+    };
+    "source.add": {
+        params: SourceAddParams;
+        result: SourceAddResult;
+    };
+    "source.remove": {
+        params: SourceRemoveParams;
+        result: SourceRemoveResult;
+    };
+    "source.sync": {
+        params: SourceSyncParams;
+        result: SourceSyncResult;
+    };
+    "preset.list": {
+        params: PresetListParams;
+        result: PresetListResult;
+    };
+    "preset.show": {
+        params: PresetShowParams;
+        result: PresetShowResult;
+    };
+    "preset.apply": {
+        params: PresetApplyParams;
+        result: PresetApplyResult;
+    };
+    "daemon.ping": {
+        params: DaemonPingParams;
+        result: DaemonPingResult;
+    };
+    "daemon.shutdown": {
+        params: DaemonShutdownParams;
+        result: DaemonShutdownResult;
+    };
+    "gateway.lease": {
+        params: GatewayLeaseParams;
+        result: GatewayLeaseResult;
+    };
+}
+type RpcMethod = keyof RpcMethodMap;
+
+type ErrorCategory = "configuration" | "lifecycle" | "communication" | "cli";
+declare abstract class ActantError extends Error {
+    abstract readonly code: string;
+    abstract readonly category: ErrorCategory;
+    readonly timestamp: Date;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, context?: Record<string, unknown>);
+}
+
+declare class ConfigNotFoundError extends ActantError {
+    readonly code = "CONFIG_NOT_FOUND";
+    readonly category: ErrorCategory;
+    constructor(configPath: string);
+}
+declare class ConfigValidationError extends ActantError {
+    readonly validationErrors: Array<{
+        path: string;
+        message: string;
+    }>;
+    /** Structured validation issues with severity (#119) */
+    readonly issues?: ValidationIssue[] | undefined;
+    readonly code = "CONFIG_VALIDATION_ERROR";
+    readonly category: ErrorCategory;
+    constructor(message: string, validationErrors: Array<{
+        path: string;
+        message: string;
+    }>, 
+    /** Structured validation issues with severity (#119) */
+    issues?: ValidationIssue[] | undefined);
+}
+declare class TemplateNotFoundError extends ActantError {
+    readonly code = "TEMPLATE_NOT_FOUND";
+    readonly category: ErrorCategory;
+    constructor(templateName: string);
+}
+declare class SkillReferenceError extends ActantError {
+    readonly code = "SKILL_REFERENCE_ERROR";
+    readonly category: ErrorCategory;
+    constructor(skillName: string);
+}
+declare class ComponentReferenceError extends ActantError {
+    readonly code = "COMPONENT_REFERENCE_ERROR";
+    readonly category: ErrorCategory;
+    constructor(componentType: string, componentName: string);
+}
+declare class CircularReferenceError extends ActantError {
+    readonly code = "CIRCULAR_REFERENCE";
+    readonly category: ErrorCategory;
+    constructor(cyclePath: string[]);
+}
+
+declare class AgentLaunchError extends ActantError {
+    readonly code = "AGENT_LAUNCH_ERROR";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string, cause?: Error);
+}
+declare class AgentNotFoundError extends ActantError {
+    readonly code = "AGENT_NOT_FOUND";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string);
+}
+declare class AgentAlreadyRunningError extends ActantError {
+    readonly code = "AGENT_ALREADY_RUNNING";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string);
+}
+declare class AgentAlreadyAttachedError extends ActantError {
+    readonly code = "AGENT_ALREADY_ATTACHED";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string);
+}
+declare class AgentNotAttachedError extends ActantError {
+    readonly code = "AGENT_NOT_ATTACHED";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string);
+}
+declare class InstanceCorruptedError extends ActantError {
+    readonly code = "INSTANCE_CORRUPTED";
+    readonly category: ErrorCategory;
+    constructor(instanceName: string, reason: string);
+}
+declare class WorkspaceInitError extends ActantError {
+    readonly code = "WORKSPACE_INIT_ERROR";
+    readonly category: ErrorCategory;
+    constructor(workspacePath: string, cause?: Error);
+}
+
+type Logger = pino.Logger;
+declare function createLogger(module: string): Logger;
+
+/**
+ * Returns the platform-appropriate IPC path for daemon communication.
+ *
+ * - macOS/Linux: Unix domain socket at `~/.actant/actant.sock`
+ * - Windows: Named pipe at `\\.\pipe\actant`
+ *
+ * Named pipes are the standard Windows IPC mechanism and work with
+ * Node.js `net.createServer` / `net.createConnection` transparently.
+ */
+declare function getDefaultIpcPath(homeDir?: string): string;
+/**
+ * Returns the IPC path for a given home directory.
+ * Used by AppContext when homeDir is explicitly provided.
+ */
+declare function getIpcPath(homeDir: string): string;
+/**
+ * Whether the current platform uses file-based IPC (Unix sockets)
+ * that may need cleanup (unlink) before listening.
+ */
+declare function ipcRequiresFileCleanup(): boolean;
+/**
+ * Registers graceful shutdown handlers that work across all platforms.
+ *
+ * - Unix: SIGINT, SIGTERM
+ * - Windows: SIGINT (Ctrl+C in terminal), SIGBREAK (Ctrl+Break)
+ *
+ * SIGTERM is not reliably delivered on Windows, so we also listen for
+ * SIGBREAK which is the closest equivalent.
+ */
+declare function onShutdownSignal(handler: () => void | Promise<void>): void;
+declare function isWindows(): boolean;
+/**
+ * Detects if the process is running as a Node.js Single Executable Application.
+ * Uses `node:sea` module (Node 20+) with a fallback heuristic.
+ */
+declare function isSingleExecutable(): boolean;
+
+export { ActantError, type AgentAdoptParams, type AgentAdoptResult, AgentAlreadyAttachedError, AgentAlreadyRunningError, type AgentAttachParams, type AgentAttachResult, type AgentBackendConfig, type AgentBackendType, type AgentCreateParams, type AgentCreateResult, type AgentDestroyParams, type AgentDestroyResult, type AgentDetachParams, type AgentDetachResult, type AgentDispatchParams, type AgentDispatchResult, type AgentInstanceMeta, AgentLaunchError, type AgentListParams, type AgentListResult, type AgentLogsParams, type AgentLogsResult, AgentNotAttachedError, AgentNotFoundError, type AgentPromptParams, type AgentPromptResult, type AgentResolveParams, type AgentResolveResult, type AgentRunParams, type AgentRunResult, type AgentStartParams, type AgentStartResult, type AgentStatus, type AgentStatusParams, type AgentStatusResult, type AgentStopParams, type AgentStopResult, type AgentTasksParams, type AgentTasksResult, type AgentTemplate, type AgentUpdatePermissionsParams, type AgentUpdatePermissionsResult, CircularReferenceError, type ComponentAddParams, type ComponentAddResult, type ComponentExportParams, type ComponentExportResult, type ComponentImportParams, type ComponentImportResult, type ComponentOrigin, type ComponentOriginType, ComponentReferenceError, type ComponentRemoveParams, type ComponentRemoveResult, type ComponentUpdateParams, type ComponentUpdateResult, ConfigNotFoundError, ConfigValidationError, type ConfigValidationResult, type DaemonPingParams, type DaemonPingResult, type DaemonShutdownParams, type DaemonShutdownResult, type DetachResult, type DomainContextConfig, type ErrorCategory, type GitHubSourceConfig, type InitializerConfig, type InitializerStep, InstanceCorruptedError, type LaunchMode, type LocalSourceConfig, type Logger, type McpGetParams, type McpGetResult, type McpListParams, type McpListResult, type McpServerDefinition, type McpServerRef, type ModelProviderConfig, type ModelProviderType, type PackageManifest, type PermissionMode, type PermissionPreset, type PermissionsConfig, type PermissionsInput, type PluginDefinition, type PluginGetParams, type PluginGetResult, type PluginListParams, type PluginListResult, type PresetApplyParams, type PresetApplyResult, type PresetDefinition, type PresetListParams, type PresetListResult, type PresetShowParams, type PresetShowResult, type ProcessOwnership, type PromptDefinition, type PromptGetParams, type PromptGetResult, type PromptListParams, type PromptListResult, type ProxyConnectParams, type ProxyConnectResult, type ProxyDisconnectParams, type ProxyDisconnectResult, type ProxyForwardParams, type ProxyForwardResult, type ProxySession, RPC_ERROR_CODES, type ResolveResult, type RpcError, type RpcErrorCode, type RpcMethod, type RpcMethodMap, type RpcRequest, type RpcResponse, type SandboxConfig, type SandboxNetworkConfig, type ScheduleListParams, type ScheduleListResult, type SessionCancelParams, type SessionCancelResult, type SessionCloseParams, type SessionCloseResult, type SessionCreateParams, type SessionCreateResult, type SessionLeaseInfo, type SessionListParams, type SessionListResult, type SessionPromptParams, type SessionPromptResult, type SkillDefinition, type SkillGetParams, type SkillGetResult, type SkillListParams, type SkillListResult, SkillReferenceError, type SourceAddParams, type SourceAddResult, type SourceConfig, type SourceEntry, type SourceListParams, type SourceListResult, type SourceRemoveParams, type SourceRemoveResult, type SourceSyncParams, type SourceSyncResult, type TemplateGetParams, type TemplateGetResult, type TemplateListParams, type TemplateListResult, type TemplateLoadParams, type TemplateLoadResult, TemplateNotFoundError, type TemplateUnloadParams, type TemplateUnloadResult, type TemplateValidateParams, type TemplateValidateResult, type ValidationIssue, type ValidationSeverity, type VersionedComponent, type WorkDirConflict, type WorkflowDefinition, type WorkflowGetParams, type WorkflowGetResult, type WorkflowListParams, type WorkflowListResult, WorkspaceInitError, type WorkspacePolicy, createLogger, getDefaultIpcPath, getIpcPath, ipcRequiresFileCleanup, isSingleExecutable, isWindows, onShutdownSignal };