a2a-memory 0.10.11 → 0.10.13

package/dist/a2a/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * A2A Protocol TypeScript Types
+ * Google A2A Protocol RC v1.0 준수
+ */
+export interface JSONRPCRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: Record<string, unknown>;
+    id?: string | number;
+}
+export interface JSONRPCResponse<T = unknown> {
+    jsonrpc: '2.0';
+    result?: T;
+    error?: JSONRPCError;
+    id?: string | number;
+}
+export interface JSONRPCError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export declare enum JSONRPCErrorCode {
+    PARSE_ERROR = -32700,
+    INVALID_REQUEST = -32600,
+    METHOD_NOT_FOUND = -32601,
+    INVALID_PARAMS = -32602,
+    INTERNAL_ERROR = -32603,
+    TASK_NOT_FOUND = -32001,
+    TASK_NOT_CANCELABLE = -32002,
+    PUSH_NOTIFICATION_NOT_SUPPORTED = -32003,
+    UNSUPPORTED_OPERATION = -32004,
+    CONTENT_TYPE_NOT_SUPPORTED = -32005,
+    INVALID_AGENT_CARD = -32006
+}
+export interface TextPart {
+    type: 'text';
+    text: string;
+}
+export interface FilePart {
+    type: 'file';
+    file: {
+        name: string;
+        mimeType: string;
+        bytes?: string;
+        uri?: string;
+    };
+}
+export interface DataPart {
+    type: 'data';
+    data: Record<string, unknown>;
+}
+export type MessagePart = TextPart | FilePart | DataPart;
+export type MessageRole = 'user' | 'agent';
+export interface Message {
+    role: MessageRole;
+    parts: MessagePart[];
+    metadata?: Record<string, unknown>;
+}
+export declare enum TaskState {
+    SUBMITTED = "submitted",
+    WORKING = "working",
+    INPUT_REQUIRED = "input-required",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELED = "canceled"
+}
+export declare const TERMINAL_STATES: ReadonlySet<TaskState>;
+export interface TaskStatus {
+    state: TaskState;
+    timestamp: string;
+    message?: string;
+}
+export interface Artifact {
+    name: string;
+    parts: MessagePart[];
+}
+export interface TaskData {
+    id: string;
+    sessionId: string;
+    status: TaskStatus;
+    messages: Message[];
+    artifacts: Artifact[];
+    history: TaskStatus[];
+    metadata: Record<string, unknown>;
+}
+export declare enum EventType {
+    TASK_STATUS_UPDATE = "TaskStatusUpdateEvent",
+    TASK_ARTIFACT_UPDATE = "TaskArtifactUpdateEvent"
+}
+export interface TaskStatusUpdateEvent {
+    id: string;
+    status: TaskStatus;
+    final: boolean;
+}
+export interface TaskArtifactUpdateEvent {
+    id: string;
+    artifact: Artifact;
+}
+export type SSEEvent = TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+export interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+export interface AgentExtension {
+    uri: string;
+    description?: string;
+    params?: Record<string, unknown>;
+    required?: boolean;
+}
+export interface AgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+    extensions?: AgentExtension[];
+}
+export interface SecurityScheme {
+    type: string;
+    name?: string;
+    in?: string;
+    scheme?: string;
+    bearerFormat?: string;
+    description?: string;
+}
+export interface AgentProvider {
+    organization: string;
+    url: string;
+}
+export interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    protocolVersion?: string;
+    skills: AgentSkill[];
+    capabilities: AgentCapabilities;
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    securitySchemes?: Record<string, SecurityScheme>;
+    security?: Array<Record<string, string[]>>;
+    provider?: AgentProvider;
+    documentationUrl?: string;
+    iconUrl?: string;
+    preferredTransport?: string;
+    supportsAuthenticatedExtendedCard?: boolean;
+}
+export interface MessageSendParams {
+    id: string;
+    sessionId?: string;
+    message: Message;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskGetParams {
+    id: string;
+    historyLength?: number;
+}
+export interface TaskCancelParams {
+    id: string;
+}
+export type A2AMethod = 'message/send' | 'message/stream' | 'tasks/get' | 'tasks/cancel' | 'tasks/pushNotification/set' | 'tasks/pushNotification/get';
+export interface A2AProtocolClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+    jwtToken?: string;
+    timeout?: number;
+}
+export interface StreamCallbacks {
+    onStatusUpdate?: (event: TaskStatusUpdateEvent) => void;
+    onArtifactUpdate?: (event: TaskArtifactUpdateEvent) => void;
+    onError?: (error: Error) => void;
+    onComplete?: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/a2a/types.js

@@ -0,0 +1,42 @@
+/**
+ * A2A Protocol TypeScript Types
+ * Google A2A Protocol RC v1.0 준수
+ */
+export var JSONRPCErrorCode;
+(function (JSONRPCErrorCode) {
+    // Standard JSON-RPC 2.0
+    JSONRPCErrorCode[JSONRPCErrorCode["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+    JSONRPCErrorCode[JSONRPCErrorCode["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+    JSONRPCErrorCode[JSONRPCErrorCode["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+    JSONRPCErrorCode[JSONRPCErrorCode["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+    JSONRPCErrorCode[JSONRPCErrorCode["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+    // A2A Protocol Custom
+    JSONRPCErrorCode[JSONRPCErrorCode["TASK_NOT_FOUND"] = -32001] = "TASK_NOT_FOUND";
+    JSONRPCErrorCode[JSONRPCErrorCode["TASK_NOT_CANCELABLE"] = -32002] = "TASK_NOT_CANCELABLE";
+    JSONRPCErrorCode[JSONRPCErrorCode["PUSH_NOTIFICATION_NOT_SUPPORTED"] = -32003] = "PUSH_NOTIFICATION_NOT_SUPPORTED";
+    JSONRPCErrorCode[JSONRPCErrorCode["UNSUPPORTED_OPERATION"] = -32004] = "UNSUPPORTED_OPERATION";
+    JSONRPCErrorCode[JSONRPCErrorCode["CONTENT_TYPE_NOT_SUPPORTED"] = -32005] = "CONTENT_TYPE_NOT_SUPPORTED";
+    JSONRPCErrorCode[JSONRPCErrorCode["INVALID_AGENT_CARD"] = -32006] = "INVALID_AGENT_CARD";
+})(JSONRPCErrorCode || (JSONRPCErrorCode = {}));
+// ─── Task ───────────────────────────────────────────────────
+export var TaskState;
+(function (TaskState) {
+    TaskState["SUBMITTED"] = "submitted";
+    TaskState["WORKING"] = "working";
+    TaskState["INPUT_REQUIRED"] = "input-required";
+    TaskState["COMPLETED"] = "completed";
+    TaskState["FAILED"] = "failed";
+    TaskState["CANCELED"] = "canceled";
+})(TaskState || (TaskState = {}));
+export const TERMINAL_STATES = new Set([
+    TaskState.COMPLETED,
+    TaskState.FAILED,
+    TaskState.CANCELED,
+]);
+// ─── SSE Events ─────────────────────────────────────────────
+export var EventType;
+(function (EventType) {
+    EventType["TASK_STATUS_UPDATE"] = "TaskStatusUpdateEvent";
+    EventType["TASK_ARTIFACT_UPDATE"] = "TaskArtifactUpdateEvent";
+})(EventType || (EventType = {}));
+//# sourceMappingURL=types.js.map

package/dist/a2a/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/a2a/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,CAAN,IAAY,gBAeX;AAfD,WAAY,gBAAgB;IAC1B,wBAAwB;IACxB,0EAAoB,CAAA;IACpB,kFAAwB,CAAA;IACxB,oFAAyB,CAAA;IACzB,gFAAuB,CAAA;IACvB,gFAAuB,CAAA;IAEvB,sBAAsB;IACtB,gFAAuB,CAAA;IACvB,0FAA4B,CAAA;IAC5B,kHAAwC,CAAA;IACxC,8FAA8B,CAAA;IAC9B,wGAAmC,CAAA;IACnC,wFAA2B,CAAA;AAC7B,CAAC,EAfW,gBAAgB,KAAhB,gBAAgB,QAe3B;AAoCD,+DAA+D;AAE/D,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,gCAAmB,CAAA;IACnB,8CAAiC,CAAA;IACjC,oCAAuB,CAAA;IACvB,8BAAiB,CAAA;IACjB,kCAAqB,CAAA;AACvB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC;IAC7D,SAAS,CAAC,SAAS;IACnB,SAAS,CAAC,MAAM;IAChB,SAAS,CAAC,QAAQ;CACnB,CAAC,CAAC;AAuBH,+DAA+D;AAE/D,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,yDAA4C,CAAA;IAC5C,6DAAgD,CAAA;AAClD,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB"}

package/dist/cli/commands/setup-wizard.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Setup Wizard
+ *
+ * One-click interactive setup wizard for A2A Memory Plugin.
+ * Automates all 7 manual setup steps into a single guided flow.
+ */
+import { ConfigManager } from '../../config/manager.js';
+interface AgentResult {
+    id: string;
+    name: string;
+    api_key: string;
+}
+export interface WizardOptions {
+    serverUrl?: string;
+    email?: string;
+    password?: string;
+    force?: boolean;
+}
+export interface WizardResult {
+    success: boolean;
+    serverUrl: string;
+    agentId?: string;
+    apiKey?: string;
+    hooksRegistered: boolean;
+    error?: string;
+}
+export declare function checkServerHealth(serverUrl: string): Promise<boolean>;
+export declare function loginAndGetToken(serverUrl: string, email: string, password: string): Promise<string | null>;
+export declare function findExistingAgent(serverUrl: string, token: string, agentName: string): Promise<AgentResult | null>;
+export declare function createAgent(serverUrl: string, token: string, agentName: string): Promise<AgentResult | null>;
+export declare function saveServerConfig(configManager: ConfigManager, serverUrl: string, apiKey: string): void;
+export declare function getPluginDir(): string;
+export declare function detectGlobalPluginDir(): string;
+export declare function registerHooksToSettings(settingsPath: string, pluginDir: string, force: boolean): {
+    registered: boolean;
+    alreadyExisted: boolean;
+};
+export declare function runSetupWizard(options?: WizardOptions): Promise<WizardResult>;
+export {};
+//# sourceMappingURL=setup-wizard.d.ts.map

package/dist/cli/commands/setup-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-wizard.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup-wizard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAuBxD,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgFD,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS3E;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBxB;AAED,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqB7B;AAED,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwB7B;AAMD,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,IAAI,CAKN;AAED,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAa9C;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GACb;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,CAoDlD;AAMD,wBAAsB,cAAc,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2KvF"}

package/dist/cli/commands/setup-wizard.js

@@ -0,0 +1,387 @@
+/**
+ * Setup Wizard
+ *
+ * One-click interactive setup wizard for A2A Memory Plugin.
+ * Automates all 7 manual setup steps into a single guided flow.
+ */
+import { createInterface } from 'node:readline';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { ConfigManager } from '../../config/manager.js';
+const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+const DEFAULT_SERVER_URL = 'https://a2a-api-production-8d17.up.railway.app';
+const AGENT_NAME = 'claude-code-plugin';
+// ──────────────────────────────────────────────
+// readline helpers
+// ──────────────────────────────────────────────
+function createRl() {
+    return createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+async function prompt(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            resolve(answer.trim());
+        });
+    });
+}
+async function promptWithDefault(rl, question, defaultValue) {
+    const answer = await prompt(rl, `  ${question} [${chalk.dim(defaultValue)}]: `);
+    return answer === '' ? defaultValue : answer;
+}
+async function promptPassword(rl, question) {
+    return new Promise((resolve) => {
+        // stdin이 TTY일 때만 에코 끄기 시도
+        const stdin = process.stdin;
+        process.stdout.write(`  ${question}: `);
+        let password = '';
+        if (stdin.setRawMode) {
+            stdin.setRawMode(true);
+            stdin.resume();
+            stdin.setEncoding('utf8');
+            const onData = (char) => {
+                if (char === '\r' || char === '\n') {
+                    stdin.setRawMode(false);
+                    stdin.pause();
+                    stdin.removeListener('data', onData);
+                    process.stdout.write('\n');
+                    resolve(password);
+                }
+                else if (char === '\u0003') {
+                    // Ctrl+C
+                    process.exit(0);
+                }
+                else if (char === '\u007F') {
+                    // Backspace
+                    if (password.length > 0) {
+                        password = password.slice(0, -1);
+                        process.stdout.write('\b \b');
+                    }
+                }
+                else {
+                    password += char;
+                    process.stdout.write('*');
+                }
+            };
+            stdin.on('data', onData);
+        }
+        else {
+            // TTY가 아닌 경우 (테스트/파이프) 일반 readline 사용
+            rl.question('', (answer) => {
+                resolve(answer.trim());
+            });
+        }
+    });
+}
+// ──────────────────────────────────────────────
+// Network helpers (testable, injectable)
+// ──────────────────────────────────────────────
+export async function checkServerHealth(serverUrl) {
+    try {
+        const res = await fetch(`${serverUrl}/api/v1/health`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function loginAndGetToken(serverUrl, email, password) {
+    try {
+        const res = await fetch(`${serverUrl}/api/v1/auth/login`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ email, password }),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            return null;
+        }
+        const data = (await res.json());
+        return data.token ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function findExistingAgent(serverUrl, token, agentName) {
+    try {
+        const res = await fetch(`${serverUrl}/api/v1/agents?name=${encodeURIComponent(agentName)}`, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            return null;
+        }
+        const data = (await res.json());
+        const agents = Array.isArray(data) ? data : (data.agents ?? data.items ?? []);
+        const match = agents.find((a) => a.name === agentName);
+        return match ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function createAgent(serverUrl, token, agentName) {
+    try {
+        const res = await fetch(`${serverUrl}/api/v1/agents`, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                name: agentName,
+                description: 'Claude Code Plugin Agent — auto-registered by setup wizard',
+                capabilities: ['memory:read', 'memory:create', 'memory:update', 'memory:delete', 'memory:search'],
+            }),
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok) {
+            return null;
+        }
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+// ──────────────────────────────────────────────
+// Config / Hook helpers (testable)
+// ──────────────────────────────────────────────
+export function saveServerConfig(configManager, serverUrl, apiKey) {
+    const config = configManager.load();
+    config.server.url = serverUrl;
+    configManager.save(config);
+    configManager.setApiKey(apiKey);
+}
+export function getPluginDir() {
+    const url = new URL(import.meta.url);
+    const filePath = url.pathname;
+    const parts = filePath.split('/');
+    // dist/cli/commands/setup-wizard.js → plugin/
+    return parts.slice(0, -4).join('/');
+}
+export function detectGlobalPluginDir() {
+    try {
+        const npmRoot = execSync('npm root -g', { encoding: 'utf8', timeout: 5000 }).trim();
+        const candidate = join(npmRoot, 'a2a-memory');
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    catch {
+        // ignore
+    }
+    // Fallback: import.meta.url 기반
+    return getPluginDir();
+}
+export function registerHooksToSettings(settingsPath, pluginDir, force) {
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+        }
+        catch {
+            // 파싱 실패 시 빈 settings로 시작
+        }
+    }
+    if (!settings.hooks) {
+        settings.hooks = {};
+    }
+    const hasExisting = Object.values(settings.hooks).some((configs) => configs.some((c) => c.hooks?.some((h) => h.command?.includes('a2a-memory'))));
+    if (hasExisting && !force) {
+        return { registered: false, alreadyExisted: true };
+    }
+    const hooksDir = join(pluginDir, 'dist', 'hooks');
+    const hookEntries = [
+        ['SessionStart', join(hooksDir, 'session-start.js')],
+        ['PostToolUse', join(hooksDir, 'post-tool-use.js')],
+        ['SessionEnd', join(hooksDir, 'session-end.js')],
+        ['UserPromptSubmit', join(hooksDir, 'user-prompt-submit.js')],
+        ['PreCompact', join(hooksDir, 'pre-compact.js')],
+    ];
+    for (const [hookName, hookPath] of hookEntries) {
+        settings.hooks[hookName] = [
+            ...(settings.hooks[hookName] ?? []).filter((c) => !c.hooks?.some((h) => h.command?.includes('a2a-memory'))),
+            {
+                matcher: '',
+                hooks: [{ type: 'command', command: `node ${hookPath}` }],
+            },
+        ];
+    }
+    const settingsDir = join(homedir(), '.claude');
+    if (!existsSync(settingsDir)) {
+        mkdirSync(settingsDir, { recursive: true });
+    }
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    return { registered: true, alreadyExisted: false };
+}
+// ──────────────────────────────────────────────
+// Main wizard runner
+// ──────────────────────────────────────────────
+export async function runSetupWizard(options = {}) {
+    const result = {
+        success: false,
+        serverUrl: options.serverUrl ?? DEFAULT_SERVER_URL,
+        hooksRegistered: false,
+    };
+    const rl = createRl();
+    try {
+        // ── Header ──────────────────────────────
+        console.log('');
+        console.log(chalk.cyan('╔══════════════════════════════════════╗'));
+        console.log(chalk.cyan('║') + chalk.bold('   A2A Memory — Quick Setup Wizard   ') + chalk.cyan('║'));
+        console.log(chalk.cyan('╚══════════════════════════════════════╝'));
+        console.log('');
+        // ── Step 1: Server URL ───────────────────
+        console.log(chalk.bold('Step 1/4: Server Connection'));
+        let serverUrl;
+        if (options.serverUrl) {
+            serverUrl = options.serverUrl;
+            console.log(`  Server URL: ${chalk.cyan(serverUrl)} ${chalk.dim('(from options)')}`);
+        }
+        else {
+            serverUrl = await promptWithDefault(rl, 'Server URL', DEFAULT_SERVER_URL);
+        }
+        // URL 유효성 검증
+        try {
+            new URL(serverUrl);
+        }
+        catch {
+            console.log(chalk.red(`  Error: Invalid URL format — ${serverUrl}`));
+            result.error = `Invalid URL: ${serverUrl}`;
+            return result;
+        }
+        // Health check
+        process.stdout.write('  Checking server connection... ');
+        const healthy = await checkServerHealth(serverUrl);
+        if (!healthy) {
+            console.log(chalk.red('failed'));
+            console.log(chalk.red(`  Error: Cannot reach server at ${serverUrl}`));
+            result.error = `Cannot reach server at ${serverUrl}`;
+            return result;
+        }
+        console.log(chalk.green('ok'));
+        result.serverUrl = serverUrl;
+        console.log('');
+        // ── Step 2: Authentication ───────────────
+        console.log(chalk.bold('Step 2/4: Authentication'));
+        let email;
+        let password;
+        if (options.email) {
+            email = options.email;
+            console.log(`  Admin Email: ${chalk.cyan(email)} ${chalk.dim('(from options)')}`);
+        }
+        else {
+            email = await promptWithDefault(rl, 'Admin Email', 'admin@a2amemory.com');
+        }
+        if (options.password) {
+            password = options.password;
+            console.log(`  Password: ${chalk.dim('(from options)')}`);
+        }
+        else {
+            password = await promptPassword(rl, 'Password');
+        }
+        process.stdout.write('  Authenticating... ');
+        const token = await loginAndGetToken(serverUrl, email, password);
+        if (!token) {
+            console.log(chalk.red('failed'));
+            console.log(chalk.red('  Error: Authentication failed. Check email/password.'));
+            result.error = 'Authentication failed';
+            return result;
+        }
+        console.log(chalk.green('ok'));
+        console.log(`  ${chalk.green('Authenticated successfully')}`);
+        console.log('');
+        // ── Step 3: Agent Registration ───────────
+        console.log(chalk.bold('Step 3/4: Agent Registration'));
+        let agentId;
+        let apiKey;
+        // 기존 Agent 확인
+        process.stdout.write(`  Checking for existing agent '${AGENT_NAME}'... `);
+        const existing = await findExistingAgent(serverUrl, token, AGENT_NAME);
+        if (existing) {
+            console.log(chalk.yellow('found'));
+            console.log(`  ${chalk.yellow('Agent already exists')} (ID: ${existing.id})`);
+            agentId = existing.id;
+            // 기존 agent의 api_key가 있으면 사용, 없으면 재생성 불가 → 안내
+            if (existing.api_key) {
+                apiKey = existing.api_key;
+                console.log(`  ${chalk.green('API Key retrieved')}`);
+            }
+            else {
+                console.log(chalk.yellow('  Warning: Existing agent API Key not returned by server.'));
+                console.log(chalk.yellow('  Please retrieve the API Key manually from the dashboard.'));
+                apiKey = '';
+            }
+        }
+        else {
+            console.log(chalk.dim('not found'));
+            process.stdout.write(`  Creating agent '${AGENT_NAME}'... `);
+            const created = await createAgent(serverUrl, token, AGENT_NAME);
+            if (!created) {
+                console.log(chalk.red('failed'));
+                console.log(chalk.red('  Error: Failed to create agent.'));
+                result.error = 'Agent creation failed';
+                return result;
+            }
+            console.log(chalk.green('done'));
+            console.log(`  ${chalk.green('Agent created')} (ID: ${created.id})`);
+            agentId = created.id;
+            apiKey = created.api_key;
+        }
+        if (apiKey) {
+            const masked = `${apiKey.slice(0, 12)}...`;
+            console.log(`  ${chalk.green('API Key saved:')} ${chalk.cyan(masked)}`);
+        }
+        result.agentId = agentId;
+        result.apiKey = apiKey;
+        // Config 저장
+        const configManager = new ConfigManager();
+        if (apiKey) {
+            saveServerConfig(configManager, serverUrl, apiKey);
+        }
+        else {
+            // API Key 없어도 URL은 저장
+            const config = configManager.load();
+            config.server.url = serverUrl;
+            configManager.save(config);
+        }
+        console.log('');
+        // ── Step 4: Hook Registration ────────────
+        console.log(chalk.bold('Step 4/4: Hook Registration'));
+        const pluginDir = detectGlobalPluginDir();
+        const hookResult = registerHooksToSettings(CLAUDE_SETTINGS_PATH, pluginDir, options.force ?? false);
+        if (hookResult.alreadyExisted) {
+            console.log(`  ${chalk.yellow('Hooks already registered')} (use --force to overwrite)`);
+            result.hooksRegistered = false;
+        }
+        else {
+            console.log(`  ${chalk.green('Claude Code settings.json updated')}`);
+            console.log(`  ${chalk.green('5 hooks registered')} ${chalk.dim('(SessionStart, PostToolUse, SessionEnd, UserPromptSubmit, PreCompact)')}`);
+            result.hooksRegistered = true;
+        }
+        console.log('');
+        // ── Footer ──────────────────────────────
+        console.log(chalk.cyan('═══════════════════════════════════════'));
+        console.log(chalk.green.bold('  Setup Complete! Restart Claude Code.'));
+        console.log(chalk.cyan('═══════════════════════════════════════'));
+        console.log('');
+        result.success = true;
+        return result;
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=setup-wizard.js.map