@inhuman.tools/env-capability-module-prompt 0.0.0-stage → 0.2.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/bundle.d.ts

@@ -0,0 +1,33 @@
+/**
+ * One rendered `.prompt` call, and the host port for an isolated completion.
+ * A ProgrammaticJob parents an omitted-spec AgentCallJob instead of calling the port.
+ */
+import type { ReasoningEffort } from "@inhuman.tools/env-capability-dotprompt";
+import type { CompletionExpectation, PromptMessageRole } from "@inhuman.tools/harness-model";
+/** Session/research intern port. Homed `round` is mutated in place. `responseSchemaJson` is the serialized schema, matching CompleteFields. */
+export type PromptCompleteRequest = {
+    readonly connectionId: string;
+    readonly model: string;
+    readonly promptText?: string;
+    readonly responseSchemaJson?: string;
+    readonly signal?: AbortSignal;
+    readonly round: CompletionExpectation;
+};
+export type PromptComplete = (req: PromptCompleteRequest) => Promise<{
+    readonly text: string;
+    readonly thought?: string;
+    readonly thoughtKind?: string;
+}>;
+export declare class RenderedPrompt {
+    readonly model: string | null;
+    readonly reasoningEffort: ReasoningEffort | null;
+    readonly responseSchema: Record<string, unknown> | null;
+    readonly faceName: string;
+    /** Null inherits the caller catalog; an empty list is an explicit empty overlay. */
+    readonly tools: readonly string[] | null;
+    readonly messages: readonly [PromptMessageRole, string][];
+    constructor(model: string | null, reasoningEffort: ReasoningEffort | null, responseSchema: Record<string, unknown> | null, faceName: string, 
+    /** Null inherits the caller catalog; an empty list is an explicit empty overlay. */
+    tools: readonly string[] | null, messages: readonly [PromptMessageRole, string][]);
+}
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE7F,+IAA+I;AAC/I,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAC3B,GAAG,EAAE,qBAAqB,KACvB,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAElG,qBAAa,cAAc;aAEP,KAAK,EAAE,MAAM,GAAG,IAAI;aACpB,eAAe,EAAE,eAAe,GAAG,IAAI;aACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;aAC9C,QAAQ,EAAE,MAAM;IAChC,oFAAoF;aACpE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;aAC/B,QAAQ,EAAE,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE;gBANhD,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,eAAe,EAAE,eAAe,GAAG,IAAI,EACvC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC9C,QAAQ,EAAE,MAAM;IAChC,oFAAoF;IACpE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,EAC/B,QAAQ,EAAE,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAAE;CAEnE"}

package/dist/bundle.js

