@inkeep/agents-core 0.6.4 → 0.6.6

package/dist/validation/index.d.cts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { cU as AgentDefinition, cT as InternalAgentDefinition, cy as ExternalAgentApiInsert, fs as FullGraphDefinitionSchema, t as FullGraphDefinition } from '../utility-CgaoTJn6.cjs';
+export { du as AgentApiInsertSchema, dt as AgentApiSelectSchema, dv as AgentApiUpdateSchema, eF as AgentArtifactComponentApiInsertSchema, eE as AgentArtifactComponentApiSelectSchema, eG as AgentArtifactComponentApiUpdateSchema, eC as AgentArtifactComponentInsertSchema, eB as AgentArtifactComponentSelectSchema, eD as AgentArtifactComponentUpdateSchema, et as AgentDataComponentApiInsertSchema, es as AgentDataComponentApiSelectSchema, eu as AgentDataComponentApiUpdateSchema, eq as AgentDataComponentInsertSchema, ep as AgentDataComponentSelectSchema, er as AgentDataComponentUpdateSchema, dJ as AgentGraphApiInsertSchema, dI as AgentGraphApiSelectSchema, dK as AgentGraphApiUpdateSchema, dG as AgentGraphInsertSchema, dF as AgentGraphSelectSchema, dH as AgentGraphUpdateSchema, dr as AgentInsertSchema, dA as AgentRelationApiInsertSchema, dz as AgentRelationApiSelectSchema, dB as AgentRelationApiUpdateSchema, dx as AgentRelationInsertSchema, dC as AgentRelationQuerySchema, dw as AgentRelationSelectSchema, dy as AgentRelationUpdateSchema, dq as AgentSelectSchema, c as AgentStopWhen, A as AgentStopWhenSchema, fh as AgentToolRelationApiInsertSchema, fg as AgentToolRelationApiSelectSchema, fi as AgentToolRelationApiUpdateSchema, fe as AgentToolRelationInsertSchema, fd as AgentToolRelationSelectSchema, ff as AgentToolRelationUpdateSchema, ds as AgentUpdateSchema, eN as AllAgentSchema, eS as ApiKeyApiCreationResponseSchema, eT as ApiKeyApiInsertSchema, eR as ApiKeyApiSelectSchema, eU as ApiKeyApiUpdateSchema, eP as ApiKeyInsertSchema, eO as ApiKeySelectSchema, eQ as ApiKeyUpdateSchema, ez as ArtifactComponentApiInsertSchema, ey as ArtifactComponentApiSelectSchema, eA as ArtifactComponentApiUpdateSchema, ew as ArtifactComponentInsertSchema, ev as ArtifactComponentSelectSchema, ex as ArtifactComponentUpdateSchema, fr as CanUseItemSchema, eg as ContextCacheApiInsertSchema, ef as ContextCacheApiSelectSchema, eh as ContextCacheApiUpdateSchema, ed as ContextCacheInsertSchema, ec as ContextCacheSelectSchema, ee as ContextCacheUpdateSchema, fb as ContextConfigApiInsertSchema, fa as ContextConfigApiSelectSchema, fc as ContextConfigApiUpdateSchema, f8 as ContextConfigInsertSchema, f7 as ContextConfigSelectSchema, f9 as ContextConfigUpdateSchema, e4 as ConversationApiInsertSchema, e3 as ConversationApiSelectSchema, e5 as ConversationApiUpdateSchema, e1 as ConversationInsertSchema, e0 as ConversationSelectSchema, e2 as ConversationUpdateSchema, eZ as CredentialReferenceApiInsertSchema, eY as CredentialReferenceApiSelectSchema, e_ as CredentialReferenceApiUpdateSchema, eW as CredentialReferenceInsertSchema, eV as CredentialReferenceSelectSchema, eX as CredentialReferenceUpdateSchema, en as DataComponentApiInsertSchema, em as DataComponentApiSelectSchema, eo as DataComponentApiUpdateSchema, ek as DataComponentBaseSchema, ej as DataComponentInsertSchema, ei as DataComponentSelectSchema, el as DataComponentUpdateSchema, fx as ErrorResponseSchema, fy as ExistsResponseSchema, eL as ExternalAgentApiInsertSchema, eK as ExternalAgentApiSelectSchema, eM as ExternalAgentApiUpdateSchema, eI as ExternalAgentInsertSchema, dE as ExternalAgentRelationApiInsertSchema, dD as ExternalAgentRelationInsertSchema, eH as ExternalAgentSelectSchema, eJ as ExternalAgentUpdateSchema, f5 as FetchConfigSchema, f6 as FetchDefinitionSchema, F as FullGraphAgentInsertSchema, fG as FullProjectDefinitionSchema, b as GraphStopWhen, G as GraphStopWhenSchema, ft as GraphWithinContextOfProjectSchema, fH as HeadersScopeSchema, fO as IdParamsSchema, fn as LedgerArtifactApiInsertSchema, fm as LedgerArtifactApiSelectSchema, fo as LedgerArtifactApiUpdateSchema, fk as LedgerArtifactInsertSchema, fj as LedgerArtifactSelectSchema, fl as LedgerArtifactUpdateSchema, fv as ListResponseSchema, dj as MAX_ID_LENGTH, f0 as MCPToolConfigSchema, di as MIN_ID_LENGTH, dZ as McpToolDefinitionSchema, e$ as McpToolSchema, dX as McpTransportConfigSchema, ea as MessageApiInsertSchema, e9 as MessageApiSelectSchema, eb as MessageApiUpdateSchema, e7 as MessageInsertSchema, e6 as MessageSelectSchema, e8 as MessageUpdateSchema, dn as ModelSchema, dm as ModelSettingsSchema, fP as PaginationQueryParamsSchema, fu as PaginationSchema, fE as ProjectApiInsertSchema, fD as ProjectApiSelectSchema, fF as ProjectApiUpdateSchema, fB as ProjectInsertSchema, dp as ProjectModelSchema, fA as ProjectSelectSchema, fC as ProjectUpdateSchema, fz as RemovedResponseSchema, fw as SingleResponseSchema, fp as StatusComponentSchema, fq as StatusUpdateSchema, a as StopWhen, S as StopWhenSchema, dP as TaskApiInsertSchema, dO as TaskApiSelectSchema, dQ as TaskApiUpdateSchema, dM as TaskInsertSchema, dV as TaskRelationApiInsertSchema, dU as TaskRelationApiSelectSchema, dW as TaskRelationApiUpdateSchema, dS as TaskRelationInsertSchema, dR as TaskRelationSelectSchema, dT as TaskRelationUpdateSchema, dL as TaskSelectSchema, dN as TaskUpdateSchema, fN as TenantIdParamsSchema, fI as TenantParamsSchema, fL as TenantProjectGraphIdParamsSchema, fK as TenantProjectGraphParamsSchema, fM as TenantProjectIdParamsSchema, fJ as TenantProjectParamsSchema, f3 as ToolApiInsertSchema, f2 as ToolApiSelectSchema, f4 as ToolApiUpdateSchema, d$ as ToolInsertSchema, d_ as ToolSelectSchema, dY as ToolStatusSchema, f1 as ToolUpdateSchema, dk as URL_SAFE_ID_PATTERN, dl as resourceIdSchema } from '../utility-CgaoTJn6.cjs';
+import 'drizzle-zod';
+import 'drizzle-orm/sqlite-core';
+import '@hono/zod-openapi';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+
+declare function isInternalAgent(agent: AgentDefinition): agent is InternalAgentDefinition;
+declare function isExternalAgent(agent: AgentDefinition): agent is ExternalAgentApiInsert;
+declare function validateAndTypeGraphData(data: unknown): z.infer<typeof FullGraphDefinitionSchema>;
+/**
+ * Validates that all tool IDs referenced in agents exist in the tools record
+ * Note: With scoped architecture, tool validation should be done at the project level
+ * This function is kept for backward compatibility but will need project-scoped tool data
+ */
+declare function validateToolReferences(graphData: FullGraphDefinition, availableToolIds?: Set<string>): void;
+/**
+ * Validates that all dataComponent IDs referenced in agents exist in the dataComponents record
+ * Note: With scoped architecture, dataComponent validation should be done at the project level
+ */
+declare function validateDataComponentReferences(graphData: FullGraphDefinition, availableDataComponentIds?: Set<string>): void;
+/**
+ * Validates that all artifactComponent IDs referenced in agents exist in the artifactComponents record.
+ * Note: With scoped architecture, artifactComponent validation should be done at the project level
+ */
+declare function validateArtifactComponentReferences(graphData: FullGraphDefinition, availableArtifactComponentIds?: Set<string>): void;
+/**
+ * Validates agent relationships (transfer and delegation targets exist)
+ */
+declare function validateAgentRelationships(graphData: FullGraphDefinition): void;
+/**
+ * Validates the graph structure before creation/update
+ * Note: With scoped architecture, project-scoped resource validation should be done at project level
+ */
+declare function validateGraphStructure(graphData: FullGraphDefinition, projectResources?: {
+    toolIds?: Set<string>;
+    dataComponentIds?: Set<string>;
+    artifactComponentIds?: Set<string>;
+}): void;
+
+/**
+ * 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
+ */
+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.
+ */
+declare function generateIdFromName(name: string): string;
+
+export { FullGraphDefinitionSchema, generateIdFromName, isExternalAgent, isInternalAgent, isValidResourceId, validateAgentRelationships, validateAndTypeGraphData, validateArtifactComponentReferences, validateDataComponentReferences, validateGraphStructure, validateToolReferences };

