@5ss/ai-tools 3.0.3 → 3.1.0

package/CHANGELOG.md

@@ -4,6 +4,8 @@ All notable changes to `@5ss/ai-tools` are documented here.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Releases are cut by [semantic-release](https://semantic-release.gitbook.io/) from [conventional commits](https://www.conventionalcommits.org/).
 
+## [3.1.0](https://github.com/five-star-solutions-co/ai-tools/compare/v3.0.3...v3.1.0) (2026-08-24)
+
 ## [3.0.3](https://github.com/five-star-solutions-co/ai-tools/compare/v3.0.2...v3.0.3) (2026-08-21)
 
 ## [3.0.2](https://github.com/five-star-solutions-co/ai-tools/compare/v3.0.1...v3.0.2) (2026-08-12)

package/dist/modules/artifacts/index.d.ts

@@ -70,8 +70,6 @@ declare const artifactsReadLinesInputSchema: z.ZodObject<{
     filename: z.ZodOptional<z.ZodString>;
     byte_length: z.ZodOptional<z.ZodInt>;
   }, z.core.$strip>;
-  start_line: z.ZodInt;
-  end_line: z.ZodInt;
 }, z.core.$strip>;
 declare const artifactsReadLinesOutputSchema: z.ZodObject<{
   source: z.ZodObject<{
@@ -276,8 +274,6 @@ declare const artifactsReadLinesTool: ToolDefinition<{
     filename?: string | undefined;
     byte_length?: number | undefined;
   };
-  start_line: number;
-  end_line: number;
 }, {
   source: {
     store: "host" | "object";

package/dist/modules/artifacts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/artifacts/contracts.ts","../../../src/modules/artifacts/client.ts","../../../src/modules/artifacts/module.ts","../../../src/modules/artifacts/providers/host.ts","../../../src/modules/artifacts/providers/object.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/modules/artifacts/contracts.ts","../../../src/modules/artifacts/client.ts","../../../src/modules/artifacts/module.ts","../../../src/modules/artifacts/providers/host.ts","../../../src/modules/artifacts/providers/object.ts"],"mappings":"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"}

package/dist/modules/artifacts/index.js

@@ -9,7 +9,7 @@ import { isFunction } from "es-toolkit";
 import { z } from "zod";
 //#region src/modules/artifacts/contracts.ts
 /**
-* ArtifactRef creation and bounded read contracts.
+* ArtifactRef creation and read contracts.
 * Host-mapped and object-store backends share the same model-facing verbs.
 */
 const MAX_ARTIFACT_READ_BYTES = MAX_OBJECT_BYTES;
@@ -48,17 +48,10 @@ const artifactsReadRangeOutputSchema = z.object({
 	total_bytes: z.int().min(0).optional(),
 	media_type: z.string().optional()
 });
-const artifactsReadLinesInputSchema = z.object({
-	source: artifactRefSchema.describe("UTF-8 text artifact to read"),
-	start_line: z.int().min(1).describe("Inclusive one-based start line"),
-	end_line: z.int().min(1).describe("Inclusive one-based end line")
-}).refine((input) => input.end_line >= input.start_line, {
-	path: ["end_line"],
-	message: "end_line must be greater than or equal to start_line"
-});
+const artifactsReadLinesInputSchema = z.object({ source: artifactRefSchema.describe("UTF-8 text artifact to read") });
 const artifactsReadLinesOutputSchema = z.object({
 	source: artifactRefSchema,
-	text: z.string().describe("Selected UTF-8 lines"),
+	text: z.string().describe("Complete UTF-8 text content"),
 	start_line: z.int().min(1),
 	end_line: z.int().min(1),
 	total_lines: z.int().min(0)
@@ -193,19 +186,11 @@ var ObjectArtifactsProvider = class {
 	async readLines(input) {
 		requireObjectSource(input.source.store);
 		const lines = textLines(bytesToUtf8(await this.#storage.getBytes(input.source.key, { maxBytes: MAX_ARTIFACT_READ_BYTES })));
-		if (input.start_line > lines.length) throw new ToolError("start_line is beyond the end of the artifact", {
-			code: "bad_input",
-			details: {
-				start_line: input.start_line,
-				total_lines: lines.length
-			}
-		});
-		const selected = lines.slice(input.start_line - 1, input.end_line);
 		return {
 			source: input.source,
-			text: selected.join("\n"),
-			start_line: input.start_line,
-			end_line: input.start_line + selected.length - 1,
+			text: lines.join("\n"),
+			start_line: 1,
+			end_line: lines.length,
 			total_lines: lines.length
 		};
 	}
@@ -317,7 +302,7 @@ const artifactsReadRangeTool = defineTool({
 const artifactsReadLinesTool = defineTool({
 	id: "artifacts-read-lines",
 	name: "readArtifactLines",
-	description: "Read an explicit inclusive line range from a UTF-8 text artifact. Use for bounded inspection instead of loading the whole file into context.",
+	description: "Read the complete contents of a UTF-8 text artifact, bounded by the artifact read-size limit.",
 	inputSchema: artifactsReadLinesInputSchema,
 	outputSchema: artifactsReadLinesOutputSchema,
 	sideEffect: "read",
@@ -327,7 +312,7 @@ const artifactsReadLinesTool = defineTool({
 const artifactsModule = defineModule({
 	id: "artifacts",
 	title: "Artifacts",
-	description: "Persist small serialized content and inspect bounded byte or text ranges. ArtifactRef is the handoff between tools; structured document creation belongs to purpose-built builders.",
+	description: "Persist small serialized content, inspect bounded byte ranges, and read UTF-8 text artifacts. ArtifactRef is the handoff between tools; structured document creation belongs to purpose-built builders.",
 	runtime: "both",
 	auth: {
 		type: "custom",

package/dist/modules/artifacts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#backend","#storage","#ops"],"sources":["../../../src/modules/artifacts/contracts.ts","../../../src/modules/artifacts/providers/host.ts","../../../src/modules/artifacts/providers/object.ts","../../../src/modules/artifacts/client.ts","../../../src/modules/artifacts/module.ts"],"sourcesContent":["/**\n * ArtifactRef creation and bounded read contracts.\n * Host-mapped and object-store backends share the same model-facing verbs.\n */\n\nimport { isFunction } from 'es-toolkit'\nimport { z } from 'zod'\n\nimport { artifactRefSchema } from '../../shared/artifact'\nimport { MAX_OBJECT_BYTES, s3AuthSchema } from '../../vendors/s3'\n\nexport const MAX_ARTIFACT_READ_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_CREATE_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_INLINE_CHARS = Math.ceil((MAX_ARTIFACT_CREATE_BYTES * 4) / 3) + 4\n\nexport const artifactsCreateInputSchema = z.object({\n\tkey: z.string().min(1).max(1_024).describe('Destination key for the new artifact'),\n\tbody: z.string().max(MAX_ARTIFACT_INLINE_CHARS).describe('Artifact body encoded as specified by encoding'),\n\tencoding: z.enum(['utf8', 'base64']).describe('How body is encoded'),\n\tmedia_type: z.string().min(1).max(200).optional().describe('MIME type when known'),\n\tfilename: z.string().min(1).max(512).optional().describe('Display filename when different from the key')\n})\n\nexport const artifactsCreateOutputSchema = z.object({\n\tartifact: artifactRefSchema.describe('Reference to the created artifact')\n})\n\nexport const artifactsReadRangeInputSchema = z\n\t.object({\n\t\tsource: artifactRefSchema.describe('Artifact to read'),\n\t\tstart_byte: z.int().min(0).describe('Inclusive zero-based start byte'),\n\t\tend_byte: z.int().min(0).describe('Inclusive zero-based end byte')\n\t})\n\t.superRefine((input, ctx) => {\n\t\tconst byteLength = input.end_byte - input.start_byte + 1\n\t\tif (byteLength < 1) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: 'end_byte must be greater than or equal to start_byte'\n\t\t\t})\n\t\t}\n\t\tif (byteLength > MAX_ARTIFACT_READ_BYTES) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: `Byte range cannot exceed ${MAX_ARTIFACT_READ_BYTES} bytes`\n\t\t\t})\n\t\t}\n\t})\n\nexport const artifactsReadRangeOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\tbody_base64: z.string().describe('Requested bytes encoded as base64'),\n\tstart_byte: z.int().min(0),\n\tend_byte: z.int().min(0),\n\ttotal_bytes: z.int().min(0).optional(),\n\tmedia_type: z.string().optional()\n})\n\nexport const artifactsReadLinesInputSchema = z\n\t.object({\n\t\tsource: artifactRefSchema.describe('UTF-8 text artifact to read'),\n\t\tstart_line: z.int().min(1).describe('Inclusive one-based start line'),\n\t\tend_line: z.int().min(1).describe('Inclusive one-based end line')\n\t})\n\t.refine((input) => input.end_line >= input.start_line, {\n\t\tpath: ['end_line'],\n\t\tmessage: 'end_line must be greater than or equal to start_line'\n\t})\n\nexport const artifactsReadLinesOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\ttext: z.string().describe('Selected UTF-8 lines'),\n\tstart_line: z.int().min(1),\n\tend_line: z.int().min(1),\n\ttotal_lines: z.int().min(0)\n})\n\nexport const artifactResolveInputSchema = z.object({\n\tsource: artifactRefSchema,\n\tmax_bytes: z.int().min(0)\n})\n\nexport const resolvedArtifactSchema = z.object({\n\tartifact: artifactRefSchema,\n\tbytes: z.custom<Uint8Array>((value) => value instanceof Uint8Array, 'bytes must be a Uint8Array')\n})\n\nexport type ArtifactsCreateInput = z.infer<typeof artifactsCreateInputSchema>\nexport type ArtifactsCreateOutput = z.infer<typeof artifactsCreateOutputSchema>\nexport type ArtifactsReadRangeInput = z.infer<typeof artifactsReadRangeInputSchema>\nexport type ArtifactsReadRangeOutput = z.infer<typeof artifactsReadRangeOutputSchema>\nexport type ArtifactsReadLinesInput = z.infer<typeof artifactsReadLinesInputSchema>\nexport type ArtifactsReadLinesOutput = z.infer<typeof artifactsReadLinesOutputSchema>\nexport type ArtifactResolveInput = z.infer<typeof artifactResolveInputSchema>\nexport type ResolvedArtifact = z.infer<typeof resolvedArtifactSchema>\n\nexport type ArtifactsOps = {\n\tcreate(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput>\n\treadRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput>\n\treadLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput>\n}\n\nexport type ArtifactResolverOps = {\n\tresolve(input: ArtifactResolveInput): Promise<ResolvedArtifact>\n}\n\nexport type ArtifactsClientOps = ArtifactsOps & ArtifactResolverOps\n\nexport const artifactsBackendSchema = z.object({\n\tcreate: z.custom<ArtifactsOps['create']>(isFunction, 'create must be a function'),\n\treadRange: z.custom<ArtifactsOps['readRange']>(isFunction, 'readRange must be a function'),\n\treadLines: z.custom<ArtifactsOps['readLines']>(isFunction, 'readLines must be a function'),\n\tresolve: z.custom<ArtifactResolverOps['resolve']>(isFunction, 'resolve must be a function').optional()\n})\n\nexport const objectArtifactsAuthSchema = z.object({\n\tprovider: z.literal('object'),\n\tstorage: s3AuthSchema.describe('S3-compatible object storage for ArtifactRef bytes')\n})\n\nexport const hostArtifactsAuthSchema = z.object({\n\tprovider: z.literal('host'),\n\tbackend: artifactsBackendSchema.describe('Host artifact operations for host-mapped ArtifactRefs')\n})\n\nexport const artifactsAuthSchema = z.discriminatedUnion('provider', [\n\tobjectArtifactsAuthSchema,\n\thostArtifactsAuthSchema\n])\n\nexport type ArtifactsAuth = z.infer<typeof artifactsAuthSchema>\nexport type ObjectArtifactsAuth = z.infer<typeof objectArtifactsAuthSchema>\nexport type HostArtifactsAuth = z.infer<typeof hostArtifactsAuthSchema>\n","import { ToolError } from '../../../core/errors'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tHostArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport {\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeOutputSchema,\n\tresolvedArtifactSchema\n} from '../contracts'\n\nfunction requireHostStore(store: 'object' | 'host'): void {\n\tif (store !== 'host') {\n\t\tthrow new ToolError('The host artifact provider only resolves host-mapped references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nexport class HostArtifactsProvider implements ArtifactsClientOps {\n\treadonly #backend: HostArtifactsAuth['backend']\n\n\tconstructor(auth: HostArtifactsAuth) {\n\t\tthis.#backend = auth.backend\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst output = artifactsCreateOutputSchema.parse(await this.#backend.create(input))\n\t\trequireHostStore(output.artifact.store)\n\t\treturn output\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadRangeOutputSchema.parse(await this.#backend.readRange(input))\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadLinesOutputSchema.parse(await this.#backend.readLines(input))\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireHostStore(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\t\tif (!this.#backend.resolve) {\n\t\t\tthrow new ToolError('The host artifact backend does not support byte resolution', {\n\t\t\t\tcode: 'unsupported'\n\t\t\t})\n\t\t}\n\n\t\tconst output = resolvedArtifactSchema.parse(await this.#backend.resolve(input))\n\t\trequireHostStore(output.artifact.store)\n\t\tif (output.artifact.key !== input.source.key) {\n\t\t\tthrow new ToolError('The host artifact backend resolved a different artifact', {\n\t\t\t\tcode: 'internal'\n\t\t\t})\n\t\t}\n\t\tif (output.bytes.byteLength > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...input.source,\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../../core/errors'\nimport { artifactRefSchema } from '../../../shared/artifact'\nimport { base64ToBytes, bytesToBase64, bytesToUtf8, utf8ToBytes } from '../../../shared/bytes'\nimport { mediaTypeFromPath } from '../../../shared/content-type'\nimport type { HttpServiceOptions } from '../../../transport/http-service'\nimport { S3Client } from '../../../vendors/s3'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tObjectArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport { MAX_ARTIFACT_CREATE_BYTES, MAX_ARTIFACT_READ_BYTES } from '../contracts'\n\nexport type ObjectArtifactsProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nfunction requireObjectSource(store: 'object' | 'host'): void {\n\tif (store !== 'object') {\n\t\tthrow new ToolError('The object artifact provider only resolves object-store references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nfunction artifactBytes(input: ArtifactsCreateInput): Uint8Array {\n\tconst bytes = input.encoding === 'base64' ? base64ToBytes(input.body) : utf8ToBytes(input.body)\n\tif (bytes.byteLength > MAX_ARTIFACT_CREATE_BYTES) {\n\t\tthrow new ToolError('Artifact body exceeds create limit', {\n\t\t\tcode: 'too_large',\n\t\t\tdetails: { max_bytes: MAX_ARTIFACT_CREATE_BYTES, content_length: bytes.byteLength }\n\t\t})\n\t}\n\treturn bytes\n}\n\nfunction textLines(text: string): string[] {\n\treturn text.split('\\n').map((line) => (line.endsWith('\\r') ? line.slice(0, -1) : line))\n}\n\nexport class ObjectArtifactsProvider implements ArtifactsClientOps {\n\treadonly #storage: S3Client\n\n\tconstructor(auth: ObjectArtifactsAuth, options: ObjectArtifactsProviderOptions = {}) {\n\t\tthis.#storage = new S3Client(auth.storage, options)\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst bytes = artifactBytes(input)\n\t\tconst mediaType = input.media_type ?? mediaTypeFromPath(input.filename ?? input.key)\n\t\tawait this.#storage.putBytes(input.key, bytes, mediaType)\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\tstore: 'object',\n\t\t\t\tkey: input.key,\n\t\t\t\tbyte_length: bytes.byteLength,\n\t\t\t\t...(mediaType && { media_type: mediaType }),\n\t\t\t\t...(input.filename && { filename: input.filename })\n\t\t\t})\n\t\t}\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst result = await this.#storage.getBytesRange(input.source.key, {\n\t\t\tstart_byte: input.start_byte,\n\t\t\tend_byte: input.end_byte\n\t\t})\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\tbody_base64: bytesToBase64(result.bytes),\n\t\t\tstart_byte: result.start_byte,\n\t\t\tend_byte: result.end_byte,\n\t\t\t...(result.total_bytes !== undefined && { total_bytes: result.total_bytes }),\n\t\t\t...(result.content_type && { media_type: result.content_type })\n\t\t}\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: MAX_ARTIFACT_READ_BYTES })\n\t\tconst lines = textLines(bytesToUtf8(bytes))\n\t\tif (input.start_line > lines.length) {\n\t\t\tthrow new ToolError('start_line is beyond the end of the artifact', {\n\t\t\t\tcode: 'bad_input',\n\t\t\t\tdetails: { start_line: input.start_line, total_lines: lines.length }\n\t\t\t})\n\t\t}\n\t\tconst selected = lines.slice(input.start_line - 1, input.end_line)\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\ttext: selected.join('\\n'),\n\t\t\tstart_line: input.start_line,\n\t\t\tend_line: input.start_line + selected.length - 1,\n\t\t\ttotal_lines: lines.length\n\t\t}\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireObjectSource(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\n\t\tconst head = await this.#storage.head({ key: input.source.key })\n\t\tif (!head.exists) {\n\t\t\tthrow new ToolError('Artifact not found', { code: 'not_found' })\n\t\t}\n\t\tif (head.content_length !== undefined && head.content_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: head.content_length }\n\t\t\t})\n\t\t}\n\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: input.max_bytes })\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\t...input.source,\n\t\t\t\t...(!input.source.media_type && head.content_type && { media_type: head.content_type }),\n\t\t\t\tbyte_length: bytes.byteLength\n\t\t\t}),\n\t\t\tbytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsAuth,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadRangeInput,\n\tResolvedArtifact\n} from './contracts'\nimport { artifactResolveInputSchema, artifactsAuthSchema, resolvedArtifactSchema } from './contracts'\nimport { HostArtifactsProvider } from './providers/host'\nimport { ObjectArtifactsProvider } from './providers/object'\n\nfunction transportOptions(ctx: ToolContext) {\n\treturn {\n\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t...(ctx.signal && { signal: ctx.signal })\n\t}\n}\n\nfunction providerFor(auth: ArtifactsAuth, ctx: ToolContext): ArtifactsClientOps {\n\tswitch (auth.provider) {\n\t\tcase 'object':\n\t\t\treturn new ObjectArtifactsProvider(auth, transportOptions(ctx))\n\t\tcase 'host':\n\t\t\treturn new HostArtifactsProvider(auth)\n\t}\n}\n\nexport class ArtifactsClient implements ArtifactsClientOps {\n\treadonly #ops: ArtifactsClientOps\n\n\tconstructor(ops: ArtifactsClientOps) {\n\t\tthis.#ops = ops\n\t}\n\n\tstatic fromContext(ctx: ToolContext): ArtifactsClient {\n\t\tconst auth = requireAuth(ctx, artifactsAuthSchema)\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tstatic fromAuth(auth: ArtifactsAuth, ctx: ToolContext = {}): ArtifactsClient {\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tcreate(input: ArtifactsCreateInput) {\n\t\treturn this.#ops.create(input)\n\t}\n\n\treadRange(input: ArtifactsReadRangeInput) {\n\t\treturn this.#ops.readRange(input)\n\t}\n\n\treadLines(input: ArtifactsReadLinesInput) {\n\t\treturn this.#ops.readLines(input)\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\tconst parsedInput = artifactResolveInputSchema.parse(input)\n\t\tconst output = resolvedArtifactSchema.parse(await this.#ops.resolve(parsedInput))\n\t\tif (output.bytes.byteLength > parsedInput.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: parsedInput.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { ArtifactsClient } from './client'\nimport {\n\tartifactsAuthSchema,\n\tartifactsCreateInputSchema,\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesInputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeInputSchema,\n\tartifactsReadRangeOutputSchema\n} from './contracts'\n\nexport const artifactsCreateTool = defineTool({\n\tid: 'artifacts-create',\n\tname: 'createArtifact',\n\tdescription:\n\t\t'Persist small, already-serialized UTF-8 or base64 content and return its ArtifactRef. Use for raw bytes or text when no structured builder is required. Do not use this to invent DOCX, XLSX, PPTX, PDF, or image formats.',\n\tinputSchema: artifactsCreateInputSchema,\n\toutputSchema: artifactsCreateOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).create(input)\n})\n\nexport const artifactsReadRangeTool = defineTool({\n\tid: 'artifacts-read-range',\n\tname: 'readArtifactRange',\n\tdescription:\n\t\t'Read an explicit inclusive byte range from an existing ArtifactRef as base64. Use for bounded binary inspection or chunked transfer, not for understanding a supported document when a format-aware reader is available.',\n\tinputSchema: artifactsReadRangeInputSchema,\n\toutputSchema: artifactsReadRangeOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readRange(input)\n})\n\nexport const artifactsReadLinesTool = defineTool({\n\tid: 'artifacts-read-lines',\n\tname: 'readArtifactLines',\n\tdescription:\n\t\t'Read an explicit inclusive line range from a UTF-8 text artifact. Use for bounded inspection instead of loading the whole file into context.',\n\tinputSchema: artifactsReadLinesInputSchema,\n\toutputSchema: artifactsReadLinesOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readLines(input)\n})\n\nexport const artifactsModule = defineModule({\n\tid: 'artifacts',\n\ttitle: 'Artifacts',\n\tdescription:\n\t\t'Persist small serialized content and inspect bounded byte or text ranges. ArtifactRef is the handoff between tools; structured document creation belongs to purpose-built builders.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: artifactsAuthSchema },\n\tcategories: ['storage', 'artifacts'],\n\tclassification: 'pii',\n\ttags: ['artifact-ref', 'object-store'],\n\ttools: [artifactsCreateTool, artifactsReadRangeTool, artifactsReadLinesTool]\n})\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#backend","#storage","#ops"],"sources":["../../../src/modules/artifacts/contracts.ts","../../../src/modules/artifacts/providers/host.ts","../../../src/modules/artifacts/providers/object.ts","../../../src/modules/artifacts/client.ts","../../../src/modules/artifacts/module.ts"],"sourcesContent":["/**\n * ArtifactRef creation and read contracts.\n * Host-mapped and object-store backends share the same model-facing verbs.\n */\n\nimport { isFunction } from 'es-toolkit'\nimport { z } from 'zod'\n\nimport { artifactRefSchema } from '../../shared/artifact'\nimport { MAX_OBJECT_BYTES, s3AuthSchema } from '../../vendors/s3'\n\nexport const MAX_ARTIFACT_READ_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_CREATE_BYTES = MAX_OBJECT_BYTES\nexport const MAX_ARTIFACT_INLINE_CHARS = Math.ceil((MAX_ARTIFACT_CREATE_BYTES * 4) / 3) + 4\n\nexport const artifactsCreateInputSchema = z.object({\n\tkey: z.string().min(1).max(1_024).describe('Destination key for the new artifact'),\n\tbody: z.string().max(MAX_ARTIFACT_INLINE_CHARS).describe('Artifact body encoded as specified by encoding'),\n\tencoding: z.enum(['utf8', 'base64']).describe('How body is encoded'),\n\tmedia_type: z.string().min(1).max(200).optional().describe('MIME type when known'),\n\tfilename: z.string().min(1).max(512).optional().describe('Display filename when different from the key')\n})\n\nexport const artifactsCreateOutputSchema = z.object({\n\tartifact: artifactRefSchema.describe('Reference to the created artifact')\n})\n\nexport const artifactsReadRangeInputSchema = z\n\t.object({\n\t\tsource: artifactRefSchema.describe('Artifact to read'),\n\t\tstart_byte: z.int().min(0).describe('Inclusive zero-based start byte'),\n\t\tend_byte: z.int().min(0).describe('Inclusive zero-based end byte')\n\t})\n\t.superRefine((input, ctx) => {\n\t\tconst byteLength = input.end_byte - input.start_byte + 1\n\t\tif (byteLength < 1) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: 'end_byte must be greater than or equal to start_byte'\n\t\t\t})\n\t\t}\n\t\tif (byteLength > MAX_ARTIFACT_READ_BYTES) {\n\t\t\tctx.addIssue({\n\t\t\t\tcode: 'custom',\n\t\t\t\tpath: ['end_byte'],\n\t\t\t\tmessage: `Byte range cannot exceed ${MAX_ARTIFACT_READ_BYTES} bytes`\n\t\t\t})\n\t\t}\n\t})\n\nexport const artifactsReadRangeOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\tbody_base64: z.string().describe('Requested bytes encoded as base64'),\n\tstart_byte: z.int().min(0),\n\tend_byte: z.int().min(0),\n\ttotal_bytes: z.int().min(0).optional(),\n\tmedia_type: z.string().optional()\n})\n\nexport const artifactsReadLinesInputSchema = z.object({\n\tsource: artifactRefSchema.describe('UTF-8 text artifact to read')\n})\n\nexport const artifactsReadLinesOutputSchema = z.object({\n\tsource: artifactRefSchema,\n\ttext: z.string().describe('Complete UTF-8 text content'),\n\tstart_line: z.int().min(1),\n\tend_line: z.int().min(1),\n\ttotal_lines: z.int().min(0)\n})\n\nexport const artifactResolveInputSchema = z.object({\n\tsource: artifactRefSchema,\n\tmax_bytes: z.int().min(0)\n})\n\nexport const resolvedArtifactSchema = z.object({\n\tartifact: artifactRefSchema,\n\tbytes: z.custom<Uint8Array>((value) => value instanceof Uint8Array, 'bytes must be a Uint8Array')\n})\n\nexport type ArtifactsCreateInput = z.infer<typeof artifactsCreateInputSchema>\nexport type ArtifactsCreateOutput = z.infer<typeof artifactsCreateOutputSchema>\nexport type ArtifactsReadRangeInput = z.infer<typeof artifactsReadRangeInputSchema>\nexport type ArtifactsReadRangeOutput = z.infer<typeof artifactsReadRangeOutputSchema>\nexport type ArtifactsReadLinesInput = z.infer<typeof artifactsReadLinesInputSchema>\nexport type ArtifactsReadLinesOutput = z.infer<typeof artifactsReadLinesOutputSchema>\nexport type ArtifactResolveInput = z.infer<typeof artifactResolveInputSchema>\nexport type ResolvedArtifact = z.infer<typeof resolvedArtifactSchema>\n\nexport type ArtifactsOps = {\n\tcreate(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput>\n\treadRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput>\n\treadLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput>\n}\n\nexport type ArtifactResolverOps = {\n\tresolve(input: ArtifactResolveInput): Promise<ResolvedArtifact>\n}\n\nexport type ArtifactsClientOps = ArtifactsOps & ArtifactResolverOps\n\nexport const artifactsBackendSchema = z.object({\n\tcreate: z.custom<ArtifactsOps['create']>(isFunction, 'create must be a function'),\n\treadRange: z.custom<ArtifactsOps['readRange']>(isFunction, 'readRange must be a function'),\n\treadLines: z.custom<ArtifactsOps['readLines']>(isFunction, 'readLines must be a function'),\n\tresolve: z.custom<ArtifactResolverOps['resolve']>(isFunction, 'resolve must be a function').optional()\n})\n\nexport const objectArtifactsAuthSchema = z.object({\n\tprovider: z.literal('object'),\n\tstorage: s3AuthSchema.describe('S3-compatible object storage for ArtifactRef bytes')\n})\n\nexport const hostArtifactsAuthSchema = z.object({\n\tprovider: z.literal('host'),\n\tbackend: artifactsBackendSchema.describe('Host artifact operations for host-mapped ArtifactRefs')\n})\n\nexport const artifactsAuthSchema = z.discriminatedUnion('provider', [\n\tobjectArtifactsAuthSchema,\n\thostArtifactsAuthSchema\n])\n\nexport type ArtifactsAuth = z.infer<typeof artifactsAuthSchema>\nexport type ObjectArtifactsAuth = z.infer<typeof objectArtifactsAuthSchema>\nexport type HostArtifactsAuth = z.infer<typeof hostArtifactsAuthSchema>\n","import { ToolError } from '../../../core/errors'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tHostArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport {\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeOutputSchema,\n\tresolvedArtifactSchema\n} from '../contracts'\n\nfunction requireHostStore(store: 'object' | 'host'): void {\n\tif (store !== 'host') {\n\t\tthrow new ToolError('The host artifact provider only resolves host-mapped references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nexport class HostArtifactsProvider implements ArtifactsClientOps {\n\treadonly #backend: HostArtifactsAuth['backend']\n\n\tconstructor(auth: HostArtifactsAuth) {\n\t\tthis.#backend = auth.backend\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst output = artifactsCreateOutputSchema.parse(await this.#backend.create(input))\n\t\trequireHostStore(output.artifact.store)\n\t\treturn output\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadRangeOutputSchema.parse(await this.#backend.readRange(input))\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireHostStore(input.source.store)\n\t\treturn artifactsReadLinesOutputSchema.parse(await this.#backend.readLines(input))\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireHostStore(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\t\tif (!this.#backend.resolve) {\n\t\t\tthrow new ToolError('The host artifact backend does not support byte resolution', {\n\t\t\t\tcode: 'unsupported'\n\t\t\t})\n\t\t}\n\n\t\tconst output = resolvedArtifactSchema.parse(await this.#backend.resolve(input))\n\t\trequireHostStore(output.artifact.store)\n\t\tif (output.artifact.key !== input.source.key) {\n\t\t\tthrow new ToolError('The host artifact backend resolved a different artifact', {\n\t\t\t\tcode: 'internal'\n\t\t\t})\n\t\t}\n\t\tif (output.bytes.byteLength > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...input.source,\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../../core/errors'\nimport { artifactRefSchema } from '../../../shared/artifact'\nimport { base64ToBytes, bytesToBase64, bytesToUtf8, utf8ToBytes } from '../../../shared/bytes'\nimport { mediaTypeFromPath } from '../../../shared/content-type'\nimport type { HttpServiceOptions } from '../../../transport/http-service'\nimport { S3Client } from '../../../vendors/s3'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsCreateOutput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadLinesOutput,\n\tArtifactsReadRangeInput,\n\tArtifactsReadRangeOutput,\n\tObjectArtifactsAuth,\n\tResolvedArtifact\n} from '../contracts'\nimport { MAX_ARTIFACT_CREATE_BYTES, MAX_ARTIFACT_READ_BYTES } from '../contracts'\n\nexport type ObjectArtifactsProviderOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nfunction requireObjectSource(store: 'object' | 'host'): void {\n\tif (store !== 'object') {\n\t\tthrow new ToolError('The object artifact provider only resolves object-store references', {\n\t\t\tcode: 'unsupported'\n\t\t})\n\t}\n}\n\nfunction artifactBytes(input: ArtifactsCreateInput): Uint8Array {\n\tconst bytes = input.encoding === 'base64' ? base64ToBytes(input.body) : utf8ToBytes(input.body)\n\tif (bytes.byteLength > MAX_ARTIFACT_CREATE_BYTES) {\n\t\tthrow new ToolError('Artifact body exceeds create limit', {\n\t\t\tcode: 'too_large',\n\t\t\tdetails: { max_bytes: MAX_ARTIFACT_CREATE_BYTES, content_length: bytes.byteLength }\n\t\t})\n\t}\n\treturn bytes\n}\n\nfunction textLines(text: string): string[] {\n\treturn text.split('\\n').map((line) => (line.endsWith('\\r') ? line.slice(0, -1) : line))\n}\n\nexport class ObjectArtifactsProvider implements ArtifactsClientOps {\n\treadonly #storage: S3Client\n\n\tconstructor(auth: ObjectArtifactsAuth, options: ObjectArtifactsProviderOptions = {}) {\n\t\tthis.#storage = new S3Client(auth.storage, options)\n\t}\n\n\tasync create(input: ArtifactsCreateInput): Promise<ArtifactsCreateOutput> {\n\t\tconst bytes = artifactBytes(input)\n\t\tconst mediaType = input.media_type ?? mediaTypeFromPath(input.filename ?? input.key)\n\t\tawait this.#storage.putBytes(input.key, bytes, mediaType)\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\tstore: 'object',\n\t\t\t\tkey: input.key,\n\t\t\t\tbyte_length: bytes.byteLength,\n\t\t\t\t...(mediaType && { media_type: mediaType }),\n\t\t\t\t...(input.filename && { filename: input.filename })\n\t\t\t})\n\t\t}\n\t}\n\n\tasync readRange(input: ArtifactsReadRangeInput): Promise<ArtifactsReadRangeOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst result = await this.#storage.getBytesRange(input.source.key, {\n\t\t\tstart_byte: input.start_byte,\n\t\t\tend_byte: input.end_byte\n\t\t})\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\tbody_base64: bytesToBase64(result.bytes),\n\t\t\tstart_byte: result.start_byte,\n\t\t\tend_byte: result.end_byte,\n\t\t\t...(result.total_bytes !== undefined && { total_bytes: result.total_bytes }),\n\t\t\t...(result.content_type && { media_type: result.content_type })\n\t\t}\n\t}\n\n\tasync readLines(input: ArtifactsReadLinesInput): Promise<ArtifactsReadLinesOutput> {\n\t\trequireObjectSource(input.source.store)\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: MAX_ARTIFACT_READ_BYTES })\n\t\tconst lines = textLines(bytesToUtf8(bytes))\n\t\treturn {\n\t\t\tsource: input.source,\n\t\t\ttext: lines.join('\\n'),\n\t\t\tstart_line: 1,\n\t\t\tend_line: lines.length,\n\t\t\ttotal_lines: lines.length\n\t\t}\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\trequireObjectSource(input.source.store)\n\t\tif (input.source.byte_length !== undefined && input.source.byte_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: input.source.byte_length }\n\t\t\t})\n\t\t}\n\n\t\tconst head = await this.#storage.head({ key: input.source.key })\n\t\tif (!head.exists) {\n\t\t\tthrow new ToolError('Artifact not found', { code: 'not_found' })\n\t\t}\n\t\tif (head.content_length !== undefined && head.content_length > input.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: input.max_bytes, content_length: head.content_length }\n\t\t\t})\n\t\t}\n\n\t\tconst bytes = await this.#storage.getBytes(input.source.key, { maxBytes: input.max_bytes })\n\t\treturn {\n\t\t\tartifact: artifactRefSchema.parse({\n\t\t\t\t...input.source,\n\t\t\t\t...(!input.source.media_type && head.content_type && { media_type: head.content_type }),\n\t\t\t\tbyte_length: bytes.byteLength\n\t\t\t}),\n\t\t\tbytes\n\t\t}\n\t}\n}\n","import { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport type {\n\tArtifactResolveInput,\n\tArtifactsAuth,\n\tArtifactsClientOps,\n\tArtifactsCreateInput,\n\tArtifactsReadLinesInput,\n\tArtifactsReadRangeInput,\n\tResolvedArtifact\n} from './contracts'\nimport { artifactResolveInputSchema, artifactsAuthSchema, resolvedArtifactSchema } from './contracts'\nimport { HostArtifactsProvider } from './providers/host'\nimport { ObjectArtifactsProvider } from './providers/object'\n\nfunction transportOptions(ctx: ToolContext) {\n\treturn {\n\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t...(ctx.signal && { signal: ctx.signal })\n\t}\n}\n\nfunction providerFor(auth: ArtifactsAuth, ctx: ToolContext): ArtifactsClientOps {\n\tswitch (auth.provider) {\n\t\tcase 'object':\n\t\t\treturn new ObjectArtifactsProvider(auth, transportOptions(ctx))\n\t\tcase 'host':\n\t\t\treturn new HostArtifactsProvider(auth)\n\t}\n}\n\nexport class ArtifactsClient implements ArtifactsClientOps {\n\treadonly #ops: ArtifactsClientOps\n\n\tconstructor(ops: ArtifactsClientOps) {\n\t\tthis.#ops = ops\n\t}\n\n\tstatic fromContext(ctx: ToolContext): ArtifactsClient {\n\t\tconst auth = requireAuth(ctx, artifactsAuthSchema)\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tstatic fromAuth(auth: ArtifactsAuth, ctx: ToolContext = {}): ArtifactsClient {\n\t\treturn new ArtifactsClient(providerFor(auth, ctx))\n\t}\n\n\tcreate(input: ArtifactsCreateInput) {\n\t\treturn this.#ops.create(input)\n\t}\n\n\treadRange(input: ArtifactsReadRangeInput) {\n\t\treturn this.#ops.readRange(input)\n\t}\n\n\treadLines(input: ArtifactsReadLinesInput) {\n\t\treturn this.#ops.readLines(input)\n\t}\n\n\tasync resolve(input: ArtifactResolveInput): Promise<ResolvedArtifact> {\n\t\tconst parsedInput = artifactResolveInputSchema.parse(input)\n\t\tconst output = resolvedArtifactSchema.parse(await this.#ops.resolve(parsedInput))\n\t\tif (output.bytes.byteLength > parsedInput.max_bytes) {\n\t\t\tthrow new ToolError('Artifact exceeds resolution limit', {\n\t\t\t\tcode: 'too_large',\n\t\t\t\tdetails: { max_bytes: parsedInput.max_bytes, content_length: output.bytes.byteLength }\n\t\t\t})\n\t\t}\n\t\treturn {\n\t\t\tartifact: {\n\t\t\t\t...output.artifact,\n\t\t\t\tbyte_length: output.bytes.byteLength\n\t\t\t},\n\t\t\tbytes: output.bytes\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { ArtifactsClient } from './client'\nimport {\n\tartifactsAuthSchema,\n\tartifactsCreateInputSchema,\n\tartifactsCreateOutputSchema,\n\tartifactsReadLinesInputSchema,\n\tartifactsReadLinesOutputSchema,\n\tartifactsReadRangeInputSchema,\n\tartifactsReadRangeOutputSchema\n} from './contracts'\n\nexport const artifactsCreateTool = defineTool({\n\tid: 'artifacts-create',\n\tname: 'createArtifact',\n\tdescription:\n\t\t'Persist small, already-serialized UTF-8 or base64 content and return its ArtifactRef. Use for raw bytes or text when no structured builder is required. Do not use this to invent DOCX, XLSX, PPTX, PDF, or image formats.',\n\tinputSchema: artifactsCreateInputSchema,\n\toutputSchema: artifactsCreateOutputSchema,\n\tsideEffect: 'write',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).create(input)\n})\n\nexport const artifactsReadRangeTool = defineTool({\n\tid: 'artifacts-read-range',\n\tname: 'readArtifactRange',\n\tdescription:\n\t\t'Read an explicit inclusive byte range from an existing ArtifactRef as base64. Use for bounded binary inspection or chunked transfer, not for understanding a supported document when a format-aware reader is available.',\n\tinputSchema: artifactsReadRangeInputSchema,\n\toutputSchema: artifactsReadRangeOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readRange(input)\n})\n\nexport const artifactsReadLinesTool = defineTool({\n\tid: 'artifacts-read-lines',\n\tname: 'readArtifactLines',\n\tdescription: 'Read the complete contents of a UTF-8 text artifact, bounded by the artifact read-size limit.',\n\tinputSchema: artifactsReadLinesInputSchema,\n\toutputSchema: artifactsReadLinesOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\texecute: async (input, ctx) => ArtifactsClient.fromContext(ctx).readLines(input)\n})\n\nexport const artifactsModule = defineModule({\n\tid: 'artifacts',\n\ttitle: 'Artifacts',\n\tdescription:\n\t\t'Persist small serialized content, inspect bounded byte ranges, and read UTF-8 text artifacts. ArtifactRef is the handoff between tools; structured document creation belongs to purpose-built builders.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: artifactsAuthSchema },\n\tcategories: ['storage', 'artifacts'],\n\tclassification: 'pii',\n\ttags: ['artifact-ref', 'object-store'],\n\ttools: [artifactsCreateTool, artifactsReadRangeTool, artifactsReadLinesTool]\n})\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@5ss/ai-tools",
-	"version": "3.0.3",
+	"version": "3.1.0",
 	"description": "Reusable AI tools with strict schemas and model-facing contracts. Define once; project to Node, edge, Mastra, AI SDK, TanStack AI, Cloudflare Workers AI, or MCP.",
 	"license": "MIT",
 	"author": "harryy",