@@ -0,0 +1,19 @@
+export class RenderedPrompt {
+    model;
+    reasoningEffort;
+    responseSchema;
+    faceName;
+    tools;
+    messages;
+    constructor(model, reasoningEffort, responseSchema, faceName, 
+    /** Null inherits the caller catalog; an empty list is an explicit empty overlay. */
+    tools, messages) {
+        this.model = model;
+        this.reasoningEffort = reasoningEffort;
+        this.responseSchema = responseSchema;
+        this.faceName = faceName;
+        this.tools = tools;
+        this.messages = messages;
+    }
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,cAAc;IAEP;IACA;IACA;IACA;IAEA;IACA;IAPlB,YACkB,KAAoB,EACpB,eAAuC,EACvC,cAA8C,EAC9C,QAAgB;IAChC,oFAAoF;IACpE,KAA+B,EAC/B,QAAgD;QANhD,UAAK,GAAL,KAAK,CAAe;QACpB,oBAAe,GAAf,eAAe,CAAwB;QACvC,mBAAc,GAAd,cAAc,CAAgC;QAC9C,aAAQ,GAAR,QAAQ,CAAQ;QAEhB,UAAK,GAAL,KAAK,CAA0B;QAC/B,aAAQ,GAAR,QAAQ,CAAwC;IAC/D,CAAC;CACL"}

package/dist/dotprompt.d.ts

@@ -0,0 +1,6 @@
+import { type ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+import { RenderedPrompt } from "./bundle.js";
+export declare function renderPrompt(spec: ParsedPrompt, args: readonly unknown[]): RenderedPrompt;
+/** Both prompt hosts install this prelude. Require parses once and closes over the spec. */
+export declare const promptPrelude = "(define (ext/prompt/resolve contents)\n  (let ((spec (dotprompt/parse (if (bytevector? contents) (utf8->string contents) contents)\n                               \"anonymous.prompt\")))\n    ;; apply would run dotprompt/run under the lists capability's context.\n    (lambda args\n      (dotprompt/run spec args))))\n(require/register-extension \".prompt\" ext/prompt/resolve)";
+//# sourceMappingURL=dotprompt.d.ts.map

package/dist/dotprompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotprompt.d.ts","sourceRoot":"","sources":["../src/dotprompt.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,YAAY,EAAyB,MAAM,yCAAyC,CAAC;AAKlH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAO7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,CAoDzF;AAED,4FAA4F;AAC5F,eAAO,MAAM,aAAa,8XAMgC,CAAC"}

package/dist/dotprompt.js

@@ -0,0 +1,67 @@
+/**
+ * Render both prompt hosts call, and the prelude they install.
+ * `dotprompt/parse` is `dotpromptCapability`.
+ */
+import { toJS } from "@here.build/arrival";
+import { compileTemplate, runCompiledTemplate } from "@here.build/arrival-modules/handlebars";
+import { isPlainRecord, reasoningEffortSchema } from "@inhuman.tools/env-capability-dotprompt";
+import invariant from "tiny-invariant";
+import { z } from "zod";
+import { RenderedPrompt } from "./bundle.js";
+const promptMeta = z.object({
+    model: z.string().optional(),
+    reasoningEffort: reasoningEffortSchema.optional(),
+});
+export function renderPrompt(spec, args) {
+    let pairs = args;
+    let positional;
+    if (pairs.length > 0) {
+        const head = String(pairs[0]);
+        if (!(head.startsWith(":") || head.startsWith("':"))) {
+            positional = pairs[0];
+            pairs = pairs.slice(1);
+        }
+    }
+    const folded = {};
+    if (pairs.length > 0) {
+        invariant(pairs.length % 2 === 0, "kwargs: needs an even number of trailing args (alternating :key value pairs)");
+        for (let i = 0; i < pairs.length; i += 2) {
+            folded[String(pairs[i]).replace(/^'?:/, "")] = toJS(pairs[i + 1]);
+        }
+    }
+    let inputs;
+    let meta;
+    if (positional !== undefined) {
+        const value = toJS(positional);
+        if (isPlainRecord(value) && Object.keys(folded).length === 0) {
+            const metaRaw = isPlainRecord(value.meta) ? value.meta : {};
+            const { meta: _meta, key: _key, ...rest } = value;
+            inputs = rest;
+            meta = promptMeta.parse(metaRaw);
+        }
+        else if (folded.evidence === undefined) {
+            folded.evidence = value;
+        }
+    }
+    if (inputs === undefined || meta === undefined) {
+        const metaRaw = isPlainRecord(folded.meta) ? folded.meta : {};
+        const { meta: _metaSlot, key: _keySlot, ...rest } = folded;
+        inputs = rest;
+        meta = promptMeta.parse(metaRaw);
+    }
+    const rendered = spec.sections.map((section) => [
+        section.role,
+        runCompiledTemplate(compileTemplate(section.source), [inputs]),
+    ]);
+    const model = [meta.model, spec.model].find((candidate) => typeof candidate === "string" && candidate !== "") ?? null;
+    return new RenderedPrompt(model, meta.reasoningEffort ?? spec.reasoningEffort, spec.responseSchema, spec.faceName, spec.tools, spec.mode === "instruct" ? [["user", rendered.map(([, content]) => content).join("\n\n")]] : rendered);
+}
+/** Both prompt hosts install this prelude. Require parses once and closes over the spec. */
+export const promptPrelude = `(define (ext/prompt/resolve contents)
+  (let ((spec (dotprompt/parse (if (bytevector? contents) (utf8->string contents) contents)
+                               "anonymous.prompt")))
+    ;; apply would run dotprompt/run under the lists capability's context.
+    (lambda args
+      (dotprompt/run spec args))))
+(require/register-extension ".prompt" ext/prompt/resolve)`;
+//# sourceMappingURL=dotprompt.js.map

package/dist/dotprompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dotprompt.js","sourceRoot":"","sources":["../src/dotprompt.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type PromptComplete, RenderedPrompt } from "./bundle.js";
+export { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+export { promptIsolatedCapability } from "./run-isolated.js";
+export { promptProgramCapability } from "./run-program.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { RenderedPrompt } from "./bundle.js";
+export { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+export { promptIsolatedCapability } from "./run-isolated.js";
+export { promptProgramCapability } from "./run-program.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,cAAc,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/run-isolated.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Isolated host for `.prompt`. `dotprompt/run` performs one completion
+ * on the configured job (compact, classifier).
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { Job } from "@inhuman.tools/plexus-expectations";
+import { z } from "zod";
+export declare const promptIsolatedCapability: EnvCapability<{
+    job: z.ZodCustom<Job<unknown, unknown>, Job<unknown, unknown>>;
+    connectionId: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    /** Session/judge model. `model` is reserved by some exec hosts. */
+    completionModel: z.ZodOptional<z.ZodString>;
+}, Record<string, never>>;
+//# sourceMappingURL=run-isolated.d.ts.map

package/dist/run-isolated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-isolated.d.ts","sourceRoot":"","sources":["../src/run-isolated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AAEzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,wBAAwB;;;;IAUjC,mEAAmE;;yBAqCrE,CAAC"}

package/dist/run-isolated.js

@@ -0,0 +1,53 @@
+/**
+ * Isolated host for `.prompt`. `dotprompt/run` performs one completion
+ * on the configured job (compact, classifier).
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { arrivalLoaderCapability } from "@here.build/arrival-modules";
+import { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+import { CompletionExpectation, CompletionJob, ProgrammaticJob, PromptMessage } from "@inhuman.tools/harness-model";
+import { Job } from "@inhuman.tools/plexus-expectations";
+import invariant from "tiny-invariant";
+import { z } from "zod";
+import { promptPrelude, renderPrompt } from "./dotprompt.js";
+export const promptIsolatedCapability = EnvCapability.define("ext/prompt/isolated", {
+    deps: [dotpromptCapability, arrivalLoaderCapability],
+    configuration: {
+        job: z.instanceof(Job).refine((job) => !(job instanceof ProgrammaticJob), {
+            error: "dotprompt/run: a program uses promptProgramCapability",
+        }),
+        connectionId: z
+            .string({ error: "dotprompt/run: connectionId is required" })
+            .refine((value) => value !== "", { error: "dotprompt/run: connectionId is required" }),
+        model: z.string().optional(),
+        /** Session/judge model. `model` is reserved by some exec hosts. */
+        completionModel: z.string().optional(),
+    },
+    symbols: (symbol, sz) => ({
+        "dotprompt/run": symbol.rosetta `dotprompt/run: completes the rendered prompt in isolation`({
+            input: [sz.box.pipe(z.instanceof(ParsedPrompt)), sz.list(sz.dynamic)],
+            output: [sz.dynamic],
+            provenance: "source",
+            requiresConfig: ["job"],
+        }, async function (spec, args) {
+            const bundle = renderPrompt(spec, args);
+            // Render overlays :meta, then the file model. The host model is appended here.
+            const model = [bundle.model, this.configuration.completionModel, this.configuration.model].find((candidate) => typeof candidate === "string" && candidate !== "") ?? null;
+            invariant(model != null, "dotprompt/run: model is required");
+            // The session orchestrator drives the CompletionJob. Await reads its result.
+            return await this.configuration.job.registerJob(new CompletionJob({
+                expectation: new CompletionExpectation({
+                    connectionId: this.configuration.connectionId,
+                    model,
+                    responseSchema: bundle.responseSchema,
+                    completionMode: "isolated",
+                    promptMessages: bundle.messages.map(([role, content]) => new PromptMessage({ role, content })),
+                    reasoningEffort: bundle.reasoningEffort,
+                }),
+                turnTail: this.configuration.job,
+            }));
+        }),
+    }),
+    prelude: promptPrelude,
+});
+//# sourceMappingURL=run-isolated.js.map

package/dist/run-isolated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-isolated.js","sourceRoot":"","sources":["../src/run-isolated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACpH,OAAO,EAAE,GAAG,EAAE,MAAM,oCAAoC,CAAC;AACzD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC,MAAM,CAAC,qBAAqB,EAAE;IAClF,IAAI,EAAE,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;IACpD,aAAa,EAAE;QACb,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,eAAe,CAAC,EAAE;YACxE,KAAK,EAAE,uDAAuD;SAC/D,CAAC;QACF,YAAY,EAAE,CAAC;aACZ,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;aAC5D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;QACxF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC5B,mEAAmE;QACnE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC;IACD,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC,OAAO,CAAA,2DAA2D,CACxF;YACE,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACrE,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC;YACpB,UAAU,EAAE,QAAQ;YACpB,cAAc,EAAE,CAAC,KAAK,CAAC;SACxB,EACD,KAAK,WAAW,IAAI,EAAE,IAAI;YACxB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,+EAA+E;YAC/E,MAAM,KAAK,GACT,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,eAAe,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAC/E,CAAC,SAAS,EAAuB,EAAE,CAAC,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,EAAE,CACtF,IAAI,IAAI,CAAC;YACZ,SAAS,CAAC,KAAK,IAAI,IAAI,EAAE,kCAAkC,CAAC,CAAC;YAC7D,6EAA6E;YAC7E,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAC7C,IAAI,aAAa,CAAC;gBAChB,WAAW,EAAE,IAAI,qBAAqB,CAAC;oBACrC,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY;oBAC7C,KAAK;oBACL,cAAc,EAAE,MAAM,CAAC,cAAc;oBACrC,cAAc,EAAE,UAAU;oBAC1B,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC9F,eAAe,EAAE,MAAM,CAAC,eAAe;iBACxC,CAAC;gBACF,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG;aACjC,CAAC,CACH,CAAC;QACJ,CAAC,CACF;KACF,CAAC;IACF,OAAO,EAAE,aAAa;CACvB,CAAC,CAAC"}

package/dist/run-program.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Program host for `.prompt`. `dotprompt/run` parents an omitted-spec
+ * AgentCallJob on the ProgrammaticJob and waits for the worker.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { ProgrammaticJob } from "@inhuman.tools/harness-model";
+import { z } from "zod";
+export declare const promptProgramCapability: EnvCapability<{
+    job: z.ZodCustom<ProgrammaticJob, ProgrammaticJob>;
+    readonly: z.ZodDefault<z.ZodBoolean>;
+}, Record<string, never>>;
+//# sourceMappingURL=run-program.d.ts.map

package/dist/run-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-program.d.ts","sourceRoot":"","sources":["../src/run-program.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAML,eAAe,EAGhB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB;;;yBAsDlC,CAAC"}

package/dist/run-program.js

@@ -0,0 +1,69 @@
+/**
+ * Program host for `.prompt`. `dotprompt/run` parents an omitted-spec
+ * AgentCallJob on the ProgrammaticJob and waits for the worker.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { arrivalLoaderCapability } from "@here.build/arrival-modules";
+import { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+import { AgentCallJob, claimCrossing, crossingPending, crossingWindow, isReplaying, ProgrammaticJob, PromptMessage, takeCrossing, } from "@inhuman.tools/harness-model";
+import { runInAction, when } from "mobx";
+import { z } from "zod";
+import { promptPrelude, renderPrompt } from "./dotprompt.js";
+const AGENT_ASK = "agent__ask";
+export const promptProgramCapability = EnvCapability.define("ext/prompt/program", {
+    deps: [dotpromptCapability, arrivalLoaderCapability],
+    configuration: {
+        job: z.instanceof(ProgrammaticJob),
+        readonly: z.boolean().default(false),
+    },
+    symbols: (symbol, sz) => ({
+        "dotprompt/run": symbol.rosetta `dotprompt/run: parents an omitted-spec AgentCallJob on the program and waits`({
+            input: [sz.box.pipe(z.instanceof(ParsedPrompt)), sz.list(sz.dynamic)],
+            output: [sz.dynamic],
+            provenance: "source",
+            requiresConfig: ["job"],
+        }, async function (spec, args) {
+            const bundle = renderPrompt(spec, args);
+            const job = this.configuration.job;
+            const emission = this.runCtx.emission;
+            const path = job.trackMatch && emission != null ? claimCrossing(emission, crossingWindow(this)) : "";
+            if (path !== "" && emission != null) {
+                let existing = takeCrossing(job, emission, path);
+                if (existing == null && isReplaying(emission)) {
+                    if (!job.completed && !job.cancelled) {
+                        const joined = when(() => job.completed || job.cancelled || crossingPending(job, emission, path));
+                        try {
+                            await joined;
+                        }
+                        finally {
+                            joined.cancel();
+                        }
+                    }
+                    existing = takeCrossing(job, emission, path);
+                    if (existing == null)
+                        throw new Error("replay: no recorded dotprompt/run");
+                }
+                if (existing != null)
+                    return await existing;
+            }
+            const minted = new AgentCallJob({
+                toolCallId: `${job.toolCallId}:prompt:${job.children.length + 1}`,
+                name: AGENT_ASK,
+                argsJson: "{}",
+                voidLegal: false,
+                readonly: this.configuration.readonly === true,
+                responseSchema: bundle.responseSchema,
+                promptMessages: bundle.messages.map(([role, content]) => new PromptMessage({ role, content })),
+                faceName: bundle.faceName.trim(),
+                tools: bundle.tools ?? [],
+                inheritCallerTools: bundle.tools === null,
+                reasoningEffort: bundle.reasoningEffort,
+            });
+            if (path !== "")
+                runInAction(() => (minted.track = path));
+            return await job.registerJob(minted);
+        }),
+    }),
+    prelude: promptPrelude,
+});
+//# sourceMappingURL=run-program.js.map

package/dist/run-program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-program.js","sourceRoot":"","sources":["../src/run-program.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@inhuman.tools/env-capability-module-prompt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Arrival ext/prompt: (require \"x.prompt\") pretreats to a scheme lambda; a ProgrammaticJob parents an omitted-spec agent ask.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!**/__tests__"
+  ],
+  "dependencies": {
+    "@here.build/arrival": "^0.10.2",
+    "@here.build/arrival-modules": "^0.10.0",
+    "handlebars": "^4.7.9",
+    "tiny-invariant": "^1.3.3",
+    "zod": "^4.4.3",
+    "@inhuman.tools/env-capability-dotprompt": "^0.2.0",
+    "@inhuman.tools/harness-model": "^0.2.0",
+    "@inhuman.tools/harness-commons": "^0.2.0",
+    "@inhuman.tools/plexus-expectations": "^0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "dedent": "1.7.2",
+    "eslint": "9.39.2",
+    "mobx": "6.16.1",
+    "typescript": "6.0.2",
+    "vitest": "4.1.0",
+    "@-internal-/eslint-configs": "0.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/here-build/inhuman-harness.git",
+    "directory": "packages/env-capability-module-prompt"
+  },
+  "peerDependencies": {
+    "mobx": "6.16.1"
+  },
+  "browserslist": [
+    "last 2 chrome versions",
+    "last 2 firefox versions",
+    "last 2 safari versions",
+    "ios_saf >= 16.4",
+    "node >= 22"
+  ],
+  "author": "Merkle Bonsai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "tsc -p tsconfig.json --noEmit && vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }

