npm - @wildo-ai/saas-backend-lib - Versions diffs - 1.1.2 → 1.1.4 - Mend

@wildo-ai/saas-backend-lib 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1358) hide show

package/dist/esm/flows-actors/a2a/models/a2a.backend.schemas.d.ts CHANGED Viewed

@@ -417,6 +417,66 @@ export declare const ADVANCEABLE_TASK_STATUSES: FlowsActors_Status[];
  * once its protocol meaning is decided.
  */
 export declare const LIVENESS_GOVERNED_TASK_STATUSES: FlowsActors_Status[];
+/**
+ * WHY an absent lease is absent — the difference between a VERDICT and a failed enquiry.
+ *
+ * ## The inversion this vocabulary exists to name (review finding S-1a)
+ *
+ * "No lease" was a single answer with two incompatible meanings, and the sweep read both as
+ * death:
+ *
+ *   - **a pod held this task and stopped refreshing** — the lease existed and lapsed. That is
+ *     abandonment, and repairing the row is the sweep's whole purpose.
+ *   - **this task's liveness was never observable at all** — the owning pod could not write the
+ *     lease (its own Redis connection is broken while the sweep's is fine, or it started the turn
+ *     with no client at all). The turn is HEALTHY and running; nothing about it is knowable from
+ *     the lease.
+ *
+ * The two are indistinguishable from a single read of one key, so the write side leaves a second,
+ * long-lived ESTABLISHMENT marker whenever it successfully writes a lease. Its presence is what
+ * turns an absent lease into evidence; its absence is what makes the reading indeterminate.
+ *
+ * `isLeaseMechanismWritable` does NOT cover this: it is evaluated on the SWEEP's pod, so a
+ * per-pod outage on the executing pod passes it unnoticed. That check answers "can the fleet's
+ * liveness signal be trusted at all"; this answers "does this one task's missing lease mean
+ * anything".
+ *
+ * Four members, not two, because "do not act" has two causes that want opposite follow-ups: one
+ * makes progress toward a verdict on a later run, the other learned nothing at all and must not
+ * be recorded as though it had. Merging them is the semantic collapse this framework refuses.
+ */
+export declare enum A2A_AbandonmentEvidence {
+    /**
+     * The task's lease was demonstrably established and has since lapsed. A pod claimed this work
+     * and stopped refreshing — the classic dead-pod signature, and a VERDICT.
+     */
+    LEASE_LAPSED = "lease-lapsed",
+    /**
+     * No establishment marker, but a PRIOR sweep run recorded the same absence and that observation
+     * is still standing. Two observations separated by at least one sweep period — a lease that a
+     * live pod merely failed to write once is rewritten on the next 10-second heartbeat, so an
+     * absence that survives a full period is not a missed write. A VERDICT.
+     */
+    CORROBORATED_ABSENCE = "corroborated-absence",
+    /**
+     * No establishment marker and no prior observation; THIS run recorded the first one. Not a
+     * verdict — the task is left exactly as it stands, and a later run decides.
+     */
+    FIRST_ABSENCE = "first-absence",
+    /**
+     * Nothing was learned: the observation itself could not be read or recorded. Not a verdict, and
+     * unlike {@link FIRST_ABSENCE} it makes no progress toward one — a later run starts over.
+     */
+    UNDETERMINED = "undetermined"
+}
+/**
+ * May the sweep turn this evidence into a DURABLE terminal status?
+ *
+ * Named rather than inlined at the one call site on purpose: this predicate IS the boundary
+ * between an enquiry and a verdict, and the sweep is the only consumer allowed to cross it. A
+ * second consumer that re-derives the set by hand is how the two come to disagree.
+ */
+export declare function abandonmentEvidenceIsAVerdict(evidence: A2A_AbandonmentEvidence): boolean;
 /**
  * An outbound A2A `Task` — the `result` of `tasks/get`, `tasks/cancel`, and of a
  * `message/send` whose turn could not complete inline.

package/dist/esm/flows-actors/a2a/models/a2a.backend.schemas.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"a2a.backend.schemas.d.ts","sourceRoot":"","sources":["~~../../../../../../~~src/flows-actors/a2a/models/a2a.backend.schemas.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"a2a.backend.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/a2a/models/a2a.backend.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/flows-actors/a2a/models/a2a.backend.schemas.js CHANGED Viewed

@@ -441,5 +441,68 @@ export const ADVANCEABLE_TASK_STATUSES = Object.values(FlowsActors_Status).filte
  * once its protocol meaning is decided.
  */
 export const LIVENESS_GOVERNED_TASK_STATUSES = Object.values(FlowsActors_Status).filter(isLivenessGovernedA2ATaskStatus);
+/**
+ * WHY an absent lease is absent — the difference between a VERDICT and a failed enquiry.
+ *
+ * ## The inversion this vocabulary exists to name (review finding S-1a)
+ *
+ * "No lease" was a single answer with two incompatible meanings, and the sweep read both as
+ * death:
+ *
+ *   - **a pod held this task and stopped refreshing** — the lease existed and lapsed. That is
+ *     abandonment, and repairing the row is the sweep's whole purpose.
+ *   - **this task's liveness was never observable at all** — the owning pod could not write the
+ *     lease (its own Redis connection is broken while the sweep's is fine, or it started the turn
+ *     with no client at all). The turn is HEALTHY and running; nothing about it is knowable from
+ *     the lease.
+ *
+ * The two are indistinguishable from a single read of one key, so the write side leaves a second,
+ * long-lived ESTABLISHMENT marker whenever it successfully writes a lease. Its presence is what
+ * turns an absent lease into evidence; its absence is what makes the reading indeterminate.
+ *
+ * `isLeaseMechanismWritable` does NOT cover this: it is evaluated on the SWEEP's pod, so a
+ * per-pod outage on the executing pod passes it unnoticed. That check answers "can the fleet's
+ * liveness signal be trusted at all"; this answers "does this one task's missing lease mean
+ * anything".
+ *
+ * Four members, not two, because "do not act" has two causes that want opposite follow-ups: one
+ * makes progress toward a verdict on a later run, the other learned nothing at all and must not
+ * be recorded as though it had. Merging them is the semantic collapse this framework refuses.
+ */
+export var A2A_AbandonmentEvidence;
+(function (A2A_AbandonmentEvidence) {
+    /**
+     * The task's lease was demonstrably established and has since lapsed. A pod claimed this work
+     * and stopped refreshing — the classic dead-pod signature, and a VERDICT.
+     */
+    A2A_AbandonmentEvidence["LEASE_LAPSED"] = "lease-lapsed";
+    /**
+     * No establishment marker, but a PRIOR sweep run recorded the same absence and that observation
+     * is still standing. Two observations separated by at least one sweep period — a lease that a
+     * live pod merely failed to write once is rewritten on the next 10-second heartbeat, so an
+     * absence that survives a full period is not a missed write. A VERDICT.
+     */
+    A2A_AbandonmentEvidence["CORROBORATED_ABSENCE"] = "corroborated-absence";
+    /**
+     * No establishment marker and no prior observation; THIS run recorded the first one. Not a
+     * verdict — the task is left exactly as it stands, and a later run decides.
+     */
+    A2A_AbandonmentEvidence["FIRST_ABSENCE"] = "first-absence";
+    /**
+     * Nothing was learned: the observation itself could not be read or recorded. Not a verdict, and
+     * unlike {@link FIRST_ABSENCE} it makes no progress toward one — a later run starts over.
+     */
+    A2A_AbandonmentEvidence["UNDETERMINED"] = "undetermined";
+})(A2A_AbandonmentEvidence || (A2A_AbandonmentEvidence = {}));
+/**
+ * May the sweep turn this evidence into a DURABLE terminal status?
+ *
+ * Named rather than inlined at the one call site on purpose: this predicate IS the boundary
+ * between an enquiry and a verdict, and the sweep is the only consumer allowed to cross it. A
+ * second consumer that re-derives the set by hand is how the two come to disagree.
+ */
+export function abandonmentEvidenceIsAVerdict(evidence) {
+    return evidence === A2A_AbandonmentEvidence.LEASE_LAPSED || evidence === A2A_AbandonmentEvidence.CORROBORATED_ABSENCE;
+}
 /** @wildo_source:part:end saas.backend.flows-actors.a2a-agent-card */
 //# sourceMappingURL=a2a.backend.schemas.js.map

