@harrylabsj/kiwi 0.6.0

package/dist/runtime/foreground.js

@@ -0,0 +1,97 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { CommerceError } from "../commerce/types.js";
+import { runNegotiationTurn } from "./negotiation-turn.js";
+/** Upper bound for the transient-error backoff (ms). */
+export const MAX_BACKOFF_MS = 60_000;
+/** Default sleeper: resolves early (without throwing) when aborted. */
+export const defaultSleeper = (ms, signal) => new Promise((resolve) => {
+    if (signal?.aborted) {
+        resolve();
+        return;
+    }
+    const timer = setTimeout(() => {
+        signal?.removeEventListener("abort", onAbort);
+        resolve();
+    }, ms);
+    const onAbort = () => {
+        clearTimeout(timer);
+        resolve();
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+});
+function isTransientCommerceError(err) {
+    return err instanceof CommerceError && (err.kind === "transient" || err.kind === "rate_limit");
+}
+/** Outcomes that are worth an immediate follow-up poll. */
+function needsBackoff(report) {
+    const k = report.outcome.kind;
+    return k === "timeout" || k === "no_decision" || (k === "failed" && report.outcome.retriable);
+}
+export async function runForeground(options) {
+    const { profile, client, streamFn } = options;
+    const sleep = options.sleep ?? defaultSleeper;
+    const signal = options.signal;
+    const pollMs = profile.runtime.poll_interval_seconds * 1000;
+    let turns = 0;
+    let consecutiveTransient = 0;
+    for (;;) {
+        if (signal?.aborted)
+            return { turns, stopped_by: "signal" };
+        if (options.maxTurns !== undefined && turns >= options.maxTurns) {
+            return { turns, stopped_by: "max_turns" };
+        }
+        let report;
+        try {
+            report = await runNegotiationTurn({
+                profile,
+                client,
+                streamFn,
+                ...(options.getApiKey !== undefined ? { getApiKey: options.getApiKey } : {}),
+                ...(signal !== undefined ? { signal } : {}),
+            });
+        }
+        catch (err) {
+            if (isTransientCommerceError(err)) {
+                // Bounded exponential backoff; the loop keeps going.
+                consecutiveTransient += 1;
+                const backoff = Math.min(MAX_BACKOFF_MS, pollMs * 2 ** (consecutiveTransient - 1));
+                await sleep(backoff, signal);
+                continue;
+            }
+            throw err;
+        }
+        turns += 1;
+        options.onReport?.(report);
+        if (report.outcome.kind === "aborted" || signal?.aborted) {
+            return { turns, stopped_by: "signal" };
+        }
+        if (report.outcome.kind === "no_work" || report.outcome.kind === "already_claimed") {
+            consecutiveTransient = 0;
+            await sleep(pollMs, signal);
+            continue;
+        }
+        if (needsBackoff(report)) {
+            consecutiveTransient += 1;
+            const backoff = Math.min(MAX_BACKOFF_MS, pollMs * 2 ** (consecutiveTransient - 1));
+            await sleep(backoff, signal);
+            continue;
+        }
+        // accepted / human_required: poll again immediately for follow-up work.
+        consecutiveTransient = 0;
+    }
+}
+//# sourceMappingURL=foreground.js.map

package/dist/runtime/foreground.js.map

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

package/dist/runtime/heartbeat.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Claim heartbeat (M3 reliability).
+ *
+ * While a claimed message is being processed by the model loop, the runtime
+ * periodically refreshes the claim's updated_at on the gateway so a healthy
+ * long turn is never considered stale. Discipline:
+ *
+ * - heartbeats never overlap: a beat is skipped while the previous one is
+ *   still in flight;
+ * - failures are counted, never thrown: a heartbeat problem must not fail
+ *   the turn (the authoritative gate still sees every real write);
+ * - stop() clears the timer and awaits the in-flight beat, so no timer or
+ *   request outlives the turn.
+ */
+import type { CommerceClient } from "../commerce/types.js";
+export interface ClaimHeartbeat {
+    beats(): number;
+    failures(): number;
+    stop(): Promise<void>;
+}
+export declare function startClaimHeartbeat(client: CommerceClient, messageId: number, intervalMs: number): ClaimHeartbeat;

package/dist/runtime/heartbeat.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export function startClaimHeartbeat(client, messageId, intervalMs) {
+    let beats = 0;
+    let failures = 0;
+    let stopped = false;
+    let inflight;
+    const beat = () => {
+        if (stopped || inflight !== undefined)
+            return; // never overlap
+        inflight = client
+            .heartbeat({ message_id: messageId })
+            .then(() => {
+            beats += 1;
+        })
+            .catch(() => {
+            failures += 1; // transient heartbeat failure: keep the turn running
+        })
+            .finally(() => {
+            inflight = undefined;
+        });
+    };
+    const timer = setInterval(beat, intervalMs);
+    // The heartbeat must never keep the process alive on its own.
+    timer.unref();
+    return {
+        beats: () => beats,
+        failures: () => failures,
+        stop: async () => {
+            stopped = true;
+            clearInterval(timer);
+            await inflight;
+        },
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/runtime/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/runtime/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyBH,MAAM,UAAU,mBAAmB,CACjC,MAAsB,EACtB,SAAiB,EACjB,UAAkB;IAElB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAmC,CAAC;IAExC,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,IAAI,OAAO,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,gBAAgB;QAC/D,QAAQ,GAAG,MAAM;aACd,SAAS,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;aACpC,IAAI,CAAC,GAAG,EAAE;YACT,KAAK,IAAI,CAAC,CAAC;QACb,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE;YACV,QAAQ,IAAI,CAAC,CAAC,CAAC,qDAAqD;QACtE,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,8DAA8D;IAC9D,KAAK,CAAC,KAAK,EAAE,CAAC;IAEd,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;QAClB,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;QACxB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,MAAM,QAAQ,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/merchant-turn.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Back-compat module: the M1 merchant turn is the role-aware negotiation
+ * turn (runtime/negotiation-turn.ts) driven with a merchant profile.
+ * New code should import runNegotiationTurn directly.
+ */
+import type { StreamFn } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../config/profile.js";
+import type { CommerceClient } from "../commerce/types.js";
+import { type TurnReport, type TurnOutcome, type TurnUsage } from "./negotiation-turn.js";
+export type { TurnOutcome, TurnReport, TurnUsage };
+export interface MerchantTurnOptions {
+    profile: AgentProfile;
+    client: CommerceClient;
+    streamFn: StreamFn;
+    /** Resolves the model API key for the real provider; unused for fake. */
+    getApiKey?: () => string | undefined;
+    /** External shutdown signal (SIGINT/SIGTERM). Aborts the Pi run. */
+    signal?: AbortSignal;
+}
+export declare function runMerchantTurn(options: MerchantTurnOptions): Promise<TurnReport>;

package/dist/runtime/merchant-turn.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { runNegotiationTurn, } from "./negotiation-turn.js";
+export async function runMerchantTurn(options) {
+    return runNegotiationTurn(options);
+}
+//# sourceMappingURL=merchant-turn.js.map

package/dist/runtime/merchant-turn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merchant-turn.js","sourceRoot":"","sources":["../../src/runtime/merchant-turn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,EACL,kBAAkB,GAInB,MAAM,uBAAuB,CAAC;AAc/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA4B;IAChE,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/runtime/model.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Model construction for Pi.
+ *
+ * Real models: a pi-ai Model object is built from the profile and streamed
+ * through pi-ai's api-dispatch streamSimple. API keys come from the env var
+ * named by model.api_key_env — never from the profile.
+ *
+ * Fake model: provider "fake" yields a deterministic scripted StreamFn used
+ * by tests and offline smoke runs. It needs no network and no key.
+ */
+import type { Api, Model, ThinkingLevel } from "@earendil-works/pi-ai";
+import type { StreamFn } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../config/profile.js";
+export declare function isFakeProvider(profile: AgentProfile): boolean;
+/**
+ * Map profile model.thinking_level onto Pi's ThinkingLevel (agent-core 0.83:
+ * "minimal" | "low" | "medium" | "high" | "xhigh" | "max"; the Agent default
+ * is "off"). Kiwi profiles only allow off/minimal/low/medium/high; "off" and
+ * undefined leave initialState untouched so Pi keeps its default. Anything
+ * else fails closed — a silently dropped level would be a config lie.
+ */
+export declare function resolveThinkingLevel(profile: AgentProfile): ThinkingLevel | undefined;
+export declare function buildModel(profile: AgentProfile): Model<Api>;
+/** StreamFn for real providers, dispatching through pi-ai's api registry. */
+export declare function realStreamFn(): StreamFn;

package/dist/runtime/model.js

@@ -0,0 +1,86 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { streamSimple } from "@earendil-works/pi-ai/compat";
+const PROVIDER_API = {
+    openai: "openai-completions",
+    anthropic: "anthropic-messages",
+    google: "google-generative-ai",
+    "google-vertex": "google-vertex",
+    openrouter: "openai-completions",
+    deepseek: "openai-completions",
+    xai: "openai-completions",
+    groq: "openai-completions",
+    together: "openai-completions",
+    mistral: "mistral-conversations",
+    "amazon-bedrock": "bedrock-converse-stream",
+};
+const PROVIDER_BASE_URL = {
+    openai: "https://api.openai.com/v1",
+    anthropic: "https://api.anthropic.com",
+    google: "https://generativelanguage.googleapis.com",
+    openrouter: "https://openrouter.ai/api/v1",
+    deepseek: "https://api.deepseek.com",
+    xai: "https://api.x.ai/v1",
+    groq: "https://api.groq.com/openai/v1",
+    together: "https://api.together.xyz/v1",
+    mistral: "https://api.mistral.ai",
+    // google-vertex and amazon-bedrock are intentionally absent: pi-ai
+    // resolves their endpoints through the provider SDKs (region-based) and
+    // never reads model.baseUrl, so the "" fallback below is harmless for
+    // exactly those two. Every other provider needs a default or an explicit
+    // model.base_url in the profile.
+};
+export function isFakeProvider(profile) {
+    return profile.model.provider === "fake";
+}
+/**
+ * Map profile model.thinking_level onto Pi's ThinkingLevel (agent-core 0.83:
+ * "minimal" | "low" | "medium" | "high" | "xhigh" | "max"; the Agent default
+ * is "off"). Kiwi profiles only allow off/minimal/low/medium/high; "off" and
+ * undefined leave initialState untouched so Pi keeps its default. Anything
+ * else fails closed — a silently dropped level would be a config lie.
+ */
+export function resolveThinkingLevel(profile) {
+    const level = profile.model.thinking_level;
+    if (level === undefined || level === "off")
+        return undefined;
+    if (level === "minimal" || level === "low" || level === "medium" || level === "high") {
+        return level;
+    }
+    throw new Error(`Unsupported model.thinking_level: ${String(level)}`);
+}
+export function buildModel(profile) {
+    const provider = profile.model.provider;
+    const api = (profile.model.api ?? PROVIDER_API[provider] ?? "openai-completions");
+    const baseUrl = profile.model.base_url ?? PROVIDER_BASE_URL[provider] ?? "";
+    return {
+        id: profile.model.model,
+        name: profile.model.model,
+        api,
+        provider,
+        baseUrl,
+        reasoning: false,
+        input: ["text"],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 128_000,
+        maxTokens: 8192,
+    };
+}
+/** StreamFn for real providers, dispatching through pi-ai's api registry. */
+export function realStreamFn() {
+    return (model, context, options) => streamSimple(model, context, options);
+}
+//# sourceMappingURL=model.js.map

package/dist/runtime/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/runtime/model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAI5D,MAAM,YAAY,GAA2B;IAC3C,MAAM,EAAE,oBAAoB;IAC5B,SAAS,EAAE,oBAAoB;IAC/B,MAAM,EAAE,sBAAsB;IAC9B,eAAe,EAAE,eAAe;IAChC,UAAU,EAAE,oBAAoB;IAChC,QAAQ,EAAE,oBAAoB;IAC9B,GAAG,EAAE,oBAAoB;IACzB,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,oBAAoB;IAC9B,OAAO,EAAE,uBAAuB;IAChC,gBAAgB,EAAE,yBAAyB;CAC5C,CAAC;AAEF,MAAM,iBAAiB,GAA2B;IAChD,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,2BAA2B;IACtC,MAAM,EAAE,2CAA2C;IACnD,UAAU,EAAE,8BAA8B;IAC1C,QAAQ,EAAE,0BAA0B;IACpC,GAAG,EAAE,qBAAqB;IAC1B,IAAI,EAAE,gCAAgC;IACtC,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,wBAAwB;IACjC,mEAAmE;IACnE,wEAAwE;IACxE,sEAAsE;IACtE,yEAAyE;IACzE,iCAAiC;CAClC,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7D,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;IACxC,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAQ,CAAC;IACzF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5E,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QACvB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;QACzB,GAAG;QACH,QAAQ;QACR,OAAO;QACP,SAAS,EAAE,KAAK;QAChB,KAAK,EAAE,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE;QAC1D,aAAa,EAAE,OAAO;QACtB,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC"}

package/dist/runtime/negotiation-turn.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Copyright 2026 harrylabsj
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Role-aware single-turn orchestration (buyer and merchant share one loop).
+ *
+ * Flow per design §10 (with M3 reliability):
+ *   capabilities (fail closed) -> recover own stale claims -> list pending
+ *   -> claim -> Pi agent loop under claim heartbeat (snapshot -> decision)
+ *   -> policy result -> complete / fail / abandon.
+ *
+ * The marketplace conversation is the authoritative memory; no Pi session is
+ * persisted. Every turn rebuilds its context from the snapshot.
+ *
+ * Shutdown semantics (design §16.2): an external AbortSignal (SIGINT/SIGTERM
+ * in the foreground loop) aborts the Pi run; a claim that was never accepted
+ * is abandoned (never completed) so another worker can pick it up. A
+ * decision already accepted by the policy gate is never rolled back — the
+ * claim completes normally.
+ */
+import { type StreamFn } from "@earendil-works/pi-agent-core";
+import type { AgentProfile } from "../config/profile.js";
+import type { CommerceClient } from "../commerce/types.js";
+import { type PolicyResult } from "../negotiation/types.js";
+export type TurnOutcome = {
+    kind: "no_work";
+} | {
+    kind: "already_claimed";
+    status: string;
+} | {
+    kind: "accepted";
+    message_id?: number;
+} | {
+    kind: "human_required";
+    reason_codes: string[];
+} | {
+    kind: "no_decision";
+    reason: string;
+} | {
+    kind: "timeout";
+    reason: string;
+} | {
+    kind: "aborted";
+    reason: string;
+} | {
+    kind: "failed";
+    error: string;
+    retriable: boolean;
+};
+export interface TurnUsage {
+    input: number;
+    output: number;
+    total: number;
+    cost_total: number;
+}
+export interface TurnReport {
+    outcome: TurnOutcome;
+    conversation_id?: string;
+    message_id?: number;
+    idempotency_key?: string;
+    policy_result?: PolicyResult;
+    steps: number;
+    usage: TurnUsage;
+    /** Claim heartbeat activity while the turn held the claim. */
+    heartbeat?: {
+        beats: number;
+        failures: number;
+    };
+}
+export interface NegotiationTurnOptions {
+    profile: AgentProfile;
+    client: CommerceClient;
+    streamFn: StreamFn;
+    /** Resolves the model API key for the real provider; unused for fake. */
+    getApiKey?: () => string | undefined;
+    /** External shutdown signal (SIGINT/SIGTERM). Aborts the Pi run. */
+    signal?: AbortSignal;
+    /** Claim heartbeat cadence; defaults to HEARTBEAT_INTERVAL_MS. */
+    heartbeatIntervalMs?: number;
+}
+/**
+ * M3 reliability constants (documented in README): claims untouched for
+ * STALE_CLAIM_TTL_SECONDS are recovered as crashed; a claimed turn
+ * heartbeats every HEARTBEAT_INTERVAL_MS — comfortably below the TTL — so
+ * healthy long turns are never mistaken for crashed ones.
+ */
+export declare const STALE_CLAIM_TTL_SECONDS = 300;
+export declare const HEARTBEAT_INTERVAL_MS = 60000;
+export declare function runNegotiationTurn(options: NegotiationTurnOptions): Promise<TurnReport>;