@astrosheep/keiyaku 4.6.7 → 4.6.9

package/build/src/debt/mutation-result.js

@@ -0,0 +1,109 @@
+import { debtIdSchema as debtMutationIdSchema, debtIdsSchema, debtNamespaceSchema, parseDebtId } from "./identity.js";
+import { debtNonblankTextSchema, debtStateSchema, debtPrioritySchema } from "./document.js";
+import { z } from "zod";
+export { debtIdSchema as debtMutationIdSchema } from "./identity.js";
+function withoutUndefined(value, keys) {
+    const result = { ...value };
+    for (const key of keys) {
+        const field = result[key];
+        delete result[key];
+        if (field !== undefined)
+            result[key] = field;
+    }
+    return result;
+}
+const timestampSchema = z.string().refine((value) => {
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) && new Date(parsed).toISOString() === value;
+}, "expected canonical UTC timestamp");
+const debtRetrySchema = z
+    .object({ kind: z.literal("retry"), reason: z.enum(["busy", "concurrent-modification"]) })
+    .strict();
+const debtCleanupFailureSchema = z
+    .object({ kind: z.literal("lock-release-failed"), diagnostics: z.array(z.string()).readonly() })
+    .strict();
+const debtViewSchema = z
+    .object({
+    id: debtMutationIdSchema,
+    namespace: debtNamespaceSchema,
+    title: debtNonblankTextSchema,
+    state: debtStateSchema,
+    priority: debtPrioritySchema,
+    needs: debtIdsSchema,
+    parent: debtMutationIdSchema.nullable(),
+    supersedes: debtIdsSchema,
+    relates: debtIdsSchema,
+    note: z.string(),
+    createdBy: debtNonblankTextSchema.optional(),
+    createdAt: timestampSchema,
+    updatedAt: timestampSchema,
+    body: z.string(),
+})
+    .strict()
+    .superRefine((debt, context) => {
+    if (debt.namespace.join("/") !== parseDebtId(debt.id).namespace.join("/"))
+        context.addIssue({ code: "custom", path: ["namespace"], message: "namespace must agree with debt ID" });
+})
+    .transform(({ createdBy, ...debt }) => withoutUndefined({ ...debt, createdBy }, ["createdBy"]));
+export const debtRefusalSchema = z.union([
+    z.object({ kind: z.literal("debt-missing"), debtId: debtMutationIdSchema }).strict(),
+    z
+        .object({
+        kind: z.literal("invalid-lifecycle-transition"),
+        debtId: debtMutationIdSchema,
+        state: debtStateSchema,
+        verb: z.enum(["done", "drop"]),
+    })
+        .strict(),
+    z.object({ kind: z.literal("invalid-graph"), diagnostic: z.string() }).strict(),
+    z.object({ kind: z.literal("invalid-namespace-context"), path: z.string() }).strict(),
+    z
+        .object({
+        kind: z.literal("relation-owned-by-other"),
+        debtId: debtMutationIdSchema,
+        related: debtMutationIdSchema,
+        declaringDebt: debtMutationIdSchema,
+    })
+        .strict(),
+]);
+const debtRefusedResultSchema = z.object({ kind: z.literal("refused"), refusal: debtRefusalSchema }).strict();
+export const debtMutationResultSchema = z.union([
+    z
+        .object({ kind: z.literal("accepted"), value: debtViewSchema, cleanup: debtCleanupFailureSchema.optional() })
+        .strict()
+        .transform((value) => withoutUndefined(value, ["cleanup"])),
+    debtRefusedResultSchema,
+    debtRetrySchema,
+]);
+export const debtUpdateResultSchema = z.union([
+    z
+        .object({
+        kind: z.literal("accepted"),
+        value: z
+            .object({
+            debt: debtViewSchema,
+            documentDiff: z.string(),
+            changedFields: z
+                .array(z
+                .object({ field: z.string(), action: z.enum(["added", "replaced", "cleared", "changed", "appended"]) })
+                .strict())
+                .readonly(),
+        })
+            .strict(),
+        cleanup: debtCleanupFailureSchema.optional(),
+    })
+        .strict()
+        .transform((value) => withoutUndefined(value, ["cleanup"])),
+    debtRefusedResultSchema,
+    debtRetrySchema,
+]);
+export const debtBatchResultSchema = z
+    .object({
+    items: z.array(z.object({ id: debtMutationIdSchema, outcome: debtMutationResultSchema }).strict()).readonly(),
+})
+    .strict();
+export const debtMutationExecutionResultSchema = z.union([
+    debtBatchResultSchema,
+    debtMutationResultSchema,
+    debtUpdateResultSchema,
+]);