package/dist/esm/flows-actors/a2a/models/a2a.backend.schemas.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"a2a.backend.schemas.js","sourceRoot":"","sources":["../../../../../../src/flows-actors/a2a/models/a2a.backend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE, FlowsActors_Status } from '@wildo-ai/saas-models';\n\n/*\n Backend-local contracts for the inbound Agent2Agent (A2A) JSON-RPC transport.\n * The public card advertises both A2A 1.0 and the legacy 0.2.5 dialect; the\n * controller normalizes both vocabularies onto these canonical message, task,\n * push-notification and agent-card shapes.\n \n Kept backend-local (not `saas-models`) on purpose: no frontend or\n * cross-package consumer owns the A2A wire representation. The conversational\n * runtime remains transport-agnostic; this module owns only the external\n * protocol boundary and the dialect-neutral shapes used by the controller.\n /\n\n/* Legacy scalar version retained for 0.2.5 clients that do not read `supportedInterfaces`. /\nexport const A2A_PROTOCOL_VERSION = '0.2.5';\n\n/\n The transport name for this surface's JSON-RPC binding, as `AgentInterface.transport` spells it.\n \n spec-cite: A2A 1.0 §5.3 — the binding table's JSON-RPC column; the proto's `AgentInterface`\n * carries the transport alongside the url and version.\n /\nexport const A2A_JSONRPC_TRANSPORT = 'JSONRPC';\n\n/* A2A message roles. External callers send `user`; the agent replies as `agent`. /\nexport enum A2A_MessageRole {\n USER = 'user',\n AGENT = 'agent',\n}\n\n/\n A single text part of an A2A message. A2A also defines `file` and `data`\n * parts; this slice consumes/produces TEXT only (the conversational runtime is\n * text-in/markdown-out) and fails closed on a message with no text part.\n /\nexport const A2A_TextPartSchema: z.ZodObject<{\n kind: z.ZodLiteral<'text'>;\n text: z.ZodString;\n}> = z.object({\n kind: z.literal('text'),\n text: z.string(),\n});\n\n/\n An inbound A2A part. Non-text parts are tolerated on the wire (passthrough,\n * unknown-key-preserving) but ignored by the text-only mapping — we never reject\n * a caller for sending a richer part, we just read the text.\n /\nexport const A2A_InboundPartSchema: z.ZodType<Record<string, unknown>> = z.looseObject({\n kind: z.string(),\n});\n\n/* Inbound A2A message (the `params.message` of a `message/send` / `message/stream`). /\nexport const A2A_InboundMessageSchema: z.ZodObject<{\n role: z.ZodOptional<z.ZodEnum<typeof A2A_MessageRole>>;\n parts: z.ZodArray<typeof A2A_InboundPartSchema>;\n messageId: z.ZodOptional<z.ZodString>;\n taskId: z.ZodOptional<z.ZodString>;\n contextId: z.ZodOptional<z.ZodString>;\n metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;\n}> = z.object({\n role: z.enum(A2A_MessageRole).optional(),\n parts: z.array(A2A_InboundPartSchema),\n messageId: z.string().optional(),\n /\n A2A task continuation — \"this message belongs to task X\".\n \n DECLARED AND REJECTED, not declared-and-ignored (review finding A3-9). This transport opens a\n * task per non-inline turn and has no continuation runtime, so honouring the field is a later\n * phase. The two alternatives to rejecting are both worse: dropping it from the schema strips it\n * silently (still reading as supported), and accepting it would open a SECOND task for a message\n * the client explicitly attached to a first — a divergence the client cannot see. The controller\n * therefore answers `INVALID_PARAMS` naming `contextId` as the supported way to continue a thread.\n /\n taskId: z.string().optional(),\n contextId: z.string().optional(),\n metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\n/\n `configuration` of an A2A `message/send` / `message/stream` call.\n \n ## `blocking` is the protocol's field. `returnImmediately` never existed.\n \n ⚠️ An earlier revision keyed the whole task plane on `configuration.returnImmediately`, described\n * as \"the PROTOCOL's own answer to whether this turn is inline\" and supported by quotations\n * attributed to the specification. *The field is not in A2A, and the quotations are not in the\n specification.** v0.2.5 defines `MessageSendConfiguration` as\n * `{ acceptedOutputModes, historyLength?, pushNotificationConfig?, blocking? }`, where `blocking` is\n * documented as \"If the server should treat the client as a blocking request\".\n \n The consequence was not cosmetic: every mechanism built on the trigger — task materialisation,\n * `tasks/get`, `tasks/cancel`, the Redis lease and cancel broadcast, the compare-and-swap, the\n * abandoned-task sweep — was reachable only by a client sending a Wildo-invented field. A\n * conformant client asking for exactly this behaviour with `{\"blocking\": false}` got a blocking\n * call and could never obtain a task id.\n \n The sense is also INVERTED from the field it replaced, so this is not a rename:\n * `returnImmediately: true` ⇒ `blocking: false`.\n \n Absent means blocking. The spec makes the field optional and prescribes no default, so the\n * choice is ours: a client that says nothing keeps the inline `Message` reply, which preserves the\n * hot-path property D-P1-1 exists for (no task row per turn) and changes nothing for existing\n * callers. Only an explicit `blocking: false` opts into a task.\n \n `z.looseObject` on purpose: the configuration carries further fields this transport does not\n * implement yet (`acceptedOutputModes`, `historyLength`, `pushNotificationConfig`), and dropping\n * unknown keys silently would make a future client's request look accepted while its intent was\n * discarded.\n /\nexport const A2A_MessageSendConfigurationSchema: z.ZodType<Record<string, unknown>> = z.looseObject({\n blocking: z.boolean().optional(),\n});\n\n/\n Does this configuration ask for a NON-BLOCKING turn — i.e. a task the client will poll?\n \n The one place the protocol field is interpreted, so the inversion lives here rather than at each\n * call site. `undefined` is deliberately NOT non-blocking; see the schema note above.\n /\nexport function requestsNonBlockingTurn(configuration: unknown): boolean {\n return (configuration as { blocking?: unknown } \| undefined)?.blocking === false;\n}\n\n/* `params` of an A2A `message/send` / `message/stream` call. /\n/\n ⚠️ `looseObject`, and the strict version was a REAL defect — found live, not in review.\n \n A2A 1.0 puts its non-blocking flag at the TOP LEVEL (`return_immediately`), where v0.2.5 nests it\n * under `configuration.blocking`. A strict `z.object` silently STRIPS unknown top-level keys, so\n * `return_immediately` never survived the parse: a 1.0 client's request for a non-blocking turn was\n * discarded, the turn blocked, and the response was a `Message` where the client expected a `Task`.\n * No error anywhere — the client simply looked broken.\n \n The reasoning was already written down TWICE in this very file, on\n * `A2A_MessageSendConfigurationSchema` and `A2A_TaskIdParamsSchema`: \"dropping unknown keys\n silently would make a future client's request look accepted while its intent was discarded.\"\n This schema was the one sibling that did not follow it, and the cost was exactly the one predicted.\n /\nexport const A2A_MessageSendParamsSchema: z.ZodType<{\n message: z.infer<typeof A2A_InboundMessageSchema>;\n configuration?: Record<string, unknown>;\n metadata?: Record<string, unknown>;\n}> = z.looseObject({\n message: A2A_InboundMessageSchema,\n configuration: A2A_MessageSendConfigurationSchema.optional(),\n metadata: z.record(z.string(), z.unknown()).optional(),\n}) as unknown as z.ZodType<{\n message: z.infer<typeof A2A_InboundMessageSchema>;\n configuration?: Record<string, unknown>;\n metadata?: Record<string, unknown>;\n}>;\n\n/\n `params` of an A2A `tasks/get` / `tasks/cancel` call — both address a task by id.\n \n `looseObject` for the same reason the send configuration uses it (review finding L-4): the spec\n * carries further fields here — `historyLength` on `tasks/get` — that this transport does not\n * implement. A strict object DROPS them silently, so the request looks accepted while the client's\n * intent was discarded. Tolerating-and-ignoring is honest; the fields simply have no effect yet.\n \n `id` stays `z.string()`, which is also the NoSQL-operator-injection boundary: an object here\n * would otherwise reach the owner filter as a query operator.\n /\nexport const A2A_TaskIdParamsSchema: z.ZodType<{ id: string; metadata?: Record<string, unknown> }> = z.looseObject({\n id: z.string().min(1),\n metadata: z.record(z.string(), z.unknown()).optional(),\n}) as unknown as z.ZodType<{ id: string; metadata?: Record<string, unknown> }>;\nexport type A2A_TaskIdParams = z.infer<typeof A2A_TaskIdParamsSchema>;\n\n/* JSON-RPC 2.0 request envelope for the A2A endpoint. /\nexport const A2A_JsonRpcRequestSchema: z.ZodObject<{\n jsonrpc: z.ZodLiteral<'2.0'>;\n id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;\n method: z.ZodString;\n params: z.ZodOptional<z.ZodUnknown>;\n}> = z.object({\n jsonrpc: z.literal('2.0'),\n id: z.union([z.string(), z.number(), z.null()]),\n method: z.string(),\n params: z.unknown().optional(),\n});\n\nexport type A2A_JsonRpcRequest = z.infer<typeof A2A_JsonRpcRequestSchema>;\nexport type A2A_MessageSendParams = z.infer<typeof A2A_MessageSendParamsSchema>;\n\n/\n JSON-RPC error codes for this transport, split into the two ranges that actually exist.\n \n ## The numbering is SPEC-CONFORMANT, and that was a correction\n \n A2A assigns SIX codes in this block: `-32001` TaskNotFound, `-32002` TaskNotCancelable,\n * `-32003` PushNotificationNotSupported, `-32004` UnsupportedOperation, `-32005`\n * ContentTypeNotSupported, `-32006` InvalidAgentResponse. `-32007`..`-32009` are UNASSIGNED in\n * v0.2.5.\n * spec-cite: A2A v0.2.5 §8.2 (error code assignments)\n \n An earlier revision of this enum occupied five of those slots with Wildo meanings, so a\n * conformant client mis-read every one — an unknown skill answered `-32002`, which the spec defines\n * as TaskNotCancelable, so the client was told the task could not be canceled.\n * spec-cite: N/A — that reading is the MEANING a client derives from the code, not a quotation.\n \n spec-cite: N/A — the sentence quoted just below is this file's OWN retired claim, reproduced so\n * the error is legible; it is not attributed to the specification.\n \n ⚠️ THE COUNT HAS NOW BEEN WRONG TWICE IN THIS BLOCK, which is worth more than the correction.\n * The first note flagged only the `-32001` clash and picked `-32005` without noticing it too was\n * assigned. The SECOND said the spec assigns nine and that \"every slot was taken; there was never a\n * free one to move into\" — and a later pass added a `spec-cite:` marker directly beneath it, so a\n * citation ended up vouching for a number nobody had checked. A citation records WHERE to look; it\n * is not evidence that anyone looked. Re-derive counts from the document, never from this block.\n \n Reserving `-32007`..`-32009` rather than using them is therefore a WILDO CHOICE, not a necessity:\n * they are free today, and leaving them alone keeps the Wildo range from colliding with codes a\n * future A2A version may assign.\n \n The resolution keeps the two ranges apart:\n \n - -32001..-32009 — A2A's, used ONLY with A2A's meanings. Adding a code here means adopting\n * the spec's error for it, never inventing one.\n * - -32010..-32099 — Wildo's. JSON-RPC 2.0 reserves `-32000..-32099` for implementation-defined\n * server errors, and A2A assigns nothing above `-32006`, so this is genuinely free. Wildo\n * concerns that the protocol has no vocabulary for (authentication, skill routing, rate limits,\n * spend caps) live here and cannot collide with a future spec code below `-32010`.\n \n Renumbering was a WIRE change to a shipped surface; it is safe here only because this is a\n * greenfield project, and the e2e assertions that pinned the old literals were moved with it.\n /\nexport enum A2A_JsonRpcErrorCode {\n // ── JSON-RPC 2.0 standard ────────────────────────────────────────────────────────────────\n PARSE_ERROR = -32700,\n INVALID_REQUEST = -32600,\n METHOD_NOT_FOUND = -32601,\n INVALID_PARAMS = -32602,\n INTERNAL_ERROR = -32603,\n\n // ── A2A-assigned (-32001..-32009): the spec's codes, with the spec's meanings ─────────────\n /* A2A `TaskNotFoundError`: the addressed task does not exist, or is not visible to this caller. /\n TASK_NOT_FOUND = -32001,\n /\n A2A `TaskNotCancelableError`: the task is already terminal, so it cannot be canceled.\n \n spec-cite: A2A v0.2.5 §7.4 (tasks/cancel error list, permissive tone) — and N/A for the quoted\n * `\"MUST NOT succeed\"`, which appears here BECAUSE it is false, and for the two client-outcome\n * phrases, which are not document text.\n \n ⚠️ A WILDO DESIGN DECISION, not a protocol requirement — and an earlier revision of this note\n * claimed otherwise by quoting `\"MUST NOT succeed\"` as specification text. *That string is not in\n v0.2.5.** §7.4 is permissive in tone (\"the server will attempt to cancel… but success is not\n * guaranteed\") and lists `TaskNotCancelableError` among its example errors. So the spec PERMITS\n * this answer; it does not mandate it.\n \n spec-cite: N/A — the two phrases below are the OUTCOMES a client could not tell apart, not\n * text from the document.\n \n The reason we choose it stands on its own, which is why the correction changes no behaviour:\n * answering 200 with the task makes \"I stopped it\" and \"it had already finished\"\n * indistinguishable on the wire, and those are different outcomes to anything reconciling state.\n * The task remains readable via `tasks/get` either way.\n /\n TASK_NOT_CANCELABLE = -32002,\n /\n A2A `PushNotificationNotSupportedError`: the agent does not support webhook task updates.\n \n Returned by all four push-notification-configuration operations whenever the agent card\n * advertises `capabilities.pushNotifications: false`. The norm makes this a MUST, and it is not\n * interchangeable with `METHOD_NOT_FOUND`: a client that receives `-32601` cannot distinguish\n * \"this agent does not do push notifications\" from \"this agent is not A2A-compliant\", whereas\n * `-32003` tells it exactly which capability to stop asking for.\n \n spec-cite: A2A 1.0 §3.3.4 — \"If `AgentCard.capabilities.pushNotifications` is `false` or not\n present, operations related to push notification configuration (Create, Get, List, Delete)\n * MUST return `PushNotificationNotSupportedError`\"* — and §5.4, which assigns it the JSON-RPC\n * code `-32003` (gRPC `FAILED_PRECONDITION`, HTTP `400 Bad Request`).\n /\n PUSH_NOTIFICATION_NOT_SUPPORTED = -32003,\n /\n A2A `UnsupportedOperationError`: the agent does not support this operation.\n \n Distinct from `METHOD_NOT_FOUND` in exactly the way `-32003` is: `-32601` says \"this server does\n * not know that method\", which a client cannot tell from a misrouted or non-compliant server, so\n * it retries or reports a transport fault. `-32004` says \"this agent knows the operation and does\n * not offer it\" — permanent, cacheable, actionable.\n \n spec-cite: A2A 1.0 §5.4 assigns `UnsupportedOperationError` the JSON-RPC code `-32004` (gRPC\n * `FAILED_PRECONDITION`, HTTP `400 Bad Request`); §3.3.4 — \"If `AgentCard.capabilities.\n extendedAgentCard` is `false` or not present, attempts to call the Get Extended Agent Card\n * operation MUST return `UnsupportedOperationError`\".\n /\n UNSUPPORTED_OPERATION = -32004,\n\n // ── Wildo-assigned (-32010..-32099): concerns A2A has no vocabulary for ───────────────────\n /** The caller is unauthenticated / the token is invalid. /\n UNAUTHENTICATED = -32010,\n /* The referenced skill / actor system does not exist, or is outside this agent's subset. /\n SKILL_NOT_FOUND = -32011,\n /\n The caller exceeded the per-principal turn rate cap. Ridden by a transport-level HTTP 429 +\n * `Retry-After` (throttling is a transport concern), unlike the codes above which ride HTTP 200\n * per JSON-RPC. The body stays a valid JSON-RPC error so strict clients still parse it.\n /\n RATE_LIMITED = -32012,\n /\n The caller's tenant has exhausted its plan-granted LLM token budget for the current period.\n * Ridden by a transport-level HTTP 402 — deliberately NOT the 429 + `Retry-After` of\n * {@link RATE_LIMITED}: a spend cap is not a rolling-window throttle, so the client's correct\n * reaction is to upgrade the plan or wait for the period to roll, not to retry after N seconds.\n * 402 matches the existing `FEATURE_LIMIT_EXCEEDED` / `INSUFFICIENT_CREDITS` billing mapping.\n /\n BUDGET_EXCEEDED = -32013,\n}\n\n/\n @wildo_source:part:start saas.backend.flows-actors.a2a-task-surface facet:layer:backend facet:family:flows-actors\n \n The A2A TASK surface your app exposes to external agents. You never author these —\n * the engine serves them — but knowing the contract tells you what an agent client can\n * do with a turn your actor system runs.\n \n A task is materialised ONLY when a turn cannot complete inline:\n * - the client sent `configuration.blocking: false` (the A2A field — absent means blocking), or\n * - the turn reached an interrupted state (a human-in-the-loop approval pause).\n \n BOTH triggers are live. The interrupted-state arm needs a runtime that can pause a turn; that\n * is the human-in-the-loop approval gate, and a paused turn now materialises a task carrying\n * `input-required` on all three transports (blocking send, non-blocking send, stream). An earlier\n * revision of this note warned that the arm was inert and `input-required` never emitted — true\n * when written, and left here in corrected form because a reader who remembers the old claim would\n * otherwise conclude the state is decorative and safe to drop.\n \n A blocking turn that answers in one shot returns an A2A `Message` and writes no task\n * row at all. Both shapes are protocol-conformant: the specification types the\n * `message/send` result as `Task \| Message`, so returning either is conformance rather than a\n * shortcut. The inline case is the default so a chatty agent does not accumulate a row per turn.\n * spec-cite: A2A v0.2.5 §7.1 (SendMessageResponse result type)\n \n \n * Once a task exists the client can poll it with `tasks/get` and stop it with\n * `tasks/cancel`. Cancel is a STATUS TRANSITION, never a delete: the spec requires it to\n * return the task's updated state, so a cancelled task stays readable.\n \n ⚠️ What cancel does and does not guarantee. It always records the cancellation, and\n * it aborts the model call for the streaming API transports — which is every agent using\n * the standard text/chat operations. It does NOT interrupt two cases: an agent whose\n * transport buffers its whole reply (a CLI-transport agent, or a non-text operation), and\n * a tool call already in flight — those finish, and only then does the turn stop. So\n * cancel is best read as \"stop as soon as the runtime is able\", not \"stop instantly\".\n * The task record is the truth about the request either way.\n \n Import path: `@wildo-ai/saas-backend-lib`.\n /\n/\n ⚠️ DOCUMENTATION-ONLY. Nothing implements this interface — it exists to give the anchored\n * excerpt a typed shape an app builder can read. The real methods are\n * `A2ATaskBackendService.readTask` / `advanceTask`, whose signatures differ (they take an\n * owner scope). Do not `implements` this; keep it in step with the service by hand, or\n * delete it if it ever drifts.\n /\nexport interface A2A_TaskSurfaceContract {\n /* `tasks/get` — read one task by id. Returns the task in its current state. /\n tasksGet: (taskId: string) => Promise<A2A_OutboundTask \| undefined>;\n /* `tasks/cancel` — request cancellation; returns the task's UPDATED state. /\n tasksCancel: (taskId: string) => Promise<A2A_OutboundTask \| undefined>;\n}\n\n/\n A2A task lifecycle states — the PROTOCOL's closed vocabulary (v0.2.5).\n \n Declared as a named enum rather than inline literals because it is exactly the\n * kind of closed semantic vocabulary that must have one runtime source: the\n * projection from `FlowsActors_Status` reads it, the transport emits it, and tests\n * pin it.\n \n Not every member is emitted by this transport today — `AUTH_REQUIRED` and\n * `REJECTED` have no `FlowsActors_Status` counterpart and are never produced. They\n * are declared because the vocabulary belongs to the protocol, not to us: a client\n * may legitimately receive them from another A2A server, and omitting them would\n * invite a future contributor to invent a second, partial enum.\n /\nexport enum A2A_TaskState {\n /* Acknowledged, not yet processing. /\n SUBMITTED = 'submitted',\n /* Actively being processed. /\n WORKING = 'working',\n /\n Interrupted (non-terminal): the agent needs input. The current transport emits this when a\n * user-delegated turn reaches an approval-gated tool, persists the signed pending decision and\n * materialises an addressable task. Approval or refusal resumes that same execution; machine\n * principals are denied rather than parked because no named person can answer for them.\n /\n INPUT_REQUIRED = 'input-required',\n /* Interrupted (non-terminal): authentication needed. NOT emitted by this transport. /\n AUTH_REQUIRED = 'auth-required',\n /* Terminal: finished successfully. /\n COMPLETED = 'completed',\n /* Terminal: finished with error. /\n FAILED = 'failed',\n /* Terminal: canceled before completion. /\n CANCELED = 'canceled',\n /* Terminal: refused by the agent. NOT emitted by this transport. /\n REJECTED = 'rejected',\n /\n Terminal: the agent cannot determine the task's state.\n \n Declared for the same reason as `AUTH_REQUIRED` and `REJECTED` — the enum's rule is that the\n * protocol vocabulary is represented in full so nobody invents a second, partial one. It was\n * simply missed: the spec defines NINE states and this declared eight (review finding G5-6).\n * Never emitted by this transport, which always knows a task's state or cannot find the row.\n /\n UNKNOWN = 'unknown',\n}\n\n/* States after which no further work occurs — a terminal task cannot be canceled. /\nexport const A2A_TERMINAL_TASK_STATES: ReadonlySet<A2A_TaskState> = new Set([\n A2A_TaskState.COMPLETED,\n A2A_TaskState.FAILED,\n A2A_TaskState.CANCELED,\n A2A_TaskState.REJECTED,\n A2A_TaskState.UNKNOWN,\n]);\n/* @wildo_source:part:end saas.backend.flows-actors.a2a-task-surface /\n\n/\n Deliberately OUTSIDE the `@wildo_source` anchor above: this is an authoring correction for\n * framework maintainers, and the anchored span ships verbatim into application-facing skills\n * where neither the anchor nor this repository's revision history exists.\n \n ⚠️ An earlier revision of the `message/send` paragraph above supported its conclusion with a\n * QUOTATION — \"the agent MAY create a new Task … or MAY return a direct Message response for\n * simple interactions\" — attributed to the A2A specification. It is not in the document.\n * spec-cite: N/A — that sentence is quoted precisely BECAUSE it is absent from A2A v0.2.5; it is\n * the defect, not the standard's words.\n \n The conclusion was right and the authority was invented, and because the block was anchored it\n * shipped that invention into the app-facing skill. Cite the TYPE, which is checkable in one step,\n * not a remembered sentence. See `.claude/rules/external-specification-citations.md`.\n /\n\n/\n Project the engine's persisted lifecycle status onto the A2A protocol vocabulary.\n \n This is the ONLY place the two vocabularies meet, and it is exhaustive by\n * construction — `FlowsActors_Status` is a closed enum, so adding a member without\n * deciding its protocol meaning is a compile error at the `satisfies` below rather\n * than a silent fallthrough to some default state.\n \n Both `READY` and `PENDING` project to `SUBMITTED`: the protocol draws its line at\n * \"acknowledged but not yet processing\", and our two pre-processing states are on the\n * same side of it. `ABORTED` projects to `FAILED` rather than `CANCELED` deliberately —\n * `CANCELED` means a caller asked for it, whereas `ABORTED` is the runtime halting\n * itself (e.g. a tripped circuit breaker), which a client should read as a failure it\n * did not request.\n /\nconst A2A_STATE_BY_FLOWS_ACTORS_STATUS = {\n [FlowsActors_Status.READY]: A2A_TaskState.SUBMITTED,\n [FlowsActors_Status.PENDING]: A2A_TaskState.SUBMITTED,\n [FlowsActors_Status.PROCESSING]: A2A_TaskState.WORKING,\n [FlowsActors_Status.AWAITING_APPROVAL]: A2A_TaskState.INPUT_REQUIRED,\n [FlowsActors_Status.COMPLETED]: A2A_TaskState.COMPLETED,\n [FlowsActors_Status.FAILED]: A2A_TaskState.FAILED,\n [FlowsActors_Status.CANCELLED]: A2A_TaskState.CANCELED,\n [FlowsActors_Status.ABORTED]: A2A_TaskState.FAILED,\n} satisfies Record<FlowsActors_Status, A2A_TaskState>;\n\n/* Project a persisted task status onto its A2A protocol state. /\nexport function toA2ATaskState(status: FlowsActors_Status): A2A_TaskState {\n return A2A_STATE_BY_FLOWS_ACTORS_STATUS[status];\n}\n\n/* True when the persisted status is one the protocol treats as terminal. /\nexport function isTerminalA2ATaskStatus(status: FlowsActors_Status): boolean {\n return A2A_TERMINAL_TASK_STATES.has(toA2ATaskState(status));\n}\n\n/\n The stored instance identity of the DEFAULT (unnamed) A2A agent.\n \n Declared instance refs are constrained to `^[a-z0-9][a-z0-9-]$`, so the `` characters make\n * this value unreachable by any real ref — the default agent gets its own identity on the task\n * plane without a collision, and without the filter having to special-case an absent field.\n /\nexport const A2A_DEFAULT_INSTANCE_REF: string = FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE;\n\n/\n States in which a task is waiting on something OUTSIDE the runtime — a human approval, an\n * authentication step — rather than executing on any pod.\n \n ## Why this is a THIRD class and not a shade of \"non-terminal\" (review finding A3-3)\n \n The liveness design asks one question: \"a pod claimed this work — is that pod still alive?\"\n * That question is only meaningful while a pod is actually executing. Splitting statuses merely\n * into terminal / non-terminal conflates two very different non-terminal situations:\n \n - executing — a pod holds the turn and refreshes a lease. No lease ⇒ the pod died ⇒ the\n * task is abandoned, and reporting the stored `working` forever would be a lie.\n * - interrupted — nobody is executing, deliberately. The lease is released the moment the\n * turn unwinds, so a paused task has no lease BY DESIGN. Applying the abandonment rule here\n * reads a correct pause as a dead pod.\n \n With only the two-way split, a task paused for approval read as `failed` on the very next\n * poll and the sweep then made that durable within the grace window — so the approval seam\n * Phase 1 claims to have prepared would have been destroyed by Phase 1's own liveness rules\n * before Phase 2 could use it. A human approval takes minutes to hours; a lease TTL is 30s.\n \n Deliberately OUTSIDE the `@wildo_source` anchor above: this is engine-internal liveness\n * taxonomy, not app-facing protocol surface, and widening the shipped contract with states this\n * transport cannot yet reach is the mistake finding G2-3 recorded.\n /\nexport const A2A_INTERRUPTED_TASK_STATES: ReadonlySet<A2A_TaskState> = new Set([\n A2A_TaskState.INPUT_REQUIRED,\n A2A_TaskState.AUTH_REQUIRED,\n]);\n\n/\n True when the task's status is one whose truthfulness depends on a pod being alive — i.e.\n * neither terminal nor interrupted.\n \n This is the ONLY predicate that should gate derive-on-read downgrades and the abandoned-task\n * sweep. Using `!isTerminalA2ATaskStatus(...)` for that purpose is the A3-3 defect.\n /\nexport function isLivenessGovernedA2ATaskStatus(status: FlowsActors_Status): boolean {\n const state = toA2ATaskState(status);\n return !A2A_TERMINAL_TASK_STATES.has(state) && !A2A_INTERRUPTED_TASK_STATES.has(state);\n}\n\n/\n The persisted statuses a task may still be advanced FROM — everything non-terminal.\n \n This is the compare-and-swap set for `advanceTask` (finding A3-2). Note it deliberately\n * INCLUDES the interrupted states: a task paused for approval must remain cancellable, and\n * Phase 2 must be able to resume it. \"Cannot be advanced\" means terminal, nothing else.\n /\nexport const ADVANCEABLE_TASK_STATUSES: FlowsActors_Status[] =\n (Object.values(FlowsActors_Status) as FlowsActors_Status[]).filter((status) => !isTerminalA2ATaskStatus(status));\n\n/\n The persisted statuses whose stored value is only trustworthy while a pod is alive — the\n * candidate set for the abandoned-task sweep and for the derive-on-read downgrade.\n \n Strictly NARROWER than {@link ADVANCEABLE_TASK_STATUSES}: an interrupted task is advanceable\n * but is not abandoned merely because no pod holds it. Both are derived from the single status\n * projection above, so a new `FlowsActors_Status` member lands in the right set automatically\n * once its protocol meaning is decided.\n /\nexport const LIVENESS_GOVERNED_TASK_STATUSES: FlowsActors_Status[] =\n (Object.values(FlowsActors_Status) as FlowsActors_Status[]).filter(isLivenessGovernedA2ATaskStatus);\n\n/\n An outbound A2A `Task` — the `result` of `tasks/get`, `tasks/cancel`, and of a\n * `message/send` whose turn could not complete inline.\n \n `status.state` is the projection of the persisted `FlowsActors_Status`; `status.timestamp`\n * is when that state was last advanced, so a polling client can tell a fresh `working`\n * from a stale one.\n /\nexport interface A2A_OutboundTask {\n kind: 'task';\n id: string;\n contextId: string;\n status: {\n state: A2A_TaskState;\n timestamp: string;\n /* Present when the state carries an agent-visible message (e.g. why input is required). /\n message?: A2A_OutboundMessage;\n };\n artifacts?: { artifactId: string; name?: string; parts: { kind: string; [k: string]: unknown }[] }[];\n metadata?: Record<string, unknown>;\n}\n\n/* An outbound A2A text message (the `result` of a blocking `message/send`). /\nexport interface A2A_OutboundMessage {\n kind: 'message';\n role: A2A_MessageRole.AGENT;\n parts: { kind: 'text'; text: string }[];\n messageId: string;\n contextId: string;\n metadata?: Record<string, unknown>;\n}\n\n/\n @wildo_source:part:start saas.backend.flows-actors.a2a-agent-card facet:layer:backend facet:family:flows-actors\n \n The A2A discovery contract an external agent fetches at\n * `GET /a2a/.well-known/agent-card.json` to learn what your app exposes over\n * Agent2Agent and how to authenticate. It is SERVED by the engine — you never\n * author it: every ACTOR system with an AGENTIC actor bound to an agent is\n * exposed automatically as one `A2A_Skill` (`skill.id === system.ref`). External\n * agents then POST JSON-RPC `message/send` / `message/stream` to the card `url`.\n * Import path: `@wildo-ai/saas-backend-lib`.\n /\n\n/* One advertised A2A skill = one exposed agentic actor system (`id === system.ref`). /\nexport interface A2A_Skill {\n id: string;\n name: string;\n description: string;\n tags: string[];\n examples?: string[];\n}\n\n/\n The served A2A agent card. `url` is the absolute task-endpoint URI AND the\n * agent's canonical audience: BOTH a USER-delegated and a MACHINE (client-credentials)\n * inbound token MUST carry it as `aud` (RFC 8707 / external-access D7) — a token minted for\n * another surface (including the generic API audience, per the 2026-07-29 flip) is rejected.\n * `securitySchemes.oauth2.flows`\n * advertises BOTH D6 principals — `authorizationCode` (user-delegated → the\n * conversation is owned by the delegating user) and `clientCredentials` (org/app\n * machine → the conversation is owned by the org/app). Tokens are minted by the\n * app's own OIDC provider (`/oauth/authorize`, `/oauth/token`).\n /\n/\n One protocol interface this agent exposes — a URL, a transport, and the version it speaks there.\n \n spec-cite: A2A 1.0 proto `AgentInterface` — `url` (REQUIRED), and \"The version of the A2A\n protocol this interface exposes. Use the latest supported minor version per major version.\n * Examples: `\"0.3\"`, `\"1.0\"`\".\n /\nexport interface A2A_AgentInterface {\n url: string;\n transport: string;\n version: string;\n}\n\nexport interface A2A_AgentCard {\n /*\n The v0.2.5 scalar version field.\n \n KEPT, and deliberately still `0.2.5`. A v0.2.5 client reads only this field, and it is the\n * version that dialect of the surface actually speaks — advertising `1.0` here would tell every\n * legacy client to send `TASK_STATE_` states and `return_immediately`, which is the exact misread\n this migration exists to prevent. 1.0 clients read {@link supportedInterfaces} instead.\n /\n protocolVersion: string;\n /\n Ordered list of supported interfaces, first entry preferred — the 1.0 mechanism for\n * advertising more than one protocol version.\n \n spec-cite: A2A 1.0 proto `AgentCard` — `repeated AgentInterface supported_interfaces = 3\n * [(google.api.field_behavior) = REQUIRED]`, \"Ordered list of supported interfaces. The first\n entry is preferred.\"\n \n * This is what makes serving two dialects a DECLARED capability rather than an undocumented\n * accident: before it, a 1.0 client could only reach the 1.0 vocabulary by guessing that it\n * existed.\n /\n supportedInterfaces: A2A_AgentInterface[];\n name: string;\n description: string;\n url: string;\n version: string;\n capabilities: { streaming: boolean; pushNotifications: boolean };\n defaultInputModes: string[];\n defaultOutputModes: string[];\n skills: A2A_Skill[];\n securitySchemes: Record<string, unknown>;\n security: Record<string, string[]>[];\n}\n/* @wildo_source:part:end saas.backend.flows-actors.a2a-agent-card */\n"]}
1	+ {"version":3,"file":"a2a.backend.schemas.js","sourceRoot":"","sources":["../../../../../src/flows-actors/a2a/models/a2a.backend.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE, FlowsActors_Status } from '@wildo-ai/saas-models';\n\n/*\n Backend-local contracts for the inbound Agent2Agent (A2A) JSON-RPC transport.\n * The public card advertises both A2A 1.0 and the legacy 0.2.5 dialect; the\n * controller normalizes both vocabularies onto these canonical message, task,\n * push-notification and agent-card shapes.\n \n Kept backend-local (not `saas-models`) on purpose: no frontend or\n * cross-package consumer owns the A2A wire representation. The conversational\n * runtime remains transport-agnostic; this module owns only the external\n * protocol boundary and the dialect-neutral shapes used by the controller.\n /\n\n/* Legacy scalar version retained for 0.2.5 clients that do not read `supportedInterfaces`. /\nexport const A2A_PROTOCOL_VERSION = '0.2.5';\n\n/\n The transport name for this surface's JSON-RPC binding, as `AgentInterface.transport` spells it.\n \n spec-cite: A2A 1.0 §5.3 — the binding table's JSON-RPC column; the proto's `AgentInterface`\n * carries the transport alongside the url and version.\n /\nexport const A2A_JSONRPC_TRANSPORT = 'JSONRPC';\n\n/* A2A message roles. External callers send `user`; the agent replies as `agent`. /\nexport enum A2A_MessageRole {\n USER = 'user',\n AGENT = 'agent',\n}\n\n/\n A single text part of an A2A message. A2A also defines `file` and `data`\n * parts; this slice consumes/produces TEXT only (the conversational runtime is\n * text-in/markdown-out) and fails closed on a message with no text part.\n /\nexport const A2A_TextPartSchema: z.ZodObject<{\n kind: z.ZodLiteral<'text'>;\n text: z.ZodString;\n}> = z.object({\n kind: z.literal('text'),\n text: z.string(),\n});\n\n/\n An inbound A2A part. Non-text parts are tolerated on the wire (passthrough,\n * unknown-key-preserving) but ignored by the text-only mapping — we never reject\n * a caller for sending a richer part, we just read the text.\n /\nexport const A2A_InboundPartSchema: z.ZodType<Record<string, unknown>> = z.looseObject({\n kind: z.string(),\n});\n\n/* Inbound A2A message (the `params.message` of a `message/send` / `message/stream`). /\nexport const A2A_InboundMessageSchema: z.ZodObject<{\n role: z.ZodOptional<z.ZodEnum<typeof A2A_MessageRole>>;\n parts: z.ZodArray<typeof A2A_InboundPartSchema>;\n messageId: z.ZodOptional<z.ZodString>;\n taskId: z.ZodOptional<z.ZodString>;\n contextId: z.ZodOptional<z.ZodString>;\n metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;\n}> = z.object({\n role: z.enum(A2A_MessageRole).optional(),\n parts: z.array(A2A_InboundPartSchema),\n messageId: z.string().optional(),\n /\n A2A task continuation — \"this message belongs to task X\".\n \n DECLARED AND REJECTED, not declared-and-ignored (review finding A3-9). This transport opens a\n * task per non-inline turn and has no continuation runtime, so honouring the field is a later\n * phase. The two alternatives to rejecting are both worse: dropping it from the schema strips it\n * silently (still reading as supported), and accepting it would open a SECOND task for a message\n * the client explicitly attached to a first — a divergence the client cannot see. The controller\n * therefore answers `INVALID_PARAMS` naming `contextId` as the supported way to continue a thread.\n /\n taskId: z.string().optional(),\n contextId: z.string().optional(),\n metadata: z.record(z.string(), z.unknown()).optional(),\n});\n\n/\n `configuration` of an A2A `message/send` / `message/stream` call.\n \n ## `blocking` is the protocol's field. `returnImmediately` never existed.\n \n ⚠️ An earlier revision keyed the whole task plane on `configuration.returnImmediately`, described\n * as \"the PROTOCOL's own answer to whether this turn is inline\" and supported by quotations\n * attributed to the specification. *The field is not in A2A, and the quotations are not in the\n specification.** v0.2.5 defines `MessageSendConfiguration` as\n * `{ acceptedOutputModes, historyLength?, pushNotificationConfig?, blocking? }`, where `blocking` is\n * documented as \"If the server should treat the client as a blocking request\".\n \n The consequence was not cosmetic: every mechanism built on the trigger — task materialisation,\n * `tasks/get`, `tasks/cancel`, the Redis lease and cancel broadcast, the compare-and-swap, the\n * abandoned-task sweep — was reachable only by a client sending a Wildo-invented field. A\n * conformant client asking for exactly this behaviour with `{\"blocking\": false}` got a blocking\n * call and could never obtain a task id.\n \n The sense is also INVERTED from the field it replaced, so this is not a rename:\n * `returnImmediately: true` ⇒ `blocking: false`.\n \n Absent means blocking. The spec makes the field optional and prescribes no default, so the\n * choice is ours: a client that says nothing keeps the inline `Message` reply, which preserves the\n * hot-path property D-P1-1 exists for (no task row per turn) and changes nothing for existing\n * callers. Only an explicit `blocking: false` opts into a task.\n \n `z.looseObject` on purpose: the configuration carries further fields this transport does not\n * implement yet (`acceptedOutputModes`, `historyLength`, `pushNotificationConfig`), and dropping\n * unknown keys silently would make a future client's request look accepted while its intent was\n * discarded.\n /\nexport const A2A_MessageSendConfigurationSchema: z.ZodType<Record<string, unknown>> = z.looseObject({\n blocking: z.boolean().optional(),\n});\n\n/\n Does this configuration ask for a NON-BLOCKING turn — i.e. a task the client will poll?\n \n The one place the protocol field is interpreted, so the inversion lives here rather than at each\n * call site. `undefined` is deliberately NOT non-blocking; see the schema note above.\n /\nexport function requestsNonBlockingTurn(configuration: unknown): boolean {\n return (configuration as { blocking?: unknown } \| undefined)?.blocking === false;\n}\n\n/* `params` of an A2A `message/send` / `message/stream` call. /\n/\n ⚠️ `looseObject`, and the strict version was a REAL defect — found live, not in review.\n \n A2A 1.0 puts its non-blocking flag at the TOP LEVEL (`return_immediately`), where v0.2.5 nests it\n * under `configuration.blocking`. A strict `z.object` silently STRIPS unknown top-level keys, so\n * `return_immediately` never survived the parse: a 1.0 client's request for a non-blocking turn was\n * discarded, the turn blocked, and the response was a `Message` where the client expected a `Task`.\n * No error anywhere — the client simply looked broken.\n \n The reasoning was already written down TWICE in this very file, on\n * `A2A_MessageSendConfigurationSchema` and `A2A_TaskIdParamsSchema`: \"dropping unknown keys\n silently would make a future client's request look accepted while its intent was discarded.\"\n This schema was the one sibling that did not follow it, and the cost was exactly the one predicted.\n /\nexport const A2A_MessageSendParamsSchema: z.ZodType<{\n message: z.infer<typeof A2A_InboundMessageSchema>;\n configuration?: Record<string, unknown>;\n metadata?: Record<string, unknown>;\n}> = z.looseObject({\n message: A2A_InboundMessageSchema,\n configuration: A2A_MessageSendConfigurationSchema.optional(),\n metadata: z.record(z.string(), z.unknown()).optional(),\n}) as unknown as z.ZodType<{\n message: z.infer<typeof A2A_InboundMessageSchema>;\n configuration?: Record<string, unknown>;\n metadata?: Record<string, unknown>;\n}>;\n\n/\n `params` of an A2A `tasks/get` / `tasks/cancel` call — both address a task by id.\n \n `looseObject` for the same reason the send configuration uses it (review finding L-4): the spec\n * carries further fields here — `historyLength` on `tasks/get` — that this transport does not\n * implement. A strict object DROPS them silently, so the request looks accepted while the client's\n * intent was discarded. Tolerating-and-ignoring is honest; the fields simply have no effect yet.\n \n `id` stays `z.string()`, which is also the NoSQL-operator-injection boundary: an object here\n * would otherwise reach the owner filter as a query operator.\n /\nexport const A2A_TaskIdParamsSchema: z.ZodType<{ id: string; metadata?: Record<string, unknown> }> = z.looseObject({\n id: z.string().min(1),\n metadata: z.record(z.string(), z.unknown()).optional(),\n}) as unknown as z.ZodType<{ id: string; metadata?: Record<string, unknown> }>;\nexport type A2A_TaskIdParams = z.infer<typeof A2A_TaskIdParamsSchema>;\n\n/* JSON-RPC 2.0 request envelope for the A2A endpoint. /\nexport const A2A_JsonRpcRequestSchema: z.ZodObject<{\n jsonrpc: z.ZodLiteral<'2.0'>;\n id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;\n method: z.ZodString;\n params: z.ZodOptional<z.ZodUnknown>;\n}> = z.object({\n jsonrpc: z.literal('2.0'),\n id: z.union([z.string(), z.number(), z.null()]),\n method: z.string(),\n params: z.unknown().optional(),\n});\n\nexport type A2A_JsonRpcRequest = z.infer<typeof A2A_JsonRpcRequestSchema>;\nexport type A2A_MessageSendParams = z.infer<typeof A2A_MessageSendParamsSchema>;\n\n/\n JSON-RPC error codes for this transport, split into the two ranges that actually exist.\n \n ## The numbering is SPEC-CONFORMANT, and that was a correction\n \n A2A assigns SIX codes in this block: `-32001` TaskNotFound, `-32002` TaskNotCancelable,\n * `-32003` PushNotificationNotSupported, `-32004` UnsupportedOperation, `-32005`\n * ContentTypeNotSupported, `-32006` InvalidAgentResponse. `-32007`..`-32009` are UNASSIGNED in\n * v0.2.5.\n * spec-cite: A2A v0.2.5 §8.2 (error code assignments)\n \n An earlier revision of this enum occupied five of those slots with Wildo meanings, so a\n * conformant client mis-read every one — an unknown skill answered `-32002`, which the spec defines\n * as TaskNotCancelable, so the client was told the task could not be canceled.\n * spec-cite: N/A — that reading is the MEANING a client derives from the code, not a quotation.\n \n spec-cite: N/A — the sentence quoted just below is this file's OWN retired claim, reproduced so\n * the error is legible; it is not attributed to the specification.\n \n ⚠️ THE COUNT HAS NOW BEEN WRONG TWICE IN THIS BLOCK, which is worth more than the correction.\n * The first note flagged only the `-32001` clash and picked `-32005` without noticing it too was\n * assigned. The SECOND said the spec assigns nine and that \"every slot was taken; there was never a\n * free one to move into\" — and a later pass added a `spec-cite:` marker directly beneath it, so a\n * citation ended up vouching for a number nobody had checked. A citation records WHERE to look; it\n * is not evidence that anyone looked. Re-derive counts from the document, never from this block.\n \n Reserving `-32007`..`-32009` rather than using them is therefore a WILDO CHOICE, not a necessity:\n * they are free today, and leaving them alone keeps the Wildo range from colliding with codes a\n * future A2A version may assign.\n \n The resolution keeps the two ranges apart:\n \n - -32001..-32009 — A2A's, used ONLY with A2A's meanings. Adding a code here means adopting\n * the spec's error for it, never inventing one.\n * - -32010..-32099 — Wildo's. JSON-RPC 2.0 reserves `-32000..-32099` for implementation-defined\n * server errors, and A2A assigns nothing above `-32006`, so this is genuinely free. Wildo\n * concerns that the protocol has no vocabulary for (authentication, skill routing, rate limits,\n * spend caps) live here and cannot collide with a future spec code below `-32010`.\n \n Renumbering was a WIRE change to a shipped surface; it is safe here only because this is a\n * greenfield project, and the e2e assertions that pinned the old literals were moved with it.\n /\nexport enum A2A_JsonRpcErrorCode {\n // ── JSON-RPC 2.0 standard ────────────────────────────────────────────────────────────────\n PARSE_ERROR = -32700,\n INVALID_REQUEST = -32600,\n METHOD_NOT_FOUND = -32601,\n INVALID_PARAMS = -32602,\n INTERNAL_ERROR = -32603,\n\n // ── A2A-assigned (-32001..-32009): the spec's codes, with the spec's meanings ─────────────\n /* A2A `TaskNotFoundError`: the addressed task does not exist, or is not visible to this caller. /\n TASK_NOT_FOUND = -32001,\n /\n A2A `TaskNotCancelableError`: the task is already terminal, so it cannot be canceled.\n \n spec-cite: A2A v0.2.5 §7.4 (tasks/cancel error list, permissive tone) — and N/A for the quoted\n * `\"MUST NOT succeed\"`, which appears here BECAUSE it is false, and for the two client-outcome\n * phrases, which are not document text.\n \n ⚠️ A WILDO DESIGN DECISION, not a protocol requirement — and an earlier revision of this note\n * claimed otherwise by quoting `\"MUST NOT succeed\"` as specification text. *That string is not in\n v0.2.5.** §7.4 is permissive in tone (\"the server will attempt to cancel… but success is not\n * guaranteed\") and lists `TaskNotCancelableError` among its example errors. So the spec PERMITS\n * this answer; it does not mandate it.\n \n spec-cite: N/A — the two phrases below are the OUTCOMES a client could not tell apart, not\n * text from the document.\n \n The reason we choose it stands on its own, which is why the correction changes no behaviour:\n * answering 200 with the task makes \"I stopped it\" and \"it had already finished\"\n * indistinguishable on the wire, and those are different outcomes to anything reconciling state.\n * The task remains readable via `tasks/get` either way.\n /\n TASK_NOT_CANCELABLE = -32002,\n /\n A2A `PushNotificationNotSupportedError`: the agent does not support webhook task updates.\n \n Returned by all four push-notification-configuration operations whenever the agent card\n * advertises `capabilities.pushNotifications: false`. The norm makes this a MUST, and it is not\n * interchangeable with `METHOD_NOT_FOUND`: a client that receives `-32601` cannot distinguish\n * \"this agent does not do push notifications\" from \"this agent is not A2A-compliant\", whereas\n * `-32003` tells it exactly which capability to stop asking for.\n \n spec-cite: A2A 1.0 §3.3.4 — \"If `AgentCard.capabilities.pushNotifications` is `false` or not\n present, operations related to push notification configuration (Create, Get, List, Delete)\n * MUST return `PushNotificationNotSupportedError`\"* — and §5.4, which assigns it the JSON-RPC\n * code `-32003` (gRPC `FAILED_PRECONDITION`, HTTP `400 Bad Request`).\n /\n PUSH_NOTIFICATION_NOT_SUPPORTED = -32003,\n /\n A2A `UnsupportedOperationError`: the agent does not support this operation.\n \n Distinct from `METHOD_NOT_FOUND` in exactly the way `-32003` is: `-32601` says \"this server does\n * not know that method\", which a client cannot tell from a misrouted or non-compliant server, so\n * it retries or reports a transport fault. `-32004` says \"this agent knows the operation and does\n * not offer it\" — permanent, cacheable, actionable.\n \n spec-cite: A2A 1.0 §5.4 assigns `UnsupportedOperationError` the JSON-RPC code `-32004` (gRPC\n * `FAILED_PRECONDITION`, HTTP `400 Bad Request`); §3.3.4 — \"If `AgentCard.capabilities.\n extendedAgentCard` is `false` or not present, attempts to call the Get Extended Agent Card\n * operation MUST return `UnsupportedOperationError`\".\n /\n UNSUPPORTED_OPERATION = -32004,\n\n // ── Wildo-assigned (-32010..-32099): concerns A2A has no vocabulary for ───────────────────\n /** The caller is unauthenticated / the token is invalid. /\n UNAUTHENTICATED = -32010,\n /* The referenced skill / actor system does not exist, or is outside this agent's subset. /\n SKILL_NOT_FOUND = -32011,\n /\n The caller exceeded the per-principal turn rate cap. Ridden by a transport-level HTTP 429 +\n * `Retry-After` (throttling is a transport concern), unlike the codes above which ride HTTP 200\n * per JSON-RPC. The body stays a valid JSON-RPC error so strict clients still parse it.\n /\n RATE_LIMITED = -32012,\n /\n The caller's tenant has exhausted its plan-granted LLM token budget for the current period.\n * Ridden by a transport-level HTTP 402 — deliberately NOT the 429 + `Retry-After` of\n * {@link RATE_LIMITED}: a spend cap is not a rolling-window throttle, so the client's correct\n * reaction is to upgrade the plan or wait for the period to roll, not to retry after N seconds.\n * 402 matches the existing `FEATURE_LIMIT_EXCEEDED` / `INSUFFICIENT_CREDITS` billing mapping.\n /\n BUDGET_EXCEEDED = -32013,\n}\n\n/\n @wildo_source:part:start saas.backend.flows-actors.a2a-task-surface facet:layer:backend facet:family:flows-actors\n \n The A2A TASK surface your app exposes to external agents. You never author these —\n * the engine serves them — but knowing the contract tells you what an agent client can\n * do with a turn your actor system runs.\n \n A task is materialised ONLY when a turn cannot complete inline:\n * - the client sent `configuration.blocking: false` (the A2A field — absent means blocking), or\n * - the turn reached an interrupted state (a human-in-the-loop approval pause).\n \n BOTH triggers are live. The interrupted-state arm needs a runtime that can pause a turn; that\n * is the human-in-the-loop approval gate, and a paused turn now materialises a task carrying\n * `input-required` on all three transports (blocking send, non-blocking send, stream). An earlier\n * revision of this note warned that the arm was inert and `input-required` never emitted — true\n * when written, and left here in corrected form because a reader who remembers the old claim would\n * otherwise conclude the state is decorative and safe to drop.\n \n A blocking turn that answers in one shot returns an A2A `Message` and writes no task\n * row at all. Both shapes are protocol-conformant: the specification types the\n * `message/send` result as `Task \| Message`, so returning either is conformance rather than a\n * shortcut. The inline case is the default so a chatty agent does not accumulate a row per turn.\n * spec-cite: A2A v0.2.5 §7.1 (SendMessageResponse result type)\n \n \n * Once a task exists the client can poll it with `tasks/get` and stop it with\n * `tasks/cancel`. Cancel is a STATUS TRANSITION, never a delete: the spec requires it to\n * return the task's updated state, so a cancelled task stays readable.\n \n ⚠️ What cancel does and does not guarantee. It always records the cancellation, and\n * it aborts the model call for the streaming API transports — which is every agent using\n * the standard text/chat operations. It does NOT interrupt two cases: an agent whose\n * transport buffers its whole reply (a CLI-transport agent, or a non-text operation), and\n * a tool call already in flight — those finish, and only then does the turn stop. So\n * cancel is best read as \"stop as soon as the runtime is able\", not \"stop instantly\".\n * The task record is the truth about the request either way.\n \n Import path: `@wildo-ai/saas-backend-lib`.\n /\n/\n ⚠️ DOCUMENTATION-ONLY. Nothing implements this interface — it exists to give the anchored\n * excerpt a typed shape an app builder can read. The real methods are\n * `A2ATaskBackendService.readTask` / `advanceTask`, whose signatures differ (they take an\n * owner scope). Do not `implements` this; keep it in step with the service by hand, or\n * delete it if it ever drifts.\n /\nexport interface A2A_TaskSurfaceContract {\n /* `tasks/get` — read one task by id. Returns the task in its current state. /\n tasksGet: (taskId: string) => Promise<A2A_OutboundTask \| undefined>;\n /* `tasks/cancel` — request cancellation; returns the task's UPDATED state. /\n tasksCancel: (taskId: string) => Promise<A2A_OutboundTask \| undefined>;\n}\n\n/\n A2A task lifecycle states — the PROTOCOL's closed vocabulary (v0.2.5).\n \n Declared as a named enum rather than inline literals because it is exactly the\n * kind of closed semantic vocabulary that must have one runtime source: the\n * projection from `FlowsActors_Status` reads it, the transport emits it, and tests\n * pin it.\n \n Not every member is emitted by this transport today — `AUTH_REQUIRED` and\n * `REJECTED` have no `FlowsActors_Status` counterpart and are never produced. They\n * are declared because the vocabulary belongs to the protocol, not to us: a client\n * may legitimately receive them from another A2A server, and omitting them would\n * invite a future contributor to invent a second, partial enum.\n /\nexport enum A2A_TaskState {\n /* Acknowledged, not yet processing. /\n SUBMITTED = 'submitted',\n /* Actively being processed. /\n WORKING = 'working',\n /\n Interrupted (non-terminal): the agent needs input. The current transport emits this when a\n * user-delegated turn reaches an approval-gated tool, persists the signed pending decision and\n * materialises an addressable task. Approval or refusal resumes that same execution; machine\n * principals are denied rather than parked because no named person can answer for them.\n /\n INPUT_REQUIRED = 'input-required',\n /* Interrupted (non-terminal): authentication needed. NOT emitted by this transport. /\n AUTH_REQUIRED = 'auth-required',\n /* Terminal: finished successfully. /\n COMPLETED = 'completed',\n /* Terminal: finished with error. /\n FAILED = 'failed',\n /* Terminal: canceled before completion. /\n CANCELED = 'canceled',\n /* Terminal: refused by the agent. NOT emitted by this transport. /\n REJECTED = 'rejected',\n /\n Terminal: the agent cannot determine the task's state.\n \n Declared for the same reason as `AUTH_REQUIRED` and `REJECTED` — the enum's rule is that the\n * protocol vocabulary is represented in full so nobody invents a second, partial one. It was\n * simply missed: the spec defines NINE states and this declared eight (review finding G5-6).\n * Never emitted by this transport, which always knows a task's state or cannot find the row.\n /\n UNKNOWN = 'unknown',\n}\n\n/* States after which no further work occurs — a terminal task cannot be canceled. /\nexport const A2A_TERMINAL_TASK_STATES: ReadonlySet<A2A_TaskState> = new Set([\n A2A_TaskState.COMPLETED,\n A2A_TaskState.FAILED,\n A2A_TaskState.CANCELED,\n A2A_TaskState.REJECTED,\n A2A_TaskState.UNKNOWN,\n]);\n/* @wildo_source:part:end saas.backend.flows-actors.a2a-task-surface /\n\n/\n Deliberately OUTSIDE the `@wildo_source` anchor above: this is an authoring correction for\n * framework maintainers, and the anchored span ships verbatim into application-facing skills\n * where neither the anchor nor this repository's revision history exists.\n \n ⚠️ An earlier revision of the `message/send` paragraph above supported its conclusion with a\n * QUOTATION — \"the agent MAY create a new Task … or MAY return a direct Message response for\n * simple interactions\" — attributed to the A2A specification. It is not in the document.\n * spec-cite: N/A — that sentence is quoted precisely BECAUSE it is absent from A2A v0.2.5; it is\n * the defect, not the standard's words.\n \n The conclusion was right and the authority was invented, and because the block was anchored it\n * shipped that invention into the app-facing skill. Cite the TYPE, which is checkable in one step,\n * not a remembered sentence. See `.claude/rules/external-specification-citations.md`.\n /\n\n/\n Project the engine's persisted lifecycle status onto the A2A protocol vocabulary.\n \n This is the ONLY place the two vocabularies meet, and it is exhaustive by\n * construction — `FlowsActors_Status` is a closed enum, so adding a member without\n * deciding its protocol meaning is a compile error at the `satisfies` below rather\n * than a silent fallthrough to some default state.\n \n Both `READY` and `PENDING` project to `SUBMITTED`: the protocol draws its line at\n * \"acknowledged but not yet processing\", and our two pre-processing states are on the\n * same side of it. `ABORTED` projects to `FAILED` rather than `CANCELED` deliberately —\n * `CANCELED` means a caller asked for it, whereas `ABORTED` is the runtime halting\n * itself (e.g. a tripped circuit breaker), which a client should read as a failure it\n * did not request.\n /\nconst A2A_STATE_BY_FLOWS_ACTORS_STATUS = {\n [FlowsActors_Status.READY]: A2A_TaskState.SUBMITTED,\n [FlowsActors_Status.PENDING]: A2A_TaskState.SUBMITTED,\n [FlowsActors_Status.PROCESSING]: A2A_TaskState.WORKING,\n [FlowsActors_Status.AWAITING_APPROVAL]: A2A_TaskState.INPUT_REQUIRED,\n [FlowsActors_Status.COMPLETED]: A2A_TaskState.COMPLETED,\n [FlowsActors_Status.FAILED]: A2A_TaskState.FAILED,\n [FlowsActors_Status.CANCELLED]: A2A_TaskState.CANCELED,\n [FlowsActors_Status.ABORTED]: A2A_TaskState.FAILED,\n} satisfies Record<FlowsActors_Status, A2A_TaskState>;\n\n/* Project a persisted task status onto its A2A protocol state. /\nexport function toA2ATaskState(status: FlowsActors_Status): A2A_TaskState {\n return A2A_STATE_BY_FLOWS_ACTORS_STATUS[status];\n}\n\n/* True when the persisted status is one the protocol treats as terminal. /\nexport function isTerminalA2ATaskStatus(status: FlowsActors_Status): boolean {\n return A2A_TERMINAL_TASK_STATES.has(toA2ATaskState(status));\n}\n\n/\n The stored instance identity of the DEFAULT (unnamed) A2A agent.\n \n Declared instance refs are constrained to `^[a-z0-9][a-z0-9-]$`, so the `` characters make\n * this value unreachable by any real ref — the default agent gets its own identity on the task\n * plane without a collision, and without the filter having to special-case an absent field.\n /\nexport const A2A_DEFAULT_INSTANCE_REF: string = FLOWS_ACTORS_DEFAULT_AGENT_INSTANCE;\n\n/\n States in which a task is waiting on something OUTSIDE the runtime — a human approval, an\n * authentication step — rather than executing on any pod.\n \n ## Why this is a THIRD class and not a shade of \"non-terminal\" (review finding A3-3)\n \n The liveness design asks one question: \"a pod claimed this work — is that pod still alive?\"\n * That question is only meaningful while a pod is actually executing. Splitting statuses merely\n * into terminal / non-terminal conflates two very different non-terminal situations:\n \n - executing — a pod holds the turn and refreshes a lease. No lease ⇒ the pod died ⇒ the\n * task is abandoned, and reporting the stored `working` forever would be a lie.\n * - interrupted — nobody is executing, deliberately. The lease is released the moment the\n * turn unwinds, so a paused task has no lease BY DESIGN. Applying the abandonment rule here\n * reads a correct pause as a dead pod.\n \n With only the two-way split, a task paused for approval read as `failed` on the very next\n * poll and the sweep then made that durable within the grace window — so the approval seam\n * Phase 1 claims to have prepared would have been destroyed by Phase 1's own liveness rules\n * before Phase 2 could use it. A human approval takes minutes to hours; a lease TTL is 30s.\n \n Deliberately OUTSIDE the `@wildo_source` anchor above: this is engine-internal liveness\n * taxonomy, not app-facing protocol surface, and widening the shipped contract with states this\n * transport cannot yet reach is the mistake finding G2-3 recorded.\n /\nexport const A2A_INTERRUPTED_TASK_STATES: ReadonlySet<A2A_TaskState> = new Set([\n A2A_TaskState.INPUT_REQUIRED,\n A2A_TaskState.AUTH_REQUIRED,\n]);\n\n/\n True when the task's status is one whose truthfulness depends on a pod being alive — i.e.\n * neither terminal nor interrupted.\n \n This is the ONLY predicate that should gate derive-on-read downgrades and the abandoned-task\n * sweep. Using `!isTerminalA2ATaskStatus(...)` for that purpose is the A3-3 defect.\n /\nexport function isLivenessGovernedA2ATaskStatus(status: FlowsActors_Status): boolean {\n const state = toA2ATaskState(status);\n return !A2A_TERMINAL_TASK_STATES.has(state) && !A2A_INTERRUPTED_TASK_STATES.has(state);\n}\n\n/\n The persisted statuses a task may still be advanced FROM — everything non-terminal.\n \n This is the compare-and-swap set for `advanceTask` (finding A3-2). Note it deliberately\n * INCLUDES the interrupted states: a task paused for approval must remain cancellable, and\n * Phase 2 must be able to resume it. \"Cannot be advanced\" means terminal, nothing else.\n /\nexport const ADVANCEABLE_TASK_STATUSES: FlowsActors_Status[] =\n (Object.values(FlowsActors_Status) as FlowsActors_Status[]).filter((status) => !isTerminalA2ATaskStatus(status));\n\n/\n The persisted statuses whose stored value is only trustworthy while a pod is alive — the\n * candidate set for the abandoned-task sweep and for the derive-on-read downgrade.\n \n Strictly NARROWER than {@link ADVANCEABLE_TASK_STATUSES}: an interrupted task is advanceable\n * but is not abandoned merely because no pod holds it. Both are derived from the single status\n * projection above, so a new `FlowsActors_Status` member lands in the right set automatically\n * once its protocol meaning is decided.\n /\nexport const LIVENESS_GOVERNED_TASK_STATUSES: FlowsActors_Status[] =\n (Object.values(FlowsActors_Status) as FlowsActors_Status[]).filter(isLivenessGovernedA2ATaskStatus);\n\n/\n WHY an absent lease is absent — the difference between a VERDICT and a failed enquiry.\n \n ## The inversion this vocabulary exists to name (review finding S-1a)\n \n \"No lease\" was a single answer with two incompatible meanings, and the sweep read both as\n * death:\n \n - a pod held this task and stopped refreshing — the lease existed and lapsed. That is\n * abandonment, and repairing the row is the sweep's whole purpose.\n * - this task's liveness was never observable at all — the owning pod could not write the\n * lease (its own Redis connection is broken while the sweep's is fine, or it started the turn\n * with no client at all). The turn is HEALTHY and running; nothing about it is knowable from\n * the lease.\n \n The two are indistinguishable from a single read of one key, so the write side leaves a second,\n * long-lived ESTABLISHMENT marker whenever it successfully writes a lease. Its presence is what\n * turns an absent lease into evidence; its absence is what makes the reading indeterminate.\n \n `isLeaseMechanismWritable` does NOT cover this: it is evaluated on the SWEEP's pod, so a\n * per-pod outage on the executing pod passes it unnoticed. That check answers \"can the fleet's\n * liveness signal be trusted at all\"; this answers \"does this one task's missing lease mean\n * anything\".\n \n Four members, not two, because \"do not act\" has two causes that want opposite follow-ups: one\n * makes progress toward a verdict on a later run, the other learned nothing at all and must not\n * be recorded as though it had. Merging them is the semantic collapse this framework refuses.\n /\nexport enum A2A_AbandonmentEvidence {\n /\n The task's lease was demonstrably established and has since lapsed. A pod claimed this work\n * and stopped refreshing — the classic dead-pod signature, and a VERDICT.\n /\n LEASE_LAPSED = 'lease-lapsed',\n /\n No establishment marker, but a PRIOR sweep run recorded the same absence and that observation\n * is still standing. Two observations separated by at least one sweep period — a lease that a\n * live pod merely failed to write once is rewritten on the next 10-second heartbeat, so an\n * absence that survives a full period is not a missed write. A VERDICT.\n /\n CORROBORATED_ABSENCE = 'corroborated-absence',\n /\n No establishment marker and no prior observation; THIS run recorded the first one. Not a\n * verdict — the task is left exactly as it stands, and a later run decides.\n /\n FIRST_ABSENCE = 'first-absence',\n /\n Nothing was learned: the observation itself could not be read or recorded. Not a verdict, and\n * unlike {@link FIRST_ABSENCE} it makes no progress toward one — a later run starts over.\n /\n UNDETERMINED = 'undetermined',\n}\n\n/\n May the sweep turn this evidence into a DURABLE terminal status?\n \n Named rather than inlined at the one call site on purpose: this predicate IS the boundary\n * between an enquiry and a verdict, and the sweep is the only consumer allowed to cross it. A\n * second consumer that re-derives the set by hand is how the two come to disagree.\n /\nexport function abandonmentEvidenceIsAVerdict(evidence: A2A_AbandonmentEvidence): boolean {\n return evidence === A2A_AbandonmentEvidence.LEASE_LAPSED \|\| evidence === A2A_AbandonmentEvidence.CORROBORATED_ABSENCE;\n}\n\n/\n An outbound A2A `Task` — the `result` of `tasks/get`, `tasks/cancel`, and of a\n * `message/send` whose turn could not complete inline.\n \n `status.state` is the projection of the persisted `FlowsActors_Status`; `status.timestamp`\n * is when that state was last advanced, so a polling client can tell a fresh `working`\n * from a stale one.\n /\nexport interface A2A_OutboundTask {\n kind: 'task';\n id: string;\n contextId: string;\n status: {\n state: A2A_TaskState;\n timestamp: string;\n /* Present when the state carries an agent-visible message (e.g. why input is required). /\n message?: A2A_OutboundMessage;\n };\n artifacts?: { artifactId: string; name?: string; parts: { kind: string; [k: string]: unknown }[] }[];\n metadata?: Record<string, unknown>;\n}\n\n/* An outbound A2A text message (the `result` of a blocking `message/send`). /\nexport interface A2A_OutboundMessage {\n kind: 'message';\n role: A2A_MessageRole.AGENT;\n parts: { kind: 'text'; text: string }[];\n messageId: string;\n contextId: string;\n metadata?: Record<string, unknown>;\n}\n\n/\n @wildo_source:part:start saas.backend.flows-actors.a2a-agent-card facet:layer:backend facet:family:flows-actors\n \n The A2A discovery contract an external agent fetches at\n * `GET /a2a/.well-known/agent-card.json` to learn what your app exposes over\n * Agent2Agent and how to authenticate. It is SERVED by the engine — you never\n * author it: every ACTOR system with an AGENTIC actor bound to an agent is\n * exposed automatically as one `A2A_Skill` (`skill.id === system.ref`). External\n * agents then POST JSON-RPC `message/send` / `message/stream` to the card `url`.\n * Import path: `@wildo-ai/saas-backend-lib`.\n /\n\n/* One advertised A2A skill = one exposed agentic actor system (`id === system.ref`). /\nexport interface A2A_Skill {\n id: string;\n name: string;\n description: string;\n tags: string[];\n examples?: string[];\n}\n\n/\n The served A2A agent card. `url` is the absolute task-endpoint URI AND the\n * agent's canonical audience: BOTH a USER-delegated and a MACHINE (client-credentials)\n * inbound token MUST carry it as `aud` (RFC 8707 / external-access D7) — a token minted for\n * another surface (including the generic API audience, per the 2026-07-29 flip) is rejected.\n * `securitySchemes.oauth2.flows`\n * advertises BOTH D6 principals — `authorizationCode` (user-delegated → the\n * conversation is owned by the delegating user) and `clientCredentials` (org/app\n * machine → the conversation is owned by the org/app). Tokens are minted by the\n * app's own OIDC provider (`/oauth/authorize`, `/oauth/token`).\n /\n/\n One protocol interface this agent exposes — a URL, a transport, and the version it speaks there.\n \n spec-cite: A2A 1.0 proto `AgentInterface` — `url` (REQUIRED), and \"The version of the A2A\n protocol this interface exposes. Use the latest supported minor version per major version.\n * Examples: `\"0.3\"`, `\"1.0\"`\".\n /\nexport interface A2A_AgentInterface {\n url: string;\n transport: string;\n version: string;\n}\n\nexport interface A2A_AgentCard {\n /*\n The v0.2.5 scalar version field.\n \n KEPT, and deliberately still `0.2.5`. A v0.2.5 client reads only this field, and it is the\n * version that dialect of the surface actually speaks — advertising `1.0` here would tell every\n * legacy client to send `TASK_STATE_` states and `return_immediately`, which is the exact misread\n this migration exists to prevent. 1.0 clients read {@link supportedInterfaces} instead.\n /\n protocolVersion: string;\n /\n Ordered list of supported interfaces, first entry preferred — the 1.0 mechanism for\n * advertising more than one protocol version.\n \n spec-cite: A2A 1.0 proto `AgentCard` — `repeated AgentInterface supported_interfaces = 3\n * [(google.api.field_behavior) = REQUIRED]`, \"Ordered list of supported interfaces. The first\n entry is preferred.\"\n \n * This is what makes serving two dialects a DECLARED capability rather than an undocumented\n * accident: before it, a 1.0 client could only reach the 1.0 vocabulary by guessing that it\n * existed.\n /\n supportedInterfaces: A2A_AgentInterface[];\n name: string;\n description: string;\n url: string;\n version: string;\n capabilities: { streaming: boolean; pushNotifications: boolean };\n defaultInputModes: string[];\n defaultOutputModes: string[];\n skills: A2A_Skill[];\n securitySchemes: Record<string, unknown>;\n security: Record<string, string[]>[];\n}\n/* @wildo_source:part:end saas.backend.flows-actors.a2a-agent-card */\n"]}

