@inkeep/agents-core 0.75.4 → 0.77.1

package/dist/text-attachments/text-document-attachments.js

@@ -0,0 +1,86 @@
+import { ALLOWED_TEXT_DOCUMENT_MIME_TYPES, canonicalizeMimeType, getExtensionFromMimeType, normalizeMimeType } from "../constants/allowed-file-formats.js";
+import { InvalidUtf8TextDocumentError, TextDocumentControlCharacterError } from "../external-fetch/file-security-errors.js";
+
+//#region src/text-attachments/text-document-attachments.ts
+function isDisallowedTextControlCharacter(codePoint) {
+	return codePoint >= 0 && codePoint <= 8 || codePoint === 11 || codePoint === 12 || codePoint >= 14 && codePoint <= 31 || codePoint === 127;
+}
+function hasDisallowedControlCharacters(value) {
+	for (const char of value) {
+		const codePoint = char.codePointAt(0);
+		if (codePoint === void 0 || isDisallowedTextControlCharacter(codePoint)) return true;
+	}
+	return false;
+}
+function isTextDocumentMimeType(mimeType) {
+	if (!mimeType) return false;
+	const canonical = canonicalizeMimeType(mimeType);
+	return ALLOWED_TEXT_DOCUMENT_MIME_TYPES.has(canonical);
+}
+function getDefaultTextDocumentFilename(mimeType) {
+	const extension = getExtensionFromMimeType(normalizeMimeType(mimeType));
+	return `unnamed.${extension === "bin" ? "txt" : extension}`;
+}
+function decodeTextDocumentBytes(data) {
+	let decoded;
+	try {
+		decoded = new TextDecoder("utf-8", { fatal: true }).decode(data);
+	} catch {
+		throw new InvalidUtf8TextDocumentError();
+	}
+	if (hasDisallowedControlCharacters(decoded)) throw new TextDocumentControlCharacterError();
+	return decoded.replace(/\r\n?/g, "\n");
+}
+function buildTextAttachmentBlock(params) {
+	const mimeType = normalizeMimeType(params.mimeType);
+	const filename = params.filename?.trim() || getDefaultTextDocumentFilename(mimeType);
+	return [
+		`<attached_file filename=${JSON.stringify(filename)} media_type=${JSON.stringify(mimeType)}>`,
+		params.content,
+		"</attached_file>"
+	].join("\n");
+}
+function buildDecodedTextAttachmentBlock(params) {
+	const content = decodeTextDocumentBytes(params.data);
+	return buildTextAttachmentBlock({
+		mimeType: params.mimeType,
+		content,
+		filename: params.filename
+	});
+}
+const UNAVAILABLE_ATTACHMENT_PLACEHOLDER = "[Attachment unavailable]";
+/**
+* Convenience wrapper around `buildTextAttachmentBlock` for the failure path —
+* produces an `<attached_file>...[Attachment unavailable]...</attached_file>` block
+* so the model still sees that an attachment existed even when its bytes are lost.
+*/
+function buildUnavailableTextAttachmentBlock(params) {
+	return buildTextAttachmentBlock({
+		mimeType: params.mimeType,
+		content: UNAVAILABLE_ATTACHMENT_PLACEHOLDER,
+		filename: params.filename
+	});
+}
+/**
+* Self-closing `<attached_file ... />` marker used when the attachment's content is not
+* (or can no longer be) inlined — e.g. images/PDFs in conversation history, or a text
+* attachment whose bytes failed to decode. The marker preserves provenance for the model
+* so prior attachments don't silently disappear on resume. When `artifactId` and
+* `toolCallId` are provided, the marker is self-describing enough for the model (or
+* downstream tools) to fetch the attachment from the artifact ledger.
+*/
+function buildAttachedFileMarker(params) {
+	const mimeType = params.mimeType ? normalizeMimeType(params.mimeType) : "";
+	const filename = params.filename?.trim() || void 0;
+	const artifactId = params.artifactId?.trim() || void 0;
+	const toolCallId = params.toolCallId?.trim() || void 0;
+	const attrs = [];
+	if (filename) attrs.push(`filename=${JSON.stringify(filename)}`);
+	if (mimeType) attrs.push(`media_type=${JSON.stringify(mimeType)}`);
+	if (artifactId) attrs.push(`artifact_id=${JSON.stringify(artifactId)}`);
+	if (toolCallId) attrs.push(`tool_call_id=${JSON.stringify(toolCallId)}`);
+	return `<attached_file${attrs.length > 0 ? ` ${attrs.join(" ")}` : ""} />`;
+}
+
+//#endregion
+export { UNAVAILABLE_ATTACHMENT_PLACEHOLDER, buildAttachedFileMarker, buildDecodedTextAttachmentBlock, buildTextAttachmentBlock, buildUnavailableTextAttachmentBlock, decodeTextDocumentBytes, getDefaultTextDocumentFilename, isTextDocumentMimeType };

