@softure-ai/mcp-access 0.2.9 → 0.4.0

package/dist/jobs/operation-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-tasks.js","sourceRoot":"","sources":["../../src/jobs/operation-tasks.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAChH,wHAAwH;AACxH,iHAAiH;AACjH,EAAE;AACF,mGAAmG;AACnG,4EAA4E;AAC5E,sGAAsG;AACtG,EAAE;AACF,sHAAsH;AACtH,kHAAkH;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,4BAA4B,EAC5B,oCAAoC,EACpC,aAAa,EACb,iBAAiB,GAGlB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAE9B,uHAAuH;AACvH,MAAM,CAAC,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AACvC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,IAAI,GAAG,iEAAiE,CAAC;AAC/E,MAAM,cAAc,GAAG,yCAAyC,CAAC;AACjE,MAAM,YAAY,GAAG,2CAA2C,CAAC;AACjE,MAAM,kBAAkB,GAAG,mDAAmD,CAAC;AA6C/E,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3D,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AACrC,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEvG,yHAAyH;AACzH,MAAM,UAAU,cAAc,CAAC,OAA6B;IAC1D,MAAM,QAAQ,GAAqC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAClF,MAAM,YAAY,GAAG,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC,CAAC;IAC1F,OAAO,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,eAAe,CAAC,KAAK,SAAS,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,oBAAoB,IAAI,OAAO,IAAI,oBAAoB,CAAC;AACzG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAgB,EAAE,QAA2B,EAAE,KAA+B;IACtH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,GAAG,KAAK,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,CAAC,KAAK,sCAAsC,CAAC,CAAC;IACjH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACrG,mHAAmH;IACnH,2FAA2F;IAC3F,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,oHAAoH;AACpH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAgB,EAChB,QAA2B,EAC3B,MAAc,EACd,UAA8D,EAAE;IAEhE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAA8B;IACtF,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7B,MAAM,cAAc,GAAG,GAAyB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5I,MAAM,eAAe,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3K,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE9E,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE;QACvH,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,MAAM,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,kHAAkH;IAClH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE;QAC1H,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,WAAW,CAAC,MAAM,cAAc,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QAC7E,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE;QAC1H,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,cAAc,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC7F,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QAChG,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACtG,+FAA+F;QAC/F,MAAM,gBAAgB,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAgB,EAAE,QAA2B,EAAE,KAA+B;IACrG,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,wBAAwB,CAAC,GAAG,IAAI,CAAC,CAAC;IAClG,iHAAiH;IACjH,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,MAAM,CAAC,cAAc,CAAC;SACtB,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;SACpJ,kBAAkB,CAAC;QAClB,MAAM,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC;QACrD,GAAG,EAAE,EAAE,SAAS,EAAE,GAAG,CAAA,YAAY,cAAc,CAAC,SAAS,wBAAwB,EAAE;KACpF,CAAC;SACD,SAAS,EAAE,CAAC;IACf,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAClG,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAgB,EAAE,QAA2B,EAAE,MAAc;IACnF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE;SACvB,MAAM,EAAE;SACR,IAAI,CAAC,cAAc,CAAC;SACpB,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;SACzF,KAAK,CAAC,CAAC,CAAC,CAAC;IACZ,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,SAAS,CAAC;IAC3E,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpE,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,GAAgB,EAChB,QAA2B,EAC3B,MAAc,EACd,OAA2D;IAE3D,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACpE,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAC5F,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gHAAgH;AAChH,SAAS,sBAAsB,CAAC,OAA6B;IAC3D,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,oCAAoC,CAAC,EAAE,oBAAoB,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;AACpJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAgB,EAAE,GAAY,EAAE,GAAQ,EAAE,OAA2D;IAC/H,MAAM,QAAQ,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC;IAC7D,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG;QACX,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;QACtC,aAAa,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;QAC1C,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE;KACzD,CAAC;IACF,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;QAChF,MAAM,aAAa,GAAG,GAAG,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;QACvJ,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;IAC7H,CAAC;IACD,IAAI,MAAM,KAAK,WAAW;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;IACvG,4GAA4G;IAC5G,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnG,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;AACjF,CAAC"}

