@opencontextprotocol/agent 0.1.0

package/dist/src/headers.js

@@ -0,0 +1,238 @@
+/**
+ * OCP Headers - HTTP header management for Open Context Protocol.
+ *
+ * Handles encoding/decoding agent context into HTTP headers and validation.
+ */
+import { gzipSync, gunzipSync } from 'zlib';
+import { AgentContext } from './context.js';
+// OCP Header names
+export const OCP_CONTEXT_ID = 'OCP-Context-ID';
+export const OCP_SESSION = 'OCP-Session';
+export const OCP_CURRENT_GOAL = 'OCP-Current-Goal';
+export const OCP_AGENT_TYPE = 'OCP-Agent-Type';
+export const OCP_USER = 'OCP-User';
+export const OCP_WORKSPACE = 'OCP-Workspace';
+export const OCP_VERSION = 'OCP-Version';
+// Current OCP specification version
+export const OCP_SPEC_VERSION = '1.0';
+/**
+ * Manages OCP HTTP headers for agent context transmission.
+ *
+ * Handles encoding agent context into HTTP headers and decoding
+ * received headers back into context objects.
+ */
+export class OCPHeaders {
+    /**
+     * Encode AgentContext into OCP HTTP headers
+     */
+    static encodeContext(context, compress = true) {
+        const headers = {
+            [OCP_CONTEXT_ID]: context.context_id,
+            [OCP_AGENT_TYPE]: context.agent_type,
+            [OCP_VERSION]: OCP_SPEC_VERSION,
+        };
+        // Add optional headers if present
+        if (context.current_goal) {
+            headers[OCP_CURRENT_GOAL] = context.current_goal;
+        }
+        if (context.user) {
+            headers[OCP_USER] = context.user;
+        }
+        if (context.workspace) {
+            headers[OCP_WORKSPACE] = context.workspace;
+        }
+        // Encode session data
+        const sessionData = context.toDict();
+        const sessionJson = JSON.stringify(sessionData);
+        if (compress && sessionJson.length > 1000) {
+            // Compress large session data
+            const compressed = gzipSync(Buffer.from(sessionJson, 'utf-8'));
+            const encoded = compressed.toString('base64');
+            headers[OCP_SESSION] = `gzip:${encoded}`;
+        }
+        else {
+            // Base64 encode without compression
+            const encoded = Buffer.from(sessionJson, 'utf-8').toString('base64');
+            headers[OCP_SESSION] = encoded;
+        }
+        return headers;
+    }
+    /**
+     * Decode OCP headers back into an AgentContext object
+     */
+    static decodeContext(headers) {
+        // Normalize header names (case-insensitive lookup)
+        const normalizedHeaders = {};
+        for (const [key, value] of Object.entries(headers)) {
+            normalizedHeaders[key.toLowerCase()] = value;
+        }
+        const contextId = normalizedHeaders[OCP_CONTEXT_ID.toLowerCase()];
+        const sessionData = normalizedHeaders[OCP_SESSION.toLowerCase()];
+        if (!contextId || !sessionData) {
+            return null;
+        }
+        try {
+            let sessionJson;
+            // Decode session data
+            if (sessionData.startsWith('gzip:')) {
+                // Decompress gzipped data
+                const encodedData = sessionData.slice(5); // Remove "gzip:" prefix
+                const compressed = Buffer.from(encodedData, 'base64');
+                sessionJson = gunzipSync(compressed).toString('utf-8');
+            }
+            else {
+                // Base64 decode
+                sessionJson = Buffer.from(sessionData, 'base64').toString('utf-8');
+            }
+            // Parse context data
+            const contextData = JSON.parse(sessionJson);
+            return AgentContext.fromDict(contextData);
+        }
+        catch (e) {
+            return null;
+        }
+    }
+    /**
+     * Validate that headers contain valid OCP context
+     */
+    static validateHeaders(headers) {
+        const normalizedHeaders = {};
+        for (const [key, value] of Object.entries(headers)) {
+            normalizedHeaders[key.toLowerCase()] = value;
+        }
+        // Check required headers
+        const required = [OCP_CONTEXT_ID.toLowerCase(), OCP_SESSION.toLowerCase()];
+        if (!required.every(header => header in normalizedHeaders)) {
+            return false;
+        }
+        // Validate context can be decoded
+        const context = OCPHeaders.decodeContext(headers);
+        return context !== null;
+    }
+    /**
+     * Get a human-readable summary of the OCP context from headers
+     */
+    static getContextSummary(headers) {
+        const normalizedHeaders = {};
+        for (const [key, value] of Object.entries(headers)) {
+            normalizedHeaders[key.toLowerCase()] = value;
+        }
+        const contextId = normalizedHeaders[OCP_CONTEXT_ID.toLowerCase()] || 'unknown';
+        const agentType = normalizedHeaders[OCP_AGENT_TYPE.toLowerCase()] || 'unknown';
+        const goal = normalizedHeaders[OCP_CURRENT_GOAL.toLowerCase()] || 'none';
+        const user = normalizedHeaders[OCP_USER.toLowerCase()] || 'unknown';
+        const workspace = normalizedHeaders[OCP_WORKSPACE.toLowerCase()] || 'unknown';
+        return `OCP Context: ${contextId} | Agent: ${agentType} | Goal: ${goal} | Workspace: ${workspace}`;
+    }
+    /**
+     * Merge OCP headers with existing HTTP headers
+     */
+    static mergeHeaders(baseHeaders, ocpHeaders) {
+        return { ...baseHeaders, ...ocpHeaders };
+    }
+    /**
+     * Remove OCP headers from a headers dictionary
+     */
+    static stripOCPHeaders(headers) {
+        const ocpHeaderNames = new Set([
+            OCP_CONTEXT_ID.toLowerCase(),
+            OCP_SESSION.toLowerCase(),
+            OCP_CURRENT_GOAL.toLowerCase(),
+            OCP_AGENT_TYPE.toLowerCase(),
+            OCP_USER.toLowerCase(),
+            OCP_WORKSPACE.toLowerCase(),
+            OCP_VERSION.toLowerCase(),
+        ]);
+        const result = {};
+        for (const [key, value] of Object.entries(headers)) {
+            if (!ocpHeaderNames.has(key.toLowerCase())) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Convenience function to create OCP headers from context
+ */
+export function createOCPHeaders(context, baseHeaders, compress = true) {
+    const ocpHeaders = OCPHeaders.encodeContext(context, compress);
+    if (baseHeaders) {
+        return OCPHeaders.mergeHeaders(baseHeaders, ocpHeaders);
+    }
+    return ocpHeaders;
+}
+/**
+ * Extract OCP context from an HTTP response object
+ */
+export function extractContextFromResponse(response) {
+    if (!response || !response.headers) {
+        return null;
+    }
+    // Convert headers to dict (handle different response types)
+    let headersDict;
+    if (typeof response.headers.entries === 'function') {
+        headersDict = {};
+        for (const [key, value] of response.headers.entries()) {
+            headersDict[key] = value;
+        }
+    }
+    else if (typeof response.headers.items === 'function') {
+        headersDict = Object.fromEntries(response.headers.items());
+    }
+    else {
+        headersDict = response.headers;
+    }
+    return OCPHeaders.decodeContext(headersDict);
+}
+/**
+ * Convenience function to parse OCP context from HTTP headers
+ */
+export function parseContext(headers) {
+    // Convert headers to dict (handle different header types)
+    let headersDict;
+    if (headers instanceof Headers) {
+        headersDict = {};
+        headers.forEach((value, key) => {
+            headersDict[key] = value;
+        });
+    }
+    else if (typeof headers.entries === 'function') {
+        headersDict = Object.fromEntries(headers.entries());
+    }
+    else if (typeof headers.items === 'function') {
+        headersDict = Object.fromEntries(headers.items());
+    }
+    else {
+        headersDict = headers;
+    }
+    return OCPHeaders.decodeContext(headersDict);
+}
+/**
+ * Convenience function to add OCP headers to HTTP response objects
+ */
+export function addContextHeaders(response, context, compress = true) {
+    const ocpHeaders = createOCPHeaders(context, undefined, compress);
+    // Handle different response types
+    if (response.headers && typeof response.headers.set === 'function') {
+        // Headers object (fetch API)
+        for (const [key, value] of Object.entries(ocpHeaders)) {
+            response.headers.set(key, value);
+        }
+    }
+    else if (response.headers && typeof response.headers === 'object') {
+        // Plain object
+        Object.assign(response.headers, ocpHeaders);
+    }
+    else if (typeof response.setHeader === 'function') {
+        // Node.js response
+        for (const [key, value] of Object.entries(ocpHeaders)) {
+            response.setHeader(key, value);
+        }
+    }
+    else {
+        throw new TypeError(`Unsupported response type: ${typeof response}. ` +
+            `Response must have a 'headers' attribute that supports item assignment.`);
+    }
+}
+//# sourceMappingURL=headers.js.map

package/dist/src/headers.js.map

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

package/dist/src/http_client.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OCP HTTP Client
+ *
+ * HTTP client wrapper that automatically injects OCP context headers.
+ */
+import { AgentContext } from './context.js';
+/**
+ * HTTP request options
+ */
+interface RequestOptions {
+    params?: Record<string, string | number | boolean>;
+    json?: any;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+/**
+ * HTTP response wrapper
+ */
+export interface OCPResponse {
+    status: number;
+    statusText: string;
+    ok: boolean;
+    headers: Headers;
+    data: any;
+    text: string;
+    json: () => Promise<any>;
+}
+/**
+ * OCP HTTP Client
+ *
+ * Wraps HTTP requests to automatically inject OCP context headers
+ * and log interactions.
+ */
+export declare class OCPHTTPClient {
+    private context;
+    private autoUpdateContext;
+    private baseUrl?;
+    constructor(context: AgentContext, autoUpdateContext?: boolean, baseUrl?: string);
+    /**
+     * Prepare headers with OCP context.
+     */
+    private _prepareHeaders;
+    /**
+     * Log API interaction to context.
+     */
+    private _logInteraction;
+    /**
+     * Make HTTP request.
+     */
+    request(method: string, url: string, options?: RequestOptions): Promise<OCPResponse>;
+    /**
+     * GET request.
+     */
+    get(url: string, options?: RequestOptions): Promise<OCPResponse>;
+    /**
+     * POST request.
+     */
+    post(url: string, options?: RequestOptions): Promise<OCPResponse>;
+    /**
+     * PUT request.
+     */
+    put(url: string, options?: RequestOptions): Promise<OCPResponse>;
+    /**
+     * DELETE request.
+     */
+    delete(url: string, options?: RequestOptions): Promise<OCPResponse>;
+    /**
+     * PATCH request.
+     */
+    patch(url: string, options?: RequestOptions): Promise<OCPResponse>;
+}
+/**
+ * Create API-specific HTTP client (internal use only).
+ *
+ * @param baseUrl - API base URL
+ * @param context - Agent context
+ * @param headers - Optional headers to include in all requests
+ * @returns Configured HTTP client
+ */
+export declare function _wrapApi(baseUrl: string, context: AgentContext, headers?: Record<string, string>): OCPHTTPClient;
+export {};
+//# sourceMappingURL=http_client.d.ts.map

package/dist/src/http_client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http_client.d.ts","sourceRoot":"","sources":["../../src/http_client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C;;GAEG;AACH,UAAU,cAAc;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,EAAE,YAAY,EAAE,iBAAiB,GAAE,OAAc,EAAE,OAAO,CAAC,EAAE,MAAM;IAMtF;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4CvB;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA2E9F;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI1E;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI3E;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7E;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;CAG/E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,CAchH"}

package/dist/src/http_client.js

@@ -0,0 +1,181 @@
+/**
+ * OCP HTTP Client
+ *
+ * HTTP client wrapper that automatically injects OCP context headers.
+ */
+import { createOCPHeaders } from './headers.js';
+/**
+ * OCP HTTP Client
+ *
+ * Wraps HTTP requests to automatically inject OCP context headers
+ * and log interactions.
+ */
+export class OCPHTTPClient {
+    constructor(context, autoUpdateContext = true, baseUrl) {
+        this.context = context;
+        this.autoUpdateContext = autoUpdateContext;
+        this.baseUrl = baseUrl?.replace(/\/$/, ''); // Remove trailing slash
+    }
+    /**
+     * Prepare headers with OCP context.
+     */
+    _prepareHeaders(additionalHeaders) {
+        const ocpHeaders = createOCPHeaders(this.context);
+        return {
+            ...ocpHeaders,
+            ...additionalHeaders
+        };
+    }
+    /**
+     * Log API interaction to context.
+     */
+    _logInteraction(method, url, response, error) {
+        if (!this.autoUpdateContext) {
+            return;
+        }
+        // Parse API endpoint
+        const parsedUrl = new URL(url);
+        const endpoint = `${method.toUpperCase()} ${parsedUrl.pathname}`;
+        // Get status code from response
+        const statusCode = response?.status;
+        // Determine result string
+        let result;
+        if (error) {
+            result = `Error: ${error.message}`;
+        }
+        else if (statusCode !== undefined) {
+            result = `HTTP ${statusCode}`;
+        }
+        // Build interaction metadata
+        const metadata = {
+            method: method.toUpperCase(),
+            url: url,
+            domain: parsedUrl.hostname,
+            success: !error && statusCode ? statusCode >= 200 && statusCode < 300 : false,
+        };
+        if (statusCode !== undefined) {
+            metadata.status_code = statusCode;
+        }
+        if (error) {
+            metadata.error = error.message;
+        }
+        this.context.addInteraction(`api_call_${method.toLowerCase()}`, endpoint, result, metadata);
+    }
+    /**
+     * Make HTTP request.
+     */
+    async request(method, url, options = {}) {
+        const { params, json, headers, timeout = 30000 } = options;
+        // Handle base URL for relative URLs
+        let finalUrl;
+        if (this.baseUrl && !url.startsWith('http://') && !url.startsWith('https://')) {
+            finalUrl = new URL(`${this.baseUrl}${url}`);
+        }
+        else {
+            finalUrl = new URL(url);
+        }
+        // Add query parameters
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                finalUrl.searchParams.append(key, String(value));
+            }
+        }
+        // Prepare headers
+        const finalHeaders = this._prepareHeaders(headers);
+        // Add content-type for JSON
+        if (json !== undefined) {
+            finalHeaders['Content-Type'] = 'application/json';
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(finalUrl.toString(), {
+                method: method.toUpperCase(),
+                headers: finalHeaders,
+                body: json !== undefined ? JSON.stringify(json) : undefined,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            // Read response text
+            const text = await response.text();
+            // Parse JSON if possible
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+            const ocpResponse = {
+                status: response.status,
+                statusText: response.statusText,
+                ok: response.ok,
+                headers: response.headers,
+                data,
+                text,
+                json: async () => JSON.parse(text)
+            };
+            this._logInteraction(method, finalUrl.toString(), ocpResponse);
+            return ocpResponse;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            const err = error instanceof Error ? error : new Error(String(error));
+            this._logInteraction(method, finalUrl.toString(), undefined, err);
+            throw err;
+        }
+    }
+    /**
+     * GET request.
+     */
+    async get(url, options = {}) {
+        return this.request('GET', url, options);
+    }
+    /**
+     * POST request.
+     */
+    async post(url, options = {}) {
+        return this.request('POST', url, options);
+    }
+    /**
+     * PUT request.
+     */
+    async put(url, options = {}) {
+        return this.request('PUT', url, options);
+    }
+    /**
+     * DELETE request.
+     */
+    async delete(url, options = {}) {
+        return this.request('DELETE', url, options);
+    }
+    /**
+     * PATCH request.
+     */
+    async patch(url, options = {}) {
+        return this.request('PATCH', url, options);
+    }
+}
+/**
+ * Create API-specific HTTP client (internal use only).
+ *
+ * @param baseUrl - API base URL
+ * @param context - Agent context
+ * @param headers - Optional headers to include in all requests
+ * @returns Configured HTTP client
+ */
+export function _wrapApi(baseUrl, context, headers) {
+    const client = new OCPHTTPClient(context, true, baseUrl);
+    // Override request method to add additional headers if provided
+    if (headers) {
+        const originalRequest = client.request.bind(client);
+        client.request = (method, url, options = {}) => {
+            const opts = { ...options };
+            opts.headers = { ...headers, ...opts.headers };
+            return originalRequest(method, url, opts);
+        };
+    }
+    return client;
+}
+//# sourceMappingURL=http_client.js.map

package/dist/src/http_client.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Open Context Protocol (OCP) - JavaScript/TypeScript Library
+ *
+ * A zero-infrastructure protocol that provides conversational context
+ * and automatic API discovery to enhance AI agent interactions.
+ *
+ * Enables persistent context sharing across HTTP API calls using standard headers,
+ * requiring no servers or infrastructure setup.
+ */
+/**
+ * Open Context Protocol (OCP) - JavaScript/TypeScript Implementation
+ *
+ * Core library for implementing OCP context management in AI agents.
+ */
+export { AgentContext, OCPContextDict } from './context.js';
+export { OCPHeaders, OCP_CONTEXT_ID, OCP_SESSION, OCP_CURRENT_GOAL, OCP_AGENT_TYPE, OCP_USER, OCP_WORKSPACE, OCP_VERSION, OCP_SPEC_VERSION, createOCPHeaders, extractContextFromResponse, parseContext, addContextHeaders } from './headers.js';
+export { ValidationResult, validateContext, validateContextDict, getSchema, validateAndFixContext } from './validation.js';
+export { OCPError, RegistryUnavailable, APINotFound, SchemaDiscoveryError, ValidationError } from './errors.js';
+export { OCPSchemaDiscovery, type OCPTool, type OCPAPISpec } from './schema_discovery.js';
+export { OCPRegistry } from './registry.js';
+export { OCPHTTPClient, type OCPResponse } from './http_client.js';
+export { OCPAgent } from './agent.js';
+export { OCPStorage } from './storage.js';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AAGH,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG5D,OAAO,EACH,UAAU,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACH,QAAQ,EACR,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,eAAe,EAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACH,kBAAkB,EAClB,KAAK,OAAO,EACZ,KAAK,UAAU,EAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EACH,aAAa,EACb,KAAK,WAAW,EACnB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,35 @@
+/**
+ * Open Context Protocol (OCP) - JavaScript/TypeScript Library
+ *
+ * A zero-infrastructure protocol that provides conversational context
+ * and automatic API discovery to enhance AI agent interactions.
+ *
+ * Enables persistent context sharing across HTTP API calls using standard headers,
+ * requiring no servers or infrastructure setup.
+ */
+/**
+ * Open Context Protocol (OCP) - JavaScript/TypeScript Implementation
+ *
+ * Core library for implementing OCP context management in AI agents.
+ */
+// Core exports
+export { AgentContext } from './context.js';
+// Headers
+export { OCPHeaders, OCP_CONTEXT_ID, OCP_SESSION, OCP_CURRENT_GOAL, OCP_AGENT_TYPE, OCP_USER, OCP_WORKSPACE, OCP_VERSION, OCP_SPEC_VERSION, createOCPHeaders, extractContextFromResponse, parseContext, addContextHeaders } from './headers.js';
+// Validation
+export { ValidationResult, validateContext, validateContextDict, getSchema, validateAndFixContext } from './validation.js';
+// Errors
+export { OCPError, RegistryUnavailable, APINotFound, SchemaDiscoveryError, ValidationError } from './errors.js';
+// Schema Discovery
+export { OCPSchemaDiscovery } from './schema_discovery.js';
+// Registry
+export { OCPRegistry } from './registry.js';
+// HTTP Client
+export { OCPHTTPClient } from './http_client.js';
+// Agent
+export { OCPAgent } from './agent.js';
+// Storage
+export { OCPStorage } from './storage.js';
+// Version
+export const VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAkB,MAAM,cAAc,CAAC;AAE5D,UAAU;AACV,OAAO,EACH,UAAU,EACV,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,YAAY,EACZ,iBAAiB,EACpB,MAAM,cAAc,CAAC;AAEtB,aAAa;AACb,OAAO,EACH,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AAEzB,SAAS;AACT,OAAO,EACH,QAAQ,EACR,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,eAAe,EAClB,MAAM,aAAa,CAAC;AAErB,mBAAmB;AACnB,OAAO,EACH,kBAAkB,EAGrB,MAAM,uBAAuB,CAAC;AAE/B,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,cAAc;AACd,OAAO,EACH,aAAa,EAEhB,MAAM,kBAAkB,CAAC;AAE1B,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,UAAU;AACV,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/dist/src/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * OCP Registry Client
+ *
+ * Client for accessing pre-discovered API specifications from the OCP registry.
+ */
+import { OCPAPISpec } from './schema_discovery.js';
+/**
+ * OCP Registry Client
+ *
+ * Access pre-discovered API specifications from the OCP community registry.
+ */
+export declare class OCPRegistry {
+    private registryUrl;
+    /**
+     * Initialize registry client.
+     *
+     * @param registryUrl - Registry URL (defaults to OCP_REGISTRY_URL env var or registry.ocp.dev)
+     */
+    constructor(registryUrl?: string);
+    /**
+     * Get API specification from registry.
+     *
+     * @param name - API name in registry
+     * @param baseUrl - Optional override for API base URL
+     * @returns API specification with tools
+     * @throws RegistryUnavailable if registry is unreachable
+     * @throws APINotFound if API is not found in registry
+     */
+    getApiSpec(name: string, baseUrl?: string): Promise<OCPAPISpec>;
+    /**
+     * Search for APIs in the registry.
+     *
+     * @param query - Search query string
+     * @returns List of API names matching query
+     */
+    searchApis(query: string): Promise<string[]>;
+    /**
+     * List all APIs in the registry.
+     *
+     * @returns List of API names
+     */
+    listApis(): Promise<string[]>;
+    /**
+     * Convert registry entry to API spec.
+     */
+    private _entryToSpec;
+    /**
+     * Get API name suggestions for error messages.
+     */
+    private _getSuggestions;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAW,MAAM,uBAAuB,CAAC;AA8B5D;;;;GAIG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,WAAW,CAAC,EAAE,MAAM;IAShC;;;;;;;;OAQG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAwCrE;;;;;OAKG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyBlD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBnC;;OAEG;YACW,YAAY;IAiC1B;;OAEG;YACW,eAAe;CAgBhC"}