@sema-agent/server 7.124.0 → 7.125.0

package/dist/http/idempotency.js

@@ -1,3 +1,5 @@
+import { createHash } from "node:crypto";
+import { gatedPrincipal } from "./principal-gate.js";
 export class IdempotencyCache {
     ttlMs;
     sweepThreshold;
@@ -9,7 +11,7 @@ export class IdempotencyCache {
     peek(key) {
         return this.live(key);
     }
-    run(key, produce, shouldCache = () => true) {
+    run(key, produce) {
         if (!key)
             return produce();
         this.maybeSweep();
@@ -17,17 +19,13 @@ export class IdempotencyCache {
         if (hit)
             return hit;
         const promise = produce();
-        this.entries.set(key, { at: Date.now(), promise });
-        promise.then((value) => {
-            let cacheable = false;
-            try {
-                cacheable = shouldCache(value);
-            }
-            catch {
-            }
-            if (!cacheable)
+        const entry = { at: Date.now(), promise };
+        this.entries.set(key, entry);
+        const settle = () => {
+            if (this.entries.get(key) === entry)
                 this.entries.delete(key);
-        }, () => this.entries.delete(key));
+        };
+        promise.then(settle, settle);
         return promise;
     }
     get size() {
@@ -52,7 +50,34 @@ export class IdempotencyCache {
                 this.entries.delete(k);
     }
 }
-export function scopedIdempotencyKey(raw, source, principal) {
-    return raw ? `${source ?? ""}\x1f${principal ?? ""}\x1f${raw}` : undefined;
+function idemFamilyTag(family) {
+    switch (family) {
+        case "run":
+            return "run";
+        case "leader":
+            return "leader";
+        case "bake":
+            return "bake";
+        default: {
+            const unknown = family;
+            throw new Error(`idemKeyOf: unknown resource family ${String(unknown)}`);
+        }
+    }
+}
+export function idemCallerOf(req, ctx) {
+    return { principal: gatedPrincipal(req, ctx.deps.config), source: ctx.req.source };
+}
+export function idemIdentityOf(caller) {
+    if (caller.principal !== undefined && caller.principal !== null)
+        return `principal\x1e${caller.principal}`;
+    if (caller.source !== undefined && caller.source !== null)
+        return `source\x1e${caller.source}`;
+    return "";
+}
+export function idemKeyOf(raw, caller, family) {
+    return createHash("sha256").update(`${idemIdentityOf(caller)}\x1f${idemFamilyTag(family)}\x1f${raw}`).digest("hex");
+}
+export function inflightKeyOf(idemKey, face, clientTaskId) {
+    return `${idemKey}\x1f${face}\x1f${clientTaskId ?? ""}`;
 }
 //# sourceMappingURL=idempotency.js.map

package/dist/http/request-guards.d.ts

@@ -6,6 +6,7 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { FlatServiceDeps } from "./server.js";
 import type { LeaseRefusalAdmission } from "../fleet-lease.js";
+import { type QuotaDecision } from "../observability/cost-quota.js";
 /**
  * S-866 ③ —— 租约拒绝的应答形({@link leaseRefusalOf} 的产物;`{status, body}` 交回形 + 镜像头用的 `retryAfterSec`)。
  * 体键序固定 `error, errorCode, …`(冻结门 `FROZEN_RESULT_BODY` 按这个字面形锚)。
@@ -30,6 +31,23 @@ export interface LeaseRefusal {
  * 一只映射之后两形同体(resume 族的 429 体多出中心的 E4 字段,additive)。
  */
 export declare function leaseRefusalOf(adm: LeaseRefusalAdmission): LeaseRefusal;
+/**
+ * 成本配额越顶 → 429 `limit.cost_quota_exceeded` 的**唯一**体铸点(三只门同调:路由门 `quotaExceeded`、属主门
+ * `ownerCostQuotaDenied`、赎回席 `approval-sweeps.ts`;修前三份手抄)。体键序 `error, errorCode, …`(冻结门
+ * `FROZEN_RESULT_BODY` 按这个字面形锚)。`retryAfterSec` 与 `windowResetsAt` 同源于决策的 `windowEndsAtMs`
+ * (同一次读钟),`Retry-After` 头由各发送点从体里的 `retryAfterSec` 镜像。
+ */
+export declare function costQuotaRefusalOf(d: QuotaDecision): {
+    status: 429;
+    body: {
+        error: string;
+        errorCode: string;
+        usedMicroUsd: number;
+        limitMicroUsd: number;
+        retryAfterSec: number;
+        windowResetsAt: string;
+    };
+};
 export declare function createRequestGuards(ctx: {
     deps: FlatServiceDeps;
 }): {

package/dist/http/request-guards.js

@@ -3,6 +3,7 @@ import { HttpError, principalFrom } from "../security.js";
 import { RUN_NOT_FOUND_MESSAGE, SESSION_NOT_FOUND_MESSAGE } from "./route-ctx.js";
 import { sendError } from "./send.js";
 import { authorized, systemFor, gatedPrincipal, explicitOperatorOk, runOwnerReadable, sendPrincipalRefusal } from "./principal-gate.js";
+import { quotaWindowResetsAt } from "../observability/cost-quota.js";
 const MAX_BODY = 8 * 1024 * 1024;
 export function leaseRefusalOf(adm) {
     switch (adm.reason) {
@@ -20,6 +21,12 @@ export function leaseRefusalOf(adm) {
         }
     }
 }
+export function costQuotaRefusalOf(d) {
+    return {
+        status: 429,
+        body: { error: "cost quota exceeded", errorCode: "limit.cost_quota_exceeded", usedMicroUsd: d.usedMicroUsd, limitMicroUsd: d.limitMicroUsd, retryAfterSec: d.retryAfterSec, windowResetsAt: quotaWindowResetsAt(d) },
+    };
+}
 function sendLeaseRefusal(res, refusal) {
     const { error, errorCode, ...extra } = refusal.body;
     res.setHeader("retry-after", String(refusal.retryAfterSec));
@@ -37,8 +44,10 @@ export function createRequestGuards(ctx) {
         if (d.allowed)
             return false;
         deps.metrics?.inc("cost_quota_rejected_total");
-        res.setHeader("retry-after", String(d.retryAfterSec));
-        sendError(res, 429, "limit.cost_quota_exceeded", "cost quota exceeded", { usedMicroUsd: d.usedMicroUsd, limitMicroUsd: d.limitMicroUsd, retryAfterSec: d.retryAfterSec });
+        const { status, body } = costQuotaRefusalOf(d);
+        const { error, errorCode, ...extra } = body;
+        res.setHeader("retry-after", String(body.retryAfterSec));
+        sendError(res, status, errorCode, error, extra);
         return true;
     }
     function ownerCostQuotaDenied(principal) {
@@ -48,7 +57,7 @@ export function createRequestGuards(ctx) {
         if (d.allowed)
             return undefined;
         deps.metrics?.inc("cost_quota_rejected_total");
-        return { status: 429, body: { error: "cost quota exceeded", errorCode: "limit.cost_quota_exceeded", usedMicroUsd: d.usedMicroUsd, limitMicroUsd: d.limitMicroUsd, retryAfterSec: d.retryAfterSec } };
+        return costQuotaRefusalOf(d);
     }
     async function ownerFleetLeaseDenied(owner) {
         if (!deps.fleetLease || !owner)

package/dist/http/resume-legs.js

@@ -511,6 +511,9 @@ export function createResumeLegs(ctx) {
                 source: args.mintFreshRun.source,
                 objectivePreview: buildRunObjectivePreview(resumeObjective ?? ""),
             });
+            if (created.existing) {
+                throw new Error(`wake fresh run: createRun observed an existing row for the freshly minted taskId ${freshId} (no idempotency key was sent) — refusing to treat it as a busy session`);
+            }
             if (!created.ok) {
                 return { status: 409, body: await buildActiveRunConflict({ runStore: deps.runStore, checkpointStore: deps.checkpointStore, governance: deps.config, runStaleSec: deps.config.runStaleSec, turnActivity: readTurnActivityMs }, sessionId, created.activeTaskId) };
             }
@@ -521,7 +524,7 @@ export function createResumeLegs(ctx) {
             freshRunClaimed = true;
         }
         const fleetPub = taskId && deps.fleetBus
-            ? fleetRunPublisher(deps.fleetBus, { runId: taskId, scope: fleetScope, rootTaskId: taskId, ...fleetRunLabels(resumeObjective) })
+            ? fleetRunPublisher(deps.fleetBus, { runId: taskId, scope: fleetScope, rootTaskId: taskId, sessionId, ...fleetRunLabels(resumeObjective) })
             : undefined;
         const resumeTaskConfig = taskId ? { ...taskConfig, taskId } : taskConfig;
         if (deps.toolApproval && taskId) {
@@ -1217,6 +1220,9 @@ export function createResumeLegs(ctx) {
             source: "workflow_parked_decide",
             trustedInternals,
         });
+        if (out.existing) {
+            throw new Error(`decide host turn: createRun observed an existing row ${out.existing.taskId} for a freshly minted taskId (no idempotency key was sent)`);
+        }
         if (out.status !== 202)
             return { status: out.status, body: out.body };
         const minted = out.body;

package/dist/http/route-ctx.d.ts

@@ -579,11 +579,11 @@ export type RouteIdsOf<T extends readonly RouteDecl[]> = Extract<T[number], {
  * (抛),不静默 200 也不静默 404。
  */
 export declare function assertNever(x: never): never;
-/** 改写门是**方法感知**的(它的撤销动词是 DELETE)。闭集 —— 加第五个动词是编译红。 */
-export type RouteMethod = "GET" | "POST" | "PUT" | "DELETE";
+/** 改写门是**方法感知**的(它的撤销动词是 DELETE)。闭集 —— 加一个动词是编译红(`PATCH` = 会话行可写位,`PATCH /v1/sessions/:id`)。 */
+export type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
 /** 闭集的**规范序**(405 的 `Allow` 头按它排,于是同一条路径的头字节恒定,不随声明序抖)。
  *  `satisfies` 让它与 {@link RouteMethod} 双向闭合:漏一个动词 / 多一个都是编译红。 */
-export declare const ROUTE_METHOD_ORDER: readonly ["GET", "POST", "PUT", "DELETE"];
+export declare const ROUTE_METHOD_ORDER: readonly ["GET", "POST", "PUT", "PATCH", "DELETE"];
 export interface RouteDeclFacts {
     /** 「这条 url **烧模型**」—— drain / model-roster-pending / 租约过期 / 无 service-token 四道 503 的共同判别。
      *  没有这一列 = 不烧模型(零默认值:要它在场必须显式写出来,漏写的方向是**少收一笔账单**而不是

package/dist/http/route-ctx.js

@@ -20,7 +20,7 @@ export function sendResumeOutcome(res, out, logger, extraBody) {
 export function assertNever(x) {
     throw new Error(`unreachable route id: ${String(x)}`);
 }
-export const ROUTE_METHOD_ORDER = ["GET", "POST", "PUT", "DELETE"];
+export const ROUTE_METHOD_ORDER = ["GET", "POST", "PUT", "PATCH", "DELETE"];
 export function buildHostLegOutcome(out) {
     return { status: out.status, body: out.body };
 }

package/dist/http/routes/a2a-serve.js

@@ -3,7 +3,9 @@ import { createHash } from "node:crypto";
 import { memoRedactedRead, redactErrorMessage } from "../../observability/run-terminal.js";
 import { isParkedRunStatus, isTerminalRunStatus } from "../../plugins/store-contracts.js";
 import { HttpError } from "../../security.js";
-import { scopedIdempotencyKey } from "../idempotency.js";
+import { idemCallerOf, idemIdentityOf, idemKeyOf, inflightKeyOf } from "../idempotency.js";
+import { isRunExistsConflictBody, replayOfExistingRun } from "../submit-replay.js";
+import { isActiveRunConflictBody } from "../active-run-conflict.js";
 import { sendJson, sendError } from "../send.js";
 import { admissionRefusalOf, readinessOf, sendBillableRefusal } from "../readiness.js";
 import { gatedPrincipal, sendPrincipalRefusal } from "../principal-gate.js";
@@ -228,28 +230,33 @@ async function handleMessageSend({ req, res, ctx, params, serve, runStore }) {
     const skillId = skill?.id;
     const scenario = skill?.scenario;
     const blocking = readBlocking(params);
-    const idemScope = `${ctx.req.source ?? ""}\x1f${gatedPrincipal(req, deps.config) ?? ""}`;
+    const caller = idemCallerOf(req, ctx);
     const fingerprint = createHash("sha256")
         .update(messageId).update("\x1f")
         .update(objective).update("\x1f")
         .update(contextId ?? "").update("\x1f")
         .update(skillId ?? "")
         .digest("hex");
-    const idemKey = scopedIdempotencyKey(fingerprint, ctx.req.source, gatedPrincipal(req, deps.config));
+    const submitter = caller.principal ?? undefined;
+    const idemKey = idemKeyOf(fingerprint, caller, "run");
     const body = {
         objective,
-        taskId: durableIdempotencyTaskId(idemScope, fingerprint),
+        taskId: durableIdempotencyTaskId(idemIdentityOf(caller), fingerprint),
         ...(contextId !== undefined ? { sessionId: contextId } : {}),
         ...(scenario !== undefined ? { scenario } : {}),
     };
-    const replay = await runStore.getRun(body.taskId).catch(() => undefined);
-    if (replay && (replay.owner === null || replay.owner === gatedPrincipal(req, deps.config))) {
-        return taskFromRun(replay, isStaleRun(replay, deps.config.runStaleSec));
+    const keyed = (await runStore.getRunByIdem(idemKey).catch(() => undefined)) ?? (await runStore.getRun(body.taskId).catch(() => undefined));
+    const replay = keyed ? await replayOfExistingRun(keyed, { principal: submitter, clientTaskId: body.taskId }, "durable", deps, runStore) : undefined;
+    if (keyed && replay?.status === 202) {
+        return taskFromRun(keyed, isStaleRun(keyed, deps.config.runStaleSec));
     }
-    const cached = idemKey ? ctx.registry.idemCache.peek(idemKey) : undefined;
+    const inflight = replay === undefined ? ctx.registry.idemCache.peek(inflightKeyOf(idemKey, "durable", body.taskId)) : undefined;
     let receipt;
-    if (cached) {
-        receipt = await cached;
+    if (replay !== undefined) {
+        receipt = replay;
+    }
+    else if (inflight) {
+        receipt = await inflight;
     }
     else {
         if (submitUnavailable(res, ctx))
@@ -270,7 +277,7 @@ async function handleMessageSend({ req, res, ctx, params, serve, runStore }) {
         return undefined;
     const receiptBody = receipt.body;
     if (receipt.status !== 202 || typeof receiptBody.taskId !== "string" || typeof receiptBody.sessionId !== "string") {
-        throw new RpcError(JSONRPC_INVALID_PARAMS, `the serving deployment did not accept this submission (it answered ${receipt.status}); a session already running a turn must finish or be cancelled before the next message on the same contextId`);
+        throw rpcErrorFromRefusedReceipt(receipt);
     }
     const taskId = receiptBody.taskId;
     const sessionId = receiptBody.sessionId;
@@ -284,6 +291,15 @@ async function handleMessageSend({ req, res, ctx, params, serve, runStore }) {
         status: { state: "submitted", timestamp: new Date().toISOString() },
     };
 }
+function rpcErrorFromRefusedReceipt(receipt) {
+    const code = receipt.body?.errorCode;
+    const head = `the serving deployment did not accept this submission (it answered ${receipt.status}${typeof code === "string" ? ` ${code}` : ""})`;
+    if (isActiveRunConflictBody(receipt.body))
+        return new RpcError(JSONRPC_INVALID_PARAMS, `${head}; a session already running a turn must finish or be cancelled before the next message on the same contextId`);
+    if (isRunExistsConflictBody(receipt.body))
+        return new RpcError(JSONRPC_INVALID_PARAMS, `${head}; this message's idempotency key already names a run this caller cannot take as this message's task — send it with a new messageId`);
+    return new RpcError(JSONRPC_INVALID_PARAMS, head);
+}
 function durableIdempotencyTaskId(scope, messageId) {
     const digest = createHash("sha256").update(scope).update("\x1f").update(messageId).digest();
     const b = Buffer.from(digest.subarray(0, 16));

package/dist/http/routes/capabilities.js

@@ -205,6 +205,7 @@ export async function handleCapabilities(req, res, match, ctx) {
                 manualCompact: facts.durableRuns(deps).available,
                 configCatalog: facts.configCatalog(deps).available,
                 sealedKey: projectSealedKeyCapability(deps.sealedKeyPublic),
+                workspaceSync: ((f) => (f.available ? f.policy : undefined))(facts.workspaceSpace(deps.config)),
             }));
             return;
         }

package/dist/http/routes/fleet.js

@@ -45,6 +45,7 @@ function streamFleet(req, res, bus, callerScope, callerSession = null, completio
             startedAt: "keep", elapsedMs: "keep", tokens: "keep",
             awaitingPlanApproval: "keep", toolUses: "keep", usage: "keep", resumable: "keep", sourceLane: "keep",
             cycleSeq: "keep", retiredBy: "keep",
+            workspaceSnapshot: "keep",
             name: "rewrite", scope: "strip", sessionId: "strip",
             description: "scrub", agentType: "scrub", agentName: "scrub", currentAction: "scrub",
             currentTool: "scrub", transcriptId: "scrub", stoppedBy: "scrub", editedFiles: "scrub",
@@ -70,6 +71,7 @@ function streamFleet(req, res, bus, callerScope, callerSession = null, completio
                     ...(rest.sourceLane !== undefined ? { sourceLane: rest.sourceLane } : {}),
                     ...(rest.cycleSeq !== undefined ? { cycleSeq: rest.cycleSeq } : {}),
                     ...(rest.retiredBy !== undefined ? { retiredBy: rest.retiredBy } : {}),
+                    ...(rest.workspaceSnapshot !== undefined ? { workspaceSnapshot: rest.workspaceSnapshot } : {}),
                 };
             }
             return rest;

package/dist/http/routes/images.js

@@ -6,7 +6,7 @@ import { validateBake, buildBakeArgv } from "../../images/bake-validate.js";
 import { streamSseLog } from "../sse-log.js";
 import { sendJson, sendError } from "../send.js";
 import { headerStr, safeEqual, gatedPrincipal, explicitOperatorOk, sendOperatorPrincipalsRequired } from "../principal-gate.js";
-import { scopedIdempotencyKey } from "../idempotency.js";
+import { idemCallerOf, idemKeyOf } from "../idempotency.js";
 import { assertNever } from "../route-ctx.js";
 import * as facts from "../../capability-facts.js";
 export function createImagesLocal(deps) {
@@ -93,7 +93,7 @@ export async function handleImages(req, res, match, ctx) {
             }
             const argv = buildBakeArgv(v, { baseRef: effectiveBaseRef, cacheBase: cfg.cacheBase });
             const rawIdem = headerStr(req.headers["idempotency-key"]) ?? (typeof body.idempotencyKey === "string" ? body.idempotencyKey : undefined);
-            const idemKey = rawIdem ? scopedIdempotencyKey(rawIdem, source, principal) ?? null : null;
+            const idemKey = rawIdem ? idemKeyOf(rawIdem, idemCallerOf(req, ctx), "bake") : null;
             const createInput = {
                 profile: v.profile,
                 bands: v.bands,

package/dist/http/routes/leader.d.ts

@@ -18,6 +18,10 @@ export declare const LEADER_ROUTES: readonly [{
     readonly path: "/v1/leader";
     readonly billable: "submit";
     readonly methods: readonly ["POST"];
+}, {
+    readonly id: "leader-by-idem";
+    readonly path: "/v1/leader";
+    readonly methods: readonly ["GET"];
 }, {
     readonly id: "leader-detail";
     readonly pattern: RegExp;

package/dist/http/routes/leader.js

@@ -1,5 +1,6 @@
 import { sendJson, sendError } from "../send.js";
 import { gatedPrincipal, headerStr, sendPrincipalRefusal } from "../principal-gate.js";
+import { idemCallerOf } from "../idempotency.js";
 import { assertNever } from "../route-ctx.js";
 import * as facts from "../../capability-facts.js";
 import { leaderEntryRefusal, leaderRunEntry } from "../../leader/run-entry.js";
@@ -8,6 +9,7 @@ export async function handleLeader(req, res, match, ctx) {
     switch (match.decl.id) {
         case "leader-submit":
         case "leader-detail":
+        case "leader-by-idem":
             break;
         default:
             return assertNever(match.decl.id);
@@ -24,7 +26,7 @@ export async function handleLeader(req, res, match, ctx) {
         sendPrincipalRefusal(res, req, deps.config);
         return;
     }
-    const requester = gatedPrincipal(req, deps.config) ?? null;
+    const caller = idemCallerOf(req, ctx);
     if (match.decl.id === "leader-submit") {
         if (rateLimited(req, res) || quotaExceeded(req, res) || (await leaseDenied(req, res)) || (await usageWindowDenied(req, res)))
             return;
@@ -41,14 +43,21 @@ export async function handleLeader(req, res, match, ctx) {
             sendError(res, 422, "request.autonomy_lane_refused", laneRefusal);
             return;
         }
-        const r = await endpoint.handle("POST", LEADER_SUBMIT_PATH, body, requester, headerStr(req.headers["idempotency-key"]) ?? null);
+        const r = await endpoint.handle("POST", LEADER_SUBMIT_PATH, body, caller, headerStr(req.headers["idempotency-key"]) ?? null);
+        if (r) {
+            sendJson(res, r.status, r.body);
+            return;
+        }
+    }
+    else if (match.decl.id === "leader-by-idem") {
+        const r = await endpoint.handle("GET", LEADER_SUBMIT_PATH, undefined, caller, new URLSearchParams(match.search).get("idempotencyKey"));
         if (r) {
             sendJson(res, r.status, r.body);
             return;
         }
     }
     else {
-        const r = await endpoint.handle("GET", `${LEADER_SUBMIT_PATH}/${match.params.id}`, undefined, requester);
+        const r = await endpoint.handle("GET", `${LEADER_SUBMIT_PATH}/${match.params.id}`, undefined, caller);
         if (r) {
             sendJson(res, r.status, r.body);
             return;
@@ -58,6 +67,7 @@ export async function handleLeader(req, res, match, ctx) {
 }
 export const LEADER_ROUTES = [
     { id: "leader-submit", path: LEADER_SUBMIT_PATH, billable: "submit", methods: ["POST"] },
+    { id: "leader-by-idem", path: LEADER_SUBMIT_PATH, methods: ["GET"] },
     { id: "leader-detail", pattern: /^\/v1\/leader\/(?<id>[^/]+)$/, label: "/v1/leader/:id", methods: ["GET"] },
 ];
 //# sourceMappingURL=leader.js.map

package/dist/http/routes/observability.js

@@ -2,6 +2,7 @@ import { sendJson, sendError } from "../send.js";
 import { gatedPrincipal, isOperator, explicitOperatorOk, sendOperatorPrincipalsRequired, sendPrincipalRefusal } from "../principal-gate.js";
 import { assertNever } from "../route-ctx.js";
 import * as facts from "../../capability-facts.js";
+import { quotaWindowResetsAt } from "../../observability/cost-quota.js";
 export async function handleObservability(req, res, match, ctx) {
     const { deps } = ctx;
     switch (match.decl.id) {
@@ -64,6 +65,7 @@ export async function handleObservability(req, res, match, ctx) {
                 remainingMicroUsd: Math.max(0, d.limitMicroUsd - d.usedMicroUsd),
                 overLimit: !d.allowed,
                 retryAfterSec: d.retryAfterSec,
+                windowResetsAt: quotaWindowResetsAt(d),
                 maxTaskCostUsd: deps.config.maxTaskCostUsd,
                 maxTaskTokens: deps.config.maxTaskTokens,
             });

package/dist/http/routes/runs.d.ts

@@ -31,8 +31,8 @@ export declare function handleRunVerbs(req: IncomingMessage, res: ServerResponse
  *    防御性复检(缺席 ⇒ 501),但两个调用方都在自己的入口先判过,那才是各自面上的正确错误形。
  */
 export declare function createDurableRun(req: IncomingMessage, res: ServerResponse, ctx: RouteCtx, prepared: PreparedTaskSubmission, 
-/** in-memory 幂等键(`POST /v1/runs` = `Idempotency-Key` 头派生;A2A = `message.messageId` 派生)。
- *  undefined = 本次提交不参与 in-memory 去重(durable `body.taskId` 重放是独立的第二道)。 */
+/** 这次提交的幂等键(`idemKeyOf(…, "run")`:`POST /v1/runs` = `Idempotency-Key` 头派生;A2A = `message.messageId`
+ *  + 内容指纹派生)—— 落 `task_run.idem_key`,同时是同进程在飞合流的键。undefined = 调用方没带键。 */
 idemKey: string | undefined): Promise<{
     status: number;
     body: unknown;
@@ -42,6 +42,10 @@ export declare const RUNS_ROUTES: readonly [{
     readonly path: "/v1/runs";
     readonly billable: "submit";
     readonly methods: readonly ["POST"];
+}, {
+    readonly id: "runs-by-idem";
+    readonly path: "/v1/runs";
+    readonly methods: readonly ["GET"];
 }, {
     readonly id: "run-steer";
     readonly pattern: RegExp;