package/dist/validation/index.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { cU as AgentDefinition, cT as InternalAgentDefinition, cy as ExternalAgentApiInsert, fs as FullGraphDefinitionSchema, t as FullGraphDefinition } from '../utility-CgaoTJn6.js';
+export { du as AgentApiInsertSchema, dt as AgentApiSelectSchema, dv as AgentApiUpdateSchema, eF as AgentArtifactComponentApiInsertSchema, eE as AgentArtifactComponentApiSelectSchema, eG as AgentArtifactComponentApiUpdateSchema, eC as AgentArtifactComponentInsertSchema, eB as AgentArtifactComponentSelectSchema, eD as AgentArtifactComponentUpdateSchema, et as AgentDataComponentApiInsertSchema, es as AgentDataComponentApiSelectSchema, eu as AgentDataComponentApiUpdateSchema, eq as AgentDataComponentInsertSchema, ep as AgentDataComponentSelectSchema, er as AgentDataComponentUpdateSchema, dJ as AgentGraphApiInsertSchema, dI as AgentGraphApiSelectSchema, dK as AgentGraphApiUpdateSchema, dG as AgentGraphInsertSchema, dF as AgentGraphSelectSchema, dH as AgentGraphUpdateSchema, dr as AgentInsertSchema, dA as AgentRelationApiInsertSchema, dz as AgentRelationApiSelectSchema, dB as AgentRelationApiUpdateSchema, dx as AgentRelationInsertSchema, dC as AgentRelationQuerySchema, dw as AgentRelationSelectSchema, dy as AgentRelationUpdateSchema, dq as AgentSelectSchema, c as AgentStopWhen, A as AgentStopWhenSchema, fh as AgentToolRelationApiInsertSchema, fg as AgentToolRelationApiSelectSchema, fi as AgentToolRelationApiUpdateSchema, fe as AgentToolRelationInsertSchema, fd as AgentToolRelationSelectSchema, ff as AgentToolRelationUpdateSchema, ds as AgentUpdateSchema, eN as AllAgentSchema, eS as ApiKeyApiCreationResponseSchema, eT as ApiKeyApiInsertSchema, eR as ApiKeyApiSelectSchema, eU as ApiKeyApiUpdateSchema, eP as ApiKeyInsertSchema, eO as ApiKeySelectSchema, eQ as ApiKeyUpdateSchema, ez as ArtifactComponentApiInsertSchema, ey as ArtifactComponentApiSelectSchema, eA as ArtifactComponentApiUpdateSchema, ew as ArtifactComponentInsertSchema, ev as ArtifactComponentSelectSchema, ex as ArtifactComponentUpdateSchema, fr as CanUseItemSchema, eg as ContextCacheApiInsertSchema, ef as ContextCacheApiSelectSchema, eh as ContextCacheApiUpdateSchema, ed as ContextCacheInsertSchema, ec as ContextCacheSelectSchema, ee as ContextCacheUpdateSchema, fb as ContextConfigApiInsertSchema, fa as ContextConfigApiSelectSchema, fc as ContextConfigApiUpdateSchema, f8 as ContextConfigInsertSchema, f7 as ContextConfigSelectSchema, f9 as ContextConfigUpdateSchema, e4 as ConversationApiInsertSchema, e3 as ConversationApiSelectSchema, e5 as ConversationApiUpdateSchema, e1 as ConversationInsertSchema, e0 as ConversationSelectSchema, e2 as ConversationUpdateSchema, eZ as CredentialReferenceApiInsertSchema, eY as CredentialReferenceApiSelectSchema, e_ as CredentialReferenceApiUpdateSchema, eW as CredentialReferenceInsertSchema, eV as CredentialReferenceSelectSchema, eX as CredentialReferenceUpdateSchema, en as DataComponentApiInsertSchema, em as DataComponentApiSelectSchema, eo as DataComponentApiUpdateSchema, ek as DataComponentBaseSchema, ej as DataComponentInsertSchema, ei as DataComponentSelectSchema, el as DataComponentUpdateSchema, fx as ErrorResponseSchema, fy as ExistsResponseSchema, eL as ExternalAgentApiInsertSchema, eK as ExternalAgentApiSelectSchema, eM as ExternalAgentApiUpdateSchema, eI as ExternalAgentInsertSchema, dE as ExternalAgentRelationApiInsertSchema, dD as ExternalAgentRelationInsertSchema, eH as ExternalAgentSelectSchema, eJ as ExternalAgentUpdateSchema, f5 as FetchConfigSchema, f6 as FetchDefinitionSchema, F as FullGraphAgentInsertSchema, fG as FullProjectDefinitionSchema, b as GraphStopWhen, G as GraphStopWhenSchema, ft as GraphWithinContextOfProjectSchema, fH as HeadersScopeSchema, fO as IdParamsSchema, fn as LedgerArtifactApiInsertSchema, fm as LedgerArtifactApiSelectSchema, fo as LedgerArtifactApiUpdateSchema, fk as LedgerArtifactInsertSchema, fj as LedgerArtifactSelectSchema, fl as LedgerArtifactUpdateSchema, fv as ListResponseSchema, dj as MAX_ID_LENGTH, f0 as MCPToolConfigSchema, di as MIN_ID_LENGTH, dZ as McpToolDefinitionSchema, e$ as McpToolSchema, dX as McpTransportConfigSchema, ea as MessageApiInsertSchema, e9 as MessageApiSelectSchema, eb as MessageApiUpdateSchema, e7 as MessageInsertSchema, e6 as MessageSelectSchema, e8 as MessageUpdateSchema, dn as ModelSchema, dm as ModelSettingsSchema, fP as PaginationQueryParamsSchema, fu as PaginationSchema, fE as ProjectApiInsertSchema, fD as ProjectApiSelectSchema, fF as ProjectApiUpdateSchema, fB as ProjectInsertSchema, dp as ProjectModelSchema, fA as ProjectSelectSchema, fC as ProjectUpdateSchema, fz as RemovedResponseSchema, fw as SingleResponseSchema, fp as StatusComponentSchema, fq as StatusUpdateSchema, a as StopWhen, S as StopWhenSchema, dP as TaskApiInsertSchema, dO as TaskApiSelectSchema, dQ as TaskApiUpdateSchema, dM as TaskInsertSchema, dV as TaskRelationApiInsertSchema, dU as TaskRelationApiSelectSchema, dW as TaskRelationApiUpdateSchema, dS as TaskRelationInsertSchema, dR as TaskRelationSelectSchema, dT as TaskRelationUpdateSchema, dL as TaskSelectSchema, dN as TaskUpdateSchema, fN as TenantIdParamsSchema, fI as TenantParamsSchema, fL as TenantProjectGraphIdParamsSchema, fK as TenantProjectGraphParamsSchema, fM as TenantProjectIdParamsSchema, fJ as TenantProjectParamsSchema, f3 as ToolApiInsertSchema, f2 as ToolApiSelectSchema, f4 as ToolApiUpdateSchema, d$ as ToolInsertSchema, d_ as ToolSelectSchema, dY as ToolStatusSchema, f1 as ToolUpdateSchema, dk as URL_SAFE_ID_PATTERN, dl as resourceIdSchema } from '../utility-CgaoTJn6.js';
+import 'drizzle-zod';
+import 'drizzle-orm/sqlite-core';
+import '@hono/zod-openapi';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+
+declare function isInternalAgent(agent: AgentDefinition): agent is InternalAgentDefinition;
+declare function isExternalAgent(agent: AgentDefinition): agent is ExternalAgentApiInsert;
+declare function validateAndTypeGraphData(data: unknown): z.infer<typeof FullGraphDefinitionSchema>;
+/**
+ * Validates that all tool IDs referenced in agents exist in the tools record
+ * Note: With scoped architecture, tool validation should be done at the project level
+ * This function is kept for backward compatibility but will need project-scoped tool data
+ */
+declare function validateToolReferences(graphData: FullGraphDefinition, availableToolIds?: Set<string>): void;
+/**
+ * Validates that all dataComponent IDs referenced in agents exist in the dataComponents record
+ * Note: With scoped architecture, dataComponent validation should be done at the project level
+ */
+declare function validateDataComponentReferences(graphData: FullGraphDefinition, availableDataComponentIds?: Set<string>): void;
+/**
+ * Validates that all artifactComponent IDs referenced in agents exist in the artifactComponents record.
+ * Note: With scoped architecture, artifactComponent validation should be done at the project level
+ */
+declare function validateArtifactComponentReferences(graphData: FullGraphDefinition, availableArtifactComponentIds?: Set<string>): void;
+/**
+ * Validates agent relationships (transfer and delegation targets exist)
+ */
+declare function validateAgentRelationships(graphData: FullGraphDefinition): void;
+/**
+ * Validates the graph structure before creation/update
+ * Note: With scoped architecture, project-scoped resource validation should be done at project level
+ */
+declare function validateGraphStructure(graphData: FullGraphDefinition, projectResources?: {
+    toolIds?: Set<string>;
+    dataComponentIds?: Set<string>;
+    artifactComponentIds?: Set<string>;
+}): void;
+
+/**
+ * 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
+ */
+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.
+ */
+declare function generateIdFromName(name: string): string;
+
+export { FullGraphDefinitionSchema, generateIdFromName, isExternalAgent, isInternalAgent, isValidResourceId, validateAgentRelationships, validateAndTypeGraphData, validateArtifactComponentReferences, validateDataComponentReferences, validateGraphStructure, validateToolReferences };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inkeep/agents-core",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Agents Core contains the database schema, types, and validation schemas for Inkeep Agent Framework, along with core components.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",