@zdql/giga-claude-client 1.0.0

package/dist/client/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Custom error classes for client SDK
+ */
+export declare class GigaClaudeError extends Error {
+    constructor(message: string);
+}
+export declare class NetworkError extends GigaClaudeError {
+    originalError?: any | undefined;
+    constructor(message: string, originalError?: any | undefined);
+}
+export declare class ValidationError extends GigaClaudeError {
+    details?: any | undefined;
+    constructor(message: string, details?: any | undefined);
+}
+export declare class NotFoundError extends GigaClaudeError {
+    constructor(message: string);
+}
+export declare class TimeoutError extends GigaClaudeError {
+    constructor(message: string);
+}
+export declare class AgentRunError extends GigaClaudeError {
+    runId: number;
+    status: string;
+    constructor(message: string, runId: number, status: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/client/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,eAAe;IACX,aAAa,CAAC,EAAE,GAAG;gBAA3C,OAAO,EAAE,MAAM,EAAS,aAAa,CAAC,EAAE,GAAG,YAAA;CAIxD;AAED,qBAAa,eAAgB,SAAQ,eAAe;IACd,OAAO,CAAC,EAAE,GAAG;gBAArC,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,GAAG,YAAA;CAIlD;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,eAAe;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,eAAe;IAGvC,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;gBAFrB,OAAO,EAAE,MAAM,EACR,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;CAKxB"}

package/dist/client/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Custom error classes for client SDK
+ */
+export class GigaClaudeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GigaClaudeError";
+    }
+}
+export class NetworkError extends GigaClaudeError {
+    originalError;
+    constructor(message, originalError) {
+        super(message);
+        this.originalError = originalError;
+        this.name = "NetworkError";
+    }
+}
+export class ValidationError extends GigaClaudeError {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "ValidationError";
+    }
+}
+export class NotFoundError extends GigaClaudeError {
+    constructor(message) {
+        super(message);
+        this.name = "NotFoundError";
+    }
+}
+export class TimeoutError extends GigaClaudeError {
+    constructor(message) {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}
+export class AgentRunError extends GigaClaudeError {
+    runId;
+    status;
+    constructor(message, runId, status) {
+        super(message);
+        this.runId = runId;
+        this.status = status;
+        this.name = "AgentRunError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IACX;IAApC,YAAY,OAAe,EAAS,aAAmB;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,kBAAa,GAAb,aAAa,CAAM;QAErD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACd;IAApC,YAAY,OAAe,EAAS,OAAa;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,YAAO,GAAP,OAAO,CAAM;QAE/C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,eAAe;IAGvC;IACA;IAHT,YACE,OAAe,EACR,KAAa,EACb,MAAc;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QAGrB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/client/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Giga-Claude Client SDK
+ * Strongly-typed client for interacting with Giga-Claude server
+ */
+import type { ClientOptions, StartRequest, StartResponse, PollOptions, PollResponse, StreamLogsOptions, AgentLog, WaitForCompletionOptions, ArtifactsResponse, ArtifactFile } from "./types.js";
+export declare class GigaClaudeClient {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    private retries;
+    constructor(options: ClientOptions);
+    /**
+     * Make HTTP request with retry logic
+     */
+    private request;
+    /**
+     * Start a new agent run
+     */
+    start(request: StartRequest): Promise<StartResponse>;
+    /**
+     * Poll for agent run status and logs
+     */
+    poll(runId: number, options?: PollOptions): Promise<PollResponse>;
+    /**
+     * Stream logs in real-time using polling
+     */
+    streamLogs(runId: number, options?: StreamLogsOptions): AsyncGenerator<AgentLog, void, unknown>;
+    /**
+     * Wait for agent run to complete
+     */
+    waitForCompletion(runId: number, options?: WaitForCompletionOptions): Promise<PollResponse>;
+    /**
+     * Get list of artifacts from agent run
+     */
+    getArtifacts(runId: number): Promise<ArtifactsResponse>;
+    /**
+     * Get specific artifact file
+     */
+    getArtifactFile(runId: number, path: string): Promise<ArtifactFile>;
+    /**
+     * Health check
+     */
+    health(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+}
+export * from "./types.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,QAAQ,EACR,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACb,MAAM,YAAY,CAAC;AAUpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,aAAa;IAOlC;;OAEG;YACW,OAAO;IA+ErB;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAO1D;;OAEG;IACG,IAAI,CACR,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,YAAY,CAAC;IA2CxB;;OAEG;IACI,UAAU,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC;IAiC1C;;OAEG;IACG,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,CAAC;IAyDxB;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI7D;;OAEG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,CAAC;IAaxB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAK/D;AAGD,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,216 @@
+/**
+ * Giga-Claude Client SDK
+ * Strongly-typed client for interacting with Giga-Claude server
+ */
+import { GigaClaudeError, NetworkError, ValidationError, NotFoundError, TimeoutError, AgentRunError, } from "./errors.js";
+export class GigaClaudeClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    retries;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, ""); // Remove trailing slash
+        this.apiKey = options.apiKey;
+        this.timeout = options.timeout || 30000; // 30 seconds default
+        this.retries = options.retries || 3;
+    }
+    /**
+     * Make HTTP request with retry logic
+     */
+    async request(path, options = {}, attempt = 1) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            ...(options.headers || {}),
+        };
+        if (this.apiKey) {
+            headers["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                ...options,
+                headers,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const error = await response.json().catch(() => ({
+                    error: `HTTP ${response.status}`,
+                }));
+                if (response.status === 404) {
+                    throw new NotFoundError(error.error || "Resource not found");
+                }
+                else if (response.status === 400) {
+                    throw new ValidationError(error.error || "Validation failed", error.details);
+                }
+                else if (response.status >= 500 && attempt < this.retries) {
+                    // Retry on server errors
+                    console.warn(`Request failed (attempt ${attempt}/${this.retries}), retrying...`);
+                    await new Promise((resolve) => setTimeout(resolve, 1000 * attempt));
+                    return this.request(path, options, attempt + 1);
+                }
+                throw new GigaClaudeError(error.error || `Request failed with status ${response.status}`);
+            }
+            return await response.json();
+        }
+        catch (error) {
+            if (error.name === "AbortError") {
+                throw new TimeoutError(`Request timeout after ${this.timeout}ms`);
+            }
+            if (error instanceof GigaClaudeError ||
+                error instanceof NotFoundError ||
+                error instanceof ValidationError) {
+                throw error;
+            }
+            throw new NetworkError(`Network request failed: ${error instanceof Error ? error.message : String(error)}`, error);
+        }
+    }
+    /**
+     * Start a new agent run
+     */
+    async start(request) {
+        return this.request("/start", {
+            method: "POST",
+            body: JSON.stringify(request),
+        });
+    }
+    /**
+     * Poll for agent run status and logs
+     */
+    async poll(runId, options) {
+        const params = new URLSearchParams();
+        if (options?.includeLogs !== undefined) {
+            params.set("includeLogs", String(options.includeLogs));
+        }
+        if (options?.logFilter) {
+            if (options.logFilter.type) {
+                if (Array.isArray(options.logFilter.type)) {
+                    options.logFilter.type.forEach((t) => params.append("type", t));
+                }
+                else {
+                    params.set("type", options.logFilter.type);
+                }
+            }
+            if (options.logFilter.afterTime) {
+                params.set("afterTime", options.logFilter.afterTime);
+            }
+            if (options.logFilter.beforeTime) {
+                params.set("beforeTime", options.logFilter.beforeTime);
+            }
+            if (options.logFilter.toolName) {
+                params.set("toolName", options.logFilter.toolName);
+            }
+        }
+        if (options?.limit !== undefined) {
+            params.set("limit", String(options.limit));
+        }
+        if (options?.offset !== undefined) {
+            params.set("offset", String(options.offset));
+        }
+        const queryString = params.toString();
+        const path = `/poll/${runId}${queryString ? `?${queryString}` : ""}`;
+        return this.request(path);
+    }
+    /**
+     * Stream logs in real-time using polling
+     */
+    async *streamLogs(runId, options) {
+        const pollInterval = options?.pollInterval || 1000;
+        let offset = options?.startOffset || 0;
+        let lastStatus = "running";
+        while (true) {
+            const response = await this.poll(runId, {
+                includeLogs: true,
+                logFilter: options?.logFilter,
+                offset,
+            });
+            // Yield new logs
+            if (response.logs && response.logs.length > 0) {
+                for (const log of response.logs) {
+                    yield log;
+                }
+                offset += response.logs.length;
+            }
+            // Update status
+            lastStatus = response.status;
+            // Stop if completed or failed
+            if (response.status !== "running") {
+                break;
+            }
+            // Wait before next poll
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+        }
+    }
+    /**
+     * Wait for agent run to complete
+     */
+    async waitForCompletion(runId, options) {
+        const pollInterval = options?.pollInterval || 2000;
+        const timeout = options?.timeout;
+        const startTime = Date.now();
+        let lastLogOffset = 0;
+        let lastStatus = "running";
+        while (true) {
+            // Check timeout
+            if (timeout && Date.now() - startTime > timeout) {
+                throw new TimeoutError(`Agent run ${runId} did not complete within ${timeout}ms`);
+            }
+            // Poll for status
+            const response = await this.poll(runId, {
+                includeLogs: !!options?.onLog,
+                offset: lastLogOffset,
+            });
+            // Call status change callback
+            if (options?.onStatusChange &&
+                response.status !== lastStatus) {
+                options.onStatusChange(response.status);
+                lastStatus = response.status;
+            }
+            // Call log callback for new logs
+            if (options?.onLog && response.logs && response.logs.length > 0) {
+                for (const log of response.logs) {
+                    options.onLog(log);
+                }
+                lastLogOffset += response.logs.length;
+            }
+            // Check if completed
+            if (response.status === "completed") {
+                return response;
+            }
+            if (response.status === "failed") {
+                throw new AgentRunError(response.error || "Agent run failed", runId, response.status);
+            }
+            // Wait before next poll
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+        }
+    }
+    /**
+     * Get list of artifacts from agent run
+     */
+    async getArtifacts(runId) {
+        return this.request(`/artifacts/${runId}`);
+    }
+    /**
+     * Get specific artifact file
+     */
+    async getArtifactFile(runId, path) {
+        const params = new URLSearchParams({ path });
+        const response = await this.request(`/artifacts/${runId}?${params.toString()}`);
+        if (!response.file) {
+            throw new NotFoundError(`Artifact file not found: ${path}`);
+        }
+        return response.file;
+    }
+    /**
+     * Health check
+     */
+    async health() {
+        return this.request("/health");
+    }
+}
+// Export types and errors
+export * from "./types.js";
+export * from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Type definitions for client SDK
+ */
+export type { StartRequest, StartResponse, LogFilter, PollQuery, PollResponse, ArtifactsQuery, ArtifactsResponse, } from "../types/api.js";
+import type { LogFilter } from "../types/api.js";
+/**
+ * Client configuration options
+ */
+export interface ClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    timeout?: number;
+    retries?: number;
+}
+/**
+ * Agent log entry
+ */
+export interface AgentLog {
+    id: number;
+    timestamp: string;
+    type: string;
+    content: any;
+    toolNumber?: number;
+    toolName?: string;
+}
+/**
+ * Poll options
+ */
+export interface PollOptions {
+    includeLogs?: boolean;
+    logFilter?: LogFilter;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Stream logs options
+ */
+export interface StreamLogsOptions {
+    pollInterval?: number;
+    logFilter?: LogFilter;
+    startOffset?: number;
+}
+/**
+ * Wait for completion options
+ */
+export interface WaitForCompletionOptions {
+    pollInterval?: number;
+    timeout?: number;
+    onLog?: (log: AgentLog) => void;
+    onStatusChange?: (status: string) => void;
+}
+/**
+ * Artifact file
+ */
+export interface ArtifactFile {
+    path: string;
+    content: string | Buffer;
+    mimeType: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/client/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for client SDK
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

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

package/dist/types/api.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Shared API type definitions
+ * Used by both server and client packages
+ */
+/**
+ * Request to start a new agent run
+ */
+export interface StartRequest {
+    prompt: string;
+    systemPrompt?: string;
+    model?: string;
+    allowedTools?: string[];
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    permissionMode?: "default" | "acceptEdits" | "bypassPermissions";
+    env?: Record<string, string>;
+}
+/**
+ * Response from starting an agent run
+ */
+export interface StartResponse {
+    runId: number;
+    sessionId: string;
+    status: "running";
+    createdAt: string;
+}
+/**
+ * Log filter options
+ */
+export interface LogFilter {
+    type?: string | string[];
+    afterTime?: string;
+    beforeTime?: string;
+    toolName?: string;
+}
+/**
+ * Query parameters for poll endpoint
+ */
+export interface PollQuery {
+    includeLogs?: boolean;
+    logFilter?: LogFilter;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response from polling an agent run
+ */
+export interface PollResponse {
+    runId: number;
+    sessionId: string;
+    status: "running" | "completed" | "failed";
+    model: string;
+    prompt: string;
+    systemPrompt?: string;
+    allowedTools: string[];
+    createdAt: string;
+    completedAt?: string;
+    totalCostUsd?: number;
+    error?: string;
+    result?: any;
+    logs?: Array<{
+        id: number;
+        timestamp: string;
+        type: string;
+        content: any;
+        toolNumber?: number;
+        toolName?: string;
+    }>;
+    logsCount: number;
+}
+/**
+ * Query parameters for artifacts endpoint
+ */
+export interface ArtifactsQuery {
+    path?: string;
+}
+/**
+ * Response from artifacts endpoint
+ */
+export interface ArtifactsResponse {
+    runId: number;
+    source: "live" | "s3" | "none";
+    artifacts: Array<{
+        path: string;
+        type: "file" | "directory";
+        size?: number;
+        url?: string;
+    }>;
+    file?: {
+        path: string;
+        content: string | Buffer;
+        mimeType: string;
+        url?: string;
+    };
+}
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../types/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,mBAAmB,CAAC;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,GAAG,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAC/B,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}

package/dist/types/api.js

@@ -0,0 +1,6 @@
+/**
+ * Shared API type definitions
+ * Used by both server and client packages
+ */
+export {};
+//# sourceMappingURL=api.js.map

package/dist/types/api.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@zdql/giga-claude-client",
+  "version": "1.0.0",
+  "description": "Strongly-typed client SDK for Giga-Claude",
+  "type": "module",
+  "main": "./dist/client/index.js",
+  "types": "./dist/client/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  },
+  "keywords": [
+    "giga-claude",
+    "claude",
+    "ai",
+    "agent",
+    "sdk",
+    "client"
+  ],
+  "license": "MIT"
+}