@signetai/connector-claude-code 0.140.1

package/bin/install.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runConnectorInstaller } from "@signetai/connector-base";
+import { ClaudeCodeConnector } from "../dist/index.js";
+
+runConnectorInstaller("claude-code", ClaudeCodeConnector);

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Signet Connector for Claude Code
+ *
+ * Integrates Signet's memory system with Claude Code's lifecycle hooks.
+ *
+ * Usage:
+ * ```typescript
+ * import { ClaudeCodeConnector } from '@signetai/connector-claude-code';
+ *
+ * const connector = new ClaudeCodeConnector();
+ * await connector.install('~/.agents');
+ * ```
+ */
+import { spawn } from "node:child_process";
+import { BaseConnector, type InstallResult, type UninstallResult } from "@signetai/connector-base";
+export interface ConnectorConfig {
+    daemonUrl?: string;
+    hooks?: {
+        sessionStart?: boolean;
+        userPromptSubmit?: boolean;
+        preCompact?: boolean;
+        sessionEnd?: boolean;
+    };
+}
+export interface SessionContext {
+    projectPath?: string;
+    sessionId?: string;
+    harness?: string;
+    transcriptPath?: string;
+}
+export interface SessionStartResult {
+    identity: {
+        name: string;
+        description?: string;
+    };
+    memories: Array<{
+        id: number;
+        content: string;
+        type: string;
+        importance: number;
+        created_at: string;
+    }>;
+    recentContext?: string;
+    inject: string;
+}
+export interface SessionEndResult {
+    success: boolean;
+    memoriesExtracted: number;
+}
+export interface SessionEndFireAndForgetPayload {
+    harness: "claude-code";
+    sessionId?: string;
+    transcriptPath?: string;
+}
+type DetachedSpawn = typeof spawn;
+export declare function dispatchSessionEndFireAndForget(daemonUrl: string, payload: SessionEndFireAndForgetPayload, spawnImpl?: DetachedSpawn): boolean;
+/**
+ * Connector for Claude Code (Anthropic's CLI)
+ *
+ * Implements the Signet connector interface for Claude Code, handling:
+ * - Hook installation into ~/.claude/settings.json
+ * - CLAUDE.md generation from identity files
+ * - Skills directory symlink management
+ * - Lifecycle callbacks for session management
+ */
+export declare class ClaudeCodeConnector extends BaseConnector {
+    readonly name = "Claude Code";
+    readonly harnessId = "claude-code";
+    private config;
+    private daemonUrl;
+    constructor(config?: ConnectorConfig);
+    /**
+     * Install the connector into Claude Code
+     */
+    install(basePath: string): Promise<InstallResult>;
+    /**
+     * Uninstall the connector from Claude Code
+     */
+    uninstall(): Promise<UninstallResult>;
+    /**
+     * Check if the connector is installed
+     */
+    isInstalled(): boolean;
+    /**
+     * Get the path to Claude Code's settings.json
+     */
+    getConfigPath(): string;
+    /**
+     * Called when a session starts
+     */
+    onSessionStart(ctx: SessionContext): Promise<SessionStartResult | null>;
+    protected dispatchSessionEnd(payload: SessionEndFireAndForgetPayload): boolean;
+    /**
+     * Called when a session ends
+     */
+    onSessionEnd(ctx: SessionContext): Promise<SessionEndResult>;
+    /**
+     * Configure hooks in ~/.claude/settings.json
+     */
+    private configureHooks;
+    /**
+     * Register Signet MCP server in ~/.claude.json (user scope)
+     *
+     * Claude Code reads MCP servers from the top-level `mcpServers` key
+     * in ~/.claude.json, NOT from ~/.claude/settings.json.
+     */
+    private registerMcpServer;
+    /**
+     * Remove Signet MCP server from ~/.claude.json
+     */
+    private removeMcpServer;
+}
+/**
+ * Create a Claude Code connector instance
+ */
+export declare function createConnector(config?: ConnectorConfig): ClaudeCodeConnector;
+export default ClaudeCodeConnector;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAmB,MAAM,wBAAwB,CAAC;AAOlH,MAAM,WAAW,eAAe;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE;QACP,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC;CACF;AAED,MAAM,WAAW,cAAc;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC9C,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,aAAa,GAAG,OAAO,KAAK,CAAC;AAiBlC,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,8BAA8B,EACvC,SAAS,GAAE,aAAqB,GAC9B,OAAO,CAmBT;AAsBD;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACrD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,iBAAiB;IAEnC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,eAAoB;IAMxC;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCvD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAsC3C;;OAEG;IACH,WAAW,IAAI,OAAO;IAkBtB;;OAEG;IACH,aAAa,IAAI,MAAM;IAQvB;;OAEG;IACG,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyB7E,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO;IAI9E;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAclE;;OAEG;YACW,cAAc;IA+G5B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAwBvB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,eAAe,GAAG,mBAAmB,CAE7E;AAGD,eAAe,mBAAmB,CAAC"}