package/dist/esm/flows-actors/a2a/services/a2a-push-delivery-log.repository.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"a2a-push-delivery-log.repository.d.ts","sourceRoot":"","sources":["~~../../../../../../~~src/flows-actors/a2a/services/a2a-push-delivery-log.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iFAAiF,CAAC;AAClI,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AA6BlI,+FAA+F;AAC/F,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,sBAAsB,EACtB,YAAY,GAAG,QAAQ,GAAG,0BAA0B,GAAG,2BAA2B,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAC3H,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAKjE,qBACa,4BAA4B;IAIF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;gBAGlC,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B;IAM3G;;;;;;;;;;OAUG;IACU,IAAI,CACf,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAgB9C,4FAA4F;IAC/E,IAAI,CACf,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAUzC;;;;;;;;OAQG;IACU,YAAY,CACvB,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC;IAQnB,wBAAwB;IACX,aAAa,CACxB,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAQnB,iFAAiF;IACpE,iBAAiB,CAC5B,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,aAAa,EAAE,IAAI,EACnB,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1E,OAAO,CAAC,OAAO,CAAC;IAQnB,sEAAsE;IACzD,iBAAiB,CAC5B,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1E,OAAO,CAAC,OAAO,CAAC;IAQnB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAQtB,mGAAmG;YACrF,UAAU;CAiBzB"}
1	+ {"version":3,"file":"a2a-push-delivery-log.repository.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/a2a/services/a2a-push-delivery-log.repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EAGL,KAAK,sBAAsB,EAE5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iFAAiF,CAAC;AAClI,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AA6BlI,+FAA+F;AAC/F,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,sBAAsB,EACtB,YAAY,GAAG,QAAQ,GAAG,0BAA0B,GAAG,2BAA2B,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAC3H,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAKjE,qBACa,4BAA4B;IAIF,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;gBAGlC,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B;IAM3G;;;;;;;;;;OAUG;IACU,IAAI,CACf,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC;IAgB9C,4FAA4F;IAC/E,IAAI,CACf,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAUzC;;;;;;;;OAQG;IACU,YAAY,CACvB,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC;IAQnB,wBAAwB;IACX,aAAa,CACxB,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC;IAQnB,iFAAiF;IACpE,iBAAiB,CAC5B,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,aAAa,EAAE,IAAI,EACnB,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1E,OAAO,CAAC,OAAO,CAAC;IAQnB,sEAAsE;IACzD,iBAAiB,CAC5B,KAAK,EAAE,wBAAwB,EAC/B,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAC1E,OAAO,CAAC,OAAO,CAAC;IAQnB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAQtB,mGAAmG;YACrF,UAAU;CAiBzB"}