package/build/src/debt/mutation.d.ts

@@ -0,0 +1,424 @@
+import { type WorldRoot } from "../world.js";
+import { type ErasedRequestCommand, type RequestProtocol, type ServiceRequestCommand } from "../akuma/request-wire.js";
+import type { AddDebtDocumentInput, AddDebtInput, DebtBatchResult, DebtMutationResult, DebtUpdateResult, UpdateDebtInput } from "./operations.js";
+import { type DebtMutationExecutionResult } from "./mutation-result.js";
+import { z } from "zod";
+export declare const DEBT_MUTATION_ACTIONS: readonly ["debt.add", "debt.addDocument", "debt.done", "debt.drop", "debt.update"];
+declare const debtMutationActionSchema: z.ZodEnum<{
+    "debt.add": "debt.add";
+    "debt.addDocument": "debt.addDocument";
+    "debt.done": "debt.done";
+    "debt.drop": "debt.drop";
+    "debt.update": "debt.update";
+}>;
+export type DebtMutationAction = z.infer<typeof debtMutationActionSchema>;
+declare const debtRequestSchemas: {
+    readonly "debt.add": z.ZodPipe<z.ZodObject<{
+        input: z.ZodObject<{
+            title: z.ZodString;
+            namespace: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            body: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            state: z.ZodOptional<z.ZodEnum<{
+                open: "open";
+                done: "done";
+                drop: "drop";
+            }>>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            needs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+            supersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            relates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        action: "debt.add";
+        input: {
+            title: string;
+            namespace: readonly string[];
+            body?: string | undefined;
+            note?: string | undefined;
+            state?: "open" | "done" | "drop" | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+        };
+    }, {
+        input: {
+            title: string;
+            namespace: readonly string[];
+            body?: string | undefined;
+            note?: string | undefined;
+            state?: "open" | "done" | "drop" | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+        };
+    }>>;
+    readonly "debt.addDocument": z.ZodPipe<z.ZodObject<{
+        input: z.ZodObject<{
+            markdown: z.ZodString;
+            namespace: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        action: "debt.addDocument";
+        input: {
+            markdown: string;
+            namespace: readonly string[];
+        };
+    }, {
+        input: {
+            markdown: string;
+            namespace: readonly string[];
+        };
+    }>>;
+    readonly "debt.done": z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.done";
+        id: `debt/${string}`;
+    }, {
+        id: `debt/${string}`;
+        note?: string | undefined;
+    }>>, z.ZodPipe<z.ZodObject<{
+        ids: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.done";
+        ids: readonly `debt/${string}`[];
+    }, {
+        ids: readonly `debt/${string}`[];
+        note?: string | undefined;
+    }>>]>;
+    readonly "debt.drop": z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.drop";
+        id: `debt/${string}`;
+    }, {
+        id: `debt/${string}`;
+        note?: string | undefined;
+    }>>, z.ZodPipe<z.ZodObject<{
+        ids: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.drop";
+        ids: readonly `debt/${string}`[];
+    }, {
+        ids: readonly `debt/${string}`[];
+        note?: string | undefined;
+    }>>]>;
+    readonly "debt.update": z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        input: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            body: z.ZodOptional<z.ZodString>;
+            appendBody: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            needs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addNeeds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropNeeds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+            supersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addSupersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropSupersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            relates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addRelates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropRelates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        id: `debt/${string}`;
+        input: {
+            title?: string | undefined;
+            body?: string | undefined;
+            appendBody?: string | undefined;
+            note?: string | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            addNeeds?: readonly `debt/${string}`[] | undefined;
+            dropNeeds?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            addSupersedes?: readonly `debt/${string}`[] | undefined;
+            dropSupersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+            addRelates?: readonly `debt/${string}`[] | undefined;
+            dropRelates?: readonly `debt/${string}`[] | undefined;
+        };
+        action: "debt.update";
+    }, {
+        id: `debt/${string}`;
+        input: {
+            title?: string | undefined;
+            body?: string | undefined;
+            appendBody?: string | undefined;
+            note?: string | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            addNeeds?: readonly `debt/${string}`[] | undefined;
+            dropNeeds?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            addSupersedes?: readonly `debt/${string}`[] | undefined;
+            dropSupersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+            addRelates?: readonly `debt/${string}`[] | undefined;
+            dropRelates?: readonly `debt/${string}`[] | undefined;
+        };
+    }>>;
+};
+export type DebtMutationRequest = z.infer<(typeof debtRequestSchemas)[DebtMutationAction]>;
+declare const debtBodyRequestSchema: z.ZodObject<{
+    world: z.ZodString;
+    request: z.ZodUnion<(z.ZodPipe<z.ZodObject<{
+        input: z.ZodObject<{
+            title: z.ZodString;
+            namespace: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            body: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            state: z.ZodOptional<z.ZodEnum<{
+                open: "open";
+                done: "done";
+                drop: "drop";
+            }>>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            needs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+            supersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            relates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        action: "debt.add";
+        input: {
+            title: string;
+            namespace: readonly string[];
+            body?: string | undefined;
+            note?: string | undefined;
+            state?: "open" | "done" | "drop" | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+        };
+    }, {
+        input: {
+            title: string;
+            namespace: readonly string[];
+            body?: string | undefined;
+            note?: string | undefined;
+            state?: "open" | "done" | "drop" | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+        };
+    }>> | z.ZodPipe<z.ZodObject<{
+        input: z.ZodObject<{
+            markdown: z.ZodString;
+            namespace: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        action: "debt.addDocument";
+        input: {
+            markdown: string;
+            namespace: readonly string[];
+        };
+    }, {
+        input: {
+            markdown: string;
+            namespace: readonly string[];
+        };
+    }>> | z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        input: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            body: z.ZodOptional<z.ZodString>;
+            appendBody: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            priority: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+            needs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addNeeds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropNeeds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+            supersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addSupersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropSupersedes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            relates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            addRelates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+            dropRelates: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodTransform<{
+        id: `debt/${string}`;
+        input: {
+            title?: string | undefined;
+            body?: string | undefined;
+            appendBody?: string | undefined;
+            note?: string | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            addNeeds?: readonly `debt/${string}`[] | undefined;
+            dropNeeds?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            addSupersedes?: readonly `debt/${string}`[] | undefined;
+            dropSupersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+            addRelates?: readonly `debt/${string}`[] | undefined;
+            dropRelates?: readonly `debt/${string}`[] | undefined;
+        };
+        action: "debt.update";
+    }, {
+        id: `debt/${string}`;
+        input: {
+            title?: string | undefined;
+            body?: string | undefined;
+            appendBody?: string | undefined;
+            note?: string | undefined;
+            priority?: 0 | 1 | 2 | 3 | undefined;
+            needs?: readonly `debt/${string}`[] | undefined;
+            addNeeds?: readonly `debt/${string}`[] | undefined;
+            dropNeeds?: readonly `debt/${string}`[] | undefined;
+            parent?: `debt/${string}` | null | undefined;
+            supersedes?: readonly `debt/${string}`[] | undefined;
+            addSupersedes?: readonly `debt/${string}`[] | undefined;
+            dropSupersedes?: readonly `debt/${string}`[] | undefined;
+            relates?: readonly `debt/${string}`[] | undefined;
+            addRelates?: readonly `debt/${string}`[] | undefined;
+            dropRelates?: readonly `debt/${string}`[] | undefined;
+        };
+    }>> | z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.done";
+        id: `debt/${string}`;
+    }, {
+        id: `debt/${string}`;
+        note?: string | undefined;
+    }>>, z.ZodPipe<z.ZodObject<{
+        ids: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.done";
+        ids: readonly `debt/${string}`[];
+    }, {
+        ids: readonly `debt/${string}`[];
+        note?: string | undefined;
+    }>>]> | z.ZodUnion<readonly [z.ZodPipe<z.ZodObject<{
+        id: z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.drop";
+        id: `debt/${string}`;
+    }, {
+        id: `debt/${string}`;
+        note?: string | undefined;
+    }>>, z.ZodPipe<z.ZodObject<{
+        ids: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`debt/${string}`, string>>>>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodTransform<{
+        note?: string;
+        action: "debt.drop";
+        ids: readonly `debt/${string}`[];
+    }, {
+        ids: readonly `debt/${string}`[];
+        note?: string | undefined;
+    }>>]>)[]>;
+}, z.core.$strict>;
+export type DebtMutationBodyRequest = z.infer<typeof debtBodyRequestSchema>;
+declare const debtMutationServiceSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        "debt.add": "debt.add";
+        "debt.addDocument": "debt.addDocument";
+        "debt.done": "debt.done";
+        "debt.drop": "debt.drop";
+        "debt.update": "debt.update";
+    }>;
+}, z.core.$strict>;
+type DebtMutationService = z.infer<typeof debtMutationServiceSchema>;
+export declare const forwardedDebtReferenceSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"served-reference">;
+    action: z.ZodEnum<{
+        "debt.add": "debt.add";
+        "debt.addDocument": "debt.addDocument";
+        "debt.done": "debt.done";
+        "debt.drop": "debt.drop";
+        "debt.update": "debt.update";
+    }>;
+}, z.core.$strict>;
+export type ForwardedDebtReference = z.infer<typeof forwardedDebtReferenceSchema>;
+export type DebtMutationResultForRequest<Request extends DebtMutationRequest> = Request extends Readonly<{
+    action: "debt.update";
+}> ? DebtUpdateResult : Request extends Readonly<{
+    ids: readonly string[];
+}> ? DebtBatchResult : DebtMutationResult;
+export type DebtLifecycleVerb = "done" | "drop";
+/**
+ * The forced-local Debts SDK abilities one descriptor execution entry consumes.
+ * They are composed at the upper Body edge from the same `Debts.of(world)`
+ * product an ordinary local caller uses; this module never imports that product
+ * because the product consumes this descriptor protocol.
+ */
+export type DebtMutationRequestPort = Readonly<{
+    add(input: Readonly<{
+        world: WorldRoot;
+        options: AddDebtInput;
+    }>): Promise<DebtMutationResult>;
+    addDocument(input: Readonly<{
+        world: WorldRoot;
+        document: AddDebtDocumentInput;
+    }>): Promise<DebtMutationResult>;
+    update(input: Readonly<{
+        world: WorldRoot;
+        id: string;
+        options: UpdateDebtInput;
+    }>): Promise<DebtUpdateResult>;
+    lifecycle(input: Readonly<{
+        world: WorldRoot;
+        verb: DebtLifecycleVerb;
+        id: string;
+        note?: string;
+        signal?: AbortSignal;
+    }>): Promise<DebtMutationResult>;
+    batch(input: Readonly<{
+        world: WorldRoot;
+        verb: DebtLifecycleVerb;
+        ids: readonly string[];
+        note?: string;
+        signal?: AbortSignal;
+    }>): Promise<DebtBatchResult>;
+}>;
+/** Debt owns forwarded mutation payload, live result, and durable service evidence. */
+export declare function debtMutationRequestProtocol(action: DebtMutationAction, batch?: boolean): RequestProtocol<DebtMutationBodyRequest, DebtMutationExecutionResult, ForwardedDebtReference>;
+export declare function debtMutationRequestCommand(action: DebtMutationAction, port: DebtMutationRequestPort): ServiceRequestCommand<DebtMutationBodyRequest, DebtMutationExecutionResult, DebtMutationService, ForwardedDebtReference>;
+export declare function debtMutationRequestCommands(port: DebtMutationRequestPort): Readonly<Record<DebtMutationAction, ErasedRequestCommand>>;
+export declare function requestForwardedDebt<Request extends DebtMutationRequest>(input: Readonly<{
+    directory: string;
+    id?: never;
+    world: WorldRoot;
+    request: Request;
+    signal?: AbortSignal;
+}>): Promise<DebtMutationResultForRequest<Request>>;
+export declare function requestForwardedDebt<Request extends DebtMutationRequest>(input: Readonly<{
+    directory: string;
+    id: string;
+    world: WorldRoot;
+    request: Request;
+    signal?: AbortSignal;
+}>): Promise<DebtMutationResultForRequest<Request> | ForwardedDebtReference>;
+export {};