@excitedjs/dreamux-utils 0.2.0 → 0.3.0-beta.100

package/dist/completion-body.d.ts

@@ -1,5 +1,5 @@
 /**
- * Neutral completion-body resolution shared by every runtime and the host.
+ * Neutral completion-body resolution shared by host-side completion targets.
  *
  * A teammate completion is delivered back to the dispatcher as turn text. When
  * the result is short it is inlined verbatim; when it overflows the inline
@@ -7,11 +7,10 @@
  * host-supplied spill directory and only the path is inlined, so a large result
  * never floods the dispatcher's context window.
  *
- * The spill directory is supplied by the caller (the host through its path
- * context, or a runtime through the create context), so this module owns no
- * Dreamux layout contract — only the safe filename shape inside that directory.
+ * The spill directory is supplied by the host-side caller, so this module owns
+ * no Dreamux layout contract — only the safe filename shape inside that
+ * directory.
  */
-import type { CompletionEnvelope } from '@excitedjs/dreamux-types';
 /**
  * Inline character budget, mirroring claude-code's native task-output budget
  * (`getMaxTaskOutputLength`): default 32000 chars, `TASK_MAX_OUTPUT_LENGTH`
@@ -26,14 +25,20 @@ export type ResolvedCompletionBody = {
     kind: 'spilled';
     path: string;
 };
+export interface CompletionBodyInput {
+    source: string;
+    id: string;
+    result: string | null;
+}
 /**
  * Spill file for a teammate completion result that overflows the inline budget.
- * Both runtimes write the full result here and inline only this path into the
- * dispatcher turn, so a large result never floods the dispatcher's context.
+ * The host writes the full result here and inlines only this path into the
+ * dispatcher or TeamLeader turn, so a large result never floods the target
+ * agent's context.
  * `spillDir` is the owning dispatcher's completion spill dir, supplied by the
- * caller so a teammate runtime spills under its operator dispatcher, not its
- * composite runtime id. `source` and `id` are sanitized for filename safety; the
- * id is unique per completion (teammate name + turn id).
+ * caller so a TeamLeader delivery target still spills under its operator
+ * dispatcher, not its composite runtime id. `source` and `id` are sanitized for
+ * filename safety; the id is unique per completion (teammate name + turn id).
  */
 export declare function teamMateCompletionOutputPath(spillDir: string, source: string, id: string): string;
 /**
@@ -52,5 +57,5 @@ export declare function completionInlineBudget(env?: NodeJS.ProcessEnv): number;
  * that path. `spillDir` is supplied by the caller, so this module stays
  * runtime-neutral and never names a dispatcher id.
  */
-export declare function resolveCompletionBody(completion: CompletionEnvelope, spillDir: string): Promise<ResolvedCompletionBody>;
+export declare function resolveCompletionBody(completion: CompletionBodyInput, spillDir: string): Promise<ResolvedCompletionBody>;
 //# sourceMappingURL=completion-body.d.ts.map

