@gopher.security/gopher-mcp-js 0.1.1

package/dist/agent.js

@@ -0,0 +1,240 @@
+"use strict";
+/**
+ * GopherAgent - Main entry point for the gopher-orch TypeScript SDK.
+ *
+ * Provides a clean, TypeScript-friendly interface to the gopher-orch agent functionality.
+ *
+ * @example
+ * ```typescript
+ * // Create an agent with API key
+ * const agent = GopherAgent.create(
+ *   GopherAgentConfig.builder()
+ *     .provider('AnthropicProvider')
+ *     .model('claude-3-haiku-20240307')
+ *     .apiKey('your-api-key')
+ *     .build()
+ * );
+ *
+ * // Run a query
+ * const answer = agent.run('What time is it in Tokyo?');
+ * console.log(answer);
+ *
+ * // Cleanup
+ * agent.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use try-finally for automatic cleanup
+ * const agent = GopherAgent.create(config);
+ * try {
+ *   const answer = agent.run('What time is it in Tokyo?');
+ *   console.log(answer);
+ * } finally {
+ *   agent.dispose();
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GopherAgent = void 0;
+const config_1 = require("./config");
+const result_1 = require("./result");
+const errors_1 = require("./errors");
+const ffi_1 = require("./ffi");
+let initialized = false;
+let cleanupHandlerRegistered = false;
+/**
+ * Main agent class for interacting with the gopher-orch native library.
+ */
+class GopherAgent {
+    handle;
+    disposed = false;
+    constructor(handle) {
+        this.handle = handle;
+    }
+    /**
+     * Initialize the gopher-orch library.
+     *
+     * Must be called before creating any agents. Called automatically by create() if not already
+     * initialized.
+     *
+     * @throws {AgentError} if initialization fails
+     */
+    static init() {
+        if (initialized) {
+            return;
+        }
+        const lib = ffi_1.GopherOrchLibrary.getInstance();
+        if (lib === null) {
+            throw new errors_1.AgentError('Failed to load gopher-orch native library');
+        }
+        initialized = true;
+        setupCleanupHandler();
+    }
+    /**
+     * Shutdown the gopher-orch library.
+     *
+     * Called automatically on process exit, but can be called manually.
+     */
+    static shutdown() {
+        initialized = false;
+    }
+    /**
+     * Check if the library is initialized.
+     */
+    static isInitialized() {
+        return initialized;
+    }
+    /**
+     * Create a new GopherAgent instance.
+     *
+     * @param config Agent configuration
+     * @returns GopherAgent instance
+     * @throws {AgentError} if agent creation fails
+     */
+    static create(config) {
+        if (!initialized) {
+            GopherAgent.init();
+        }
+        const lib = ffi_1.GopherOrchLibrary.getInstance();
+        if (lib === null) {
+            throw new errors_1.AgentError('Native library not available');
+        }
+        let handle;
+        try {
+            if (config.hasApiKey()) {
+                handle = lib.agentCreateByApiKey(config.provider, config.model, config.apiKey);
+            }
+            else {
+                handle = lib.agentCreateByJson(config.provider, config.model, config.serverConfig);
+            }
+        }
+        catch (e) {
+            throw new errors_1.AgentError(`Failed to create agent: ${e.message}`);
+        }
+        if (handle === null) {
+            const errorInfo = lib.lastError();
+            lib.clearError();
+            if (errorInfo) {
+                const details = errorInfo.details ? `: ${errorInfo.details}` : '';
+                throw new errors_1.AgentError(`${errorInfo.message ?? 'Failed to create agent'}${details}`);
+            }
+            throw new errors_1.AgentError('Failed to create agent');
+        }
+        return new GopherAgent(handle);
+    }
+    /**
+     * Create a new GopherAgent with API key.
+     *
+     * @param provider Provider name (e.g., "AnthropicProvider")
+     * @param model Model name (e.g., "claude-3-haiku-20240307")
+     * @param apiKey API key for fetching remote server config
+     * @returns GopherAgent instance
+     */
+    static createWithApiKey(provider, model, apiKey) {
+        return GopherAgent.create(config_1.GopherAgentConfig.builder()
+            .provider(provider)
+            .model(model)
+            .apiKey(apiKey)
+            .build());
+    }
+    /**
+     * Create a new GopherAgent with JSON server config.
+     *
+     * @param provider Provider name (e.g., "AnthropicProvider")
+     * @param model Model name (e.g., "claude-3-haiku-20240307")
+     * @param serverConfig JSON server configuration
+     * @returns GopherAgent instance
+     */
+    static createWithServerConfig(provider, model, serverConfig) {
+        return GopherAgent.create(config_1.GopherAgentConfig.builder()
+            .provider(provider)
+            .model(model)
+            .serverConfig(serverConfig)
+            .build());
+    }
+    /**
+     * Run a query against the agent.
+     *
+     * @param query The user query to process
+     * @param timeoutMs Timeout in milliseconds (default: 60000)
+     * @returns The agent's response
+     * @throws {AgentError} if the query fails
+     */
+    run(query, timeoutMs = 60000) {
+        this.ensureNotDisposed();
+        const lib = ffi_1.GopherOrchLibrary.getInstance();
+        if (lib === null) {
+            throw new errors_1.AgentError('Native library not available');
+        }
+        try {
+            const response = lib.agentRun(this.handle, query, timeoutMs);
+            if (response === null) {
+                return `No response for query: "${query}"`;
+            }
+            return response;
+        }
+        catch (e) {
+            throw new errors_1.AgentError(`Query execution failed: ${e.message}`);
+        }
+    }
+    /**
+     * Run a query with detailed result information.
+     *
+     * @param query The user query to process
+     * @param timeoutMs Timeout in milliseconds (default: 60000)
+     * @returns AgentResult with response and metadata
+     */
+    runDetailed(query, timeoutMs = 60000) {
+        try {
+            const response = this.run(query, timeoutMs);
+            return result_1.AgentResult.builder()
+                .response(response)
+                .status(result_1.AgentResultStatus.SUCCESS)
+                .iterationCount(1)
+                .tokensUsed(0)
+                .build();
+        }
+        catch (e) {
+            if (e instanceof errors_1.TimeoutError) {
+                return result_1.AgentResult.timeout(e.message);
+            }
+            return result_1.AgentResult.error(e.message);
+        }
+    }
+    /**
+     * Dispose of the agent and free resources.
+     */
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        const lib = ffi_1.GopherOrchLibrary.getInstance();
+        if (lib !== null && this.handle !== null) {
+            lib.agentRelease(this.handle);
+        }
+    }
+    /**
+     * Check if agent is disposed.
+     */
+    isDisposed() {
+        return this.disposed;
+    }
+    ensureNotDisposed() {
+        if (this.disposed) {
+            throw new errors_1.AgentError('Agent has been disposed');
+        }
+    }
+}
+exports.GopherAgent = GopherAgent;
+function setupCleanupHandler() {
+    if (cleanupHandlerRegistered) {
+        return;
+    }
+    cleanupHandlerRegistered = true;
+    process.on('exit', () => {
+        GopherAgent.shutdown();
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;AAEH,qCAA6C;AAC7C,qCAA0D;AAC1D,qCAAoD;AACpD,+BAA4D;AAE5D,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB,IAAI,wBAAwB,GAAG,KAAK,CAAC;AAErC;;GAEG;AACH,MAAa,WAAW;IACd,MAAM,CAAmB;IACzB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAoB,MAAwB;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI;QACT,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,GAAG,GAAG,uBAAiB,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,mBAAU,CAAC,2CAA2C,CAAC,CAAC;QACpE,CAAC;QAED,WAAW,GAAG,IAAI,CAAC;QACnB,mBAAmB,EAAE,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAQ;QACb,WAAW,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAyB;QACrC,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,GAAG,GAAG,uBAAiB,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,mBAAU,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,MAA+B,CAAC;QACpC,IAAI,CAAC;YACH,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBACvB,MAAM,GAAG,GAAG,CAAC,mBAAmB,CAC9B,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAO,CACf,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,CAAC,iBAAiB,CAC5B,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,YAAa,CACrB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,mBAAU,CAAC,2BAA4B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;YAClC,GAAG,CAAC,UAAU,EAAE,CAAC;YACjB,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClE,MAAM,IAAI,mBAAU,CAAC,GAAG,SAAS,CAAC,OAAO,IAAI,wBAAwB,GAAG,OAAO,EAAE,CAAC,CAAC;YACrF,CAAC;YACD,MAAM,IAAI,mBAAU,CAAC,wBAAwB,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAgB,EAChB,KAAa,EACb,MAAc;QAEd,OAAO,WAAW,CAAC,MAAM,CACvB,0BAAiB,CAAC,OAAO,EAAE;aACxB,QAAQ,CAAC,QAAQ,CAAC;aAClB,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,MAAM,CAAC;aACd,KAAK,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,sBAAsB,CAC3B,QAAgB,EAChB,KAAa,EACb,YAAoB;QAEpB,OAAO,WAAW,CAAC,MAAM,CACvB,0BAAiB,CAAC,OAAO,EAAE;aACxB,QAAQ,CAAC,QAAQ,CAAC;aAClB,KAAK,CAAC,KAAK,CAAC;aACZ,YAAY,CAAC,YAAY,CAAC;aAC1B,KAAK,EAAE,CACX,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,KAAa,EAAE,SAAS,GAAG,KAAK;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,MAAM,GAAG,GAAG,uBAAiB,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,mBAAU,CAAC,8BAA8B,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAC7D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,OAAO,2BAA2B,KAAK,GAAG,CAAC;YAC7C,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,mBAAU,CAAC,2BAA4B,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,KAAa,EAAE,SAAS,GAAG,KAAK;QAC1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC5C,OAAO,oBAAW,CAAC,OAAO,EAAE;iBACzB,QAAQ,CAAC,QAAQ,CAAC;iBAClB,MAAM,CAAC,0BAAiB,CAAC,OAAO,CAAC;iBACjC,cAAc,CAAC,CAAC,CAAC;iBACjB,UAAU,CAAC,CAAC,CAAC;iBACb,KAAK,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,qBAAY,EAAE,CAAC;gBAC9B,OAAO,oBAAW,CAAC,OAAO,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,oBAAW,CAAC,KAAK,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,GAAG,GAAG,uBAAiB,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACzC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,mBAAU,CAAC,yBAAyB,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAzND,kCAyNC;AAED,SAAS,mBAAmB;IAC1B,IAAI,wBAAwB,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,wBAAwB,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACtB,WAAW,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Configuration options for creating a GopherAgent.
+ */
+export interface GopherAgentConfigOptions {
+    provider: string;
+    model: string;
+    apiKey?: string;
+    serverConfig?: string;
+}
+/**
+ * Configuration for creating a GopherAgent.
+ */
+export declare class GopherAgentConfig {
+    readonly provider: string;
+    readonly model: string;
+    readonly apiKey?: string;
+    readonly serverConfig?: string;
+    private constructor();
+    /**
+     * Check if this config uses an API key.
+     */
+    hasApiKey(): boolean;
+    /**
+     * Check if this config uses a server config.
+     */
+    hasServerConfig(): boolean;
+    /**
+     * Create a new builder for GopherAgentConfig.
+     */
+    static builder(): GopherAgentConfigBuilder;
+}
+/**
+ * Builder for GopherAgentConfig.
+ */
+export declare class GopherAgentConfigBuilder {
+    private _provider?;
+    private _model?;
+    private _apiKey?;
+    private _serverConfig?;
+    /**
+     * Set the LLM provider (e.g., "AnthropicProvider").
+     */
+    provider(provider: string): this;
+    /**
+     * Set the model name (e.g., "claude-3-haiku-20240307").
+     */
+    model(model: string): this;
+    /**
+     * Set the API key for fetching remote server config.
+     * Mutually exclusive with serverConfig.
+     */
+    apiKey(apiKey: string): this;
+    /**
+     * Set the JSON server configuration.
+     * Mutually exclusive with apiKey.
+     */
+    serverConfig(serverConfig: string): this;
+    /**
+     * Build the GopherAgentConfig.
+     */
+    build(): GopherAgentConfig;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtC,OAAO;IAoBP;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,wBAAwB;CAG3C;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,aAAa,CAAC,CAAS;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKhC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;;OAGG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,KAAK,IAAI,iBAAiB;CAU3B"}

package/dist/config.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GopherAgentConfigBuilder = exports.GopherAgentConfig = void 0;
+/**
+ * Configuration for creating a GopherAgent.
+ */
+class GopherAgentConfig {
+    provider;
+    model;
+    apiKey;
+    serverConfig;
+    constructor(options) {
+        if (!options.provider) {
+            throw new Error('Provider is required');
+        }
+        if (!options.model) {
+            throw new Error('Model is required');
+        }
+        if (!options.apiKey && !options.serverConfig) {
+            throw new Error('Either apiKey or serverConfig is required');
+        }
+        if (options.apiKey && options.serverConfig) {
+            throw new Error('Cannot specify both apiKey and serverConfig');
+        }
+        this.provider = options.provider;
+        this.model = options.model;
+        this.apiKey = options.apiKey;
+        this.serverConfig = options.serverConfig;
+    }
+    /**
+     * Check if this config uses an API key.
+     */
+    hasApiKey() {
+        return this.apiKey !== undefined;
+    }
+    /**
+     * Check if this config uses a server config.
+     */
+    hasServerConfig() {
+        return this.serverConfig !== undefined;
+    }
+    /**
+     * Create a new builder for GopherAgentConfig.
+     */
+    static builder() {
+        return new GopherAgentConfigBuilder();
+    }
+}
+exports.GopherAgentConfig = GopherAgentConfig;
+/**
+ * Builder for GopherAgentConfig.
+ */
+class GopherAgentConfigBuilder {
+    _provider;
+    _model;
+    _apiKey;
+    _serverConfig;
+    /**
+     * Set the LLM provider (e.g., "AnthropicProvider").
+     */
+    provider(provider) {
+        this._provider = provider;
+        return this;
+    }
+    /**
+     * Set the model name (e.g., "claude-3-haiku-20240307").
+     */
+    model(model) {
+        this._model = model;
+        return this;
+    }
+    /**
+     * Set the API key for fetching remote server config.
+     * Mutually exclusive with serverConfig.
+     */
+    apiKey(apiKey) {
+        this._apiKey = apiKey;
+        return this;
+    }
+    /**
+     * Set the JSON server configuration.
+     * Mutually exclusive with apiKey.
+     */
+    serverConfig(serverConfig) {
+        this._serverConfig = serverConfig;
+        return this;
+    }
+    /**
+     * Build the GopherAgentConfig.
+     */
+    build() {
+        return new GopherAgentConfig({
+            provider: this._provider ?? '',
+            model: this._model ?? '',
+            apiKey: this._apiKey,
+            serverConfig: this._serverConfig,
+        });
+    }
+}
+exports.GopherAgentConfigBuilder = GopherAgentConfigBuilder;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAUA;;GAEG;AACH,MAAa,iBAAiB;IACZ,QAAQ,CAAS;IACjB,KAAK,CAAS;IACd,MAAM,CAAU;IAChB,YAAY,CAAU;IAEtC,YAAoB,OAAiC;QACnD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,wBAAwB,EAAE,CAAC;IACxC,CAAC;CACF;AA9CD,8CA8CC;AAED;;GAEG;AACH,MAAa,wBAAwB;IAC3B,SAAS,CAAU;IACnB,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,aAAa,CAAU;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAgB;QACvB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,YAAoB;QAC/B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,IAAK,iBAEV,CAAC;YACD,QAAQ,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC9B,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;YACxB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,YAAY,EAAE,IAAI,CAAC,aAAa;SACjC,CAAC,CAAC;IACL,CAAC;CACF;AArDD,4DAqDC"}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Custom error classes for gopher-orch operations.
+ */
+/**
+ * Base error class for agent operations.
+ */
+export declare class AgentError extends Error {
+    readonly code?: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Error thrown when API key is invalid or missing.
+ */
+export declare class ApiKeyError extends AgentError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when connection fails.
+ */
+export declare class ConnectionError extends AgentError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when operation times out.
+ */
+export declare class TimeoutError extends AgentError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM3C;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Custom error classes for gopher-orch operations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutError = exports.ConnectionError = exports.ApiKeyError = exports.AgentError = void 0;
+/**
+ * Base error class for agent operations.
+ */
+class AgentError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = 'AgentError';
+        this.code = code;
+        Object.setPrototypeOf(this, AgentError.prototype);
+    }
+}
+exports.AgentError = AgentError;
+/**
+ * Error thrown when API key is invalid or missing.
+ */
+class ApiKeyError extends AgentError {
+    constructor(message) {
+        super(message, 'API_KEY_ERROR');
+        this.name = 'ApiKeyError';
+        Object.setPrototypeOf(this, ApiKeyError.prototype);
+    }
+}
+exports.ApiKeyError = ApiKeyError;
+/**
+ * Error thrown when connection fails.
+ */
+class ConnectionError extends AgentError {
+    constructor(message) {
+        super(message, 'CONNECTION_ERROR');
+        this.name = 'ConnectionError';
+        Object.setPrototypeOf(this, ConnectionError.prototype);
+    }
+}
+exports.ConnectionError = ConnectionError;
+/**
+ * Error thrown when operation times out.
+ */
+class TimeoutError extends AgentError {
+    constructor(message) {
+        super(message, 'TIMEOUT_ERROR');
+        this.name = 'TimeoutError';
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+exports.TimeoutError = TimeoutError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,MAAa,UAAW,SAAQ,KAAK;IACnB,IAAI,CAAU;IAE9B,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AATD,gCASC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,UAAU;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AAND,kCAMC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,UAAU;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;CACF;AAND,0CAMC;AAED;;GAEG;AACH,MAAa,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;CACF;AAND,oCAMC"}

package/dist/ffi/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FFI module exports.
+ */
+export { GopherOrchLibrary } from './library';
+export type { GopherOrchHandle, GopherOrchErrorInfoData } from './library';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ffi/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC"}

package/dist/ffi/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * FFI module exports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GopherOrchLibrary = void 0;
+var library_1 = require("./library");
+Object.defineProperty(exports, "GopherOrchLibrary", { enumerable: true, get: function () { return library_1.GopherOrchLibrary; } });
+//# sourceMappingURL=index.js.map

package/dist/ffi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ffi/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAA8C;AAArC,4GAAA,iBAAiB,OAAA"}

package/dist/ffi/library.d.ts

@@ -0,0 +1,80 @@
+/**
+ * koffi interface to the gopher-orch native library.
+ */
+declare const OpaqueHandle: unique symbol;
+export type GopherOrchHandle = {
+    readonly [OpaqueHandle]: 'GopherOrchHandle';
+};
+export interface GopherOrchErrorInfoData {
+    code: number;
+    message: string | null;
+    details: string | null;
+    file: string | null;
+    line: number;
+}
+/**
+ * Wrapper for the gopher-orch native library using koffi.
+ */
+export declare class GopherOrchLibrary {
+    private static instance;
+    private lib;
+    private available;
+    private debug;
+    private _agentCreateByJson;
+    private _agentCreateByApiKey;
+    private _agentRun;
+    private _agentAddRef;
+    private _agentRelease;
+    private _apiFetchServers;
+    private _lastError;
+    private _clearError;
+    private _free;
+    private _setLogLevel;
+    private constructor();
+    /**
+     * Get the library instance, loading it if necessary.
+     */
+    static getInstance(): GopherOrchLibrary | null;
+    /**
+     * Check if the library is available.
+     */
+    static isAvailable(): boolean;
+    private loadLibrary;
+    private setupFunctions;
+    private getLibraryName;
+    private getSearchPaths;
+    /**
+     * Get the path to the platform-specific optional dependency package.
+     * These packages are published as gopher-orch-{platform}-{arch}
+     * and contain the native library for that specific platform.
+     */
+    private getPlatformPackagePath;
+    agentCreateByJson(provider: string, model: string, serverJson: string): GopherOrchHandle | null;
+    agentCreateByApiKey(provider: string, model: string, apiKey: string): GopherOrchHandle | null;
+    agentRun(agent: GopherOrchHandle, query: string, timeoutMs: number): string | null;
+    agentAddRef(agent: GopherOrchHandle): void;
+    agentRelease(agent: GopherOrchHandle): void;
+    apiFetchServers(apiKey: string): string | null;
+    lastError(): GopherOrchErrorInfoData | null;
+    getLastErrorMessage(): string | null;
+    clearError(): void;
+    free(ptr: unknown): void;
+    /**
+     * Set the global log level for the native library.
+     * Log levels:
+     *   0 = Debug (most verbose)
+     *   1 = Info
+     *   2 = Notice
+     *   3 = Warning (default for production)
+     *   4 = Error
+     *   5 = Critical
+     *   6 = Alert
+     *   7 = Emergency
+     *   8 = Off (no logging)
+     *
+     * @param level - Log level (0-8)
+     */
+    setLogLevel(level: number): void;
+}
+export {};
+//# sourceMappingURL=library.d.ts.map

package/dist/ffi/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/ffi/library.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAC1C,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAoB/E,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IACzD,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IAGtB,OAAO,CAAC,kBAAkB,CAMV;IAChB,OAAO,CAAC,oBAAoB,CAEZ;IAChB,OAAO,CAAC,SAAS,CAMD;IAChB,OAAO,CAAC,YAAY,CAAoD;IACxE,OAAO,CAAC,aAAa,CAAoD;IACzE,OAAO,CAAC,gBAAgB,CAAoD;IAC5E,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,YAAY,CAA0C;IAE9D,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB,GAAG,IAAI;IAS9C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,OAAO;IAK7B,OAAO,CAAC,WAAW;IAiEnB,OAAO,CAAC,cAAc;IA4DtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IA8BtB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA8C9B,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,gBAAgB,GAAG,IAAI;IAO1B,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,GAAG,IAAI;IAO1B,QAAQ,CACN,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,IAAI;IAOhB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAM1C,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAO3C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQ9C,SAAS,IAAI,uBAAuB,GAAG,IAAI;IAiB3C,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAQpC,UAAU,IAAI,IAAI;IAMlB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAMxB;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAKjC"}