package/src/bundle.ts

@@ -0,0 +1,32 @@
+/**
+ * One rendered `.prompt` call, and the host port for an isolated completion.
+ * A ProgrammaticJob parents an omitted-spec AgentCallJob instead of calling the port.
+ */
+import type { ReasoningEffort } from "@inhuman.tools/env-capability-dotprompt";
+import type { CompletionExpectation, PromptMessageRole } from "@inhuman.tools/harness-model";
+
+/** Session/research intern port. Homed `round` is mutated in place. `responseSchemaJson` is the serialized schema, matching CompleteFields. */
+export type PromptCompleteRequest = {
+  readonly connectionId: string;
+  readonly model: string;
+  readonly promptText?: string;
+  readonly responseSchemaJson?: string;
+  readonly signal?: AbortSignal;
+  readonly round: CompletionExpectation;
+};
+
+export type PromptComplete = (
+  req: PromptCompleteRequest,
+) => Promise<{ readonly text: string; readonly thought?: string; readonly thoughtKind?: string }>;
+
+export class RenderedPrompt {
+  constructor(
+    public readonly model: string | null,
+    public readonly reasoningEffort: ReasoningEffort | null,
+    public readonly responseSchema: Record<string, unknown> | null,
+    public readonly faceName: string,
+    /** Null inherits the caller catalog; an empty list is an explicit empty overlay. */
+    public readonly tools: readonly string[] | null,
+    public readonly messages: readonly [PromptMessageRole, string][],
+  ) {}
+}

