@inkeep/agents-core 0.1.0

package/dist/utils/mcp-client.js

@@ -0,0 +1,171 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { DEFAULT_REQUEST_TIMEOUT_MSEC } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { CallToolResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import { tool } from 'ai';
+import { asyncExitHook, gracefulExit } from 'exit-hook';
+import { match } from 'ts-pattern';
+import { z } from 'zod';
+///////////////////////////////////////////////////////////////////
+export class McpClient {
+    name;
+    client;
+    timeout;
+    transport;
+    serverConfig;
+    connected = false;
+    constructor(opts) {
+        this.name = opts.name;
+        this.timeout = opts.timeout || DEFAULT_REQUEST_TIMEOUT_MSEC;
+        this.serverConfig = opts.server;
+        this.client = new Client({ name: opts.name, version: opts.version || '1.0.0' }, { capabilities: opts.capabilities || {} });
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        await match(this.serverConfig)
+            .with({ type: 'streamable_http' }, (config) => this.connectHttp(config))
+            .with({ type: 'sse' }, (config) => this.connectSSE(config))
+            .exhaustive();
+        this.connected = true;
+        const close = this.client.onclose;
+        this.client.onclose = () => {
+            this.connected = false;
+            if (typeof close === 'function') {
+                close();
+            }
+        };
+        asyncExitHook(() => this.disconnect(), { wait: 5000 });
+        process.on('SIGTERM', () => gracefulExit());
+    }
+    async connectSSE(config) {
+        const url = typeof config.url === 'string' ? config.url : config.url.toString();
+        this.transport = new SSEClientTransport(new URL(url), {
+            eventSourceInit: config.eventSourceInit,
+        });
+        await this.client.connect(this.transport, {
+            timeout: config.timeout ?? this.timeout,
+        });
+    }
+    async connectHttp(config) {
+        const { url, requestInit } = config;
+        const mergedRequestInit = {
+            ...requestInit,
+            headers: {
+                ...(requestInit?.headers || {}),
+                ...(config.headers || {}),
+            },
+        };
+        const urlObj = new URL(url);
+        this.transport = new StreamableHTTPClientTransport(urlObj, {
+            requestInit: mergedRequestInit,
+            reconnectionOptions: {
+                maxRetries: 3,
+                maxReconnectionDelay: 30000,
+                initialReconnectionDelay: 1000,
+                reconnectionDelayGrowFactor: 1.5,
+                ...config.reconnectionOptions,
+            },
+            sessionId: config.sessionId,
+        });
+        await this.client.connect(this.transport, { timeout: 3000 });
+    }
+    async disconnect() {
+        if (!this.transport) {
+            return;
+        }
+        try {
+            await this.transport.close();
+        }
+        catch (e) {
+            console.error(e);
+            throw e;
+        }
+        finally {
+            this.transport = undefined;
+            this.connected = false;
+        }
+    }
+    validateSelectedTools(tools, activeTools) {
+        if (!activeTools)
+            return;
+        for (const item of activeTools) {
+            if (tools.includes(item))
+                continue;
+            throw new Error(`[Tools] Tool ${item} not found in tools`);
+        }
+    }
+    async selectTools() {
+        const { tools } = await this.client.listTools({ timeout: this.timeout });
+        const { activeTools } = this.serverConfig;
+        if (!activeTools)
+            return tools;
+        const toolNames = tools.map((tool) => tool.name);
+        this.validateSelectedTools(toolNames, activeTools);
+        return tools.filter((tool) => activeTools.includes(tool.name));
+    }
+    async tools() {
+        const tools = await this.selectTools();
+        const results = {};
+        for (const def of tools) {
+            try {
+                // Convert JSON Schema to Zod schema
+                const createZodSchema = (inputSchema) => {
+                    if (!inputSchema || !inputSchema.properties) {
+                        return z.object({});
+                    }
+                    const zodProperties = {};
+                    for (const [key, prop] of Object.entries(inputSchema.properties)) {
+                        const propDef = prop;
+                        let zodType;
+                        switch (propDef.type) {
+                            case 'string':
+                                zodType = z.string();
+                                break;
+                            case 'number':
+                                zodType = z.number();
+                                break;
+                            case 'boolean':
+                                zodType = z.boolean();
+                                break;
+                            case 'array':
+                                zodType = z.array(z.any());
+                                break;
+                            default:
+                                zodType = z.any();
+                        }
+                        if (propDef.description) {
+                            zodType = zodType.describe(propDef.description);
+                        }
+                        // Make field optional if not in required array
+                        const isRequired = inputSchema.required?.includes(key);
+                        if (!isRequired) {
+                            zodType = zodType.optional();
+                        }
+                        zodProperties[key] = zodType;
+                    }
+                    return z.object(zodProperties);
+                };
+                const schema = createZodSchema(def.inputSchema);
+                const createdTool = tool({
+                    id: `${this.name}.${def.name}`,
+                    description: def.description || '',
+                    inputSchema: schema,
+                    execute: async (context) => {
+                        const result = await this.client.callTool({ name: def.name, arguments: context }, CallToolResultSchema, { timeout: this.timeout });
+                        return result;
+                    },
+                });
+                if (def.name) {
+                    results[def.name] = createdTool;
+                }
+            }
+            catch (e) {
+                console.error(`Error creating tool ${def.name}:`, e);
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/utils/mcp-client.js.map

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

package/dist/utils/tracer.d.ts

@@ -0,0 +1,24 @@
+import { type Span, type Tracer } from '@opentelemetry/api';
+export declare const BASE = "inkeep-chat";
+export declare const SERVICE_NAME = "inkeep-chat";
+export declare const SERVICE_VERSION = "1.0.0";
+export declare const createSpanName: (suffix: string) => string;
+/**
+ * Helper function to handle span errors consistently
+ * Records the exception, sets error status, and optionally logs
+ */
+export declare function handleSpanError(span: Span, error: unknown, logger?: {
+    error: (obj: any, msg?: string) => void;
+}, logMessage?: string): void;
+/**
+ * Get the global tracer instance
+ * This creates a single tracer for the entire application
+ */
+export declare function getGlobalTracer(): Tracer;
+/**
+ * Force flush the tracer provider to ensure critical spans are sent immediately
+ * This is useful for critical operations where we want to ensure telemetry data
+ * is sent before the operation completes or fails
+ */
+export declare function forceFlushTracer(): Promise<void>;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/utils/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/utils/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,EAGT,KAAK,MAAM,EAEZ,MAAM,oBAAoB,CAAC;AAM5B,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAGlC,eAAO,MAAM,YAAY,gBAAgB,CAAC;AAC1C,eAAO,MAAM,eAAe,UAAU,CAAC;AAGvC,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,WAAwB,CAAC;AAyCtE;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,OAAO,EACd,MAAM,CAAC,EAAE;IAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,EACpD,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAgBN;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAaxC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAatD"}

package/dist/utils/tracer.js

@@ -0,0 +1,98 @@
+import { SpanStatusCode, trace, } from '@opentelemetry/api';
+import { getLogger } from './logger.js';
+const logger = getLogger('tracer');
+// Base prefix for all span names - export this to use in other files
+export const BASE = 'inkeep-chat';
+// Service name and version constants for consistent tracer identification
+export const SERVICE_NAME = 'inkeep-chat';
+export const SERVICE_VERSION = '1.0.0';
+// Helper function to create prefixed span names
+export const createSpanName = (suffix) => `${BASE}.${suffix}`;
+// No-op span implementation for when OpenTelemetry is not available
+const createNoOpSpan = () => ({
+    setAttributes: () => ({}),
+    recordException: () => ({}),
+    setStatus: () => ({}),
+    addEvent: () => ({}),
+    end: () => { },
+    isRecording: () => false,
+    setAttribute: () => ({}),
+    updateName: () => ({}),
+    spanContext: () => ({
+        traceId: '00000000000000000000000000000000',
+        spanId: '0000000000000000',
+        traceFlags: 0,
+    }),
+    addLink: () => ({}),
+    addLinks: () => ({}),
+});
+// No-op tracer implementation for when OpenTelemetry is not available
+const noopTracer = {
+    startActiveSpan(name, arg1, arg2, arg3) {
+        const fn = typeof arg1 === 'function' ? arg1 : typeof arg2 === 'function' ? arg2 : arg3;
+        if (!fn)
+            throw new Error('No callback function provided');
+        return fn(createNoOpSpan());
+    },
+    startSpan(name, options) {
+        return createNoOpSpan();
+    },
+};
+// Global tracer instance - singleton pattern
+let globalTracerInstance = null;
+/**
+ * Helper function to handle span errors consistently
+ * Records the exception, sets error status, and optionally logs
+ */
+export function handleSpanError(span, error, logger, logMessage) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    // Record the exception in the span
+    span.recordException(error);
+    // Set error status
+    span.setStatus({
+        code: SpanStatusCode.ERROR,
+        message: errorMessage,
+    });
+    // Optionally log the error
+    if (logger && logMessage) {
+        logger.error({ error: errorMessage }, logMessage);
+    }
+}
+/**
+ * Get the global tracer instance
+ * This creates a single tracer for the entire application
+ */
+export function getGlobalTracer() {
+    if (!globalTracerInstance) {
+        try {
+            globalTracerInstance = trace.getTracer(SERVICE_NAME, SERVICE_VERSION);
+        }
+        catch (error) {
+            logger.debug({ error: error instanceof Error ? error.message : 'Unknown error' }, 'OpenTelemetry tracer not available, using no-op tracer');
+            globalTracerInstance = noopTracer;
+        }
+    }
+    return globalTracerInstance;
+}
+/**
+ * Force flush the tracer provider to ensure critical spans are sent immediately
+ * This is useful for critical operations where we want to ensure telemetry data
+ * is sent before the operation completes or fails
+ */
+export async function forceFlushTracer() {
+    try {
+        // Get the tracer provider and force flush if available
+        const tracerProvider = trace.getTracerProvider();
+        if (tracerProvider && 'forceFlush' in tracerProvider && typeof tracerProvider.forceFlush === 'function') {
+            await tracerProvider.forceFlush();
+            logger.debug({ message: 'Tracer provider force flush completed' }, 'Tracer provider force flush completed');
+        }
+        else {
+            logger.debug({ message: 'Tracer provider does not support force flush or is not available' }, 'Tracer provider does not support force flush or is not available');
+        }
+    }
+    catch (error) {
+        logger.warn({ error }, 'Failed to force flush tracer');
+    }
+}
+//# sourceMappingURL=tracer.js.map

package/dist/utils/tracer.js.map

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

package/dist/validation/graphFull.d.ts

@@ -0,0 +1,36 @@
+import type { AgentDefinition, ExternalAgentApiInsert, InternalAgentDefinition, FullGraphDefinition } from '../types/entities';
+import { FullGraphDefinitionSchema } from '../validation/schemas.js';
+import type { z } from 'zod';
+export declare function isInternalAgent(agent: AgentDefinition): agent is InternalAgentDefinition;
+export declare function isExternalAgent(agent: AgentDefinition): agent is ExternalAgentApiInsert;
+export declare function validateAndTypeGraphData(data: unknown): z.infer<typeof FullGraphDefinitionSchema>;
+/**
+ * Validates that all tool IDs referenced in agents exist in the tools record
+ */
+export declare function validateToolReferences(graphData: FullGraphDefinition): void;
+/**
+ * Validates that all dataComponent IDs referenced in agents exist in the dataComponents record
+ */
+export declare function validateDataComponentReferences(graphData: FullGraphDefinition): void;
+/**
+ * Validates that all artifactComponent IDs referenced in agents exist in the artifactComponents record.
+ * Ensures referential integrity between agents and their associated artifact components.
+ *
+ * @param graphData - The validated graph data containing agents and artifact components
+ * @throws {Error} When agents reference non-existent artifact components
+ * @example
+ * ```typescript
+ * const graphData = validateAndTypeGraphData(rawGraphData);
+ * validateArtifactComponentReferences(graphData); // Throws if invalid references found
+ * ```
+ */
+export declare function validateArtifactComponentReferences(graphData: FullGraphDefinition): void;
+/**
+ * Validates agent relationships (handoff and delegation targets exist)
+ */
+export declare function validateAgentRelationships(graphData: FullGraphDefinition): void;
+/**
+ * Validates the graph structure before creation/update
+ */
+export declare function validateGraphStructure(graphData: FullGraphDefinition): void;
+//# sourceMappingURL=graphFull.d.ts.map

package/dist/validation/graphFull.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphFull.d.ts","sourceRoot":"","sources":["../../src/validation/graphFull.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,IAAI,uBAAuB,CAExF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,IAAI,sBAAsB,CAEvF;AAGD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAEjG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAkB3E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAoBpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAoBxF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAkC/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,mBAAmB,GAAG,IAAI,CAe3E"}

package/dist/validation/graphFull.js

@@ -0,0 +1,128 @@
+import { FullGraphDefinitionSchema } from '../validation/schemas.js';
+// Type guard functions
+export function isInternalAgent(agent) {
+    return 'instructions' in agent;
+}
+export function isExternalAgent(agent) {
+    return 'baseUrl' in agent;
+}
+// Zod-based validation and typing using the existing schema
+export function validateAndTypeGraphData(data) {
+    return FullGraphDefinitionSchema.parse(data);
+}
+/**
+ * Validates that all tool IDs referenced in agents exist in the tools record
+ */
+export function validateToolReferences(graphData) {
+    const errors = [];
+    const availableToolIds = new Set(Object.keys(graphData.tools));
+    for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+        // Only internal agents have tools
+        if (isInternalAgent(agentData) && agentData.tools && Array.isArray(agentData.tools)) {
+            for (const toolId of agentData.tools) {
+                if (!availableToolIds.has(toolId)) {
+                    errors.push(`Agent '${agentId}' references non-existent tool '${toolId}'`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Tool reference validation failed:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Validates that all dataComponent IDs referenced in agents exist in the dataComponents record
+ */
+export function validateDataComponentReferences(graphData) {
+    const errors = [];
+    const availableDataComponentIds = new Set(Object.keys(graphData.dataComponents || {}));
+    for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+        // Only internal agents have dataComponents
+        if (isInternalAgent(agentData) && agentData.dataComponents) {
+            for (const dataComponentId of agentData.dataComponents) {
+                if (!availableDataComponentIds.has(dataComponentId)) {
+                    errors.push(`Agent '${agentId}' references non-existent dataComponent '${dataComponentId}'`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`DataComponent reference validation failed:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Validates that all artifactComponent IDs referenced in agents exist in the artifactComponents record.
+ * Ensures referential integrity between agents and their associated artifact components.
+ *
+ * @param graphData - The validated graph data containing agents and artifact components
+ * @throws {Error} When agents reference non-existent artifact components
+ * @example
+ * ```typescript
+ * const graphData = validateAndTypeGraphData(rawGraphData);
+ * validateArtifactComponentReferences(graphData); // Throws if invalid references found
+ * ```
+ */
+export function validateArtifactComponentReferences(graphData) {
+    const errors = [];
+    const availableArtifactComponentIds = new Set(Object.keys(graphData.artifactComponents || {}));
+    for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+        // Only internal agents have artifactComponents
+        if (isInternalAgent(agentData) && agentData.artifactComponents) {
+            for (const artifactComponentId of agentData.artifactComponents) {
+                if (!availableArtifactComponentIds.has(artifactComponentId)) {
+                    errors.push(`Agent '${agentId}' references non-existent artifactComponent '${artifactComponentId}'`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`ArtifactComponent reference validation failed:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Validates agent relationships (handoff and delegation targets exist)
+ */
+export function validateAgentRelationships(graphData) {
+    const errors = [];
+    const availableAgentIds = new Set(Object.keys(graphData.agents));
+    for (const [agentId, agentData] of Object.entries(graphData.agents)) {
+        // Only internal agents have relationship properties
+        if (isInternalAgent(agentData)) {
+            // Validate handoff targets
+            if (agentData.canHandOffTo && Array.isArray(agentData.canHandOffTo)) {
+                for (const targetId of agentData.canHandOffTo) {
+                    if (!availableAgentIds.has(targetId)) {
+                        errors.push(`Agent '${agentId}' has handoff target '${targetId}' that doesn't exist in graph`);
+                    }
+                }
+            }
+            // Validate delegation targets
+            if (agentData.canDelegateTo && Array.isArray(agentData.canDelegateTo)) {
+                for (const targetId of agentData.canDelegateTo) {
+                    if (!availableAgentIds.has(targetId)) {
+                        errors.push(`Agent '${agentId}' has delegation target '${targetId}' that doesn't exist in graph`);
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Agent relationship validation failed:\n${errors.join('\n')}`);
+    }
+}
+/**
+ * Validates the graph structure before creation/update
+ */
+export function validateGraphStructure(graphData) {
+    // Validate default agent exists
+    if (!graphData.agents[graphData.defaultAgentId]) {
+        throw new Error(`Default agent '${graphData.defaultAgentId}' does not exist in agents`);
+    }
+    // Validate tool references
+    validateToolReferences(graphData);
+    validateDataComponentReferences(graphData);
+    validateArtifactComponentReferences(graphData);
+    // Validate agent relationships
+    validateAgentRelationships(graphData);
+}
+//# sourceMappingURL=graphFull.js.map

package/dist/validation/graphFull.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphFull.js","sourceRoot":"","sources":["../../src/validation/graphFull.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAGrE,uBAAuB;AACvB,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO,cAAc,IAAI,KAAK,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO,SAAS,IAAI,KAAK,CAAC;AAC5B,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,OAAO,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAA8B;IACnE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAE/D,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,kCAAkC;QAClC,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACpF,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACrC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,CAAC,UAAU,OAAO,mCAAmC,MAAM,GAAG,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,SAA8B;IAC5E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;IAEvF,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,2CAA2C;QAC3C,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;YAC3D,KAAK,MAAM,eAAe,IAAI,SAAS,CAAC,cAAc,EAAE,CAAC;gBACvD,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;oBACpD,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,4CAA4C,eAAe,GAAG,CAChF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mCAAmC,CAAC,SAA8B;IAChF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/F,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,+CAA+C;QAC/C,IAAI,eAAe,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,kBAAkB,EAAE,CAAC;YAC/D,KAAK,MAAM,mBAAmB,IAAI,SAAS,CAAC,kBAAkB,EAAE,CAAC;gBAC/D,IAAI,CAAC,6BAA6B,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,CAAC;oBAC5D,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,gDAAgD,mBAAmB,GAAG,CACxF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mDAAmD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAA8B;IACvE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAEjE,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,oDAAoD;QACpD,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,2BAA2B;YAC3B,IAAI,SAAS,CAAC,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpE,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;oBAC9C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrC,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,yBAAyB,QAAQ,+BAA+B,CAClF,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YAED,8BAA8B;YAC9B,IAAI,SAAS,CAAC,aAAa,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;gBACtE,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;oBAC/C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrC,MAAM,CAAC,IAAI,CACT,UAAU,OAAO,4BAA4B,QAAQ,+BAA+B,CACrF,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAA8B;IACnE,gCAAgC;IAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,kBAAkB,SAAS,CAAC,cAAc,4BAA4B,CAAC,CAAC;IAC1F,CAAC;IAED,2BAA2B;IAC3B,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAElC,+BAA+B,CAAC,SAAS,CAAC,CAAC;IAE3C,mCAAmC,CAAC,SAAS,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,0BAA0B,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC"}

package/dist/validation/id-validation.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Valid URL-safe characters for resource IDs based on RFC 3986.
+ *
+ * Allowed characters:
+ * - Letters: a-z, A-Z
+ * - Numbers: 0-9
+ * - Hyphens: -
+ * - Underscores: _
+ *
+ * Note: While dots (.) and tildes (~) are technically URL-safe,
+ * we exclude them for consistency with existing patterns in the codebase.
+ */
+/**
+ * Helper function to validate if a string is a valid resource ID
+ */
+export declare function isValidResourceId(id: string): boolean;
+/**
+ * Helper function to generate a URL-safe ID from a name or title.
+ * Converts to lowercase and replaces invalid characters with hyphens.
+ */
+export declare function generateIdFromName(name: string): string;
+/**
+ * Example valid IDs:
+ * - "qa-agent"
+ * - "customer_support_123"
+ * - "router"
+ * - "tool-executor-v2"
+ * - "PRODUCTION_CONFIG"
+ *
+ * Example invalid IDs:
+ * - "my.agent" (contains dot)
+ * - "agent@123" (contains @)
+ * - "agent/router" (contains slash)
+ * - "my agent" (contains space)
+ * - "agent#1" (contains hash)
+ * - "" (empty string)
+ */
+//# sourceMappingURL=id-validation.d.ts.map

package/dist/validation/id-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-validation.d.ts","sourceRoot":"","sources":["../../src/validation/id-validation.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBvD;AAED;;;;;;;;;;;;;;;GAeG"}

package/dist/validation/id-validation.js

@@ -0,0 +1,60 @@
+import { resourceIdSchema, MAX_ID_LENGTH } from './schemas.js';
+/**
+ * Valid URL-safe characters for resource IDs based on RFC 3986.
+ *
+ * Allowed characters:
+ * - Letters: a-z, A-Z
+ * - Numbers: 0-9
+ * - Hyphens: -
+ * - Underscores: _
+ *
+ * Note: While dots (.) and tildes (~) are technically URL-safe,
+ * we exclude them for consistency with existing patterns in the codebase.
+ */
+/**
+ * Helper function to validate if a string is a valid resource ID
+ */
+export function isValidResourceId(id) {
+    const result = resourceIdSchema.safeParse(id);
+    return result.success;
+}
+/**
+ * Helper function to generate a URL-safe ID from a name or title.
+ * Converts to lowercase and replaces invalid characters with hyphens.
+ */
+export function generateIdFromName(name) {
+    const id = name
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-') // Replace invalid chars with hyphens
+        .replace(/^-+|-+$/g, '') // Remove leading/trailing hyphens
+        .replace(/-{2,}/g, '-'); // Replace multiple consecutive hyphens with single hyphen
+    // Ensure the generated ID is not empty
+    if (!id) {
+        throw new Error('Cannot generate valid ID from provided name');
+    }
+    // Truncate if necessary
+    const truncatedId = id.substring(0, MAX_ID_LENGTH);
+    // Validate the generated ID
+    const result = resourceIdSchema.safeParse(truncatedId);
+    if (!result.success) {
+        throw new Error(`Generated ID "${truncatedId}" is not valid: ${result.error.message}`);
+    }
+    return truncatedId;
+}
+/**
+ * Example valid IDs:
+ * - "qa-agent"
+ * - "customer_support_123"
+ * - "router"
+ * - "tool-executor-v2"
+ * - "PRODUCTION_CONFIG"
+ *
+ * Example invalid IDs:
+ * - "my.agent" (contains dot)
+ * - "agent@123" (contains @)
+ * - "agent/router" (contains slash)
+ * - "my agent" (contains space)
+ * - "agent#1" (contains hash)
+ * - "" (empty string)
+ */
+//# sourceMappingURL=id-validation.js.map

package/dist/validation/id-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-validation.js","sourceRoot":"","sources":["../../src/validation/id-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,EAAE,GAAG,IAAI;SACZ,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,qCAAqC;SACnE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,kCAAkC;SAC1D,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,0DAA0D;IAErF,uCAAuC;IACvC,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAEnD,4BAA4B;IAC5B,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iBAAiB,WAAW,mBAAmB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;GAeG"}

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+export * from './schemas.js';
+export * from './graphFull.js';
+export * from './id-validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,5 @@
+// Re-export all validation schemas for convenience
+export * from './schemas.js';
+export * from './graphFull.js';
+export * from './id-validation.js';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}