package/dist/esm/flows-actors/a2a/services/a2a-push-dispatcher.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"a2a-push-dispatcher.backend.service.d.ts","sourceRoot":"","sources":["~~../../../../../../~~src/flows-actors/a2a/services/a2a-push-dispatcher.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAG1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AAClI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,wBAAwB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBACa,+BAA+B;IAIL,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IALvF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;gBAGlC,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,mBAAmB,EACxB,WAAW,EAAE,4BAA4B;IAMrH;;;;;;;;;OASG;IACU,kBAAkB,CAC7B,KAAK,EAAE,wBAAwB,EAC/B,IAAI,EAAE,gBAAgB,EACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,yBAAyB,EAAE,MAAM,EACjC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC;CAyDjB"}
1	+ {"version":3,"file":"a2a-push-dispatcher.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/a2a/services/a2a-push-dispatcher.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAG1F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AAClI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAItE,OAAO,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,wBAAwB,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBACa,+BAA+B;IAIL,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IALvF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;gBAGlC,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,mBAAmB,EACxB,WAAW,EAAE,4BAA4B;IAMrH;;;;;;;;;OASG;IACU,kBAAkB,CAC7B,KAAK,EAAE,wBAAwB,EAC/B,IAAI,EAAE,gBAAgB,EACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC5C,yBAAyB,EAAE,MAAM,EACjC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,IAAI,CAAC;CAyDjB"}