package/dist/validation/schemas/skills.d.ts

@@ -1,5 +1,5 @@
 import { z } from "@hono/zod-openapi";
-import * as drizzle_orm_pg_core1569 from "drizzle-orm/pg-core";
+import * as drizzle_orm_pg_core2351 from "drizzle-orm/pg-core";
 import * as drizzle_zod405 from "drizzle-zod";
 
 //#region src/validation/schemas/skills.d.ts
@@ -28,7 +28,7 @@ declare const SkillFileContentInputSchema: z.ZodObject<{
   content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
-  createdAt: drizzle_orm_pg_core1569.PgColumn<{
+  createdAt: drizzle_orm_pg_core2351.PgColumn<{
     name: "created_at";
     tableName: "skill_files";
     dataType: "string";
@@ -45,7 +45,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  updatedAt: drizzle_orm_pg_core1569.PgColumn<{
+  updatedAt: drizzle_orm_pg_core2351.PgColumn<{
     name: "updated_at";
     tableName: "skill_files";
     dataType: "string";
@@ -62,7 +62,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  skillId: drizzle_orm_pg_core1569.PgColumn<{
+  skillId: drizzle_orm_pg_core2351.PgColumn<{
     name: "skill_id";
     tableName: "skill_files";
     dataType: "string";
@@ -81,7 +81,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 64;
   }>;
-  filePath: drizzle_orm_pg_core1569.PgColumn<{
+  filePath: drizzle_orm_pg_core2351.PgColumn<{
     name: "file_path";
     tableName: "skill_files";
     dataType: "string";
@@ -100,7 +100,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 1024;
   }>;
-  content: drizzle_orm_pg_core1569.PgColumn<{
+  content: drizzle_orm_pg_core2351.PgColumn<{
     name: "content";
     tableName: "skill_files";
     dataType: "string";
@@ -117,7 +117,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  projectId: drizzle_orm_pg_core1569.PgColumn<{
+  projectId: drizzle_orm_pg_core2351.PgColumn<{
     name: "project_id";
     tableName: "skill_files";
     dataType: "string";
@@ -136,7 +136,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  tenantId: drizzle_orm_pg_core1569.PgColumn<{
+  tenantId: drizzle_orm_pg_core2351.PgColumn<{
     name: "tenant_id";
     tableName: "skill_files";
     dataType: "string";
@@ -155,7 +155,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  id: drizzle_orm_pg_core1569.PgColumn<{
+  id: drizzle_orm_pg_core2351.PgColumn<{
     name: "id";
     tableName: "skill_files";
     dataType: "string";
@@ -175,7 +175,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     length: 256;
   }>;
 }, drizzle_zod405.BuildRefine<{
-  createdAt: drizzle_orm_pg_core1569.PgColumn<{
+  createdAt: drizzle_orm_pg_core2351.PgColumn<{
     name: "created_at";
     tableName: "skill_files";
     dataType: "string";
@@ -192,7 +192,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  updatedAt: drizzle_orm_pg_core1569.PgColumn<{
+  updatedAt: drizzle_orm_pg_core2351.PgColumn<{
     name: "updated_at";
     tableName: "skill_files";
     dataType: "string";
@@ -209,7 +209,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  skillId: drizzle_orm_pg_core1569.PgColumn<{
+  skillId: drizzle_orm_pg_core2351.PgColumn<{
     name: "skill_id";
     tableName: "skill_files";
     dataType: "string";
@@ -228,7 +228,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 64;
   }>;
-  filePath: drizzle_orm_pg_core1569.PgColumn<{
+  filePath: drizzle_orm_pg_core2351.PgColumn<{
     name: "file_path";
     tableName: "skill_files";
     dataType: "string";
@@ -247,7 +247,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 1024;
   }>;
-  content: drizzle_orm_pg_core1569.PgColumn<{
+  content: drizzle_orm_pg_core2351.PgColumn<{
     name: "content";
     tableName: "skill_files";
     dataType: "string";
@@ -264,7 +264,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
     identity: undefined;
     generated: undefined;
   }, {}, {}>;
-  projectId: drizzle_orm_pg_core1569.PgColumn<{
+  projectId: drizzle_orm_pg_core2351.PgColumn<{
     name: "project_id";
     tableName: "skill_files";
     dataType: "string";
@@ -283,7 +283,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  tenantId: drizzle_orm_pg_core1569.PgColumn<{
+  tenantId: drizzle_orm_pg_core2351.PgColumn<{
     name: "tenant_id";
     tableName: "skill_files";
     dataType: "string";
@@ -302,7 +302,7 @@ declare const SkillFileSelectSchema: drizzle_zod405.BuildSchema<"select", {
   }, {}, {
     length: 256;
   }>;
-  id: drizzle_orm_pg_core1569.PgColumn<{
+  id: drizzle_orm_pg_core2351.PgColumn<{
     name: "id";
     tableName: "skill_files";
     dataType: "string";
@@ -336,10 +336,10 @@ declare const SkillFileInsertSchema: z.ZodObject<{
   in: {};
 }>;
 declare const SkillInsertSchema: z.ZodObject<{
-  name: z.ZodString;
-  metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
   description: z.ZodString;
+  name: z.ZodString;
   content: z.ZodString;
+  metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, {
   out: {};
   in: {};
@@ -351,13 +351,13 @@ declare const SkillUpdateSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const SkillApiSelectSchema: z.ZodObject<{
+  description: z.ZodString;
   id: z.ZodString;
   name: z.ZodString;
+  content: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-  description: z.ZodString;
-  content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillApiInsertSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
   files: z.ZodArray<z.ZodObject<{
@@ -384,8 +384,8 @@ declare const SkillApiInsertSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
     filePath: z.ZodString;
     content: z.ZodString;
   }, z.core.$strip>>;
-  name: z.ZodString;
   description: z.ZodString;
+  name: z.ZodString;
   content: z.ZodString;
 }, z.core.$strict>>;
 declare const SkillApiUpdateSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
@@ -400,8 +400,8 @@ declare const SkillApiUpdateSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
   }[];
 }>>, z.ZodObject<{
   metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
-  name: z.ZodOptional<z.ZodString>;
   description: z.ZodOptional<z.ZodString>;
+  name: z.ZodOptional<z.ZodString>;
   content: z.ZodOptional<z.ZodString>;
   files: z.ZodNonOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
     filePath: z.ZodString;
@@ -410,9 +410,9 @@ declare const SkillApiUpdateSchema: z.ZodPipe<z.ZodPipe<z.ZodObject<{
 }, z.core.$strict>>;
 declare const SkillFileApiSelectSchema: z.ZodObject<{
   id: z.ZodString;
+  content: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  content: z.ZodString;
   filePath: z.ZodString;
   skillId: z.ZodString;
 }, z.core.$strip>;
@@ -424,18 +424,18 @@ declare const SkillFileApiUpdateSchema: z.ZodObject<{
   content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillWithFilesApiSelectSchema: z.ZodObject<{
+  description: z.ZodString;
   id: z.ZodString;
   name: z.ZodString;
+  content: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-  description: z.ZodString;
-  content: z.ZodString;
   files: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
+    content: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    content: z.ZodString;
     filePath: z.ZodString;
     skillId: z.ZodString;
   }, z.core.$strip>>;
@@ -486,10 +486,10 @@ declare const SubAgentSkillUpdateSchema: z.ZodObject<{
   in: {};
 }>;
 declare const SubAgentSkillApiSelectSchema: z.ZodObject<{
+  subAgentId: z.ZodString;
   id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  subAgentId: z.ZodString;
   index: z.ZodInt;
   alwaysLoaded: z.ZodBoolean;
   skillId: z.ZodString;
@@ -505,22 +505,22 @@ declare const SubAgentSkillApiInsertSchema: z.ZodObject<{
   in: {};
 }>;
 declare const SubAgentSkillApiUpdateSchema: z.ZodObject<{
+  subAgentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   id: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   createdAt: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodString>>>;
   updatedAt: z.ZodOptional<z.ZodOptional<z.ZodOptional<z.ZodString>>>;
-  subAgentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
   index: z.ZodOptional<z.ZodOptional<z.ZodInt>>;
   alwaysLoaded: z.ZodOptional<z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>>;
   skillId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
 }, z.core.$strip>;
 declare const SubAgentSkillWithIndexSchema: z.ZodObject<{
+  description: z.ZodString;
   id: z.ZodString;
   name: z.ZodString;
+  content: z.ZodString;
+  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-  description: z.ZodString;
-  content: z.ZodString;
   subAgentSkillId: z.ZodString;
   subAgentId: z.ZodString;
   index: z.ZodInt;
@@ -529,27 +529,27 @@ declare const SubAgentSkillWithIndexSchema: z.ZodObject<{
 declare const SkillFileResponse: z.ZodObject<{
   data: z.ZodObject<{
     id: z.ZodString;
+    content: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    content: z.ZodString;
     filePath: z.ZodString;
     skillId: z.ZodString;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SkillWithFilesResponse: z.ZodObject<{
   data: z.ZodObject<{
+    description: z.ZodString;
     id: z.ZodString;
     name: z.ZodString;
+    content: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-    description: z.ZodString;
-    content: z.ZodString;
     files: z.ZodArray<z.ZodObject<{
       id: z.ZodString;
+      content: z.ZodString;
       createdAt: z.ZodString;
       updatedAt: z.ZodString;
-      content: z.ZodString;
       filePath: z.ZodString;
       skillId: z.ZodString;
     }, z.core.$strip>>;
@@ -557,13 +557,13 @@ declare const SkillWithFilesResponse: z.ZodObject<{
 }, z.core.$strip>;
 declare const SkillListResponse: z.ZodObject<{
   data: z.ZodArray<z.ZodObject<{
+    description: z.ZodString;
     id: z.ZodString;
     name: z.ZodString;
+    content: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-    description: z.ZodString;
-    content: z.ZodString;
   }, z.core.$strip>>;
   pagination: z.ZodObject<{
     page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -574,10 +574,10 @@ declare const SkillListResponse: z.ZodObject<{
 }, z.core.$strip>;
 declare const SubAgentSkillResponse: z.ZodObject<{
   data: z.ZodObject<{
+    subAgentId: z.ZodString;
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    subAgentId: z.ZodString;
     index: z.ZodInt;
     alwaysLoaded: z.ZodBoolean;
     skillId: z.ZodString;
@@ -585,13 +585,13 @@ declare const SubAgentSkillResponse: z.ZodObject<{
 }, z.core.$strip>;
 declare const SubAgentSkillWithIndexArrayResponse: z.ZodObject<{
   data: z.ZodArray<z.ZodObject<{
+    description: z.ZodString;
     id: z.ZodString;
     name: z.ZodString;
+    content: z.ZodString;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
-    description: z.ZodString;
-    content: z.ZodString;
     subAgentSkillId: z.ZodString;
     subAgentId: z.ZodString;
     index: z.ZodInt;