@fungi.computer/puffball 0.0.0-stage → 0.0.1

package/docs/api/background-replay.md

@@ -0,0 +1,516 @@
+<!-- Generated by Botanical API docs (TypeDoc + typedoc-plugin-markdown). Do not edit. -->
+
+[**@fungi.computer/puffball**](README.md)
+
+---
+
+[@fungi.computer/puffball](README.md) / background-replay
+
+# background-replay
+
+## Type Aliases
+
+### BackgroundOrigin
+
+```ts
+type BackgroundOrigin = z.output<typeof backgroundOriginSchema>;
+```
+
+Origin evidence, never a retained grant or credential.
+
+---
+
+### ClaimedJobAdmission
+
+```ts
+type ClaimedJobAdmission = z.output<typeof claimedJobAdmissionSchema>;
+```
+
+A claim either passes origin admission or refuses before binding effects.
+
+---
+
+### BackgroundBinding
+
+```ts
+type BackgroundBinding = Readonly<{
+  admit: (origin) => Promise<ClaimedJobAdmission>;
+}>;
+```
+
+Host-minted replay port; an App cannot declare this binding.
+
+---
+
+### BackgroundWake
+
+```ts
+type BackgroundWake = z.output<typeof backgroundWakeSchema>;
+```
+
+A host wake cannot confer authority without fresh directory and method
+admission.
+
+---
+
+### BackgroundMember
+
+```ts
+type BackgroundMember = BackgroundWake["actor"];
+```
+
+A retained identity eligible for member-only replay.
+
+---
+
+### BackgroundSyncRefusal
+
+```ts
+type BackgroundSyncRefusal = z.output<typeof backgroundSyncRefusalSchema>;
+```
+
+One available App's member-lane cleanup, delivered with zero binding grants.
+
+---
+
+### BackgroundRefusalCode
+
+```ts
+type BackgroundRefusalCode = z.output<typeof backgroundRefusalCodeSchema>;
+```
+
+Closed, durable refusal reasons for the affected member lane.
+
+---
+
+### BackgroundAdmission
+
+```ts
+type BackgroundAdmission =
+  | Readonly<{
+      kind: "admitted";
+      context: AppMethodCallContext;
+    }>
+  | Readonly<{
+      kind: "refused";
+      code:
+        | "level_too_low"
+        | "requires_not_granted"
+        | "not_approved"
+        | "denied"
+        | "unavailable"
+        | "stale_authority";
+    }>;
+```
+
+Existing method admission outcomes interpreted by the replay owner.
+
+---
+
+### BackgroundReplayPorts
+
+```ts
+type BackgroundReplayPorts<Principal> = Readonly<{
+  resolve: (actor) => Promise<Principal | null>;
+  admit: (principal, wake) => Promise<BackgroundAdmission>;
+}>;
+```
+
+Directory resolution and fresh continuation admission remain host-owned.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `Principal`    |
+
+---
+
+### BackgroundReplayDecision
+
+```ts
+type BackgroundReplayDecision =
+  | Readonly<{
+      kind: "admitted";
+      context: AppMethodCallContext;
+    }>
+  | Readonly<{
+      kind: "refused";
+      code: BackgroundRefusalCode;
+    }>
+  | Readonly<{
+      kind: "retry";
+    }>;
+```
+
+A refused wake settles its lane; retry uses the existing Carrier backoff.
+
+## Variables
+
+### backgroundOriginSchema
+
+```ts
+const backgroundOriginSchema: ZodMiniObject<
+  {
+    method: ZodMiniString<string>;
+    seal: ZodMiniString<string>;
+  },
+  $strict
+> = appMethodCallerSchema.shape.backgroundOrigin.def.innerType;
+```
+
+The caller's single lightweight grammar for a host-sealed enqueue origin.
+
+---
+
+### claimedJobAdmissionSchema
+
+```ts
+const claimedJobAdmissionSchema: ZodUnion<
+  readonly [
+    ZodObject<
+      {
+        kind: ZodLiteral<"admitted">;
+      },
+      $strict
+    >,
+    ZodObject<
+      {
+        kind: ZodLiteral<"refused">;
+        code: ZodLiteral<"access_changed">;
+      },
+      $strict
+    >,
+  ]
+>;
+```
+
+The closed result of checking a claimed job's origin in a fresh replay frame.
+
+---
+
+### backgroundWakeSchema
+
+```ts
+const backgroundWakeSchema: ZodObject<
+  {
+    installationId: ZodString;
+    actor: ZodObject<
+      {
+        kind: ZodMiniLiteral<"member">;
+        memberId: ZodMiniString<string>;
+      },
+      $strict
+    >;
+    lane: ZodString;
+    originMethod: ZodString;
+    observed: ZodObject<
+      {
+        authorityVersion: ZodNumber;
+        artifactDigest: ZodCustom<Sha256Digest, Sha256Digest>;
+        membershipVersion: ZodOptional<ZodNumber>;
+      },
+      $strict
+    >;
+    epoch: ZodNumber;
+  },
+  $strict
+>;
+```
+
+Identity and observed revisions only. Unknown fields, including bearer material,
+refuse.
+
+---
+
+### backgroundRefusalCodeSchema
+
+```ts
+const backgroundRefusalCodeSchema: ZodEnum<{
+  access_changed: "access_changed";
+  installation_unavailable: "installation_unavailable";
+}>;
+```
+
+The App can settle a refused lane without receiving any binding authority.
+
+---
+
+### backgroundSyncRefusalSchema
+
+```ts
+const backgroundSyncRefusalSchema: ZodObject<
+  {
+    lane: ZodString;
+    code: ZodEnum<{
+      access_changed: "access_changed";
+      installation_unavailable: "installation_unavailable";
+    }>;
+  },
+  $strict
+>;
+```
+
+Cleanup payload for one refused member lane; contains no actor or authority.
+
+## Functions
+
+### backgroundOriginKey()
+
+```ts
+function backgroundOriginKey(secret): Promise<CryptoKey>;
+```
+
+Derive a non-extractable host signing key; no secret is sent to an App.
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `secret`  | `string` |
+
+#### Returns
+
+`Promise`\<`CryptoKey`\>
+
+---
+
+### sealBackgroundOrigin()
+
+```ts
+function sealBackgroundOrigin(
+  key,
+  claims,
+): Promise<{
+  method: string;
+  seal: string;
+}>;
+```
+
+Seal only host-verified Instance, member lane and foreground method attribution.
+
+#### Parameters
+
+| Parameter | Type                                                                              |
+| --------- | --------------------------------------------------------------------------------- |
+| `key`     | `CryptoKey`                                                                       |
+| `claims`  | `Readonly`\<\{ `instanceId`: `string`; `lane`: `string`; `method`: `string`; \}\> |
+
+#### Returns
+
+`Promise`\<\{ `method`: `string`; `seal`: `string`; \}\>
+
+---
+
+### admitClaimedOrigin()
+
+```ts
+function admitClaimedOrigin(
+  key,
+  frame,
+  raw,
+): Promise<
+  | {
+      kind: "admitted";
+    }
+  | {
+      kind: "refused";
+      code: "access_changed";
+    }
+>;
+```
+
+Verify origin evidence against this frame's fresh admission; guest input never
+throws.
+
+#### Parameters
+
+| Parameter | Type                                                                                           |
+| --------- | ---------------------------------------------------------------------------------------------- |
+| `key`     | `CryptoKey`                                                                                    |
+| `frame`   | `Readonly`\<\{ `instanceId`: `string`; `lane`: `string`; `admitted`: readonly `string`[]; \}\> |
+| `raw`     | `unknown`                                                                                      |
+
+#### Returns
+
+`Promise`\< \| \{ `kind`: `"admitted"`; \} \| \{ `kind`: `"refused"`; `code`:
+`"access_changed"`; \}\>
+
+---
+
+### actorLane()
+
+```ts
+function actorLane(actor): string;
+```
+
+A queue lane is an actor identity, never a credential or grant.
+
+#### Parameters
+
+| Parameter | Type                                                                                                                                                  |
+| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `actor`   | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} |
+
+#### Returns
+
+`string`
+
+---
+
+### mayDefer()
+
+```ts
+function mayDefer(context, ancestry): boolean;
+```
+
+Only ordinary member calls may enqueue background work; ancestry is host-held.
+
+#### Parameters
+
+| Parameter                         | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                               |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `context`                         | \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | -                                                                                                                                                                                                                         |
+| `context.computerId`              | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                         |
+| `context.actor`                   | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                         |
+| `context.backgroundLane?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Host-attested enqueue eligibility for this ordinary write; absent otherwise.                                                                                                                                              |
+| `context.backgroundOrigin?`       | \{ `method`: `string`; `seal`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Host-sealed foreground method for durable jobs; paired with backgroundLane.                                                                                                                                               |
+| `context.backgroundOrigin.method` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.backgroundOrigin.seal`   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.role?`                   | `"member"` \| `"owner"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Team role attested by the host, never selected by App method input.                                                                                                                                                       |
+| `context.soleMember?`             | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | The host attests that this member is currently the Team's only member. Present only on a member's own call; never on an Agent, Team key or Workflow node, and never selected by App method input.                         |
+| `context.workflow?`               | \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}                                                                                                                                                                                                                                                                                                                                                                                                            | Present only on a Workflow node invocation admitted by its host.                                                                                                                                                          |
+| `context.workflow.workflowId`     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Published Workflow selected by the run owner.                                                                                                                                                                             |
+| `context.workflow.runId`          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Run identity held by the run owner.                                                                                                                                                                                       |
+| `context.workflow.nodeId`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Node selected by the stored published Workflow.                                                                                                                                                                           |
+| `context.workflow.armedBy`        | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Actor that armed the run, re-admitted by the host at dispatch.                                                                                                                                                            |
+| `context.idempotencyKey?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | The host's stable key for this logical call (for example one Workflow node), the same on every retry. A method with side effects uses it to do its work at most once. Absent when the caller supplies its own request id. |
+| `ancestry`                        | readonly `string`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                                                                                                                                                                         |
+
+#### Returns
+
+`boolean`
+
+---
+
+### backgroundContext()
+
+```ts
+function backgroundContext(context, ancestry, method, origin): object;
+```
+
+Host-only projection: replace incoming eligibility with the verified write's
+sealed origin.
+
+#### Parameters
+
+| Parameter                         | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                               |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `context`                         | \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | -                                                                                                                                                                                                                         |
+| `context.computerId`              | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                         |
+| `context.actor`                   | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                         |
+| `context.backgroundLane?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Host-attested enqueue eligibility for this ordinary write; absent otherwise.                                                                                                                                              |
+| `context.backgroundOrigin?`       | \{ `method`: `string`; `seal`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Host-sealed foreground method for durable jobs; paired with backgroundLane.                                                                                                                                               |
+| `context.backgroundOrigin.method` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.backgroundOrigin.seal`   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.role?`                   | `"member"` \| `"owner"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Team role attested by the host, never selected by App method input.                                                                                                                                                       |
+| `context.soleMember?`             | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | The host attests that this member is currently the Team's only member. Present only on a member's own call; never on an Agent, Team key or Workflow node, and never selected by App method input.                         |
+| `context.workflow?`               | \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}                                                                                                                                                                                                                                                                                                                                                                                                            | Present only on a Workflow node invocation admitted by its host.                                                                                                                                                          |
+| `context.workflow.workflowId`     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Published Workflow selected by the run owner.                                                                                                                                                                             |
+| `context.workflow.runId`          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Run identity held by the run owner.                                                                                                                                                                                       |
+| `context.workflow.nodeId`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Node selected by the stored published Workflow.                                                                                                                                                                           |
+| `context.workflow.armedBy`        | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Actor that armed the run, re-admitted by the host at dispatch.                                                                                                                                                            |
+| `context.idempotencyKey?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | The host's stable key for this logical call (for example one Workflow node), the same on every retry. A method with side effects uses it to do its work at most once. Absent when the caller supplies its own request id. |
+| `ancestry`                        | readonly `string`[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                                                                                                                                                                         |
+| `method`                          | `Readonly`\<\{ `name`: `string`; `effect`: [`AppApi`](index.md#appapi)\[`"methods"`\]\[`string`\]\[`"effect"`\]; \}\>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                         |
+| `origin`                          | \| \{ `method`: `string`; `seal`: `string`; \} \| `undefined`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | -                                                                                                                                                                                                                         |
+
+#### Returns
+
+| Name                      | Type                                                                                                                                                  | Default value     | Description                                                                                                                                                                                                               |
+| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `computerId`              | `string` \| `null`                                                                                                                                    | -                 | -                                                                                                                                                                                                                         |
+| `actor`                   | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `hostActorSchema` | -                                                                                                                                                                                                                         |
+| `backgroundLane?`         | `string`                                                                                                                                              | -                 | Host-attested enqueue eligibility for this ordinary write; absent otherwise.                                                                                                                                              |
+| `backgroundOrigin?`       | `object`                                                                                                                                              | -                 | Host-sealed foreground method for durable jobs; paired with backgroundLane.                                                                                                                                               |
+| `backgroundOrigin.method` | `string`                                                                                                                                              | -                 | -                                                                                                                                                                                                                         |
+| `backgroundOrigin.seal`   | `string`                                                                                                                                              | -                 | -                                                                                                                                                                                                                         |
+| `role?`                   | `"member"` \| `"owner"`                                                                                                                               | -                 | Team role attested by the host, never selected by App method input.                                                                                                                                                       |
+| `soleMember?`             | `true`                                                                                                                                                | -                 | The host attests that this member is currently the Team's only member. Present only on a member's own call; never on an Agent, Team key or Workflow node, and never selected by App method input.                         |
+| `workflow?`               | `object`                                                                                                                                              | -                 | Present only on a Workflow node invocation admitted by its host.                                                                                                                                                          |
+| `workflow.workflowId`     | `string`                                                                                                                                              | `identity`        | Published Workflow selected by the run owner.                                                                                                                                                                             |
+| `workflow.runId`          | `string`                                                                                                                                              | `identity`        | Run identity held by the run owner.                                                                                                                                                                                       |
+| `workflow.nodeId`         | `string`                                                                                                                                              | `identity`        | Node selected by the stored published Workflow.                                                                                                                                                                           |
+| `workflow.armedBy`        | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `hostActorSchema` | Actor that armed the run, re-admitted by the host at dispatch.                                                                                                                                                            |
+| `idempotencyKey?`         | `string`                                                                                                                                              | -                 | The host's stable key for this logical call (for example one Workflow node), the same on every retry. A method with side effects uses it to do its work at most once. Absent when the caller supplies its own request id. |
+
+---
+
+### mayEnqueueBackground()
+
+```ts
+function mayEnqueueBackground(context): boolean;
+```
+
+App-side eligibility reads only the host-attested context; it never invents
+ancestry.
+
+#### Parameters
+
+| Parameter                         | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Description                                                                                                                                                                                                               |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `context`                         | \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | -                                                                                                                                                                                                                         |
+| `context.computerId`              | `string` \| `null`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                         |
+| `context.actor`                   | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                                                         |
+| `context.backgroundLane?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Host-attested enqueue eligibility for this ordinary write; absent otherwise.                                                                                                                                              |
+| `context.backgroundOrigin?`       | \{ `method`: `string`; `seal`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Host-sealed foreground method for durable jobs; paired with backgroundLane.                                                                                                                                               |
+| `context.backgroundOrigin.method` | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.backgroundOrigin.seal`   | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | -                                                                                                                                                                                                                         |
+| `context.role?`                   | `"member"` \| `"owner"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Team role attested by the host, never selected by App method input.                                                                                                                                                       |
+| `context.soleMember?`             | `true`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | The host attests that this member is currently the Team's only member. Present only on a member's own call; never on an Agent, Team key or Workflow node, and never selected by App method input.                         |
+| `context.workflow?`               | \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}                                                                                                                                                                                                                                                                                                                                                                                                            | Present only on a Workflow node invocation admitted by its host.                                                                                                                                                          |
+| `context.workflow.workflowId`     | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Published Workflow selected by the run owner.                                                                                                                                                                             |
+| `context.workflow.runId`          | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Run identity held by the run owner.                                                                                                                                                                                       |
+| `context.workflow.nodeId`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Node selected by the stored published Workflow.                                                                                                                                                                           |
+| `context.workflow.armedBy`        | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Actor that armed the run, re-admitted by the host at dispatch.                                                                                                                                                            |
+| `context.idempotencyKey?`         | `string`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | The host's stable key for this logical call (for example one Workflow node), the same on every retry. A method with side effects uses it to do its work at most once. Absent when the caller supplies its own request id. |
+
+#### Returns
+
+`boolean`
+
+---
+
+### readmitBackground()
+
+```ts
+function readmitBackground<Principal>(
+  input,
+  ports,
+): Promise<BackgroundReplayDecision>;
+```
+
+Resolve then re-admit. Observed revisions are evidence, never equality pins.
+
+#### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `Principal`    |
+
+#### Parameters
+
+| Parameter | Type                                                             |
+| --------- | ---------------------------------------------------------------- |
+| `input`   | `unknown`                                                        |
+| `ports`   | [`BackgroundReplayPorts`](#backgroundreplayports)\<`Principal`\> |
+
+#### Returns
+
+`Promise`\<[`BackgroundReplayDecision`](#backgroundreplaydecision)\>
+
+## References
+
+### backgroundSyncAllowed
+
+Re-exports [backgroundSyncAllowed](app-method-runtime.md#backgroundsyncallowed)