@tangle-network/sdk-provider-cli-base 0.0.0-stage → 0.12.0

package/dist/prompt-input-BHn_1z69.d.mts

@@ -0,0 +1,73 @@
+import { InputPart } from "@tangle-network/agent-interface";
+import { MessagePart } from "@tangle-network/sdk-session-persistence";
+
+//#region src/prompt-input.d.ts
+/** A structured, provider-agnostic view of one materialized attachment,
+ *  handed to `buildExecArgs` alongside the rendered prompt text so an
+ *  adapter can deliver it natively (argv flag / stdin content block)
+ *  instead of relying on the `[Image: ...]` / `[File: ...]` text marker. */
+interface PreparedAttachment {
+  kind: "image" | "file";
+  /** Absolute local path when the attachment is materialized on disk. */
+  path?: string;
+  /** http(s) URL when the part is a remote reference (no local file). */
+  url?: string;
+  /** Base64 payload of the materialized file — pre-read here so synchronous
+   *  buildExecArgs implementations never touch the fs. Populated ONLY when
+   *  the adapter declares "image" in nativeAttachmentKinds (the marker-only
+   *  default never reads files). Undefined for remote urls, non-regular or
+   *  unreadable caller-supplied paths, images over MAX_INLINE_IMAGE_BYTES,
+   *  and once the per-request inline budget is spent — those fall back to
+   *  path-based delivery. */
+  base64?: string;
+  mediaType?: string;
+  filename: string;
+  /** The exact `[Image: <ref>]` / `[File: <ref>]` fallback marker text. */
+  marker: string;
+}
+/** Raw-byte ceiling for inlining one image as base64 (~1.33x expansion in
+ *  memory and on the wire); larger images keep only their `path` and the
+ *  adapter falls back to path-based delivery. */
+declare const MAX_INLINE_IMAGE_BYTES: number;
+/** Aggregate raw-byte budget for inlined images across one request's parts —
+ *  the request schema admits up to 64 parts, so a per-image cap alone would
+ *  still let one request hold hundreds of MB of base64 until execution. */
+declare const MAX_TOTAL_INLINE_IMAGE_BYTES: number;
+declare function preparePromptInputParts(parts: InputPart[], workspaceRoot: string, sessionId: string, options?: {
+  nativeAttachmentKinds?: ReadonlyArray<"image" | "file">; /** Override of MAX_TOTAL_INLINE_IMAGE_BYTES for this request. */
+  inlineImageBudgetBytes?: number;
+}): Promise<{
+  promptText: string;
+  persistedParts: MessagePart[];
+  attachments: PreparedAttachment[];
+}>;
+/**
+ * Partition a turn's image attachments into the ones the adapter will
+ * forward natively and the "stranded" rest, folding each stranded image's
+ * `[Image: ...]` marker back into the message text. Once an adapter's
+ * nativeAttachmentKinds() claims "image", the base prompt renderer omits
+ * every image marker — so any image the mechanism can't carry (no base64
+ * for a stdin block, no local path for an argv flag, beyond a single-path
+ * flag's capacity) MUST re-enter the prompt here or the model never sees
+ * a reference to it. Uses the same "Attached files:" block format the
+ * renderer itself emits for non-native kinds.
+ */
+declare function partitionImageAttachments(options: {
+  message: string;
+  attachments?: ReadonlyArray<PreparedAttachment>; /** Does this attachment qualify for the adapter's native mechanism? */
+  qualifies: (attachment: PreparedAttachment) => boolean; /** Cap on natively-forwarded images (e.g. 1 for a single-path argv flag). */
+  maxNative?: number;
+}): {
+  native: PreparedAttachment[];
+  message: string;
+};
+/** Separates the sections a harness receives as one user message. */
+declare const PROMPT_SECTION_SEPARATOR = "\n\n---\n\n";
+/**
+ * Puts `section` (a system prompt or replayed context) ahead of the message
+ * for harnesses that take no separate channel for it.
+ */
+declare function prependPromptSection(section: string | undefined, body: string): string;
+//#endregion
+export { partitionImageAttachments as a, PreparedAttachment as i, MAX_TOTAL_INLINE_IMAGE_BYTES as n, preparePromptInputParts as o, PROMPT_SECTION_SEPARATOR as r, prependPromptSection as s, MAX_INLINE_IMAGE_BYTES as t };
+//# sourceMappingURL=prompt-input-BHn_1z69.d.mts.map

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@tangle-network/sdk-provider-cli-base",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.12.0",
+  "description": "Base adapter for CLI-based AI agent providers",
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    },
+    "./conformance": {
+      "import": "./dist/conformance/index.mjs",
+      "types": "./dist/conformance/index.d.mts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@tangle-network/agent-core": "^1.0.0",
+    "@tangle-network/agent-interface": "^5.9.0",
+    "@tangle-network/agent-profile-materialize": "1.0.2",
+    "@tangle-network/cli-agent-registry": "0.14.0",
+    "@tangle-network/sdk-cli-runner": "0.3.0",
+    "@tangle-network/sdk-session-persistence": "0.7.0",
+    "zod": "4.6.6"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "~2.5.15",
+    "@types/node": "^25.9.9",
+    "tsdown": "^0.21.10",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "tangleRelease": {
+    "sourceSha": "0f6ba1deca15d9e117553eae67ff01cae6425004",
+    "mergedAt": "2026-10-27T04:36:51-06:00"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "lint": "biome check --write .",
+    "check-types": "node ../../scripts/tsc-native.mjs --noEmit"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.