package/dist/jobs/operations.d.ts

@@ -0,0 +1,89 @@
+import type { CallToolResult, McpServer } from "@modelcontextprotocol/server";
+import { type Err, type Ok, type SoftureConfig } from "@softure-ai/core";
+import { type JobsContext } from "@softure-ai/jobs/server";
+import type { McpServerIdentity } from "../contract.js";
+import { type ToolErrorHints } from "../server/tools.js";
+import { type OperationTaskRequest } from "./operation-tasks.js";
+import { type GetOperationOptions, type OperationAnswer, type OperationErrorCode, type OperationPollOptions, type ReadOperationResult } from "./operation-state.js";
+export { getOperationStatus, getPollAfterSeconds, MAX_OPERATION_DEDUP_KEY_LENGTH, OPERATION_CANCEL_TOOL_NAME, OPERATION_ORIGIN, OPERATION_STATUS_TOOL_NAME, OPERATION_STATUSES, type GetOperationOptions, type OperationAnswer, type OperationErrorCode, type OperationJob, type OperationPollOptions, type OperationStatus, type ReadOperationResult, } from "./operation-state.js";
+export interface StartOperationInput {
+    /** A queue defined in `jobs({ queues })`. */
+    readonly queue: string;
+    /** The handler's payload, as `enqueueJob` takes it: ids, not personal data. */
+    readonly payload: unknown;
+    /**
+     * While an operation of this account and queue with the same key runs, starting again joins it (the answer carries
+     * its id and status). At most 150 characters. Default: a new operation every time.
+     */
+    readonly dedupKey?: string;
+    /** The status tool the answer tells the assistant to call. Default `get_operation`. */
+    readonly statusToolName?: string;
+    readonly poll?: OperationPollOptions;
+    /**
+     * The tool handler's request context (its second argument). When the client declared the MCP Tasks extension on
+     * this request, the answer is a task (`resultType: "task"`) instead of an operation id; any other client gets the
+     * operation id as before. Pair it with `registerOperationTasks` on the same server, which serves `tasks/get`.
+     */
+    readonly taskRequest?: OperationTaskRequest;
+    /** How long a task can be read after it was created, in seconds. Default 86 400 (a day). */
+    readonly taskTtlSeconds?: number;
+}
+/**
+ * Where an operation tool finds its `{ db, clock, config }`: the request's context as a value, or a getter resolved
+ * inside each call (for a server factory that opens the database per call, so registering and listing the tools
+ * opens nothing).
+ */
+export type OperationToolContext = {
+    /** `{ db, clock, config }` of the request. */
+    readonly ctx: JobsContext;
+    readonly getContext?: never;
+    readonly config?: never;
+} | {
+    readonly ctx?: never;
+    /** Resolves `{ db, clock, config }` inside each call, once per call. */
+    readonly getContext: () => Promise<JobsContext>;
+    /** The app's config for the tool description at registration. Default: the built-in English dictionary. */
+    readonly config?: SoftureConfig;
+};
+type OperationToolOptions = OperationToolContext & {
+    /** The request's identity: operations are scoped to `identity.userId`. */
+    readonly identity: McpServerIdentity;
+    /** Default: the module dictionary's description. */
+    readonly description?: string;
+};
+export type OperationStatusToolOptions = OperationToolOptions & {
+    /** Default `get_operation`. */
+    readonly name?: string;
+    readonly readResult?: ReadOperationResult;
+    readonly poll?: OperationPollOptions;
+};
+export type OperationCancelToolOptions = OperationToolOptions & {
+    /** Default `cancel_operation`. */
+    readonly name?: string;
+    /** The status tool the answer points to. Default `get_operation`. */
+    readonly statusToolName?: string;
+    readonly poll?: OperationPollOptions;
+};
+/**
+ * For a tool handler: enqueues the operation's job and answers its id with the fixed sentence (ask the status tool,
+ * do not start again). Throws on an unknown queue or a dedup key over 150 characters (a bug in the caller); database
+ * failures propagate, so call it inside `withToolErrors` or let the SDK answer the error.
+ */
+export declare function startOperation(ctx: JobsContext, identity: McpServerIdentity, input: StartOperationInput): Promise<CallToolResult>;
+/** The caller's operation as `get_operation` answers it; `mcp-access.operation_not_found` for any other id. */
+export declare function getOperation(ctx: JobsContext, identity: McpServerIdentity, operationId: string, options?: GetOperationOptions): Promise<Ok<OperationAnswer> | Err<"mcp-access.operation_not_found">>;
+/**
+ * Cancels the caller's operation: a queued one ends at once, a running one is asked to stop (its handler's `signal`
+ * aborts on the next heartbeat). `mcp-access.operation_finished` once it has ended.
+ */
+export declare function cancelOperation(ctx: JobsContext, identity: McpServerIdentity, operationId: string, options?: Omit<GetOperationOptions, "readResult">): Promise<Ok<OperationAnswer> | Err<OperationErrorCode>>;
+/** Registers the read-only status tool (`get_operation`) for the request's account. */
+export declare function registerOperationStatusTool(server: McpServer, options: OperationStatusToolOptions): void;
+/** Registers the cancel tool (`cancel_operation`), a write: nothing is registered without `identity.canWrite`. */
+export declare function registerOperationCancelTool(server: McpServer, options: OperationCancelToolOptions): void;
+/**
+ * The module's sentences for the operation error codes, as `withToolErrors({ hints })` takes them: for an app that
+ * wraps `getOperation` or `cancelOperation` in tools of its own.
+ */
+export declare function getOperationErrorHints(config: SoftureConfig): ToolErrorHints;
+//# sourceMappingURL=operations.d.ts.map

