@amalgm/chat 0.2.9-preview.34938476986 → 0.2.9-preview.34940997223

package/PURPOSE.md

@@ -180,6 +180,8 @@ automations, and third-party apps must all use the same public SDK.
 43. Attachment bytes belong to the accepted ACP prompt. A native adapter that
     needs a filesystem path receives a host materialization of those bytes;
     that derived file is never the durable source of truth.
+    Every attachment reaches the model as native content or an explicit readable
+    reference; provider routing metadata cannot replace prompt content.
 44. A managed provider home belongs to one installation and one auth authority.
     Child environments contain standard process and network settings plus
     explicitly prepared credentials; they never inherit host service secrets.
@@ -210,6 +212,8 @@ automations, and third-party apps must all use the same public SDK.
     idempotency key and retried until acknowledged. Platform usage is metered and
     persisted by the API proxy for each upstream invocation; local observations
     cannot create a second charge. The authenticated host supplies ownership.
+    Delivery starts only with a complete host-supplied platform capability;
+    absent delivery configuration leaves measurements pending and local Chat usable.
 49. Only commands with an explicit Amalgm normalization may be advertised or
     executed. Native discovery is evidence, never execution permission. The only
     enabled command is `/compact`, on adapters with a proven compaction mapping;

package/docs/contracts/input-and-execution.md

@@ -152,7 +152,7 @@ the final native boundary:
 | Adapter | Native projection |
 | --- | --- |
 | ACP / Cursor | ACP content blocks unchanged after capability validation |
-| Codex | text, URL/base64 image or audio, local image/audio, or file mention |
+| Codex | text, URL/base64 image or audio, local image/audio, or readable file references in text |
 | Claude Code | structured text, image, plain-text document, or PDF blocks |
 | OpenCode | text and URL/data-URL file parts |
 | Pi | text plus its RPC image channel |

package/host/adapters/prompt.js

@@ -77,7 +77,9 @@ export function codexPromptInput(prompt) {
       if (!file) return [{ type: 'text', text: linkedText(part) }];
       if (mime.startsWith('image/')) return [{ type: 'localImage', path: file }];
       if (mime.startsWith('audio/')) return [{ type: 'localAudio', path: file }];
-      return [{ type: 'mention', name: resourceName(part), path: file }];
+      // Codex mentions select provider integrations; they do not put an
+      // arbitrary file reference into the model's user message.
+      return [{ type: 'text', text: linkedText(part) }];
     }
     if (part.type === 'resource') {
       const mime = mimeOf(part);

package/host/index.js

@@ -31,9 +31,10 @@ export async function createChatHost(options) {
       : options.journalBatch || createSqliteJournalBatchPolicy(),
   });
   const recoveredTurns = await chat.recoverInterruptedTurns();
-  const usageDelivery = options.native?.credentialBroker && typeof conversations.pendingUsage === 'function'
+  const proxy = runtime.preparer?.platformProxy({ required: false });
+  const usageDelivery = proxy && typeof conversations.pendingUsage === 'function'
     ? createUsageDelivery({ store: conversations, ownerUserId: options.ownerUserId,
-      proxy: runtime.preparer.platformProxy() }) : null;
+      proxy }) : null;
   const handleHttp = createChatHttpHandler({
     chat,
     ...(typeof runtime.forwardEgress === 'function'

package/host/native-contract.js

@@ -188,8 +188,9 @@ export class NativeExecutionPreparer {
     });
   }
 
-  platformProxy() {
+  platformProxy({ required = true } = {}) {
     if (!this.proxyBaseUrl || !this.credentialBroker) {
+      if (!required) return null;
       throw new InvalidPreparedAuthError('Platform proxy is not configured');
     }
     return Object.freeze({ baseUrl: this.proxyBaseUrl, credentialBroker: this.credentialBroker });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/chat",
-  "version": "0.2.9-preview.34938476986",
+  "version": "0.2.9-preview.34940997223",
   "description": "A provider-agnostic agent chat SDK with ACP content, prepared execution, normalized streams, and usage.",
   "type": "module",
   "license": "UNLICENSED",
@@ -118,11 +118,11 @@
   "allowScripts": {
     "better-sqlite3@12.11.1": true
   },
-  "gitHead": "a64d4e38ac36ae5a6ba67f1d82680522356ebe24",
+  "gitHead": "7cabb01fd99650e5e16a9160ae4470fd70a68e45",
   "amalgmSource": {
     "repository": "amalgm-inc/amalgm-chat",
     "branch": "preview",
-    "commit": "a64d4e38ac36ae5a6ba67f1d82680522356ebe24",
-    "occurrence": "34938476986"
+    "commit": "7cabb01fd99650e5e16a9160ae4470fd70a68e45",
+    "occurrence": "34940997223"
   }
 }