package/src/dotprompt.ts

@@ -0,0 +1,80 @@
+/**
+ * Render both prompt hosts call, and the prelude they install.
+ * `dotprompt/parse` is `dotpromptCapability`.
+ */
+import { type SchemeValue, toJS } from "@here.build/arrival";
+import { compileTemplate, runCompiledTemplate } from "@here.build/arrival-modules/handlebars";
+import { isPlainRecord, type ParsedPrompt, reasoningEffortSchema } from "@inhuman.tools/env-capability-dotprompt";
+import { type PromptMessageRole } from "@inhuman.tools/harness-model";
+import invariant from "tiny-invariant";
+import { z } from "zod";
+
+import { RenderedPrompt } from "./bundle.js";
+
+const promptMeta = z.object({
+  model: z.string().optional(),
+  reasoningEffort: reasoningEffortSchema.optional(),
+});
+
+export function renderPrompt(spec: ParsedPrompt, args: readonly unknown[]): RenderedPrompt {
+  let pairs = args;
+  let positional: unknown;
+  if (pairs.length > 0) {
+    const head = String(pairs[0]);
+    if (!(head.startsWith(":") || head.startsWith("':"))) {
+      positional = pairs[0];
+      pairs = pairs.slice(1);
+    }
+  }
+  const folded: Record<string, unknown> = {};
+  if (pairs.length > 0) {
+    invariant(pairs.length % 2 === 0, "kwargs: needs an even number of trailing args (alternating :key value pairs)");
+    for (let i = 0; i < pairs.length; i += 2) {
+      folded[String(pairs[i]).replace(/^'?:/, "")] = toJS(pairs[i + 1] as SchemeValue);
+    }
+  }
+  let inputs: Record<string, unknown> | undefined;
+  let meta: z.infer<typeof promptMeta> | undefined;
+  if (positional !== undefined) {
+    const value = toJS(positional as SchemeValue);
+    if (isPlainRecord(value) && Object.keys(folded).length === 0) {
+      const metaRaw = isPlainRecord(value.meta) ? value.meta : {};
+      const { meta: _meta, key: _key, ...rest } = value;
+      inputs = rest;
+      meta = promptMeta.parse(metaRaw);
+    } else if (folded.evidence === undefined) {
+      folded.evidence = value;
+    }
+  }
+  if (inputs === undefined || meta === undefined) {
+    const metaRaw = isPlainRecord(folded.meta) ? folded.meta : {};
+    const { meta: _metaSlot, key: _keySlot, ...rest } = folded;
+    inputs = rest;
+    meta = promptMeta.parse(metaRaw);
+  }
+  const rendered = spec.sections.map((section): [PromptMessageRole, string] => [
+    section.role,
+    runCompiledTemplate(compileTemplate(section.source), [inputs]),
+  ]);
+  const model =
+    [meta.model, spec.model].find(
+      (candidate): candidate is string => typeof candidate === "string" && candidate !== "",
+    ) ?? null;
+  return new RenderedPrompt(
+    model,
+    meta.reasoningEffort ?? spec.reasoningEffort,
+    spec.responseSchema,
+    spec.faceName,
+    spec.tools,
+    spec.mode === "instruct" ? [["user", rendered.map(([, content]) => content).join("\n\n")]] : rendered,
+  );
+}
+
+/** Both prompt hosts install this prelude. Require parses once and closes over the spec. */
+export const promptPrelude = `(define (ext/prompt/resolve contents)
+  (let ((spec (dotprompt/parse (if (bytevector? contents) (utf8->string contents) contents)
+                               "anonymous.prompt")))
+    ;; apply would run dotprompt/run under the lists capability's context.
+    (lambda args
+      (dotprompt/run spec args))))
+(require/register-extension ".prompt" ext/prompt/resolve)`;

package/src/index.ts

@@ -0,0 +1,4 @@
+export { type PromptComplete, RenderedPrompt } from "./bundle.js";
+export { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+export { promptIsolatedCapability } from "./run-isolated.js";
+export { promptProgramCapability } from "./run-program.js";

package/src/run-isolated.ts

@@ -0,0 +1,62 @@
+/**
+ * Isolated host for `.prompt`. `dotprompt/run` performs one completion
+ * on the configured job (compact, classifier).
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { arrivalLoaderCapability } from "@here.build/arrival-modules";
+import { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+import { CompletionExpectation, CompletionJob, ProgrammaticJob, PromptMessage } from "@inhuman.tools/harness-model";
+import { Job } from "@inhuman.tools/plexus-expectations";
+import invariant from "tiny-invariant";
+import { z } from "zod";
+
+import { promptPrelude, renderPrompt } from "./dotprompt.js";
+
+export const promptIsolatedCapability = EnvCapability.define("ext/prompt/isolated", {
+  deps: [dotpromptCapability, arrivalLoaderCapability],
+  configuration: {
+    job: z.instanceof(Job).refine((job) => !(job instanceof ProgrammaticJob), {
+      error: "dotprompt/run: a program uses promptProgramCapability",
+    }),
+    connectionId: z
+      .string({ error: "dotprompt/run: connectionId is required" })
+      .refine((value) => value !== "", { error: "dotprompt/run: connectionId is required" }),
+    model: z.string().optional(),
+    /** Session/judge model. `model` is reserved by some exec hosts. */
+    completionModel: z.string().optional(),
+  },
+  symbols: (symbol, sz) => ({
+    "dotprompt/run": symbol.rosetta`dotprompt/run: completes the rendered prompt in isolation`(
+      {
+        input: [sz.box.pipe(z.instanceof(ParsedPrompt)), sz.list(sz.dynamic)],
+        output: [sz.dynamic],
+        provenance: "source",
+        requiresConfig: ["job"],
+      },
+      async function (spec, args) {
+        const bundle = renderPrompt(spec, args);
+        // Render overlays :meta, then the file model. The host model is appended here.
+        const model =
+          [bundle.model, this.configuration.completionModel, this.configuration.model].find(
+            (candidate): candidate is string => typeof candidate === "string" && candidate !== "",
+          ) ?? null;
+        invariant(model != null, "dotprompt/run: model is required");
+        // The session orchestrator drives the CompletionJob. Await reads its result.
+        return await this.configuration.job.registerJob(
+          new CompletionJob({
+            expectation: new CompletionExpectation({
+              connectionId: this.configuration.connectionId,
+              model,
+              responseSchema: bundle.responseSchema,
+              completionMode: "isolated",
+              promptMessages: bundle.messages.map(([role, content]) => new PromptMessage({ role, content })),
+              reasoningEffort: bundle.reasoningEffort,
+            }),
+            turnTail: this.configuration.job,
+          }),
+        );
+      },
+    ),
+  }),
+  prelude: promptPrelude,
+});

