@sleep2agi/agent-network 2.3.0-preview.4 → 2.3.0-preview.41

package/dist/src/im/types.d.ts

@@ -72,13 +72,42 @@ export interface NormalizedIMEvent {
     mentioned: boolean;
     content: {
         text?: string;
-        /** Local filesystem paths to already-downloaded images. */
+        /** Local filesystem paths to already-downloaded images.
+         *
+         *  RFC-020 §17 backward-compat shim: the new richer
+         *  `attachments[]` field below is the canonical source going
+         *  forward. `images` stays a `string[]` of paths so an older
+         *  agent-node worker reading this envelope across a rolling
+         *  upgrade doesn't crash. New workers prefer `attachments`,
+         *  old workers ignore it and keep using `images`. */
         images?: string[];
         files?: {
             name: string;
             path?: string;
             url?: string;
         }[];
+        /** RFC-020 §17 cross-machine attachment descriptors.
+         *
+         *  Each entry mirrors `meta.attachments[]` on commhub tasks
+         *  (`{ type, file_id?, path?, mime?, name?, size? }`). The
+         *  feishu bridge populates `file_id` by uploading inbound
+         *  files to `/api/upload` so cross-host agents delegated via
+         *  `commhub_send_task(meta.attachments=...)` can fetch via
+         *  `/api/files/<id>`. When upload fails, `file_id` is absent
+         *  and the descriptor degrades to path-only (single-host
+         *  still works via local Read; no regression vs pre-fix
+         *  baseline).
+         *
+         *  Always populated alongside `images` for the same files —
+         *  duplication is intentional for rolling-upgrade safety. */
+        attachments?: Array<{
+            type: "image" | "file";
+            path?: string;
+            file_id?: string;
+            mime?: string;
+            name?: string;
+            size?: number;
+        }>;
     };
     /**
      * Original platform payload. Default: held in memory only and dropped after
@@ -115,6 +144,14 @@ export interface NormalizedIMMessage {
     replyToMessageId?: string;
     /** Ephemeral / visible-to-sender-only. Slack only; others ignore. */
     ephemeral?: boolean;
+    /** Caption-mode hint (RFC-020 §15.2): bypass markdown-card / markdown→PNG
+     *  rendering and send as plain text. Set by the bridge when the same
+     *  dispatch loop is also sending one or more attachment files — the text
+     *  is a caption ("here's the report"), not the deliverable. Without this
+     *  hint, Vincent's "make me a PDF" UAT had the bot's accompanying
+     *  description heading + bullet list rendered to PNG via #329, which
+     *  read as "you sent another image" instead of "you sent my file". */
+    forceTextOnly?: boolean;
     /** Tie back to the commhub task that produced this message. */
     correlation: {
         taskId: string;

package/dist/src/locale-diagnostic.d.ts

@@ -0,0 +1,12 @@
+export interface LocaleDiagnostic {
+    effectiveVariable: "LC_ALL" | "LC_CTYPE" | "LANG" | null;
+    effectiveValue: string | null;
+    shouldWarn: boolean;
+}
+/**
+ * Resolve the locale with the same precedence used by POSIX libc. Windows
+ * does not use these variables as its process Unicode boundary, so prescribing
+ * a POSIX locale there would be misleading.
+ */
+export declare function diagnoseLocale(env: Readonly<Record<string, string | undefined>>, platform: string): LocaleDiagnostic;
+export declare function formatLocaleSource(diagnostic: LocaleDiagnostic): string;

package/dist/src/mock-llm.d.ts

@@ -0,0 +1,12 @@
+export declare const MOCK_LLM_FALLBACK = "(mock LLM: no rule matched)";
+export type MockLlmRule = Readonly<{
+    in_substring: string;
+    out: string;
+}>;
+export type MockLlmResolution = Readonly<{
+    reply: string;
+    matched: boolean;
+    ruleIndex: number | null;
+}>;
+export declare function loadMockLlmRules(path: string): readonly MockLlmRule[];
+export declare function resolveMockLlmReply(rules: readonly MockLlmRule[], prompt: string, warn?: (message: string) => void): MockLlmResolution;