@inkeep/agents-core 0.8.0 → 0.8.2

package/dist/{chunk-P5LTXXFH.js → chunk-AX77SEE3.js}

@@ -1,4 +1,4 @@
-import { agents, agentRelations, agentGraph, tasks, taskRelations, tools, conversations, messages, contextCache, dataComponents, agentDataComponents, artifactComponents, agentArtifactComponents, externalAgents, apiKeys, credentialReferences, contextConfigs, agentToolRelations, ledgerArtifacts, projects } from './chunk-E4ZLV4GU.js';
+import { agents, agentRelations, agentGraph, tasks, taskRelations, tools, conversations, messages, contextCache, dataComponents, agentDataComponents, artifactComponents, agentArtifactComponents, externalAgents, apiKeys, credentialReferences, contextConfigs, agentToolRelations, ledgerArtifacts, projects } from './chunk-URSDNK76.js';
 import { VALID_RELATION_TYPES, MCPTransportType, TOOL_STATUS_VALUES, CredentialStoreType, MCPServerType } from './chunk-YFHT5M2R.js';
 import { z } from '@hono/zod-openapi';
 import { createSelectSchema, createInsertSchema } from 'drizzle-zod';

package/dist/{chunk-VZ62ZJTI.js → chunk-GPGFF2K4.js}

