@actant/shared 0.1.2

package/dist/index.js

@@ -0,0 +1,247 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/types/rpc.types.ts
+var RPC_ERROR_CODES = {
+  PARSE_ERROR: -32700,
+  INVALID_REQUEST: -32600,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  INTERNAL_ERROR: -32603,
+  TEMPLATE_NOT_FOUND: -32001,
+  CONFIG_VALIDATION: -32002,
+  AGENT_NOT_FOUND: -32003,
+  AGENT_ALREADY_RUNNING: -32004,
+  WORKSPACE_INIT: -32005,
+  COMPONENT_REFERENCE: -32006,
+  INSTANCE_CORRUPTED: -32007,
+  AGENT_LAUNCH: -32008,
+  AGENT_ALREADY_ATTACHED: -32009,
+  AGENT_NOT_ATTACHED: -32010,
+  GENERIC_BUSINESS: -32e3
+};
+
+// src/errors/base-error.ts
+var ActantError = class extends Error {
+  timestamp;
+  context;
+  constructor(message, context) {
+    super(message);
+    this.name = this.constructor.name;
+    this.timestamp = /* @__PURE__ */ new Date();
+    this.context = context;
+  }
+};
+
+// src/errors/config-errors.ts
+var ConfigNotFoundError = class extends ActantError {
+  code = "CONFIG_NOT_FOUND";
+  category = "configuration";
+  constructor(configPath) {
+    super(`Configuration file not found: ${configPath}`, { configPath });
+  }
+};
+var ConfigValidationError = class extends ActantError {
+  constructor(message, validationErrors, issues) {
+    super(message, { validationErrors });
+    this.validationErrors = validationErrors;
+    this.issues = issues;
+  }
+  code = "CONFIG_VALIDATION_ERROR";
+  category = "configuration";
+};
+var TemplateNotFoundError = class extends ActantError {
+  code = "TEMPLATE_NOT_FOUND";
+  category = "configuration";
+  constructor(templateName) {
+    super(`Template "${templateName}" not found in registry`, {
+      templateName
+    });
+  }
+};
+var SkillReferenceError = class extends ActantError {
+  code = "SKILL_REFERENCE_ERROR";
+  category = "configuration";
+  constructor(skillName) {
+    super(`Skill "${skillName}" not found in registry`, { skillName });
+  }
+};
+var ComponentReferenceError = class extends ActantError {
+  code = "COMPONENT_REFERENCE_ERROR";
+  category = "configuration";
+  constructor(componentType, componentName) {
+    super(`${componentType} "${componentName}" not found in registry`, {
+      componentType,
+      componentName
+    });
+  }
+};
+var CircularReferenceError = class extends ActantError {
+  code = "CIRCULAR_REFERENCE";
+  category = "configuration";
+  constructor(cyclePath) {
+    super(`Circular reference detected: ${cyclePath.join(" \u2192 ")}`, {
+      cyclePath
+    });
+  }
+};
+
+// src/errors/lifecycle-errors.ts
+var AgentLaunchError = class extends ActantError {
+  code = "AGENT_LAUNCH_ERROR";
+  category = "lifecycle";
+  constructor(instanceName, cause) {
+    super(`Failed to launch agent "${instanceName}"`, {
+      instanceName,
+      cause: cause?.message
+    });
+    if (cause) this.cause = cause;
+  }
+};
+var AgentNotFoundError = class extends ActantError {
+  code = "AGENT_NOT_FOUND";
+  category = "lifecycle";
+  constructor(instanceName) {
+    super(`Agent instance "${instanceName}" not found`, { instanceName });
+  }
+};
+var AgentAlreadyRunningError = class extends ActantError {
+  code = "AGENT_ALREADY_RUNNING";
+  category = "lifecycle";
+  constructor(instanceName) {
+    super(`Agent "${instanceName}" is already running`, { instanceName });
+  }
+};
+var AgentAlreadyAttachedError = class extends ActantError {
+  code = "AGENT_ALREADY_ATTACHED";
+  category = "lifecycle";
+  constructor(instanceName) {
+    super(`Agent "${instanceName}" already has an attached process`, { instanceName });
+  }
+};
+var AgentNotAttachedError = class extends ActantError {
+  code = "AGENT_NOT_ATTACHED";
+  category = "lifecycle";
+  constructor(instanceName) {
+    super(`Agent "${instanceName}" has no attached process`, { instanceName });
+  }
+};
+var InstanceCorruptedError = class extends ActantError {
+  code = "INSTANCE_CORRUPTED";
+  category = "lifecycle";
+  constructor(instanceName, reason) {
+    super(
+      `Agent instance "${instanceName}" is corrupted: ${reason}`,
+      { instanceName, reason }
+    );
+  }
+};
+var WorkspaceInitError = class extends ActantError {
+  code = "WORKSPACE_INIT_ERROR";
+  category = "lifecycle";
+  constructor(workspacePath, cause) {
+    super(`Failed to initialize workspace at "${workspacePath}"`, {
+      workspacePath,
+      cause: cause?.message
+    });
+    if (cause) this.cause = cause;
+  }
+};
+
+// src/logger/logger.ts
+import pino from "pino";
+function resolveLogLevel() {
+  if (process.env["LOG_LEVEL"]) return process.env["LOG_LEVEL"];
+  if (process.env["VITEST"] || process.env["NODE_ENV"] === "test") return "silent";
+  return "info";
+}
+function createLogger(module) {
+  return pino({
+    name: module,
+    level: resolveLogLevel(),
+    formatters: {
+      level(label) {
+        return { level: label };
+      }
+    },
+    timestamp: pino.stdTimeFunctions.isoTime
+  });
+}
+
+// src/platform/platform.ts
+import { join } from "path";
+import { homedir } from "os";
+var IS_WINDOWS = process.platform === "win32";
+function getDefaultIpcPath(homeDir) {
+  if (IS_WINDOWS) {
+    return "\\\\.\\pipe\\actant";
+  }
+  const base = homeDir ?? join(homedir(), ".actant");
+  return join(base, "actant.sock");
+}
+function getIpcPath(homeDir) {
+  if (IS_WINDOWS) {
+    const safeName = homeDir.replace(/[^a-zA-Z0-9._-]/g, "_");
+    return `\\\\.\\pipe\\actant-${safeName}`;
+  }
+  return join(homeDir, "actant.sock");
+}
+function ipcRequiresFileCleanup() {
+  return !IS_WINDOWS;
+}
+function onShutdownSignal(handler) {
+  const wrappedHandler = () => {
+    void Promise.resolve(handler());
+  };
+  process.on("SIGINT", wrappedHandler);
+  if (IS_WINDOWS) {
+    process.on("SIGBREAK", wrappedHandler);
+  } else {
+    process.on("SIGTERM", wrappedHandler);
+  }
+}
+function isWindows() {
+  return IS_WINDOWS;
+}
+var _isSea = false;
+var _isSeaChecked = false;
+function isSingleExecutable() {
+  if (_isSeaChecked) return _isSea;
+  _isSeaChecked = true;
+  try {
+    const sea = __require("sea");
+    _isSea = typeof sea.isSea === "function" ? sea.isSea() : false;
+  } catch {
+    _isSea = false;
+  }
+  return _isSea;
+}
+export {
+  ActantError,
+  AgentAlreadyAttachedError,
+  AgentAlreadyRunningError,
+  AgentLaunchError,
+  AgentNotAttachedError,
+  AgentNotFoundError,
+  CircularReferenceError,
+  ComponentReferenceError,
+  ConfigNotFoundError,
+  ConfigValidationError,
+  InstanceCorruptedError,
+  RPC_ERROR_CODES,
+  SkillReferenceError,
+  TemplateNotFoundError,
+  WorkspaceInitError,
+  createLogger,
+  getDefaultIpcPath,
+  getIpcPath,
+  ipcRequiresFileCleanup,
+  isSingleExecutable,
+  isWindows,
+  onShutdownSignal
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/rpc.types.ts","../src/errors/base-error.ts","../src/errors/config-errors.ts","../src/errors/lifecycle-errors.ts","../src/logger/logger.ts","../src/platform/platform.ts"],"sourcesContent":["import type { AgentTemplate, PermissionsInput, PermissionsConfig } from \"./template.types\";\nimport type { AgentInstanceMeta, LaunchMode, WorkspacePolicy, ResolveResult, DetachResult } from \"./agent.types\";\nimport type { SkillDefinition, PromptDefinition, McpServerDefinition, WorkflowDefinition, PluginDefinition } from \"./domain-component.types\";\nimport type { SourceEntry, SourceConfig, PresetDefinition } from \"./source.types\";\n\n// ---------------------------------------------------------------------------\n// JSON-RPC 2.0 base types\n// ---------------------------------------------------------------------------\n\nexport interface RpcRequest {\n  jsonrpc: \"2.0\";\n  id: number | string;\n  method: string;\n  params?: Record<string, unknown>;\n}\n\nexport interface RpcResponse {\n  jsonrpc: \"2.0\";\n  id: number | string;\n  result?: unknown;\n  error?: RpcError;\n}\n\nexport interface RpcError {\n  code: number;\n  message: string;\n  data?: unknown;\n}\n\n// ---------------------------------------------------------------------------\n// Error codes — maps ActantError codes to JSON-RPC error codes\n// ---------------------------------------------------------------------------\n\nexport const RPC_ERROR_CODES = {\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n\n  TEMPLATE_NOT_FOUND: -32001,\n  CONFIG_VALIDATION: -32002,\n  AGENT_NOT_FOUND: -32003,\n  AGENT_ALREADY_RUNNING: -32004,\n  WORKSPACE_INIT: -32005,\n  COMPONENT_REFERENCE: -32006,\n  INSTANCE_CORRUPTED: -32007,\n  AGENT_LAUNCH: -32008,\n  AGENT_ALREADY_ATTACHED: -32009,\n  AGENT_NOT_ATTACHED: -32010,\n  GENERIC_BUSINESS: -32000,\n} as const;\n\nexport type RpcErrorCode = (typeof RPC_ERROR_CODES)[keyof typeof RPC_ERROR_CODES];\n\n// ---------------------------------------------------------------------------\n// Method-specific param/result types\n// ---------------------------------------------------------------------------\n\n// template.*\n\nexport type TemplateListParams = Record<string, never>;\n\nexport type TemplateListResult = AgentTemplate[];\n\nexport interface TemplateGetParams {\n  name: string;\n}\n\nexport type TemplateGetResult = AgentTemplate;\n\nexport interface TemplateLoadParams {\n  filePath: string;\n}\n\nexport type TemplateLoadResult = AgentTemplate;\n\nexport interface TemplateUnloadParams {\n  name: string;\n}\n\nexport interface TemplateUnloadResult {\n  success: boolean;\n}\n\nexport interface TemplateValidateParams {\n  filePath: string;\n}\n\nexport interface TemplateValidateResult {\n  valid: boolean;\n  template?: AgentTemplate;\n  errors?: Array<{ path: string; message: string }>;\n  /** Warnings that don't prevent loading but indicate potential issues (#119) */\n  warnings?: Array<{ path: string; message: string }>;\n}\n\n// agent.*\n\nexport type WorkDirConflict = \"error\" | \"overwrite\" | \"append\";\n\nexport interface AgentCreateParams {\n  name: string;\n  template: string;\n  overrides?: {\n    launchMode?: LaunchMode;\n    workspacePolicy?: WorkspacePolicy;\n    /** Absolute path to use as workspace directory instead of the default {instancesDir}/{name}. */\n    workDir?: string;\n    /** Behavior when workDir already exists. Default: \"error\". */\n    workDirConflict?: WorkDirConflict;\n    /** Override template permissions. Completely replaces template.permissions when set. */\n    permissions?: PermissionsInput;\n    metadata?: Record<string, string>;\n  };\n}\n\nexport type AgentCreateResult = AgentInstanceMeta;\n\nexport interface AgentStartParams {\n  name: string;\n}\n\nexport type AgentStartResult = AgentInstanceMeta;\n\nexport interface AgentStopParams {\n  name: string;\n}\n\nexport type AgentStopResult = AgentInstanceMeta;\n\nexport interface AgentDestroyParams {\n  name: string;\n}\n\nexport interface AgentDestroyResult {\n  success: boolean;\n}\n\nexport interface AgentStatusParams {\n  name: string;\n}\n\nexport type AgentStatusResult = AgentInstanceMeta;\n\nexport type AgentListParams = Record<string, never>;\n\nexport type AgentListResult = AgentInstanceMeta[];\n\nexport interface AgentUpdatePermissionsParams {\n  name: string;\n  permissions: PermissionsInput;\n}\n\nexport interface AgentUpdatePermissionsResult {\n  effectivePermissions: PermissionsConfig;\n}\n\nexport interface AgentAdoptParams {\n  path: string;\n  rename?: string;\n}\n\nexport interface AgentAdoptResult {\n  name: string;\n  template: string;\n  workspacePath: string;\n  location: \"builtin\" | \"external\";\n  createdAt: string;\n  status: \"stopped\" | \"running\" | \"orphaned\";\n}\n\n// agent.resolve / agent.attach / agent.detach (external spawn)\n\nexport interface AgentResolveParams {\n  name: string;\n  template?: string;\n  overrides?: {\n    launchMode?: LaunchMode;\n    workspacePolicy?: WorkspacePolicy;\n    metadata?: Record<string, string>;\n  };\n}\n\nexport type AgentResolveResult = ResolveResult;\n\nexport interface AgentAttachParams {\n  name: string;\n  pid: number;\n  metadata?: Record<string, string>;\n}\n\nexport type AgentAttachResult = AgentInstanceMeta;\n\nexport interface AgentDetachParams {\n  name: string;\n  cleanup?: boolean;\n}\n\nexport type AgentDetachResult = DetachResult;\n\n// agent.run\n\nexport interface AgentRunParams {\n  name: string;\n  prompt: string;\n  options?: {\n    systemPromptFile?: string;\n    appendSystemPrompt?: string;\n    sessionId?: string;\n    timeoutMs?: number;\n    maxTurns?: number;\n    model?: string;\n  };\n}\n\nexport interface AgentRunResult {\n  text: string;\n  sessionId?: string;\n}\n\n// agent.dispatch\n\nexport interface AgentDispatchParams {\n  name: string;\n  prompt: string;\n  priority?: string;\n}\nexport interface AgentDispatchResult {\n  queued: boolean;\n}\n\n// agent.tasks\n\nexport interface AgentTasksParams {\n  name: string;\n}\nexport interface AgentTasksResult {\n  queued: number;\n  processing: boolean;\n  tasks: unknown[];\n}\n\n// agent.logs\n\nexport interface AgentLogsParams {\n  name: string;\n  limit?: number;\n}\nexport type AgentLogsResult = unknown[];\n\n// schedule.list\n\nexport interface ScheduleListParams {\n  name: string;\n}\nexport interface ScheduleListResult {\n  sources: Array<{ id: string; type: string; active: boolean }>;\n  running: boolean;\n}\n\n// agent.prompt (ACP session)\n\nexport interface AgentPromptParams {\n  name: string;\n  message: string;\n  sessionId?: string;\n}\n\nexport interface AgentPromptResult {\n  response: string;\n  sessionId: string;\n}\n\n// session.* (Session Lease mode)\n\nexport interface SessionCreateParams {\n  agentName: string;\n  clientId: string;\n  idleTtlMs?: number;\n}\n\nexport interface SessionLeaseInfo {\n  sessionId: string;\n  agentName: string;\n  clientId: string | null;\n  state: \"active\" | \"idle\" | \"expired\";\n  createdAt: string;\n  lastActivityAt: string;\n  idleTtlMs: number;\n}\n\nexport type SessionCreateResult = SessionLeaseInfo;\n\nexport interface SessionPromptParams {\n  sessionId: string;\n  text: string;\n}\n\nexport interface SessionPromptResult {\n  stopReason: string;\n  text: string;\n}\n\nexport interface SessionCancelParams {\n  sessionId: string;\n}\n\nexport interface SessionCancelResult {\n  ok: boolean;\n}\n\nexport interface SessionCloseParams {\n  sessionId: string;\n}\n\nexport interface SessionCloseResult {\n  ok: boolean;\n}\n\nexport interface SessionListParams {\n  agentName?: string;\n}\n\nexport type SessionListResult = SessionLeaseInfo[];\n\n// proxy.* (legacy)\n\nexport interface ProxyConnectParams {\n  agentName: string;\n  envPassthrough?: boolean;\n}\n\nexport interface ProxySession {\n  sessionId: string;\n  agentName: string;\n  envPassthrough: boolean;\n  connectedAt: string;\n}\n\nexport type ProxyConnectResult = ProxySession;\n\nexport interface ProxyDisconnectParams {\n  sessionId: string;\n}\n\nexport interface ProxyDisconnectResult {\n  ok: boolean;\n}\n\nexport interface ProxyForwardParams {\n  sessionId: string;\n  acpMessage: Record<string, unknown>;\n}\n\nexport type ProxyForwardResult = Record<string, unknown>;\n\n// skill.*\n\nexport type SkillListParams = Record<string, never>;\nexport type SkillListResult = SkillDefinition[];\n\nexport interface SkillGetParams {\n  name: string;\n}\nexport type SkillGetResult = SkillDefinition;\n\n// prompt.*\n\nexport type PromptListParams = Record<string, never>;\nexport type PromptListResult = PromptDefinition[];\n\nexport interface PromptGetParams {\n  name: string;\n}\nexport type PromptGetResult = PromptDefinition;\n\n// mcp.*\n\nexport type McpListParams = Record<string, never>;\nexport type McpListResult = McpServerDefinition[];\n\nexport interface McpGetParams {\n  name: string;\n}\nexport type McpGetResult = McpServerDefinition;\n\n// workflow.*\n\nexport type WorkflowListParams = Record<string, never>;\nexport type WorkflowListResult = WorkflowDefinition[];\n\nexport interface WorkflowGetParams {\n  name: string;\n}\nexport type WorkflowGetResult = WorkflowDefinition;\n\n// plugin.*\n\nexport type PluginListParams = Record<string, never>;\nexport type PluginListResult = PluginDefinition[];\n\nexport interface PluginGetParams {\n  name: string;\n}\nexport type PluginGetResult = PluginDefinition;\n\n// daemon.*\n\nexport type DaemonPingParams = Record<string, never>;\n\nexport interface DaemonPingResult {\n  version: string;\n  uptime: number;\n  agents: number;\n}\n\nexport type DaemonShutdownParams = Record<string, never>;\n\nexport interface DaemonShutdownResult {\n  success: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Gateway lease — request an ACP Gateway socket for Session Lease\n// ---------------------------------------------------------------------------\n\nexport interface GatewayLeaseParams {\n  agentName: string;\n}\n\nexport interface GatewayLeaseResult {\n  socketPath: string;\n}\n\nexport interface ComponentAddParams {\n  component: Record<string, unknown>;\n}\n\nexport interface ComponentAddResult {\n  name: string;\n}\n\nexport interface ComponentUpdateParams {\n  name: string;\n  patch: Record<string, unknown>;\n}\n\nexport interface ComponentUpdateResult {\n  name: string;\n}\n\nexport interface ComponentRemoveParams {\n  name: string;\n}\n\nexport interface ComponentRemoveResult {\n  success: boolean;\n}\n\nexport interface ComponentImportParams {\n  filePath: string;\n}\n\nexport interface ComponentImportResult {\n  name: string;\n}\n\nexport interface ComponentExportParams {\n  name: string;\n  filePath: string;\n}\n\nexport interface ComponentExportResult {\n  success: boolean;\n}\n\nexport type SourceListParams = Record<string, never>;\nexport type SourceListResult = SourceEntry[];\n\nexport interface SourceAddParams {\n  name: string;\n  config: SourceConfig;\n}\n\nexport interface SourceAddResult {\n  name: string;\n  components: { skills: number; prompts: number; mcp: number; workflows: number; presets: number };\n}\n\nexport interface SourceRemoveParams {\n  name: string;\n}\n\nexport interface SourceRemoveResult {\n  success: boolean;\n}\n\nexport interface SourceSyncParams {\n  name?: string;\n}\n\nexport interface SourceSyncResult {\n  synced: string[];\n  /** Sync report summary (aggregated when syncing multiple sources). */\n  report?: {\n    addedCount: number;\n    updatedCount: number;\n    removedCount: number;\n    hasBreakingChanges: boolean;\n  };\n}\n\nexport interface PresetListParams {\n  packageName?: string;\n}\n\nexport type PresetListResult = PresetDefinition[];\n\nexport interface PresetShowParams {\n  qualifiedName: string;\n}\n\nexport type PresetShowResult = PresetDefinition;\n\nexport interface PresetApplyParams {\n  qualifiedName: string;\n  templateName: string;\n}\n\nexport type PresetApplyResult = AgentTemplate;\n\n// ---------------------------------------------------------------------------\n// Method registry type — maps method name to params/result for type safety\n// ---------------------------------------------------------------------------\n\nexport interface RpcMethodMap {\n  \"template.list\": { params: TemplateListParams; result: TemplateListResult };\n  \"template.get\": { params: TemplateGetParams; result: TemplateGetResult };\n  \"template.load\": { params: TemplateLoadParams; result: TemplateLoadResult };\n  \"template.unload\": { params: TemplateUnloadParams; result: TemplateUnloadResult };\n  \"template.validate\": { params: TemplateValidateParams; result: TemplateValidateResult };\n  \"agent.create\": { params: AgentCreateParams; result: AgentCreateResult };\n  \"agent.start\": { params: AgentStartParams; result: AgentStartResult };\n  \"agent.stop\": { params: AgentStopParams; result: AgentStopResult };\n  \"agent.destroy\": { params: AgentDestroyParams; result: AgentDestroyResult };\n  \"agent.status\": { params: AgentStatusParams; result: AgentStatusResult };\n  \"agent.list\": { params: AgentListParams; result: AgentListResult };\n  \"agent.updatePermissions\": { params: AgentUpdatePermissionsParams; result: AgentUpdatePermissionsResult };\n  \"agent.adopt\": { params: AgentAdoptParams; result: AgentAdoptResult };\n  \"agent.resolve\": { params: AgentResolveParams; result: AgentResolveResult };\n  \"agent.attach\": { params: AgentAttachParams; result: AgentAttachResult };\n  \"agent.detach\": { params: AgentDetachParams; result: AgentDetachResult };\n  \"agent.run\": { params: AgentRunParams; result: AgentRunResult };\n  \"agent.prompt\": { params: AgentPromptParams; result: AgentPromptResult };\n  \"agent.dispatch\": { params: AgentDispatchParams; result: AgentDispatchResult };\n  \"agent.tasks\": { params: AgentTasksParams; result: AgentTasksResult };\n  \"agent.logs\": { params: AgentLogsParams; result: AgentLogsResult };\n  \"schedule.list\": { params: ScheduleListParams; result: ScheduleListResult };\n  \"session.create\": { params: SessionCreateParams; result: SessionCreateResult };\n  \"session.prompt\": { params: SessionPromptParams; result: SessionPromptResult };\n  \"session.cancel\": { params: SessionCancelParams; result: SessionCancelResult };\n  \"session.close\": { params: SessionCloseParams; result: SessionCloseResult };\n  \"session.list\": { params: SessionListParams; result: SessionListResult };\n  \"proxy.connect\": { params: ProxyConnectParams; result: ProxyConnectResult };\n  \"proxy.disconnect\": { params: ProxyDisconnectParams; result: ProxyDisconnectResult };\n  \"proxy.forward\": { params: ProxyForwardParams; result: ProxyForwardResult };\n  \"skill.list\": { params: SkillListParams; result: SkillListResult };\n  \"skill.get\": { params: SkillGetParams; result: SkillGetResult };\n  \"skill.add\": { params: ComponentAddParams; result: ComponentAddResult };\n  \"skill.update\": { params: ComponentUpdateParams; result: ComponentUpdateResult };\n  \"skill.remove\": { params: ComponentRemoveParams; result: ComponentRemoveResult };\n  \"skill.import\": { params: ComponentImportParams; result: ComponentImportResult };\n  \"skill.export\": { params: ComponentExportParams; result: ComponentExportResult };\n  \"prompt.list\": { params: PromptListParams; result: PromptListResult };\n  \"prompt.get\": { params: PromptGetParams; result: PromptGetResult };\n  \"prompt.add\": { params: ComponentAddParams; result: ComponentAddResult };\n  \"prompt.update\": { params: ComponentUpdateParams; result: ComponentUpdateResult };\n  \"prompt.remove\": { params: ComponentRemoveParams; result: ComponentRemoveResult };\n  \"prompt.import\": { params: ComponentImportParams; result: ComponentImportResult };\n  \"prompt.export\": { params: ComponentExportParams; result: ComponentExportResult };\n  \"mcp.list\": { params: McpListParams; result: McpListResult };\n  \"mcp.get\": { params: McpGetParams; result: McpGetResult };\n  \"mcp.add\": { params: ComponentAddParams; result: ComponentAddResult };\n  \"mcp.update\": { params: ComponentUpdateParams; result: ComponentUpdateResult };\n  \"mcp.remove\": { params: ComponentRemoveParams; result: ComponentRemoveResult };\n  \"mcp.import\": { params: ComponentImportParams; result: ComponentImportResult };\n  \"mcp.export\": { params: ComponentExportParams; result: ComponentExportResult };\n  \"workflow.list\": { params: WorkflowListParams; result: WorkflowListResult };\n  \"workflow.get\": { params: WorkflowGetParams; result: WorkflowGetResult };\n  \"workflow.add\": { params: ComponentAddParams; result: ComponentAddResult };\n  \"workflow.update\": { params: ComponentUpdateParams; result: ComponentUpdateResult };\n  \"workflow.remove\": { params: ComponentRemoveParams; result: ComponentRemoveResult };\n  \"workflow.import\": { params: ComponentImportParams; result: ComponentImportResult };\n  \"workflow.export\": { params: ComponentExportParams; result: ComponentExportResult };\n  \"plugin.list\": { params: PluginListParams; result: PluginListResult };\n  \"plugin.get\": { params: PluginGetParams; result: PluginGetResult };\n  \"plugin.add\": { params: ComponentAddParams; result: ComponentAddResult };\n  \"plugin.update\": { params: ComponentUpdateParams; result: ComponentUpdateResult };\n  \"plugin.remove\": { params: ComponentRemoveParams; result: ComponentRemoveResult };\n  \"plugin.import\": { params: ComponentImportParams; result: ComponentImportResult };\n  \"plugin.export\": { params: ComponentExportParams; result: ComponentExportResult };\n  \"source.list\": { params: SourceListParams; result: SourceListResult };\n  \"source.add\": { params: SourceAddParams; result: SourceAddResult };\n  \"source.remove\": { params: SourceRemoveParams; result: SourceRemoveResult };\n  \"source.sync\": { params: SourceSyncParams; result: SourceSyncResult };\n  \"preset.list\": { params: PresetListParams; result: PresetListResult };\n  \"preset.show\": { params: PresetShowParams; result: PresetShowResult };\n  \"preset.apply\": { params: PresetApplyParams; result: PresetApplyResult };\n  \"daemon.ping\": { params: DaemonPingParams; result: DaemonPingResult };\n  \"daemon.shutdown\": { params: DaemonShutdownParams; result: DaemonShutdownResult };\n  \"gateway.lease\": { params: GatewayLeaseParams; result: GatewayLeaseResult };\n}\n\nexport type RpcMethod = keyof RpcMethodMap;\n","export type ErrorCategory =\n  | \"configuration\"\n  | \"lifecycle\"\n  | \"communication\"\n  | \"cli\";\n\nexport abstract class ActantError extends Error {\n  abstract readonly code: string;\n  abstract readonly category: ErrorCategory;\n  readonly timestamp: Date;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, context?: Record<string, unknown>) {\n    super(message);\n    this.name = this.constructor.name;\n    this.timestamp = new Date();\n    this.context = context;\n  }\n}\n","import { ActantError, type ErrorCategory } from \"./base-error\";\nimport type { ValidationIssue } from \"../types/validation.types\";\n\nexport class ConfigNotFoundError extends ActantError {\n  readonly code = \"CONFIG_NOT_FOUND\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(configPath: string) {\n    super(`Configuration file not found: ${configPath}`, { configPath });\n  }\n}\n\nexport class ConfigValidationError extends ActantError {\n  readonly code = \"CONFIG_VALIDATION_ERROR\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(\n    message: string,\n    public readonly validationErrors: Array<{\n      path: string;\n      message: string;\n    }>,\n    /** Structured validation issues with severity (#119) */\n    public readonly issues?: ValidationIssue[],\n  ) {\n    super(message, { validationErrors });\n  }\n}\n\nexport class TemplateNotFoundError extends ActantError {\n  readonly code = \"TEMPLATE_NOT_FOUND\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(templateName: string) {\n    super(`Template \"${templateName}\" not found in registry`, {\n      templateName,\n    });\n  }\n}\n\nexport class SkillReferenceError extends ActantError {\n  readonly code = \"SKILL_REFERENCE_ERROR\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(skillName: string) {\n    super(`Skill \"${skillName}\" not found in registry`, { skillName });\n  }\n}\n\nexport class ComponentReferenceError extends ActantError {\n  readonly code = \"COMPONENT_REFERENCE_ERROR\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(componentType: string, componentName: string) {\n    super(`${componentType} \"${componentName}\" not found in registry`, {\n      componentType,\n      componentName,\n    });\n  }\n}\n\nexport class CircularReferenceError extends ActantError {\n  readonly code = \"CIRCULAR_REFERENCE\";\n  readonly category: ErrorCategory = \"configuration\";\n\n  constructor(cyclePath: string[]) {\n    super(`Circular reference detected: ${cyclePath.join(\" → \")}`, {\n      cyclePath,\n    });\n  }\n}\n","import { ActantError, type ErrorCategory } from \"./base-error\";\n\nexport class AgentLaunchError extends ActantError {\n  readonly code = \"AGENT_LAUNCH_ERROR\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string, cause?: Error) {\n    super(`Failed to launch agent \"${instanceName}\"`, {\n      instanceName,\n      cause: cause?.message,\n    });\n    if (cause) this.cause = cause;\n  }\n}\n\nexport class AgentNotFoundError extends ActantError {\n  readonly code = \"AGENT_NOT_FOUND\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string) {\n    super(`Agent instance \"${instanceName}\" not found`, { instanceName });\n  }\n}\n\nexport class AgentAlreadyRunningError extends ActantError {\n  readonly code = \"AGENT_ALREADY_RUNNING\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string) {\n    super(`Agent \"${instanceName}\" is already running`, { instanceName });\n  }\n}\n\nexport class AgentAlreadyAttachedError extends ActantError {\n  readonly code = \"AGENT_ALREADY_ATTACHED\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string) {\n    super(`Agent \"${instanceName}\" already has an attached process`, { instanceName });\n  }\n}\n\nexport class AgentNotAttachedError extends ActantError {\n  readonly code = \"AGENT_NOT_ATTACHED\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string) {\n    super(`Agent \"${instanceName}\" has no attached process`, { instanceName });\n  }\n}\n\nexport class InstanceCorruptedError extends ActantError {\n  readonly code = \"INSTANCE_CORRUPTED\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(instanceName: string, reason: string) {\n    super(\n      `Agent instance \"${instanceName}\" is corrupted: ${reason}`,\n      { instanceName, reason },\n    );\n  }\n}\n\nexport class WorkspaceInitError extends ActantError {\n  readonly code = \"WORKSPACE_INIT_ERROR\";\n  readonly category: ErrorCategory = \"lifecycle\";\n\n  constructor(workspacePath: string, cause?: Error) {\n    super(`Failed to initialize workspace at \"${workspacePath}\"`, {\n      workspacePath,\n      cause: cause?.message,\n    });\n    if (cause) this.cause = cause;\n  }\n}\n","import pino from \"pino\";\n\nexport type Logger = pino.Logger;\n\nfunction resolveLogLevel(): string {\n  if (process.env[\"LOG_LEVEL\"]) return process.env[\"LOG_LEVEL\"];\n  if (process.env[\"VITEST\"] || process.env[\"NODE_ENV\"] === \"test\") return \"silent\";\n  return \"info\";\n}\n\nexport function createLogger(module: string): Logger {\n  return pino({\n    name: module,\n    level: resolveLogLevel(),\n    formatters: {\n      level(label: string) {\n        return { level: label };\n      },\n    },\n    timestamp: pino.stdTimeFunctions.isoTime,\n  });\n}\n","import { join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nconst IS_WINDOWS = process.platform === \"win32\";\n\n/**\n * Returns the platform-appropriate IPC path for daemon communication.\n *\n * - macOS/Linux: Unix domain socket at `~/.actant/actant.sock`\n * - Windows: Named pipe at `\\\\.\\pipe\\actant`\n *\n * Named pipes are the standard Windows IPC mechanism and work with\n * Node.js `net.createServer` / `net.createConnection` transparently.\n */\nexport function getDefaultIpcPath(homeDir?: string): string {\n  if (IS_WINDOWS) {\n    return \"\\\\\\\\.\\\\pipe\\\\actant\";\n  }\n  const base = homeDir ?? join(homedir(), \".actant\");\n  return join(base, \"actant.sock\");\n}\n\n/**\n * Returns the IPC path for a given home directory.\n * Used by AppContext when homeDir is explicitly provided.\n */\nexport function getIpcPath(homeDir: string): string {\n  if (IS_WINDOWS) {\n    const safeName = homeDir.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n    return `\\\\\\\\.\\\\pipe\\\\actant-${safeName}`;\n  }\n  return join(homeDir, \"actant.sock\");\n}\n\n/**\n * Whether the current platform uses file-based IPC (Unix sockets)\n * that may need cleanup (unlink) before listening.\n */\nexport function ipcRequiresFileCleanup(): boolean {\n  return !IS_WINDOWS;\n}\n\n/**\n * Registers graceful shutdown handlers that work across all platforms.\n *\n * - Unix: SIGINT, SIGTERM\n * - Windows: SIGINT (Ctrl+C in terminal), SIGBREAK (Ctrl+Break)\n *\n * SIGTERM is not reliably delivered on Windows, so we also listen for\n * SIGBREAK which is the closest equivalent.\n */\nexport function onShutdownSignal(handler: () => void | Promise<void>): void {\n  const wrappedHandler = () => {\n    void Promise.resolve(handler());\n  };\n\n  process.on(\"SIGINT\", wrappedHandler);\n\n  if (IS_WINDOWS) {\n    process.on(\"SIGBREAK\", wrappedHandler);\n  } else {\n    process.on(\"SIGTERM\", wrappedHandler);\n  }\n}\n\nexport function isWindows(): boolean {\n  return IS_WINDOWS;\n}\n\nlet _isSea = false;\nlet _isSeaChecked = false;\n\n/**\n * Detects if the process is running as a Node.js Single Executable Application.\n * Uses `node:sea` module (Node 20+) with a fallback heuristic.\n */\nexport function isSingleExecutable(): boolean {\n  if (_isSeaChecked) return _isSea;\n  _isSeaChecked = true;\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const sea = require(\"node:sea\");\n    _isSea = typeof sea.isSea === \"function\" ? sea.isSea() : false;\n  } catch {\n    _isSea = false;\n  }\n  return _isSea;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@actant/shared",
+  "version": "0.1.2",
+  "description": "Shared utilities and types for the Actant AI agent platform",
+  "type": "module",
+  "license": "MIT",
+  "author": "blackplume <blackplume233@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blackplume233/Actant.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/blackplume233/Actant#readme",
+  "bugs": "https://github.com/blackplume233/Actant/issues",
+  "keywords": [
+    "actant",
+    "ai-agent",
+    "shared"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "pino": "^10.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rimraf dist"
+  }
+}