package/src/run-program.ts

@@ -0,0 +1,79 @@
+/**
+ * Program host for `.prompt`. `dotprompt/run` parents an omitted-spec
+ * AgentCallJob on the ProgrammaticJob and waits for the worker.
+ */
+import { EnvCapability } from "@here.build/arrival";
+import { arrivalLoaderCapability } from "@here.build/arrival-modules";
+import { dotpromptCapability, ParsedPrompt } from "@inhuman.tools/env-capability-dotprompt";
+import {
+  AgentCallJob,
+  claimCrossing,
+  crossingPending,
+  crossingWindow,
+  isReplaying,
+  ProgrammaticJob,
+  PromptMessage,
+  takeCrossing,
+} from "@inhuman.tools/harness-model";
+import { runInAction, when } from "mobx";
+import { z } from "zod";
+
+import { promptPrelude, renderPrompt } from "./dotprompt.js";
+
+const AGENT_ASK = "agent__ask";
+
+export const promptProgramCapability = EnvCapability.define("ext/prompt/program", {
+  deps: [dotpromptCapability, arrivalLoaderCapability],
+  configuration: {
+    job: z.instanceof(ProgrammaticJob),
+    readonly: z.boolean().default(false),
+  },
+  symbols: (symbol, sz) => ({
+    "dotprompt/run": symbol.rosetta`dotprompt/run: parents an omitted-spec AgentCallJob on the program and waits`(
+      {
+        input: [sz.box.pipe(z.instanceof(ParsedPrompt)), sz.list(sz.dynamic)],
+        output: [sz.dynamic],
+        provenance: "source",
+        requiresConfig: ["job"],
+      },
+      async function (spec, args) {
+        const bundle = renderPrompt(spec, args);
+        const job = this.configuration.job;
+        const emission = this.runCtx.emission;
+        const path = job.trackMatch && emission != null ? claimCrossing(emission, crossingWindow(this)) : "";
+        if (path !== "" && emission != null) {
+          let existing = takeCrossing(job, emission, path);
+          if (existing == null && isReplaying(emission)) {
+            if (!job.completed && !job.cancelled) {
+              const joined = when(() => job.completed || job.cancelled || crossingPending(job, emission, path));
+              try {
+                await joined;
+              } finally {
+                joined.cancel();
+              }
+            }
+            existing = takeCrossing(job, emission, path);
+            if (existing == null) throw new Error("replay: no recorded dotprompt/run");
+          }
+          if (existing != null) return await existing;
+        }
+        const minted = new AgentCallJob({
+          toolCallId: `${job.toolCallId}:prompt:${job.children.length + 1}`,
+          name: AGENT_ASK,
+          argsJson: "{}",
+          voidLegal: false,
+          readonly: this.configuration.readonly === true,
+          responseSchema: bundle.responseSchema,
+          promptMessages: bundle.messages.map(([role, content]) => new PromptMessage({ role, content })),
+          faceName: bundle.faceName.trim(),
+          tools: bundle.tools ?? [],
+          inheritCallerTools: bundle.tools === null,
+          reasoningEffort: bundle.reasoningEffort,
+        });
+        if (path !== "") runInAction(() => (minted.track = path));
+        return await job.registerJob(minted);
+      },
+    ),
+  }),
+  prelude: promptPrelude,
+});

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.