@@ -1,4 +1,4 @@
-import { FullGraphDefinitionSchema, resourceIdSchema, MAX_ID_LENGTH } from './chunk-P5LTXXFH.js';
+import { FullGraphDefinitionSchema, resourceIdSchema, MAX_ID_LENGTH } from './chunk-AX77SEE3.js';
 
 // src/validation/graphFull.ts
 function isInternalAgent(agent) {

package/dist/{chunk-E4ZLV4GU.js → chunk-URSDNK76.js}

@@ -38,6 +38,7 @@ __export(schema_exports, {
   ledgerArtifactsRelations: () => ledgerArtifactsRelations,
   ledgerArtifactsTaskContextNameUnique: () => ledgerArtifactsTaskContextNameUnique,
   ledgerArtifactsTaskIdIdx: () => ledgerArtifactsTaskIdIdx,
+  ledgerArtifactsToolCallIdIdx: () => ledgerArtifactsToolCallIdIdx,
   messages: () => messages,
   messagesRelations: () => messagesRelations,
   projects: () => projects,
@@ -539,7 +540,9 @@ var ledgerArtifacts = sqliteTable(
     projectId: text("project_id").notNull(),
     id: text("id").notNull(),
     // Links
-    taskId: text("task_id"),
+    taskId: text("task_id").notNull(),
+    toolCallId: text("tool_call_id"),
+    // Added for traceability to the specific tool execution
     contextId: text("context_id").notNull(),
     // Core Artifact fields
     type: text("type").notNull().default("source"),
@@ -558,7 +561,7 @@ var ledgerArtifacts = sqliteTable(
     updatedAt: text("updated_at").notNull().default(sql`CURRENT_TIMESTAMP`)
   },
   (table) => [
-    primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
+    primaryKey({ columns: [table.tenantId, table.projectId, table.id, table.taskId] }),
     foreignKey({
       columns: [table.tenantId, table.projectId],
       foreignColumns: [projects.tenantId, projects.id],
@@ -627,6 +630,9 @@ var credentialReferences = sqliteTable(
 var ledgerArtifactsTaskIdIdx = index("ledger_artifacts_task_id_idx").on(
   ledgerArtifacts.taskId
 );
+var ledgerArtifactsToolCallIdIdx = index("ledger_artifacts_tool_call_id_idx").on(
+  ledgerArtifacts.toolCallId
+);
 var ledgerArtifactsContextIdIdx = index("ledger_artifacts_context_id_idx").on(
   ledgerArtifacts.contextId
 );
@@ -959,4 +965,4 @@ var agentRelationsRelations = relations(agentRelations, ({ one }) => ({
   })
 }));
 
-export { agentArtifactComponents, agentArtifactComponentsRelations, agentDataComponents, agentDataComponentsRelations, agentGraph, agentGraphRelations, agentRelations, agentRelationsRelations, agentToolRelations, agentToolRelationsRelations, agents, agentsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, ledgerArtifacts, ledgerArtifactsContextIdIdx, ledgerArtifactsRelations, ledgerArtifactsTaskContextNameUnique, ledgerArtifactsTaskIdIdx, messages, messagesRelations, projects, projectsRelations, schema_exports, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations };
+export { agentArtifactComponents, agentArtifactComponentsRelations, agentDataComponents, agentDataComponentsRelations, agentGraph, agentGraphRelations, agentRelations, agentRelationsRelations, agentToolRelations, agentToolRelationsRelations, agents, agentsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, ledgerArtifacts, ledgerArtifactsContextIdIdx, ledgerArtifactsRelations, ledgerArtifactsTaskContextNameUnique, ledgerArtifactsTaskIdIdx, ledgerArtifactsToolCallIdIdx, messages, messagesRelations, projects, projectsRelations, schema_exports, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations };

package/dist/client-exports.cjs

@@ -514,7 +514,9 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     projectId: sqliteCore.text("project_id").notNull(),
     id: sqliteCore.text("id").notNull(),
     // Links
-    taskId: sqliteCore.text("task_id"),
+    taskId: sqliteCore.text("task_id").notNull(),
+    toolCallId: sqliteCore.text("tool_call_id"),
+    // Added for traceability to the specific tool execution
     contextId: sqliteCore.text("context_id").notNull(),
     // Core Artifact fields
     type: sqliteCore.text("type").notNull().default("source"),
@@ -533,7 +535,7 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     updatedAt: sqliteCore.text("updated_at").notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`)
   },
   (table) => [
-    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
+    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id, table.taskId] }),
     sqliteCore.foreignKey({
       columns: [table.tenantId, table.projectId],
       foreignColumns: [projects.tenantId, projects.id],
@@ -602,6 +604,9 @@ var credentialReferences = sqliteCore.sqliteTable(
 sqliteCore.index("ledger_artifacts_task_id_idx").on(
   ledgerArtifacts.taskId
 );
+sqliteCore.index("ledger_artifacts_tool_call_id_idx").on(
+  ledgerArtifacts.toolCallId
+);
 sqliteCore.index("ledger_artifacts_context_id_idx").on(
   ledgerArtifacts.contextId
 );

package/dist/client-exports.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { C as ConversationHistoryConfig, F as FullGraphAgentInsertSchema } from './utility-CT2pq49U.cjs';
-export { c as AgentStopWhen, A as AgentStopWhenSchema, d as CredentialStoreType, b as GraphStopWhen, G as GraphStopWhenSchema, M as MCPTransportType, a as StopWhen, S as StopWhenSchema } from './utility-CT2pq49U.cjs';
+import { C as ConversationHistoryConfig, F as FullGraphAgentInsertSchema } from './utility-C3eMTvpr.cjs';
+export { c as AgentStopWhen, A as AgentStopWhenSchema, d as CredentialStoreType, b as GraphStopWhen, G as GraphStopWhenSchema, M as MCPTransportType, a as StopWhen, S as StopWhenSchema } from './utility-C3eMTvpr.cjs';
 import 'drizzle-zod';
 import 'drizzle-orm/sqlite-core';
 import '@hono/zod-openapi';

package/dist/client-exports.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { C as ConversationHistoryConfig, F as FullGraphAgentInsertSchema } from './utility-CT2pq49U.js';
-export { c as AgentStopWhen, A as AgentStopWhenSchema, d as CredentialStoreType, b as GraphStopWhen, G as GraphStopWhenSchema, M as MCPTransportType, a as StopWhen, S as StopWhenSchema } from './utility-CT2pq49U.js';
+import { C as ConversationHistoryConfig, F as FullGraphAgentInsertSchema } from './utility-C3eMTvpr.js';
+export { c as AgentStopWhen, A as AgentStopWhenSchema, d as CredentialStoreType, b as GraphStopWhen, G as GraphStopWhenSchema, M as MCPTransportType, a as StopWhen, S as StopWhenSchema } from './utility-C3eMTvpr.js';
 import 'drizzle-zod';
 import 'drizzle-orm/sqlite-core';
 import '@hono/zod-openapi';

package/dist/client-exports.js

@@ -1,5 +1,5 @@
-import { FullGraphAgentInsertSchema } from './chunk-P5LTXXFH.js';
-export { AgentStopWhenSchema, GraphStopWhenSchema, StopWhenSchema } from './chunk-P5LTXXFH.js';
+import { FullGraphAgentInsertSchema } from './chunk-AX77SEE3.js';
+export { AgentStopWhenSchema, GraphStopWhenSchema, StopWhenSchema } from './chunk-AX77SEE3.js';
 import { CredentialStoreType } from './chunk-YFHT5M2R.js';
 export { CredentialStoreType, MCPTransportType } from './chunk-YFHT5M2R.js';
 import { z } from 'zod';

package/dist/db/schema.cjs

@@ -494,7 +494,9 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     projectId: sqliteCore.text("project_id").notNull(),
     id: sqliteCore.text("id").notNull(),
     // Links
-    taskId: sqliteCore.text("task_id"),
+    taskId: sqliteCore.text("task_id").notNull(),
+    toolCallId: sqliteCore.text("tool_call_id"),
+    // Added for traceability to the specific tool execution
     contextId: sqliteCore.text("context_id").notNull(),
     // Core Artifact fields
     type: sqliteCore.text("type").notNull().default("source"),
@@ -513,7 +515,7 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     updatedAt: sqliteCore.text("updated_at").notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`)
   },
   (table) => [
-    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
+    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id, table.taskId] }),
     sqliteCore.foreignKey({
       columns: [table.tenantId, table.projectId],
       foreignColumns: [projects.tenantId, projects.id],
@@ -582,6 +584,9 @@ var credentialReferences = sqliteCore.sqliteTable(
 var ledgerArtifactsTaskIdIdx = sqliteCore.index("ledger_artifacts_task_id_idx").on(
   ledgerArtifacts.taskId
 );
+var ledgerArtifactsToolCallIdIdx = sqliteCore.index("ledger_artifacts_tool_call_id_idx").on(
+  ledgerArtifacts.toolCallId
+);
 var ledgerArtifactsContextIdIdx = sqliteCore.index("ledger_artifacts_context_id_idx").on(
   ledgerArtifacts.contextId
 );
@@ -947,6 +952,7 @@ exports.ledgerArtifactsContextIdIdx = ledgerArtifactsContextIdIdx;
 exports.ledgerArtifactsRelations = ledgerArtifactsRelations;
 exports.ledgerArtifactsTaskContextNameUnique = ledgerArtifactsTaskContextNameUnique;
 exports.ledgerArtifactsTaskIdIdx = ledgerArtifactsTaskIdIdx;
+exports.ledgerArtifactsToolCallIdIdx = ledgerArtifactsToolCallIdIdx;
 exports.messages = messages;
 exports.messagesRelations = messagesRelations;
 exports.projects = projects;

package/dist/db/schema.d.cts

@@ -1,7 +1,7 @@
 import 'drizzle-orm';
 import 'drizzle-orm/sqlite-core';
-import '../utility-CT2pq49U.cjs';
-export { k as agentArtifactComponents, N as agentArtifactComponentsRelations, i as agentDataComponents, P as agentDataComponentsRelations, a as agentGraph, E as agentGraphRelations, e as agentRelations, R as agentRelationsRelations, m as agentToolRelations, H as agentToolRelationsRelations, d as agents, D as agentsRelations, r as apiKeys, G as apiKeysRelations, j as artifactComponents, M as artifactComponentsRelations, b as contextCache, C as contextCacheRelations, c as contextConfigs, B as contextConfigsRelations, n as conversations, K as conversationsRelations, u as credentialReferences, I as credentialReferencesRelations, h as dataComponents, O as dataComponentsRelations, f as externalAgents, F as externalAgentsRelations, q as ledgerArtifacts, w as ledgerArtifactsContextIdIdx, Q as ledgerArtifactsRelations, x as ledgerArtifactsTaskContextNameUnique, v as ledgerArtifactsTaskIdIdx, o as messages, L as messagesRelations, p as projects, z as projectsRelations, g as taskRelations, A as taskRelationsRelations, t as tasks, y as tasksRelations, l as tools, J as toolsRelations } from '../schema-BF9NpAv5.cjs';
+import '../utility-C3eMTvpr.cjs';
+export { k as agentArtifactComponents, O as agentArtifactComponentsRelations, i as agentDataComponents, Q as agentDataComponentsRelations, a as agentGraph, F as agentGraphRelations, e as agentRelations, S as agentRelationsRelations, m as agentToolRelations, I as agentToolRelationsRelations, d as agents, E as agentsRelations, r as apiKeys, H as apiKeysRelations, j as artifactComponents, N as artifactComponentsRelations, b as contextCache, D as contextCacheRelations, c as contextConfigs, C as contextConfigsRelations, n as conversations, L as conversationsRelations, u as credentialReferences, J as credentialReferencesRelations, h as dataComponents, P as dataComponentsRelations, f as externalAgents, G as externalAgentsRelations, q as ledgerArtifacts, x as ledgerArtifactsContextIdIdx, R as ledgerArtifactsRelations, y as ledgerArtifactsTaskContextNameUnique, v as ledgerArtifactsTaskIdIdx, w as ledgerArtifactsToolCallIdIdx, o as messages, M as messagesRelations, p as projects, A as projectsRelations, g as taskRelations, B as taskRelationsRelations, t as tasks, z as tasksRelations, l as tools, K as toolsRelations } from '../schema-DwiRB4zS.cjs';
 import 'zod';
 import 'drizzle-zod';
 import '@hono/zod-openapi';

package/dist/db/schema.d.ts

@@ -1,7 +1,7 @@
 import 'drizzle-orm';
 import 'drizzle-orm/sqlite-core';
-import '../utility-CT2pq49U.js';
-export { k as agentArtifactComponents, N as agentArtifactComponentsRelations, i as agentDataComponents, P as agentDataComponentsRelations, a as agentGraph, E as agentGraphRelations, e as agentRelations, R as agentRelationsRelations, m as agentToolRelations, H as agentToolRelationsRelations, d as agents, D as agentsRelations, r as apiKeys, G as apiKeysRelations, j as artifactComponents, M as artifactComponentsRelations, b as contextCache, C as contextCacheRelations, c as contextConfigs, B as contextConfigsRelations, n as conversations, K as conversationsRelations, u as credentialReferences, I as credentialReferencesRelations, h as dataComponents, O as dataComponentsRelations, f as externalAgents, F as externalAgentsRelations, q as ledgerArtifacts, w as ledgerArtifactsContextIdIdx, Q as ledgerArtifactsRelations, x as ledgerArtifactsTaskContextNameUnique, v as ledgerArtifactsTaskIdIdx, o as messages, L as messagesRelations, p as projects, z as projectsRelations, g as taskRelations, A as taskRelationsRelations, t as tasks, y as tasksRelations, l as tools, J as toolsRelations } from '../schema-78jVngGh.js';
+import '../utility-C3eMTvpr.js';
+export { k as agentArtifactComponents, O as agentArtifactComponentsRelations, i as agentDataComponents, Q as agentDataComponentsRelations, a as agentGraph, F as agentGraphRelations, e as agentRelations, S as agentRelationsRelations, m as agentToolRelations, I as agentToolRelationsRelations, d as agents, E as agentsRelations, r as apiKeys, H as apiKeysRelations, j as artifactComponents, N as artifactComponentsRelations, b as contextCache, D as contextCacheRelations, c as contextConfigs, C as contextConfigsRelations, n as conversations, L as conversationsRelations, u as credentialReferences, J as credentialReferencesRelations, h as dataComponents, P as dataComponentsRelations, f as externalAgents, G as externalAgentsRelations, q as ledgerArtifacts, x as ledgerArtifactsContextIdIdx, R as ledgerArtifactsRelations, y as ledgerArtifactsTaskContextNameUnique, v as ledgerArtifactsTaskIdIdx, w as ledgerArtifactsToolCallIdIdx, o as messages, M as messagesRelations, p as projects, A as projectsRelations, g as taskRelations, B as taskRelationsRelations, t as tasks, z as tasksRelations, l as tools, K as toolsRelations } from '../schema-DnjptA-m.js';
 import 'zod';
 import 'drizzle-zod';
 import '@hono/zod-openapi';

package/dist/db/schema.js

@@ -1 +1 @@
-export { agentArtifactComponents, agentArtifactComponentsRelations, agentDataComponents, agentDataComponentsRelations, agentGraph, agentGraphRelations, agentRelations, agentRelationsRelations, agentToolRelations, agentToolRelationsRelations, agents, agentsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, ledgerArtifacts, ledgerArtifactsContextIdIdx, ledgerArtifactsRelations, ledgerArtifactsTaskContextNameUnique, ledgerArtifactsTaskIdIdx, messages, messagesRelations, projects, projectsRelations, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations } from '../chunk-E4ZLV4GU.js';
+export { agentArtifactComponents, agentArtifactComponentsRelations, agentDataComponents, agentDataComponentsRelations, agentGraph, agentGraphRelations, agentRelations, agentRelationsRelations, agentToolRelations, agentToolRelationsRelations, agents, agentsRelations, apiKeys, apiKeysRelations, artifactComponents, artifactComponentsRelations, contextCache, contextCacheRelations, contextConfigs, contextConfigsRelations, conversations, conversationsRelations, credentialReferences, credentialReferencesRelations, dataComponents, dataComponentsRelations, externalAgents, externalAgentsRelations, ledgerArtifacts, ledgerArtifactsContextIdIdx, ledgerArtifactsRelations, ledgerArtifactsTaskContextNameUnique, ledgerArtifactsTaskIdIdx, ledgerArtifactsToolCallIdIdx, messages, messagesRelations, projects, projectsRelations, taskRelations, taskRelationsRelations, tasks, tasksRelations, tools, toolsRelations } from '../chunk-URSDNK76.js';

package/dist/index.cjs

@@ -244,6 +244,7 @@ __export(schema_exports, {
   ledgerArtifactsRelations: () => ledgerArtifactsRelations,
   ledgerArtifactsTaskContextNameUnique: () => ledgerArtifactsTaskContextNameUnique,
   ledgerArtifactsTaskIdIdx: () => ledgerArtifactsTaskIdIdx,
+  ledgerArtifactsToolCallIdIdx: () => ledgerArtifactsToolCallIdIdx,
   messages: () => messages,
   messagesRelations: () => messagesRelations,
   projects: () => projects,
@@ -745,7 +746,9 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     projectId: sqliteCore.text("project_id").notNull(),
     id: sqliteCore.text("id").notNull(),
     // Links
-    taskId: sqliteCore.text("task_id"),
+    taskId: sqliteCore.text("task_id").notNull(),
+    toolCallId: sqliteCore.text("tool_call_id"),
+    // Added for traceability to the specific tool execution
     contextId: sqliteCore.text("context_id").notNull(),
     // Core Artifact fields
     type: sqliteCore.text("type").notNull().default("source"),
@@ -764,7 +767,7 @@ var ledgerArtifacts = sqliteCore.sqliteTable(
     updatedAt: sqliteCore.text("updated_at").notNull().default(drizzleOrm.sql`CURRENT_TIMESTAMP`)
   },
   (table) => [
-    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id] }),
+    sqliteCore.primaryKey({ columns: [table.tenantId, table.projectId, table.id, table.taskId] }),
     sqliteCore.foreignKey({
       columns: [table.tenantId, table.projectId],
       foreignColumns: [projects.tenantId, projects.id],
@@ -833,6 +836,9 @@ var credentialReferences = sqliteCore.sqliteTable(
 var ledgerArtifactsTaskIdIdx = sqliteCore.index("ledger_artifacts_task_id_idx").on(
   ledgerArtifacts.taskId
 );
+var ledgerArtifactsToolCallIdIdx = sqliteCore.index("ledger_artifacts_tool_call_id_idx").on(
+  ledgerArtifacts.toolCallId
+);
 var ledgerArtifactsContextIdIdx = sqliteCore.index("ledger_artifacts_context_id_idx").on(
   ledgerArtifacts.contextId
 );
@@ -6986,38 +6992,200 @@ var deleteFullGraph = (db, logger12 = defaultLogger) => async (params) => {
     throw error;
   }
 };
+function validateArtifactData(artifact, index2) {
+  if (!artifact.artifactId?.trim()) {
+    throw new Error(`Artifact at index ${index2} missing required artifactId`);
+  }
+  if (artifact.parts) {
+    try {
+      JSON.stringify(artifact.parts);
+    } catch (error) {
+      throw new Error(
+        `Artifact ${artifact.artifactId} has invalid parts data: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  if (artifact.metadata) {
+    try {
+      JSON.stringify(artifact.metadata);
+    } catch (error) {
+      throw new Error(
+        `Artifact ${artifact.artifactId} has invalid metadata: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+}
+function determineMimeTypes(artifact) {
+  if (artifact.parts && artifact.parts.length > 0) {
+    const kinds = /* @__PURE__ */ new Set();
+    for (const part of artifact.parts) {
+      if (part.kind) {
+        kinds.add(part.kind);
+      }
+    }
+    if (kinds.size > 0) {
+      return Array.from(kinds);
+    }
+  }
+  if (artifact.type?.toLowerCase().includes("document")) {
+    return ["text"];
+  }
+  if (artifact.type?.toLowerCase().includes("image")) {
+    return ["image"];
+  }
+  if (artifact.type?.toLowerCase().includes("code")) {
+    return ["text"];
+  }
+  return ["data"];
+}
+function sanitizeArtifactForDatabase(artifact) {
+  return {
+    ...artifact,
+    // Ensure text fields don't exceed reasonable limits
+    name: artifact.name?.slice(0, 255) || void 0,
+    description: artifact.description?.slice(0, 1e3) || void 0,
+    // Clean any undefined values from JSON fields
+    parts: artifact.parts ? JSON.parse(JSON.stringify(artifact.parts)) : null,
+    metadata: artifact.metadata ? JSON.parse(JSON.stringify(artifact.metadata)) : null
+  };
+}
+async function tryFallbackInsert(db, rows, _originalError) {
+  for (let i = 0; i < rows.length; i++) {
+    const row = rows[i];
+    try {
+      await db.insert(ledgerArtifacts).values([row]);
+    } catch (_fallbackError) {
+      try {
+        const minimalRow = {
+          id: row.id,
+          tenantId: row.tenantId,
+          projectId: row.projectId,
+          taskId: row.taskId,
+          toolCallId: row.toolCallId,
+          contextId: row.contextId,
+          type: row.type || "source",
+          name: row.name || `Artifact ${row.id.substring(0, 8)}`,
+          description: row.description || "Artifact from tool results",
+          parts: null,
+          // Skip complex JSON data
+          metadata: null,
+          // Skip complex JSON data
+          summary: null,
+          mime: null,
+          visibility: "context",
+          allowedAgents: null,
+          derivedFrom: null,
+          createdAt: row.createdAt,
+          updatedAt: row.updatedAt
+        };
+        await db.insert(ledgerArtifacts).values([minimalRow]);
+      } catch (_finalError) {
+      }
+    }
+  }
+}
+var upsertLedgerArtifact = (db) => async (params) => {
+  const { scopes, contextId, taskId, toolCallId = null, artifact } = params;
+  validateArtifactData(artifact, 0);
+  const sanitizedArt = sanitizeArtifactForDatabase(artifact);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const artifactRow = {
+    id: sanitizedArt.artifactId ?? nanoid.nanoid(),
+    tenantId: scopes.tenantId,
+    projectId: scopes.projectId,
+    taskId,
+    toolCallId,
+    contextId,
+    type: sanitizedArt.type ?? "source",
+    name: sanitizedArt.name,
+    description: sanitizedArt.description,
+    parts: sanitizedArt.parts,
+    metadata: sanitizedArt.metadata,
+    summary: sanitizedArt.description?.slice(0, 200) ?? null,
+    mime: determineMimeTypes(sanitizedArt),
+    visibility: sanitizedArt.metadata?.visibility ?? "context",
+    allowedAgents: sanitizedArt.metadata?.allowedAgents ?? [],
+    derivedFrom: sanitizedArt.metadata?.derivedFrom ?? null,
+    createdAt: now,
+    updatedAt: now
+  };
+  try {
+    await db.insert(ledgerArtifacts).values([artifactRow]);
+    return { created: true };
+  } catch (error) {
+    if (error.message?.includes("UNIQUE") || error.message?.includes("duplicate")) {
+      const existing = await db.select().from(ledgerArtifacts).where(
+        drizzleOrm.and(
+          drizzleOrm.eq(ledgerArtifacts.tenantId, scopes.tenantId),
+          drizzleOrm.eq(ledgerArtifacts.projectId, scopes.projectId),
+          drizzleOrm.eq(ledgerArtifacts.id, artifactRow.id),
+          drizzleOrm.eq(ledgerArtifacts.taskId, taskId)
+        )
+      ).limit(1);
+      if (existing.length > 0) {
+        return { created: false, existing: existing[0] };
+      }
+    }
+    throw error;
+  }
+};
 var addLedgerArtifacts = (db) => async (params) => {
-  const { scopes, contextId, taskId = null, artifacts } = params;
+  const { scopes, contextId, taskId = null, toolCallId = null, artifacts } = params;
   if (artifacts.length === 0) return;
+  for (let i = 0; i < artifacts.length; i++) {
+    validateArtifactData(artifacts[i], i);
+  }
   const now = (/* @__PURE__ */ new Date()).toISOString();
   const rows = artifacts.map((art) => {
-    const resolvedTaskId = taskId ?? art.taskId ?? art.metadata?.taskId ?? null;
+    const sanitizedArt = sanitizeArtifactForDatabase(art);
+    const resolvedTaskId = taskId ?? sanitizedArt.taskId ?? sanitizedArt.metadata?.taskId ?? null;
     return {
-      id: art.artifactId ?? nanoid.nanoid(),
+      id: sanitizedArt.artifactId ?? nanoid.nanoid(),
       tenantId: scopes.tenantId,
       projectId: scopes.projectId,
       taskId: resolvedTaskId,
+      toolCallId: toolCallId ?? sanitizedArt.metadata?.toolCallId ?? null,
       contextId,
-      name: art.name ?? null,
-      description: art.description ?? null,
-      parts: art.parts ?? null,
-      metadata: art.metadata ?? null,
+      type: sanitizedArt.type ?? "source",
+      name: sanitizedArt.name,
+      description: sanitizedArt.description,
+      parts: sanitizedArt.parts,
+      metadata: sanitizedArt.metadata,
       // extra (optional) ledger fields
-      summary: art.description?.slice(0, 200) ?? null,
-      mime: art.parts?.map((p) => p.kind) ?? null,
-      visibility: art.metadata?.visibility ?? "context",
-      allowedAgents: art.metadata?.allowedAgents ?? null,
-      derivedFrom: art.metadata?.derivedFrom ?? null,
+      summary: sanitizedArt.description?.slice(0, 200) ?? null,
+      mime: determineMimeTypes(sanitizedArt),
+      // Simple string fallback until we debug the issue
+      visibility: sanitizedArt.metadata?.visibility ?? "context",
+      allowedAgents: sanitizedArt.metadata?.allowedAgents ?? [],
+      // Fix: use empty array, not null
+      derivedFrom: sanitizedArt.metadata?.derivedFrom ?? null,
       createdAt: now,
       updatedAt: now
     };
   });
-  await db.insert(ledgerArtifacts).values(rows);
+  const maxRetries = 3;
+  let lastError = null;
+  for (let attempt = 1; attempt <= maxRetries; attempt++) {
+    try {
+      await db.insert(ledgerArtifacts).values(rows);
+      return;
+    } catch (error) {
+      lastError = error;
+      const isRetryable = error.code === "SQLITE_BUSY" || error.code === "SQLITE_LOCKED" || error.message?.includes("database is locked") || error.message?.includes("busy") || error.message?.includes("timeout");
+      if (!isRetryable || attempt === maxRetries) {
+        await tryFallbackInsert(db, rows);
+        return;
+      }
+      const backoffMs = Math.min(1e3 * 2 ** (attempt - 1), 5e3);
+      await new Promise((resolve) => setTimeout(resolve, backoffMs));
+    }
+  }
+  throw lastError;
 };
 var getLedgerArtifacts = (db) => async (params) => {
-  const { scopes, taskId, artifactId } = params;
-  if (!taskId && !artifactId) {
-    throw new Error("Either taskId or artifactId must be provided");
+  const { scopes, taskId, toolCallId, artifactId } = params;
+  if (!taskId && !toolCallId && !artifactId) {
+    throw new Error("At least one of taskId, toolCallId, or artifactId must be provided");
   }
   const conditions = [
     drizzleOrm.eq(ledgerArtifacts.tenantId, scopes.tenantId),
@@ -7029,6 +7197,9 @@ var getLedgerArtifacts = (db) => async (params) => {
   if (taskId) {
     conditions.push(drizzleOrm.eq(ledgerArtifacts.taskId, taskId));
   }
+  if (toolCallId) {
+    conditions.push(drizzleOrm.eq(ledgerArtifacts.toolCallId, toolCallId));
+  }
   const query = db.select().from(ledgerArtifacts).where(conditions.length > 1 ? drizzleOrm.and(...conditions) : conditions[0]);
   const results = await query;
   return results.map(
@@ -7036,6 +7207,8 @@ var getLedgerArtifacts = (db) => async (params) => {
       artifactId: row.id,
       type: row.type ?? "source",
       taskId: row.taskId ?? void 0,
+      toolCallId: row.toolCallId ?? void 0,
+      // Added for traceability to the specific tool execution
       name: row.name ?? void 0,
       description: row.description ?? void 0,
       parts: row.parts ?? [],
@@ -10383,6 +10556,8 @@ loadEnvironmentFiles();
 var envSchema = zod.z.object({
   ENVIRONMENT: zod.z.enum(["development", "production", "pentest", "test"]).optional(),
   DB_FILE_NAME: zod.z.string().optional(),
+  TURSO_DATABASE_URL: zod.z.string().optional(),
+  TURSO_AUTH_TOKEN: zod.z.string().optional(),
   OTEL_TRACES_FORCE_FLUSH_ENABLED: zod.z.coerce.boolean().optional()
 });
 var parseEnv = () => {
@@ -10798,6 +10973,7 @@ exports.ledgerArtifactsContextIdIdx = ledgerArtifactsContextIdIdx;
 exports.ledgerArtifactsRelations = ledgerArtifactsRelations;
 exports.ledgerArtifactsTaskContextNameUnique = ledgerArtifactsTaskContextNameUnique;
 exports.ledgerArtifactsTaskIdIdx = ledgerArtifactsTaskIdIdx;
+exports.ledgerArtifactsToolCallIdIdx = ledgerArtifactsToolCallIdIdx;
 exports.listAgentGraphs = listAgentGraphs;
 exports.listAgentGraphsPaginated = listAgentGraphsPaginated;
 exports.listAgentRelations = listAgentRelations;
@@ -10878,6 +11054,7 @@ exports.upsertContextConfig = upsertContextConfig;
 exports.upsertCredentialReference = upsertCredentialReference;
 exports.upsertDataComponent = upsertDataComponent;
 exports.upsertExternalAgent = upsertExternalAgent;
+exports.upsertLedgerArtifact = upsertLedgerArtifact;
 exports.upsertTool = upsertTool;
 exports.validateAgainstJsonSchema = validateAgainstJsonSchema;
 exports.validateAgentRelationships = validateAgentRelationships;