package/dist/esm/flows-actors/a2a/services/a2a-task-cancellation.backend.service.d.ts CHANGED Viewed

@@ -24,9 +24,17 @@
  * While a pod owns a turn it refreshes a TTL'd lease key. That is what lets
  * `tasks/get` report an abandoned task honestly instead of leaving it `working`
  * forever after a pod dies — see the lease helpers below.
+ *
+ * An absent lease is NOT self-explanatory, though, and reading it as death is an inversion that
+ * costs real work: a pod that could not write the lease looks exactly like a pod that died. So
+ * every successful lease write also leaves a long-lived ESTABLISHMENT marker, and
+ * `corroborateAbandonment` is what turns "no lease" into either a verdict or an admission that
+ * nothing was learned. Only the sweep — the one consumer that makes a liveness answer DURABLE —
+ * asks that question.
  */
 import type { LoggerService } from '../../../monitoring/logger/services/logger.service';
 import type { RedisService } from '../../../databases/services/redis.service';
+import { A2A_AbandonmentEvidence } from '../../../flows-actors/a2a/models/a2a.backend.schemas';
 /**
  * Lease TTL and refresh cadence. The refresh interval is deliberately well under the
  * TTL: a single missed refresh (GC pause, a slow Redis round-trip) must not make a
@@ -34,6 +42,26 @@ import type { RedisService } from '../../../databases/services/redis.service';
  */
 export declare const A2A_TASK_LEASE_TTL_SECONDS = 30;
 export declare const A2A_TASK_LEASE_REFRESH_MS = 10000;