package/dist/completion-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion-body.d.ts","sourceRoot":"","sources":["../src/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAInE;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAGpD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAOtC;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAmC,GAC9C,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,kBAAkB,EAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAkBjC"}
+{"version":3,"file":"completion-body.d.ts","sourceRoot":"","sources":["../src/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,QAAS,CAAC;AACvD,eAAO,MAAM,4BAA4B,SAAU,CAAC;AAGpD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAOD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,GAAE,MAAM,CAAC,UAAmC,GAC9C,MAAM,CAUR;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}

package/dist/completion-body.js

@@ -1,5 +1,5 @@
 /**
- * Neutral completion-body resolution shared by every runtime and the host.
+ * Neutral completion-body resolution shared by host-side completion targets.
  *
  * A teammate completion is delivered back to the dispatcher as turn text. When
  * the result is short it is inlined verbatim; when it overflows the inline
@@ -7,9 +7,9 @@
  * host-supplied spill directory and only the path is inlined, so a large result
  * never floods the dispatcher's context window.
  *
- * The spill directory is supplied by the caller (the host through its path
- * context, or a runtime through the create context), so this module owns no
- * Dreamux layout contract — only the safe filename shape inside that directory.
+ * The spill directory is supplied by the host-side caller, so this module owns
+ * no Dreamux layout contract — only the safe filename shape inside that
+ * directory.
  */
 import { chmod, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
@@ -28,12 +28,13 @@ function safeSegment(name) {
 }
 /**
  * Spill file for a teammate completion result that overflows the inline budget.
- * Both runtimes write the full result here and inline only this path into the
- * dispatcher turn, so a large result never floods the dispatcher's context.
+ * The host writes the full result here and inlines only this path into the
+ * dispatcher or TeamLeader turn, so a large result never floods the target
+ * agent's context.
  * `spillDir` is the owning dispatcher's completion spill dir, supplied by the
- * caller so a teammate runtime spills under its operator dispatcher, not its
- * composite runtime id. `source` and `id` are sanitized for filename safety; the
- * id is unique per completion (teammate name + turn id).
+ * caller so a TeamLeader delivery target still spills under its operator
+ * dispatcher, not its composite runtime id. `source` and `id` are sanitized for
+ * filename safety; the id is unique per completion (teammate name + turn id).
  */
 export function teamMateCompletionOutputPath(spillDir, source, id) {
     return join(spillDir, `teammate-${safeSegment(source)}-${safeSegment(id)}.output`);
@@ -65,9 +66,10 @@ export function completionInlineBudget(env = globalThis.process.env) {
  * runtime-neutral and never names a dispatcher id.
  */
 export async function resolveCompletionBody(completion, spillDir) {
+    const result = completion.result ?? '';
     const budget = completionInlineBudget();
-    if (completion.result.length <= budget) {
-        return { kind: 'inline', text: completion.result };
+    if (result.length <= budget) {
+        return { kind: 'inline', text: result };
     }
     const path = teamMateCompletionOutputPath(spillDir, completion.source, completion.id);
     // Owner-only spill dir: the cache may hold full teammate output. Use the
@@ -75,7 +77,7 @@ export async function resolveCompletionBody(completion, spillDir) {
     // foreign-uid dir is rejected (issue #182 — same invariant as the run tree),
     // then a 0600 file + explicit chmod (writeFile's `mode` honors the umask).
     await ensureOwnerOnlyDir(spillDir);
-    await writeFile(path, completion.result, { mode: 0o600 });
+    await writeFile(path, result, { mode: 0o600 });
     await chmod(path, 0o600);
     return { kind: 'spilled', path };
 }

package/dist/completion-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"completion-body.js","sourceRoot":"","sources":["../src/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AACpD,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAM9D,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAgB,EAChB,MAAc,EACd,EAAU;IAEV,OAAO,IAAI,CAAC,QAAQ,EAAE,YAAY,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AACrF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB,UAAU,CAAC,OAAO,CAAC,GAAG;IAE/C,MAAM,GAAG,GAAG,GAAG,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAA8B,EAC9B,QAAgB;IAEhB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,IAAI,GAAG,4BAA4B,CACvC,QAAQ,EACR,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,EAAE,CACd,CAAC;IACF,yEAAyE;IACzE,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"completion-body.js","sourceRoot":"","sources":["../src/completion-body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,MAAM,CAAC;AACvD,MAAM,CAAC,MAAM,4BAA4B,GAAG,OAAO,CAAC;AACpD,MAAM,4BAA4B,GAAG,wBAAwB,CAAC;AAY9D,uDAAuD;AACvD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,QAAgB,EAChB,MAAc,EACd,EAAU;IAEV,OAAO,IAAI,CAAC,QAAQ,EAAE,YAAY,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;AACrF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAyB,UAAU,CAAC,OAAO,CAAC,GAAG;IAE/C,MAAM,GAAG,GAAG,GAAG,CAAC,4BAA4B,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAA+B,EAC/B,QAAgB;IAEhB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,GAAG,4BAA4B,CACvC,QAAQ,EACR,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,EAAE,CACd,CAAC;IACF,yEAAyE;IACzE,8EAA8E;IAC9E,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excitedjs/dreamux-utils",
-  "version": "0.2.0",
+  "version": "0.3.0-beta.100",
   "description": "Pure shared utilities for Dreamux providers and host: neutral config-validation primitives, OS/filesystem helpers, completion-body resolution, and inbound-turn render helpers. Depends on @excitedjs/dreamux-types only, never on @excitedjs/dreamux core (issue excitedjs/dreamux#209).",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@excitedjs/dreamux-types": "0.2.0"
+    "@excitedjs/dreamux-types": "0.3.0-beta.100"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",