@inkeep/agents-core 0.75.4 → 0.77.0

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";
@@ -412,9 +412,9 @@ declare const SkillFileApiSelectSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
-  content: z.ZodString;
-  filePath: z.ZodString;
   skillId: z.ZodString;
+  filePath: z.ZodString;
+  content: z.ZodString;
 }, z.core.$strip>;
 declare const SkillFileApiInsertSchema: z.ZodObject<{
   filePath: z.ZodString;
@@ -435,9 +435,9 @@ declare const SkillWithFilesApiSelectSchema: z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    content: z.ZodString;
-    filePath: z.ZodString;
     skillId: z.ZodString;
+    filePath: z.ZodString;
+    content: z.ZodString;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const SubAgentSkillSelectSchema: z.ZodObject<{
@@ -489,17 +489,17 @@ declare const SubAgentSkillApiSelectSchema: z.ZodObject<{
   id: z.ZodString;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
+  skillId: z.ZodString;
   subAgentId: z.ZodString;
   index: z.ZodInt;
   alwaysLoaded: z.ZodBoolean;
-  skillId: z.ZodString;
 }, z.core.$strip>;
 declare const SubAgentSkillApiInsertSchema: z.ZodObject<{
+  skillId: z.ZodString;
   agentId: z.ZodString;
   subAgentId: z.ZodString;
   index: z.ZodInt;
   alwaysLoaded: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-  skillId: z.ZodString;
 }, {
   out: {};
   in: {};
@@ -508,10 +508,10 @@ declare const SubAgentSkillApiUpdateSchema: z.ZodObject<{
   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>>>;
+  skillId: 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<{
   id: z.ZodString;
@@ -531,9 +531,9 @@ declare const SkillFileResponse: z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
-    content: z.ZodString;
-    filePath: z.ZodString;
     skillId: z.ZodString;
+    filePath: z.ZodString;
+    content: z.ZodString;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SkillWithFilesResponse: z.ZodObject<{
@@ -549,9 +549,9 @@ declare const SkillWithFilesResponse: z.ZodObject<{
       id: z.ZodString;
       createdAt: z.ZodString;
       updatedAt: z.ZodString;
-      content: z.ZodString;
-      filePath: z.ZodString;
       skillId: z.ZodString;
+      filePath: z.ZodString;
+      content: z.ZodString;
     }, z.core.$strip>>;
   }, z.core.$strip>;
 }, z.core.$strip>;
@@ -577,10 +577,10 @@ declare const SubAgentSkillResponse: z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
+    skillId: z.ZodString;
     subAgentId: z.ZodString;
     index: z.ZodInt;
     alwaysLoaded: z.ZodBoolean;
-    skillId: z.ZodString;
   }, z.core.$strip>;
 }, z.core.$strip>;
 declare const SubAgentSkillWithIndexArrayResponse: z.ZodObject<{