package/dist/jobs/operations.d.ts.map

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

package/dist/jobs/operations.js

@@ -0,0 +1,131 @@
+// Long operations as MCP tools (#952), on top of `@softure-ai/jobs`. A tool whose work takes minutes cannot hold the
+// call open (JSON mode drops mid-call notifications, proxies cut long responses, assistants time out), so it starts a
+// job and answers an operation id at once; the assistant then asks `get_operation` until the operation ends, and may
+// stop it with `cancel_operation`.
+//
+//   server.registerTool("render_video", { inputSchema }, (args) => startOperation(ctx, identity, { queue: "video.render", payload: args }));
+//   registerOperationStatusTool(server, { ctx, identity, readResult: (job) => findRenderUrl(job.id) });
+//   registerOperationCancelTool(server, { ctx, identity });
+//
+// Ownership rides on the job itself: its origin is `mcp` and its dedup key `mcp:<userId>:<key>`, which the jobs table
+// keeps after the job ends. Any other job, or another account's, is "not found".
+import { randomUUID } from "node:crypto";
+import { err, ok } from "@softure-ai/core";
+import { enqueueJob, requestJobCancel } from "@softure-ai/jobs/server";
+import { z } from "zod";
+import { mcpAccessMessages } from "../messages/index.js";
+import { getMcpAccessMessages } from "../server/options.js";
+import { answerValue, toolResult, withToolErrors } from "../server/tools.js";
+import { answerOperationTask, isTasksRequest, isTaskTtlValid, MAX_TASK_TTL_SECONDS } from "./operation-tasks.js";
+import { describeOperation, fillToolName, findOwnedJob, getOwnerPrefix, getPollMin, MAX_OPERATION_DEDUP_KEY_LENGTH, OPERATION_ORIGIN, OPERATION_STATUS_TOOL_NAME, OPERATION_CANCEL_TOOL_NAME, } from "./operation-state.js";
+export { getOperationStatus, getPollAfterSeconds, MAX_OPERATION_DEDUP_KEY_LENGTH, OPERATION_CANCEL_TOOL_NAME, OPERATION_ORIGIN, OPERATION_STATUS_TOOL_NAME, OPERATION_STATUSES, } from "./operation-state.js";
+const operationInput = z.object({ operationId: z.string().min(1).max(100) });
+/**
+ * For a tool handler: enqueues the operation's job and answers its id with the fixed sentence (ask the status tool,
+ * do not start again). Throws on an unknown queue or a dedup key over 150 characters (a bug in the caller); database
+ * failures propagate, so call it inside `withToolErrors` or let the SDK answer the error.
+ */
+export async function startOperation(ctx, identity, input) {
+    if (input.dedupKey !== undefined && (input.dedupKey.length === 0 || input.dedupKey.length > MAX_OPERATION_DEDUP_KEY_LENGTH)) {
+        throw new Error(`startOperation: the dedup key of queue ${input.queue} must have 1 to ${String(MAX_OPERATION_DEDUP_KEY_LENGTH)} characters`);
+    }
+    if (input.taskTtlSeconds !== undefined && !isTaskTtlValid(input.taskTtlSeconds)) {
+        throw new Error(`startOperation: the task lifetime of queue ${input.queue} must be whole seconds from 60 to ${String(MAX_TASK_TTL_SECONDS)}`);
+    }
+    const enqueued = await enqueueJob(ctx, {
+        queue: input.queue,
+        payload: input.payload,
+        origin: OPERATION_ORIGIN,
+        dedupKey: getOwnerPrefix(identity.userId) + (input.dedupKey ?? randomUUID()),
+    });
+    const options = { ...(input.poll === undefined ? {} : { poll: input.poll }), statusToolName: input.statusToolName ?? OPERATION_STATUS_TOOL_NAME };
+    if (input.taskRequest !== undefined && isTasksRequest(input.taskRequest)) {
+        return answerOperationTask(ctx, identity, { jobId: enqueued.id, ...(input.taskTtlSeconds === undefined ? {} : { ttlSeconds: input.taskTtlSeconds }), ...(input.poll === undefined ? {} : { poll: input.poll }) });
+    }
+    if (enqueued.isDuplicate) {
+        const joined = await getOperation(ctx, identity, enqueued.id, options);
+        if (joined.ok)
+            return toolResult(joined.value);
+    }
+    const messages = getMcpAccessMessages(ctx.config).operations;
+    const answer = {
+        operationId: enqueued.id,
+        status: "queued",
+        progress: null,
+        pollAfterSeconds: getPollMin(input.poll),
+        message: fillToolName(messages.started, options.statusToolName),
+    };
+    return toolResult(answer);
+}
+/** The caller's operation as `get_operation` answers it; `mcp-access.operation_not_found` for any other id. */
+export async function getOperation(ctx, identity, operationId, options = {}) {
+    const job = await findOwnedJob(ctx, identity, operationId);
+    if (job === null)
+        return err("mcp-access.operation_not_found");
+    return ok(await describeOperation(ctx, job, options));
+}
+/**
+ * Cancels the caller's operation: a queued one ends at once, a running one is asked to stop (its handler's `signal`
+ * aborts on the next heartbeat). `mcp-access.operation_finished` once it has ended.
+ */
+export async function cancelOperation(ctx, identity, operationId, options = {}) {
+    const owned = await findOwnedJob(ctx, identity, operationId);
+    if (owned === null)
+        return err("mcp-access.operation_not_found");
+    const cancelled = await requestJobCancel(ctx, owned.id);
+    if (!cancelled.ok)
+        return err(cancelled.error === "jobs.not_found" ? "mcp-access.operation_not_found" : "mcp-access.operation_finished");
+    return ok(await describeOperation(ctx, cancelled.value, options));
+}
+/** Registers the read-only status tool (`get_operation`) for the request's account. */
+export function registerOperationStatusTool(server, options) {
+    const name = options.name ?? OPERATION_STATUS_TOOL_NAME;
+    const messages = getRegistrationMessages(options);
+    const getOptions = {
+        statusToolName: name,
+        ...(options.readResult === undefined ? {} : { readResult: options.readResult }),
+        ...(options.poll === undefined ? {} : { poll: options.poll }),
+    };
+    server.registerTool(name, {
+        description: options.description ?? messages.statusToolDescription,
+        inputSchema: operationInput,
+        annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    }, ({ operationId }) => withToolErrors(async () => {
+        const ctx = await resolveOperationContext(options);
+        return answerValue(await getOperation(ctx, options.identity, operationId, getOptions), getOperationErrorHints(ctx.config));
+    }, { label: name }));
+}
+/** Registers the cancel tool (`cancel_operation`), a write: nothing is registered without `identity.canWrite`. */
+export function registerOperationCancelTool(server, options) {
+    if (!options.identity.canWrite)
+        return;
+    const name = options.name ?? OPERATION_CANCEL_TOOL_NAME;
+    const messages = getRegistrationMessages(options);
+    const cancelOptions = { statusToolName: options.statusToolName ?? OPERATION_STATUS_TOOL_NAME, ...(options.poll === undefined ? {} : { poll: options.poll }) };
+    server.registerTool(name, {
+        description: options.description ?? messages.cancelToolDescription,
+        inputSchema: operationInput,
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, ({ operationId }) => withToolErrors(async () => {
+        const ctx = await resolveOperationContext(options);
+        return answerValue(await cancelOperation(ctx, options.identity, operationId, cancelOptions), getOperationErrorHints(ctx.config));
+    }, { label: name }));
+}
+/**
+ * The module's sentences for the operation error codes, as `withToolErrors({ hints })` takes them: for an app that
+ * wraps `getOperation` or `cancelOperation` in tools of its own.
+ */
+export function getOperationErrorHints(config) {
+    const messages = getMcpAccessMessages(config).operations;
+    return { "mcp-access.operation_not_found": messages.notFound, "mcp-access.operation_finished": messages.finished };
+}
+/** The context of this call: the value given, or the getter resolved now. */
+function resolveOperationContext(source) {
+    return source.getContext === undefined ? Promise.resolve(source.ctx) : source.getContext();
+}
+/** The texts a registration needs before any call: from the context or config given, else the English dictionary. */
+function getRegistrationMessages(source) {
+    const config = source.getContext === undefined ? source.ctx.config : source.config;
+    return config === undefined ? mcpAccessMessages.en.operations : getMcpAccessMessages(config).operations;
+}
+//# sourceMappingURL=operations.js.map

package/dist/jobs/operations.js.map

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

package/dist/messages/en.d.ts

@@ -20,6 +20,28 @@ export declare const en: {
         pending: string;
         limit: string;
     };
+    apiScopes: {
+        title: string;
+        lead: string;
+        read: string;
+        write: string;
+        writeUnavailable: string;
+    };
+    apiIssue: {
+        title: string;
+        name: string;
+        nameHint: string;
+        scopes: string;
+        submit: string;
+        pending: string;
+    };
+    apiIssued: {
+        title: string;
+        once: string;
+        scopes: string;
+        tokenTitle: string;
+        headerTitle: string;
+    };
     issued: {
         title: string;
         once: string;
@@ -42,6 +64,8 @@ export declare const en: {
     };
     list: {
         title: string;
+        kindMcp: string;
+        kindApi: string;
         empty: string;
         readOnly: string;
         readWrite: string;
@@ -91,9 +115,37 @@ export declare const en: {
         noFields: string;
         fieldRenamed: string;
     };
+    confirmation: {
+        ask: string;
+        fieldDescription: string;
+        invalid: string;
+        otherTool: string;
+        otherAccount: string;
+        expired: string;
+        argumentsChanged: string;
+        estimateChanged: string;
+        used: string;
+    };
     serverInfoTool: {
         description: string;
     };
+    operations: {
+        statusToolDescription: string;
+        cancelToolDescription: string;
+        started: string;
+        queued: string;
+        running: string;
+        cancelRequested: string;
+        succeeded: string;
+        failed: string;
+        cancelled: string;
+        notFound: string;
+        finished: string;
+        /** The `statusMessage` of an MCP task (#977) while its operation has not ended. */
+        taskQueued: string;
+        taskRunning: string;
+        taskCancelRequested: string;
+    };
     errors: {
         "mcp-access": {
             name_required: string;
@@ -103,6 +155,9 @@ export declare const en: {
             grant_not_found: string;
             issue_refused: string;
             write_refused: string;
+            api_disabled: string;
+            scope_required: string;
+            scope_unknown: string;
         };
         auth: {
             unauthenticated: string;

package/dist/messages/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/messages/en.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHd,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/messages/en.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAiJX,mFAAmF;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BtF,CAAC"}

package/dist/messages/en.js

@@ -20,6 +20,28 @@ export const en = {
         pending: "Creating…",
         limit: "You can hold up to {max} active tokens.",
     },
+    apiScopes: {
+        title: "What a token for other apps can do",
+        lead: "Tokens for other apps, such as a phone Shortcut, an automation tool or a script, call this app's HTTP routes. Each one gets only the access you tick.",
+        read: "Reads",
+        write: "Changes data",
+        writeUnavailable: "Changes data (turned off in this app)",
+    },
+    apiIssue: {
+        title: "New token for other apps",
+        name: "Name",
+        nameHint: "Where you will use it, e.g. iPhone Shortcut or Make.",
+        scopes: "Access",
+        submit: "Create token",
+        pending: "Creating…",
+    },
+    apiIssued: {
+        title: "Token created: {name}",
+        once: "Copy it now. It is shown only once; after you leave this page, only its name remains.",
+        scopes: "Access: {scopes}.",
+        tokenTitle: "Token",
+        headerTitle: "Authorization header",
+    },
     issued: {
         title: "Token created: {name}",
         once: "Copy it now. It is shown only once; after you leave this page, only its name remains.",
@@ -42,6 +64,8 @@ export const en = {
     },
     list: {
         title: "Your tokens",
+        kindMcp: "AI assistant",
+        kindApi: "Other apps",
         empty: "You have no tokens yet.",
         readOnly: "Read only",
         readWrite: "Read and change",
@@ -91,9 +115,37 @@ export const en = {
         noFields: "none",
         fieldRenamed: "input.field_renamed: the field \"{field}\" is now \"{renamed}\". Send it as \"{renamed}\".",
     },
+    confirmation: {
+        ask: "Nothing was done yet. Show the person this estimate and ask whether to go ahead. Only after they agree in the chat, call the tool again with the same arguments and \"confirmation\" set to the value above, before {expiresAt}.",
+        fieldDescription: "Leave it out on the first call. Set it only to the confirmation the first call answered, after the person agreed to its estimate.",
+        invalid: "input.confirmation_invalid: this is not a confirmation this tool issued. Call the tool again without \"confirmation\" for a new estimate.",
+        otherTool: "input.confirmation_other_tool: the confirmation was issued for another tool. Call this tool without \"confirmation\" for its own estimate.",
+        otherAccount: "input.confirmation_other_account: the confirmation was issued to another account or access token. Call the tool again without \"confirmation\" for a new estimate.",
+        expired: "input.confirmation_expired: the confirmation has expired. Call the tool again without \"confirmation\" for a new estimate and ask the person again.",
+        argumentsChanged: "input.confirmation_arguments_changed: the arguments differ from the ones the person agreed to. Call the tool again without \"confirmation\" for an estimate of these arguments and ask the person again.",
+        estimateChanged: "input.confirmation_estimate_changed: the estimate has changed since the person agreed. Call the tool again without \"confirmation\" for the new estimate and ask the person again.",
+        used: "input.confirmation_used: the confirmation was used already; nothing was done again. Call the tool again without \"confirmation\" if the person wants it done once more.",
+    },
     serverInfoTool: {
         description: "Tells which build of this server answers: its name and version (the version changes whenever a tool changes), the release, the commit, when it was built and started, and the changelog when the app publishes one. Use it to check that a change is live.",
     },
+    operations: {
+        statusToolDescription: "Tells how a long operation started by another tool is going: queued, running (with its progress), succeeded (with its result), failed (with an error code) or cancelled. Call it again after pollAfterSeconds while the operation runs.",
+        cancelToolDescription: "Stops a long operation started by another tool. A queued one ends at once; a running one stops at its next safe point.",
+        started: "The operation has started and runs in the background. Call {tool} with this operationId after pollAfterSeconds to follow it. Do not call the starting tool again.",
+        queued: "The operation is waiting to start. Call {tool} again after pollAfterSeconds.",
+        running: "The operation is running. Call {tool} again after pollAfterSeconds.",
+        cancelRequested: "The operation was asked to stop and will end shortly. Call {tool} again after pollAfterSeconds.",
+        succeeded: "The operation has finished.",
+        failed: "The operation failed. Tell the user; start it again only if they ask.",
+        cancelled: "The operation was cancelled.",
+        notFound: "No operation with this id belongs to this account.",
+        finished: "The operation has already ended, so it cannot be cancelled.",
+        /** The `statusMessage` of an MCP task (#977) while its operation has not ended. */
+        taskQueued: "The operation is waiting to start.",
+        taskRunning: "The operation is running.",
+        taskCancelRequested: "The operation was asked to stop and will end shortly.",
+    },
     errors: {
         "mcp-access": {
             name_required: "Give the token a name, so you can tell it from the others.",
@@ -103,6 +155,9 @@ export const en = {
             grant_not_found: "This app is no longer connected.",
             issue_refused: "Your account cannot create tokens right now.",
             write_refused: "Your account cannot create tokens with write access. Create a read-only token instead.",
+            api_disabled: "This app does not offer tokens for other apps.",
+            scope_required: "Tick at least one kind of access.",
+            scope_unknown: "This app does not offer that access. Reload the page and try again.",
         },
         auth: {
             unauthenticated: "Your session has ended. Log in again.",

package/dist/messages/en.js.map

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

package/dist/messages/index.d.ts

@@ -24,6 +24,28 @@ export declare const mcpAccessMessages: {
             pending: string;
             limit: string;
         };
+        apiScopes: {
+            title: string;
+            lead: string;
+            read: string;
+            write: string;
+            writeUnavailable: string;
+        };
+        apiIssue: {
+            title: string;
+            name: string;
+            nameHint: string;
+            scopes: string;
+            submit: string;
+            pending: string;
+        };
+        apiIssued: {
+            title: string;
+            once: string;
+            scopes: string;
+            tokenTitle: string;
+            headerTitle: string;
+        };
         issued: {
             title: string;
             once: string;
@@ -46,6 +68,8 @@ export declare const mcpAccessMessages: {
         };
         list: {
             title: string;
+            kindMcp: string;
+            kindApi: string;
             empty: string;
             readOnly: string;
             readWrite: string;
@@ -95,9 +119,36 @@ export declare const mcpAccessMessages: {
             noFields: string;
             fieldRenamed: string;
         };
+        confirmation: {
+            ask: string;
+            fieldDescription: string;
+            invalid: string;
+            otherTool: string;
+            otherAccount: string;
+            expired: string;
+            argumentsChanged: string;
+            estimateChanged: string;
+            used: string;
+        };
         serverInfoTool: {
             description: string;
         };
+        operations: {
+            statusToolDescription: string;
+            cancelToolDescription: string;
+            started: string;
+            queued: string;
+            running: string;
+            cancelRequested: string;
+            succeeded: string;
+            failed: string;
+            cancelled: string;
+            notFound: string;
+            finished: string;
+            taskQueued: string;
+            taskRunning: string;
+            taskCancelRequested: string;
+        };
         errors: {
             "mcp-access": {
                 name_required: string;
@@ -107,6 +158,9 @@ export declare const mcpAccessMessages: {
                 grant_not_found: string;
                 issue_refused: string;
                 write_refused: string;
+                api_disabled: string;
+                scope_required: string;
+                scope_unknown: string;
             };
             auth: {
                 unauthenticated: string;

package/dist/messages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAS,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,OAAO,EAAE,CAAC;AAE1C,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAOlG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAS,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG,OAAO,EAAE,CAAC;AAE1C,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAOlG"}

package/dist/next/issue-token.d.ts

@@ -1,9 +1,14 @@
 import { type Err, type Ok } from "@softure-ai/core";
-import type { IssueTokenFormState, McpIssueRefusal, McpIssueRefusalCode } from "../contract.js";
+import type { AccessTokenKind, IssueTokenFormState, McpIssueRefusal, McpIssueRefusalCode } from "../contract.js";
 /** What the gate learns about the token about to be issued. */
 export interface IssueGateInput {
     readonly userId: string;
+    /** For an API token: whether any asked scope writes. */
     readonly canWrite: boolean;
+    /** `mcp` for an assistant, `api` for the app's HTTP routes (the form's `kind` field). */
+    readonly kind: AccessTokenKind;
+    /** The scopes asked for an API token, as the form sent them; empty for an MCP token. */
+    readonly scopes: readonly string[];
 }
 /**
  * How the gate answers: `ok()` lets the token through, `err(code)` refuses with the code's copy,
@@ -15,7 +20,11 @@ export type BeforeIssueGate = (input: IssueGateInput) => IssueGateResult | Promi
 export interface IssueTokenOptions {
     readonly beforeIssue?: BeforeIssueGate;
 }
-/** Issues a token for the signed-in user, after the gate, and returns its plaintext with the setup snippets, once. */
+/**
+ * Issues a token for the signed-in user, after the gate, and returns its plaintext once: an MCP token with
+ * the setup snippets (`ok`), or, when the form sends `kind=api`, an API token with the ticked `scope:<name>`
+ * fields and the app's examples (`api-ok`).
+ */
 export declare function issueToken(_previous: IssueTokenFormState, formData: FormData, options?: IssueTokenOptions): Promise<IssueTokenFormState>;
 /** A gate's refusal with the app's own text, which the token page shows instead of the code's copy. */
 export declare function refuseIssue(code: McpIssueRefusalCode, message: string): McpIssueRefusal;

package/dist/next/issue-token.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issue-token.d.ts","sourceRoot":"","sources":["../../src/next/issue-token.ts"],"names":[],"mappings":"AAaA,OAAO,EAA6D,KAAK,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAKhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAmBhG,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,mBAAmB,CAAC,GAAG,eAAe,CAAC;AAEvF,wGAAwG;AACxG,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEpG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED,sHAAsH;AACtH,wBAAsB,UAAU,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4ClJ;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAEvF"}
+{"version":3,"file":"issue-token.d.ts","sourceRoot":"","sources":["../../src/next/issue-token.ts"],"names":[],"mappings":"AAaA,OAAO,EAA6D,KAAK,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAKhH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAoBjH,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAcD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,mBAAmB,CAAC,GAAG,eAAe,CAAC;AAEvF,wGAAwG;AACxG,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEpG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuElJ;AAQD,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAEvF"}