+/**
+ * How long the establishment marker outlives its last refresh.
+ *
+ * Sized to comfortably span the sweep's grace window plus its hourly period, so a pod that dies
+ * mid-turn is still recognisable as HAVING held the task when the next sweep looks. It is a
+ * timing optimisation, never a correctness requirement: if it lapses, the reading degrades to
+ * {@link A2A_AbandonmentEvidence.FIRST_ABSENCE} and the row is repaired one run later instead of
+ * on the first — which is the direction this whole mechanism errs in anyway.
+ */
+export declare const A2A_TASK_LEASE_ESTABLISHED_TTL_SECONDS: number;
+/**
+ * How long one unexplained absence stands as corroboration for the next run.
+ *
+ * MUST exceed the sweep's period or no observation ever survives to be corroborated and nothing
+ * is ever repaired through that path; generous beyond it so a skipped run (the fleet-wide abstain)
+ * does not reset the count. Nothing clears it on recovery, and it does not need clearing: a task
+ * whose pod recovered answers ALIVE on the lease long before this is consulted, and once its lease
+ * lapses for real the establishment marker gives the verdict directly.
+ */
+export declare const A2A_TASK_ABSENCE_OBSERVATION_TTL_SECONDS: number;
 export declare class A2ATaskCancellationBackendService {
     private readonly logger;
     private readonly redisService;
@@ -46,6 +74,8 @@ export declare class A2ATaskCancellationBackendService {
     constructor(logger: LoggerService, redisService: RedisService);
     private channel;
     private leaseKey;
+    private leaseEstablishedKey;
+    private absenceObservationKey;
     /**
      * Start this pod's single shared subscriber. Idempotent — safe to call from every
      * turn, so no startup ordering is required.
@@ -74,6 +104,14 @@ export declare class A2ATaskCancellationBackendService {
      *
      * Dropping the lease EAGERLY matters — a terminal task with a live lease would look
      * like it is still executing to anything reading liveness.
+     *
+     * The ESTABLISHMENT marker is deliberately NOT dropped with it. The two record different kinds
+     * of fact: the lease says "a pod is working this NOW" and stops being true the instant the turn
+     * unwinds, while the marker says "this task's liveness was observable", which stays true
+     * afterwards. Keeping it also covers the one case that would otherwise regress — a turn that
+     * finished but whose terminal write did not land — since the row is then genuinely abandoned and
+     * the sweep can say so on its first pass instead of waiting for corroboration. It expires on its
+     * own TTL, so nothing accumulates.
      */
     endTurn(taskId: string): Promise<void>;
     /**
@@ -98,6 +136,42 @@ export declare class A2ATaskCancellationBackendService {
      * `working`.
      */
     isTurnAlive(taskId: string): Promise<boolean>;
+    /**
+     * WHY is this task's lease absent — and may that absence be turned into a durable verdict?
+     *
+     * Asked by the abandoned-task sweep, and only by it, AFTER {@link isTurnAlive} has already
+     * answered "no lease". `isTurnAlive` returns a boolean because every other consumer only needs
+     * to know whether to keep waiting; the sweep is the one caller that writes a TERMINAL status,
+     * so it is the one caller that must be able to tell a verdict from a failed enquiry.
+     *
+     * ## The case this closes, which no existing guard catches
+     *
+     * `isLeaseMechanismWritable` is evaluated on the SWEEP's pod. A per-pod failure — the executing
+     * pod's Redis connection is broken while the sweep's is fine — passes it, `isTurnAlive`
+     * truthfully reports no lease, and a healthy running turn is durably recorded FAILED. That
+     * inversion has no compensating pass; it is the reason this method exists.
+     *
+     * ## How the two are told apart
+     *
+     * 1. **An establishment marker** ({@link LEASE_ESTABLISHED_KEY_PREFIX}) is written beside every
+     *    successful lease write and outlives it by hours. Present ⇒ a pod demonstrably held this
+     *    task and stopped ⇒ `LEASE_LAPSED`, a verdict, on the very first pass. This is what keeps
+     *    ordinary abandonment repaired in the same hour it happens.
+     * 2. **Otherwise the reading is indeterminate**, and the answer is TIME rather than another key:
+     *    a live pod that merely failed one write rewrites its lease on the next 10-second heartbeat,
+     *    so an absence that is still there a full sweep period later is not a missed write. The
+     *    first pass records the observation and returns `FIRST_ABSENCE`; a later pass that still
+     *    finds no lease and still finds the observation returns `CORROBORATED_ABSENCE`.
+     * 3. **If the observation can neither be read nor written, nothing was learned** —
+     *    `UNDETERMINED`. It is NOT collapsed into `FIRST_ABSENCE`, because that one made progress
+     *    toward a verdict and this one did not; recording it as progress would let two enquiries
+     *    that both failed add up to a durable kill.
+     *
+     * Losing the medium fails toward the SAFE side in both directions: with the markers gone (a
+     * Redis restart) every absence is merely uncorroborated, so genuine abandonment is still
+     * repaired — one run later — while a healthy turn is not killed on a single reading.
+     */
+    corroborateAbandonment(taskId: string): Promise<A2A_AbandonmentEvidence>;
     /**
      * Can the lease mechanism actually be WRITTEN right now?
      *

package/dist/esm/flows-actors/a2a/services/a2a-task-cancellation.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"a2a-task-cancellation.backend.service.d.ts","sourceRoot":"","sources":["~~../../../../../../~~src/flows-actors/a2a/services/a2a-task-cancellation.backend.service.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG~~;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;~~AAQxF~~;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,qBACa,iCAAiC;IAUP,OAAO,CAAC,QAAQ,CAAC,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVxE,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,gBAAgB,CAAS;gBAGqB,MAAM,EAAE,aAAa,EACf,YAAY,EAAE,YAAY;IAGtF,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;IAIhB;;;;;;;;;;OAUG;YACW,gBAAgB;IA2C9B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;~~IA2D5D;;;;;OAKG~~;IACU,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD;;;;;;;;OAQG;IACU,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D;;;;;;;;;;OAUG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1D;;;;;;;;;;;;;;;;OAgBG;IACU,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC;CAY1D"}
1	+ {"version":3,"file":"a2a-task-cancellation.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/flows-actors/a2a/services/a2a-task-cancellation.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AAExF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gEAAgE,CAAC;AAsBzG;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,sCAAsC,QAAc,CAAC;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,wCAAwC,QAAc,CAAC;AAEpE,qBACa,iCAAiC;IAUP,OAAO,CAAC,QAAQ,CAAC,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAVxE,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;IAEjE,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,gBAAgB,CAAS;gBAGqB,MAAM,EAAE,aAAa,EACf,YAAY,EAAE,YAAY;IAGtF,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,qBAAqB;IAI7B;;;;;;;;;;OAUG;YACW,gBAAgB;IA2C9B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;;OAGG;IACU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAgG5D;;;;;;;;;;;;;OAaG;IACU,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAenD;;;;;;;;OAQG;IACU,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D;;;;;;;;;;OAUG;IACU,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAc1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACU,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2BrF;;;;;;;;;;;;;;;;OAgBG;IACU,wBAAwB,IAAI,OAAO,CAAC,OAAO,CAAC;CAY1D"}