@agent-native/core 0.46.0 → 0.48.1

package/dist/org/schema.d.ts

@@ -19,7 +19,7 @@ export declare const organizations: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "name";
@@ -38,7 +38,7 @@ export declare const organizations: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         createdBy: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "created_by";
@@ -57,7 +57,7 @@ export declare const organizations: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "created_at";
@@ -93,7 +93,7 @@ export declare const organizations: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         a2aSecret: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "a2a_secret";
@@ -112,7 +112,7 @@ export declare const organizations: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
     };
     dialect: "sqlite";
@@ -138,7 +138,7 @@ export declare const orgMembers: import("drizzle-orm/sqlite-core").SQLiteTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         orgId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "org_id";
@@ -157,7 +157,7 @@ export declare const orgMembers: import("drizzle-orm/sqlite-core").SQLiteTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         email: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "email";
@@ -176,7 +176,7 @@ export declare const orgMembers: import("drizzle-orm/sqlite-core").SQLiteTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         role: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "role";
@@ -195,7 +195,7 @@ export declare const orgMembers: import("drizzle-orm/sqlite-core").SQLiteTableWi
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         joinedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "joined_at";
@@ -238,7 +238,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         orgId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "org_id";
@@ -257,7 +257,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         email: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "email";
@@ -276,7 +276,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         invitedBy: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "invited_by";
@@ -295,7 +295,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "created_at";
@@ -331,7 +331,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
         role: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "role";
@@ -350,7 +350,7 @@ export declare const orgInvitations: import("drizzle-orm/sqlite-core").SQLiteTab
             identity: undefined;
             generated: undefined;
         }, {}, {
-            length: number;
+            length: number | undefined;
         }>;
     };
     dialect: "sqlite";

package/dist/progress/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/progress/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAchE,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA+I7B"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/progress/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAchE,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAuJ7B"}

package/dist/progress/actions.js

@@ -17,13 +17,21 @@ export function createProgressToolEntries(getCurrentUser) {
     return {
         "manage-progress": {
             tool: {
-                description: `Manage long-running task progress visible to the user. Use this whenever a task will take more than a few seconds so the user can watch status in the runs tray.
+                description: `Track multi-step task progress visible to the user in the runs tray.
+
+Use for non-trivial work with multiple real steps (not single-action lookups). Do NOT create single-step plans. Skip for trivial tasks that finish in one tool call.
+
+**Discipline:**
+- Exactly one task in progress at a time; never batch-complete steps after the fact — update as you go.
+- Always transition pending → in_progress before completing a step.
+- If the task pivots (scope change, unexpected blocker), update the current step to reflect it before continuing.
+- End every run with "complete" (succeeded / failed / cancelled). Never leave a run open indefinitely.
 
 Actions:
-• "start" — Begin tracking a new task. Returns a runId to pass to subsequent calls. Params: title (required), step (optional initial step text), metadataJson (optional JSON string with link/thread/artifact info).
-• "update" — Report progress on a running task. Call frequently during long loops. Params: runId (required), percent (optional 0–100), step (optional current step text). Omitted fields stay unchanged.
-• "complete" — Mark a task as finished. Params: runId (required), status (required: "succeeded" | "failed" | "cancelled"), step (optional final step text). Pairs well with \`notify\` to tell the user the outcome.
-• "list" — List the user's recent runs. Use when the user asks "what is still running" or "what did you do earlier". Params: active (optional boolean, filter to in-progress only), limit (optional number, default 20, max 200).`,
+• "start" — Begin tracking. Returns a runId for subsequent calls. Params: title (required, short human description e.g. "Triage 42 emails"), step (optional initial step), metadataJson (optional JSON with link/thread/artifact info).
+• "update" — Report progress. Call after each meaningful milestone. Params: runId (required), percent (optional 0–100 when a bound is known), step (optional current step text). Omitted fields stay unchanged.
+• "complete" — Mark finished. Params: runId (required), status (required: "succeeded" | "failed" | "cancelled"), step (optional final step text). Pair with \`notify\` when the user should be alerted.
+• "list" — List recent runs. Use when the user asks "what is still running" or "what did you do earlier". Params: active (optional boolean, filter to in-progress only), limit (optional number, default 20, max 200).`,
                 parameters: {
                     type: "object",
                     properties: {

package/dist/progress/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/progress/actions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Framework-level agent tools for the progress primitive. Registered as\n * native tools so every template exposes them. Use from long agent loops\n * to communicate status to the user while work is still in-flight.\n *\n * All operations are consolidated into a single `manage-progress` tool\n * with an `action` discriminator.\n */\n\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport {\n  startRun,\n  updateRunProgress,\n  completeRun,\n  listRuns,\n} from \"./registry.js\";\n\nfunction parseLimit(value: unknown, fallback = 20): number {\n  const n = Number(value ?? fallback);\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.min(Math.floor(n), 200);\n}\n\nexport function createProgressToolEntries(\n  getCurrentUser: () => string,\n): Record<string, ActionEntry> {\n  return {\n    \"manage-progress\": {\n      tool: {\n        description: `Manage long-running task progress visible to the user. Use this whenever a task will take more than a few seconds so the user can watch status in the runs tray.\n\nActions:\n• \"start\" — Begin tracking a new task. Returns a runId to pass to subsequent calls. Params: title (required), step (optional initial step text), metadataJson (optional JSON string with link/thread/artifact info).\n• \"update\" — Report progress on a running task. Call frequently during long loops. Params: runId (required), percent (optional 0–100), step (optional current step text). Omitted fields stay unchanged.\n• \"complete\" — Mark a task as finished. Params: runId (required), status (required: \"succeeded\" | \"failed\" | \"cancelled\"), step (optional final step text). Pairs well with \\`notify\\` to tell the user the outcome.\n• \"list\" — List the user's recent runs. Use when the user asks \"what is still running\" or \"what did you do earlier\". Params: active (optional boolean, filter to in-progress only), limit (optional number, default 20, max 200).`,\n        parameters: {\n          type: \"object\" as const,\n          properties: {\n            action: {\n              type: \"string\",\n              enum: [\"start\", \"update\", \"complete\", \"list\"],\n              description:\n                'The operation to perform: \"start\" a new run, \"update\" progress, \"complete\" a run, or \"list\" recent runs.',\n            },\n            title: {\n              type: \"string\",\n              description:\n                '[start] Short human-readable title, e.g. \"Triage 128 unread emails\".',\n            },\n            step: {\n              type: \"string\",\n              description:\n                '[start/update/complete] Step description, e.g. \"Fetching inbox\" or \"Drafting reply 23/100\".',\n            },\n            metadataJson: {\n              type: \"string\",\n              description:\n                \"[start] Optional JSON metadata: link, thread id, artifact path, etc.\",\n            },\n            runId: {\n              type: \"string\",\n              description:\n                '[update/complete] The id returned by a \"start\" action.',\n            },\n            percent: {\n              type: \"number\",\n              description:\n                \"[update] Progress 0–100. Omit if the task has no known upper bound.\",\n            },\n            status: {\n              type: \"string\",\n              enum: [\"succeeded\", \"failed\", \"cancelled\"],\n              description: \"[complete] Terminal status for the run.\",\n            },\n            active: {\n              type: \"boolean\",\n              description:\n                \"[list] When true, only return runs still in progress.\",\n            },\n            limit: {\n              type: \"number\",\n              description: \"[list] Max rows (default 20, max 200).\",\n            },\n          },\n          required: [\"action\"],\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const owner = getCurrentUser();\n        const action = String(args.action ?? \"\");\n\n        switch (action) {\n          case \"start\": {\n            const title = args.title ? String(args.title) : \"\";\n            if (!title) return \"Error: title is required for the start action.\";\n            let metadata: Record<string, unknown> | undefined;\n            if (args.metadataJson) {\n              try {\n                metadata = JSON.parse(String(args.metadataJson));\n              } catch {\n                return \"Error: metadataJson must be valid JSON.\";\n              }\n            }\n            const run = await startRun({\n              owner,\n              title,\n              step: args.step ? String(args.step) : undefined,\n              metadata,\n            });\n            return `Run started. runId=${run.id}`;\n          }\n\n          case \"update\": {\n            const runId = String(args.runId ?? \"\");\n            if (!runId)\n              return \"Error: runId is required for the update action.\";\n            const percent =\n              args.percent == null ? undefined : Number(args.percent);\n            const run = await updateRunProgress(runId, owner, {\n              percent,\n              step: args.step ? String(args.step) : undefined,\n            });\n            if (!run) return `Error: run ${runId} not found.`;\n            return `Run updated (percent=${run.percent ?? \"?\"}, step=${run.step ?? \"\"}).`;\n          }\n\n          case \"complete\": {\n            const runId = String(args.runId ?? \"\");\n            const status = String(args.status ?? \"\");\n            if (!runId || !status) {\n              return \"Error: runId and status are required for the complete action.\";\n            }\n            if (![\"succeeded\", \"failed\", \"cancelled\"].includes(status)) {\n              return 'Error: status must be \"succeeded\", \"failed\", or \"cancelled\".';\n            }\n            const run = await completeRun(\n              runId,\n              owner,\n              status as \"succeeded\" | \"failed\" | \"cancelled\",\n              args.step ? { step: String(args.step) } : undefined,\n            );\n            if (!run) return `Error: run ${runId} not found.`;\n            return `Run ${run.id} completed with status=${run.status}.`;\n          }\n\n          case \"list\": {\n            const rows = await listRuns(owner, {\n              activeOnly: args.active === true || args.active === \"true\",\n              limit: parseLimit(args.limit),\n            });\n            if (rows.length === 0) {\n              return args.active ? \"No active runs.\" : \"No runs.\";\n            }\n            return rows\n              .map(\n                (r) =>\n                  `[${r.status}] ${r.title}${r.percent != null ? ` · ${r.percent}%` : \"\"}${r.step ? ` — ${r.step}` : \"\"} · ${r.startedAt}`,\n              )\n              .join(\"\\n\");\n          }\n\n          default:\n            return `Error: unknown action \"${action}\". Use one of: start, update, complete, list.`;\n        }\n      },\n    },\n  };\n}\n"]}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/progress/actions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Framework-level agent tools for the progress primitive. Registered as\n * native tools so every template exposes them. Use from long agent loops\n * to communicate status to the user while work is still in-flight.\n *\n * All operations are consolidated into a single `manage-progress` tool\n * with an `action` discriminator.\n */\n\nimport type { ActionEntry } from \"../agent/production-agent.js\";\nimport {\n  startRun,\n  updateRunProgress,\n  completeRun,\n  listRuns,\n} from \"./registry.js\";\n\nfunction parseLimit(value: unknown, fallback = 20): number {\n  const n = Number(value ?? fallback);\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.min(Math.floor(n), 200);\n}\n\nexport function createProgressToolEntries(\n  getCurrentUser: () => string,\n): Record<string, ActionEntry> {\n  return {\n    \"manage-progress\": {\n      tool: {\n        description: `Track multi-step task progress visible to the user in the runs tray.\n\nUse for non-trivial work with multiple real steps (not single-action lookups). Do NOT create single-step plans. Skip for trivial tasks that finish in one tool call.\n\n**Discipline:**\n- Exactly one task in progress at a time; never batch-complete steps after the fact — update as you go.\n- Always transition pending → in_progress before completing a step.\n- If the task pivots (scope change, unexpected blocker), update the current step to reflect it before continuing.\n- End every run with \"complete\" (succeeded / failed / cancelled). Never leave a run open indefinitely.\n\nActions:\n• \"start\" — Begin tracking. Returns a runId for subsequent calls. Params: title (required, short human description e.g. \"Triage 42 emails\"), step (optional initial step), metadataJson (optional JSON with link/thread/artifact info).\n• \"update\" — Report progress. Call after each meaningful milestone. Params: runId (required), percent (optional 0–100 when a bound is known), step (optional current step text). Omitted fields stay unchanged.\n• \"complete\" — Mark finished. Params: runId (required), status (required: \"succeeded\" | \"failed\" | \"cancelled\"), step (optional final step text). Pair with \\`notify\\` when the user should be alerted.\n• \"list\" — List recent runs. Use when the user asks \"what is still running\" or \"what did you do earlier\". Params: active (optional boolean, filter to in-progress only), limit (optional number, default 20, max 200).`,\n        parameters: {\n          type: \"object\" as const,\n          properties: {\n            action: {\n              type: \"string\",\n              enum: [\"start\", \"update\", \"complete\", \"list\"],\n              description:\n                'The operation to perform: \"start\" a new run, \"update\" progress, \"complete\" a run, or \"list\" recent runs.',\n            },\n            title: {\n              type: \"string\",\n              description:\n                '[start] Short human-readable title, e.g. \"Triage 128 unread emails\".',\n            },\n            step: {\n              type: \"string\",\n              description:\n                '[start/update/complete] Step description, e.g. \"Fetching inbox\" or \"Drafting reply 23/100\".',\n            },\n            metadataJson: {\n              type: \"string\",\n              description:\n                \"[start] Optional JSON metadata: link, thread id, artifact path, etc.\",\n            },\n            runId: {\n              type: \"string\",\n              description:\n                '[update/complete] The id returned by a \"start\" action.',\n            },\n            percent: {\n              type: \"number\",\n              description:\n                \"[update] Progress 0–100. Omit if the task has no known upper bound.\",\n            },\n            status: {\n              type: \"string\",\n              enum: [\"succeeded\", \"failed\", \"cancelled\"],\n              description: \"[complete] Terminal status for the run.\",\n            },\n            active: {\n              type: \"boolean\",\n              description:\n                \"[list] When true, only return runs still in progress.\",\n            },\n            limit: {\n              type: \"number\",\n              description: \"[list] Max rows (default 20, max 200).\",\n            },\n          },\n          required: [\"action\"],\n        },\n      },\n      run: async (args: Record<string, unknown>) => {\n        const owner = getCurrentUser();\n        const action = String(args.action ?? \"\");\n\n        switch (action) {\n          case \"start\": {\n            const title = args.title ? String(args.title) : \"\";\n            if (!title) return \"Error: title is required for the start action.\";\n            let metadata: Record<string, unknown> | undefined;\n            if (args.metadataJson) {\n              try {\n                metadata = JSON.parse(String(args.metadataJson));\n              } catch {\n                return \"Error: metadataJson must be valid JSON.\";\n              }\n            }\n            const run = await startRun({\n              owner,\n              title,\n              step: args.step ? String(args.step) : undefined,\n              metadata,\n            });\n            return `Run started. runId=${run.id}`;\n          }\n\n          case \"update\": {\n            const runId = String(args.runId ?? \"\");\n            if (!runId)\n              return \"Error: runId is required for the update action.\";\n            const percent =\n              args.percent == null ? undefined : Number(args.percent);\n            const run = await updateRunProgress(runId, owner, {\n              percent,\n              step: args.step ? String(args.step) : undefined,\n            });\n            if (!run) return `Error: run ${runId} not found.`;\n            return `Run updated (percent=${run.percent ?? \"?\"}, step=${run.step ?? \"\"}).`;\n          }\n\n          case \"complete\": {\n            const runId = String(args.runId ?? \"\");\n            const status = String(args.status ?? \"\");\n            if (!runId || !status) {\n              return \"Error: runId and status are required for the complete action.\";\n            }\n            if (![\"succeeded\", \"failed\", \"cancelled\"].includes(status)) {\n              return 'Error: status must be \"succeeded\", \"failed\", or \"cancelled\".';\n            }\n            const run = await completeRun(\n              runId,\n              owner,\n              status as \"succeeded\" | \"failed\" | \"cancelled\",\n              args.step ? { step: String(args.step) } : undefined,\n            );\n            if (!run) return `Error: run ${runId} not found.`;\n            return `Run ${run.id} completed with status=${run.status}.`;\n          }\n\n          case \"list\": {\n            const rows = await listRuns(owner, {\n              activeOnly: args.active === true || args.active === \"true\",\n              limit: parseLimit(args.limit),\n            });\n            if (rows.length === 0) {\n              return args.active ? \"No active runs.\" : \"No runs.\";\n            }\n            return rows\n              .map(\n                (r) =>\n                  `[${r.status}] ${r.title}${r.percent != null ? ` · ${r.percent}%` : \"\"}${r.step ? ` — ${r.step}` : \"\"} · ${r.startedAt}`,\n              )\n              .join(\"\\n\");\n          }\n\n          default:\n            return `Error: unknown action \"${action}\". Use one of: start, update, complete, list.`;\n        }\n      },\n    },\n  };\n}\n"]}

package/dist/provider-api/actions/delete-staged-dataset.d.ts

@@ -0,0 +1,9 @@
+declare const _default: import("../../action.js").ActionDefinition<{
+    datasetId: string;
+    appId: string;
+}, {
+    deleted: boolean;
+    datasetId: string;
+}>;
+export default _default;
+//# sourceMappingURL=delete-staged-dataset.d.ts.map

package/dist/provider-api/actions/delete-staged-dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-staged-dataset.d.ts","sourceRoot":"","sources":["../../../src/provider-api/actions/delete-staged-dataset.ts"],"names":[],"mappings":";;;;;;;AAQA,wBAkCG"}

package/dist/provider-api/actions/delete-staged-dataset.js

@@ -0,0 +1,35 @@
+/**
+ * delete-staged-dataset — remove a staged dataset and free its storage.
+ */
+import { defineAction } from "../../action.js";
+import { z } from "zod";
+import { getCredentialContext } from "../../server/request-context.js";
+import { deleteStagedDataset } from "../staged-datasets-store.js";
+export default defineAction({
+    description: "Delete a staged dataset by id, freeing its scratch storage. " +
+        "Use after analysis is complete or before re-staging a large dataset under the same name. " +
+        "Only the owner who staged the dataset can delete it.",
+    schema: z.object({
+        datasetId: z
+            .string()
+            .min(1)
+            .describe("Dataset id to delete (from list-staged-datasets or provider-api-request stageAs result)."),
+        appId: z.string().min(1).describe("App id that owns the dataset."),
+    }),
+    http: false,
+    run: async (args) => {
+        const ctx = getCredentialContext();
+        if (!ctx)
+            throw new Error("No authenticated context for delete-staged-dataset.");
+        const deleted = await deleteStagedDataset({
+            id: args.datasetId,
+            appId: args.appId,
+            ownerEmail: ctx.userEmail,
+        });
+        if (!deleted) {
+            throw new Error(`Dataset ${args.datasetId} not found (or belongs to a different owner/app).`);
+        }
+        return { deleted: true, datasetId: args.datasetId };
+    },
+});
+//# sourceMappingURL=delete-staged-dataset.js.map

package/dist/provider-api/actions/delete-staged-dataset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-staged-dataset.js","sourceRoot":"","sources":["../../../src/provider-api/actions/delete-staged-dataset.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,8DAA8D;QAC9D,2FAA2F;QAC3F,sDAAsD;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,0FAA0F,CAC3F;QACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;KACnE,CAAC;IACF,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG;YACN,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC;YACxC,EAAE,EAAE,IAAI,CAAC,SAAS;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,GAAG,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,SAAS,mDAAmD,CAC7E,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;CACF,CAAC,CAAC","sourcesContent":["/**\n * delete-staged-dataset — remove a staged dataset and free its storage.\n */\nimport { defineAction } from \"../../action.js\";\nimport { z } from \"zod\";\nimport { getCredentialContext } from \"../../server/request-context.js\";\nimport { deleteStagedDataset } from \"../staged-datasets-store.js\";\n\nexport default defineAction({\n  description:\n    \"Delete a staged dataset by id, freeing its scratch storage. \" +\n    \"Use after analysis is complete or before re-staging a large dataset under the same name. \" +\n    \"Only the owner who staged the dataset can delete it.\",\n  schema: z.object({\n    datasetId: z\n      .string()\n      .min(1)\n      .describe(\n        \"Dataset id to delete (from list-staged-datasets or provider-api-request stageAs result).\",\n      ),\n    appId: z.string().min(1).describe(\"App id that owns the dataset.\"),\n  }),\n  http: false,\n  run: async (args) => {\n    const ctx = getCredentialContext();\n    if (!ctx)\n      throw new Error(\"No authenticated context for delete-staged-dataset.\");\n\n    const deleted = await deleteStagedDataset({\n      id: args.datasetId,\n      appId: args.appId,\n      ownerEmail: ctx.userEmail,\n    });\n\n    if (!deleted) {\n      throw new Error(\n        `Dataset ${args.datasetId} not found (or belongs to a different owner/app).`,\n      );\n    }\n\n    return { deleted: true, datasetId: args.datasetId };\n  },\n});\n"]}

package/dist/provider-api/actions/list-staged-datasets.d.ts

@@ -0,0 +1,15 @@
+declare const _default: import("../../action.js").ActionDefinition<{
+    appId: string;
+}, {
+    datasets: {
+        id: string;
+        name: string;
+        rowCount: number;
+        columns: string[];
+        byteSize: number;
+        updatedAt: string;
+    }[];
+    total: number;
+}>;
+export default _default;
+//# sourceMappingURL=list-staged-datasets.d.ts.map

package/dist/provider-api/actions/list-staged-datasets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-staged-datasets.d.ts","sourceRoot":"","sources":["../../../src/provider-api/actions/list-staged-datasets.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAQA,wBAqCG"}

package/dist/provider-api/actions/list-staged-datasets.js

@@ -0,0 +1,41 @@
+/**
+ * list-staged-datasets — enumerate scratch datasets staged by the current user.
+ */
+import { defineAction } from "../../action.js";
+import { z } from "zod";
+import { getCredentialContext } from "../../server/request-context.js";
+import { listStagedDatasets } from "../staged-datasets-store.js";
+export default defineAction({
+    description: "List staged datasets stored by provider-api-request (stageAs) for the current user and app. " +
+        "Returns dataset ids, names, row counts, columns, and sizes. " +
+        "Use these ids with query-staged-dataset to run aggregations, or with delete-staged-dataset to free space.",
+    schema: z.object({
+        appId: z
+            .string()
+            .min(1)
+            .describe("App id that owns the datasets (must match the staging context)."),
+    }),
+    http: { method: "GET" },
+    readOnly: true,
+    run: async (args) => {
+        const ctx = getCredentialContext();
+        if (!ctx)
+            throw new Error("No authenticated context for list-staged-datasets.");
+        const datasets = await listStagedDatasets({
+            appId: args.appId,
+            ownerEmail: ctx.userEmail,
+        });
+        return {
+            datasets: datasets.map((d) => ({
+                id: d.id,
+                name: d.name,
+                rowCount: d.rowCount,
+                columns: d.columns,
+                byteSize: d.byteSize,
+                updatedAt: new Date(d.updatedAt).toISOString(),
+            })),
+            total: datasets.length,
+        };
+    },
+});
+//# sourceMappingURL=list-staged-datasets.js.map

package/dist/provider-api/actions/list-staged-datasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-staged-datasets.js","sourceRoot":"","sources":["../../../src/provider-api/actions/list-staged-datasets.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,8FAA8F;QAC9F,8DAA8D;QAC9D,2GAA2G;IAC7G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,iEAAiE,CAClE;KACJ,CAAC;IACF,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG;YACN,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAExE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;YACxC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,GAAG,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;aAC/C,CAAC,CAAC;YACH,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["/**\n * list-staged-datasets — enumerate scratch datasets staged by the current user.\n */\nimport { defineAction } from \"../../action.js\";\nimport { z } from \"zod\";\nimport { getCredentialContext } from \"../../server/request-context.js\";\nimport { listStagedDatasets } from \"../staged-datasets-store.js\";\n\nexport default defineAction({\n  description:\n    \"List staged datasets stored by provider-api-request (stageAs) for the current user and app. \" +\n    \"Returns dataset ids, names, row counts, columns, and sizes. \" +\n    \"Use these ids with query-staged-dataset to run aggregations, or with delete-staged-dataset to free space.\",\n  schema: z.object({\n    appId: z\n      .string()\n      .min(1)\n      .describe(\n        \"App id that owns the datasets (must match the staging context).\",\n      ),\n  }),\n  http: { method: \"GET\" },\n  readOnly: true,\n  run: async (args) => {\n    const ctx = getCredentialContext();\n    if (!ctx)\n      throw new Error(\"No authenticated context for list-staged-datasets.\");\n\n    const datasets = await listStagedDatasets({\n      appId: args.appId,\n      ownerEmail: ctx.userEmail,\n    });\n\n    return {\n      datasets: datasets.map((d) => ({\n        id: d.id,\n        name: d.name,\n        rowCount: d.rowCount,\n        columns: d.columns,\n        byteSize: d.byteSize,\n        updatedAt: new Date(d.updatedAt).toISOString(),\n      })),\n      total: datasets.length,\n    };\n  },\n});\n"]}

package/dist/provider-api/actions/query-staged-dataset.d.ts

@@ -0,0 +1,29 @@
+declare const _default: import("../../action.js").ActionDefinition<{
+    datasetId: string;
+    appId: string;
+    where?: {
+        column: string;
+        op: "equals" | "lt" | "lte" | "gt" | "gte" | "not_equals" | "contains" | "not_contains" | "exists" | "not_exists";
+        value?: unknown;
+    }[] | undefined;
+    groupBy?: string[] | undefined;
+    aggregate?: {
+        column: string;
+        op: "max" | "min" | "count" | "sum" | "avg" | "count_distinct";
+        as?: string | undefined;
+    }[] | undefined;
+    select?: string[] | undefined;
+    orderBy?: string | undefined;
+    orderDir?: "desc" | "asc" | undefined;
+    limit?: unknown;
+}, {
+    dataset: {
+        id: string;
+        name: string;
+        totalRows: number;
+    };
+    rowCount: number;
+    rows: Record<string, unknown>[];
+}>;
+export default _default;
+//# sourceMappingURL=query-staged-dataset.d.ts.map

package/dist/provider-api/actions/query-staged-dataset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-staged-dataset.d.ts","sourceRoot":"","sources":["../../../src/provider-api/actions/query-staged-dataset.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,wBAgGG"}

package/dist/provider-api/actions/query-staged-dataset.js

@@ -0,0 +1,116 @@
+/**
+ * query-staged-dataset — run an in-memory aggregation over a staged dataset.
+ *
+ * All aggregation is done in TypeScript (no SQL JSON functions) so the action
+ * works identically on Postgres and SQLite.
+ */
+import { defineAction } from "../../action.js";
+import { z } from "zod";
+import { getCredentialContext } from "../../server/request-context.js";
+import { getStagedDatasetRows, getStagedDatasetMeta, } from "../staged-datasets-store.js";
+import { runAggregateQuery } from "../staged-datasets-aggregate.js";
+const WhereSchema = z.object({
+    column: z.string().min(1),
+    op: z.enum([
+        "equals",
+        "not_equals",
+        "contains",
+        "not_contains",
+        "gt",
+        "gte",
+        "lt",
+        "lte",
+        "exists",
+        "not_exists",
+    ]),
+    value: z.unknown().optional(),
+});
+const AggregateFieldSchema = z.object({
+    column: z.string().min(1).describe("Column to aggregate."),
+    op: z
+        .enum(["sum", "avg", "count", "min", "max", "count_distinct"])
+        .describe("Aggregation function."),
+    as: z
+        .string()
+        .optional()
+        .describe("Output column name. Default: {op}_{column}."),
+});
+export default defineAction({
+    description: "Run a filter/aggregate/project query over a staged dataset stored by provider-api-request (stageAs). " +
+        "All aggregation is done in-process — no SQL dialect differences. " +
+        "Use this after staging to compute counts, sums, averages, min/max, or to filter/project rows without re-fetching the provider API.",
+    schema: z.object({
+        datasetId: z
+            .string()
+            .min(1)
+            .describe("Dataset id returned by provider-api-request when stageAs was set, or from list-staged-datasets."),
+        appId: z
+            .string()
+            .min(1)
+            .describe("App id that owns the dataset (must match the staging context)."),
+        where: z
+            .array(WhereSchema)
+            .optional()
+            .describe("Optional row-level filters. All clauses must match (AND). " +
+            "Ops: equals, not_equals, contains, not_contains, gt, gte, lt, lte, exists, not_exists."),
+        groupBy: z
+            .array(z.string().min(1))
+            .optional()
+            .describe("Column(s) to group by. Omit for a single aggregate over all rows."),
+        aggregate: z
+            .array(AggregateFieldSchema)
+            .optional()
+            .describe("Aggregation fields. When set, non-group columns are aggregated. " +
+            "When omitted, rows are returned as-is (after where + select)."),
+        select: z
+            .array(z.string().min(1))
+            .optional()
+            .describe("Column projection when aggregate is empty. Omit to return all columns."),
+        orderBy: z.string().optional().describe("Sort output by this column."),
+        orderDir: z
+            .enum(["asc", "desc"])
+            .optional()
+            .describe("Sort direction (default asc)."),
+        limit: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(10_000)
+            .optional()
+            .describe("Maximum rows to return (default all, max 10000)."),
+    }),
+    http: false,
+    run: async (args) => {
+        const ctx = getCredentialContext();
+        if (!ctx)
+            throw new Error("No authenticated context for query-staged-dataset.");
+        const meta = await getStagedDatasetMeta({
+            id: args.datasetId,
+            appId: args.appId,
+            ownerEmail: ctx.userEmail,
+        });
+        if (!meta) {
+            throw new Error(`Dataset ${args.datasetId} not found (or belongs to a different owner/app).`);
+        }
+        const rows = await getStagedDatasetRows({
+            id: args.datasetId,
+            appId: args.appId,
+            ownerEmail: ctx.userEmail,
+        });
+        const result = runAggregateQuery(rows, {
+            where: args.where,
+            groupBy: args.groupBy,
+            aggregate: args.aggregate,
+            select: args.select,
+            orderBy: args.orderBy,
+            orderDir: args.orderDir,
+            limit: args.limit,
+        });
+        return {
+            dataset: { id: meta.id, name: meta.name, totalRows: meta.rowCount },
+            rowCount: result.length,
+            rows: result,
+        };
+    },
+});
+//# sourceMappingURL=query-staged-dataset.js.map

package/dist/provider-api/actions/query-staged-dataset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-staged-dataset.js","sourceRoot":"","sources":["../../../src/provider-api/actions/query-staged-dataset.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * query-staged-dataset — run an in-memory aggregation over a staged dataset.\n *\n * All aggregation is done in TypeScript (no SQL JSON functions) so the action\n * works identically on Postgres and SQLite.\n */\nimport { defineAction } from \"../../action.js\";\nimport { z } from \"zod\";\nimport { getCredentialContext } from \"../../server/request-context.js\";\nimport {\n  getStagedDatasetRows,\n  getStagedDatasetMeta,\n} from \"../staged-datasets-store.js\";\nimport { runAggregateQuery } from \"../staged-datasets-aggregate.js\";\n\nconst WhereSchema = z.object({\n  column: z.string().min(1),\n  op: z.enum([\n    \"equals\",\n    \"not_equals\",\n    \"contains\",\n    \"not_contains\",\n    \"gt\",\n    \"gte\",\n    \"lt\",\n    \"lte\",\n    \"exists\",\n    \"not_exists\",\n  ]),\n  value: z.unknown().optional(),\n});\n\nconst AggregateFieldSchema = z.object({\n  column: z.string().min(1).describe(\"Column to aggregate.\"),\n  op: z\n    .enum([\"sum\", \"avg\", \"count\", \"min\", \"max\", \"count_distinct\"])\n    .describe(\"Aggregation function.\"),\n  as: z\n    .string()\n    .optional()\n    .describe(\"Output column name. Default: {op}_{column}.\"),\n});\n\nexport default defineAction({\n  description:\n    \"Run a filter/aggregate/project query over a staged dataset stored by provider-api-request (stageAs). \" +\n    \"All aggregation is done in-process — no SQL dialect differences. \" +\n    \"Use this after staging to compute counts, sums, averages, min/max, or to filter/project rows without re-fetching the provider API.\",\n  schema: z.object({\n    datasetId: z\n      .string()\n      .min(1)\n      .describe(\n        \"Dataset id returned by provider-api-request when stageAs was set, or from list-staged-datasets.\",\n      ),\n    appId: z\n      .string()\n      .min(1)\n      .describe(\n        \"App id that owns the dataset (must match the staging context).\",\n      ),\n    where: z\n      .array(WhereSchema)\n      .optional()\n      .describe(\n        \"Optional row-level filters. All clauses must match (AND). \" +\n          \"Ops: equals, not_equals, contains, not_contains, gt, gte, lt, lte, exists, not_exists.\",\n      ),\n    groupBy: z\n      .array(z.string().min(1))\n      .optional()\n      .describe(\n        \"Column(s) to group by. Omit for a single aggregate over all rows.\",\n      ),\n    aggregate: z\n      .array(AggregateFieldSchema)\n      .optional()\n      .describe(\n        \"Aggregation fields. When set, non-group columns are aggregated. \" +\n          \"When omitted, rows are returned as-is (after where + select).\",\n      ),\n    select: z\n      .array(z.string().min(1))\n      .optional()\n      .describe(\n        \"Column projection when aggregate is empty. Omit to return all columns.\",\n      ),\n    orderBy: z.string().optional().describe(\"Sort output by this column.\"),\n    orderDir: z\n      .enum([\"asc\", \"desc\"])\n      .optional()\n      .describe(\"Sort direction (default asc).\"),\n    limit: z.coerce\n      .number()\n      .int()\n      .min(1)\n      .max(10_000)\n      .optional()\n      .describe(\"Maximum rows to return (default all, max 10000).\"),\n  }),\n  http: false,\n  run: async (args) => {\n    const ctx = getCredentialContext();\n    if (!ctx)\n      throw new Error(\"No authenticated context for query-staged-dataset.\");\n\n    const meta = await getStagedDatasetMeta({\n      id: args.datasetId,\n      appId: args.appId,\n      ownerEmail: ctx.userEmail,\n    });\n    if (!meta) {\n      throw new Error(\n        `Dataset ${args.datasetId} not found (or belongs to a different owner/app).`,\n      );\n    }\n\n    const rows = await getStagedDatasetRows({\n      id: args.datasetId,\n      appId: args.appId,\n      ownerEmail: ctx.userEmail,\n    });\n\n    const result = runAggregateQuery(rows, {\n      where: args.where,\n      groupBy: args.groupBy,\n      aggregate: args.aggregate,\n      select: args.select,\n      orderBy: args.orderBy,\n      orderDir: args.orderDir,\n      limit: args.limit,\n    });\n\n    return {\n      dataset: { id: meta.id, name: meta.name, totalRows: meta.rowCount },\n      rowCount: result.length,\n      rows: result,\n    };\n  },\n});\n"]}

package/dist/provider-api/custom-registry.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Custom provider registry — runtime storage and resolution.
+ *
+ * Lets apps register arbitrary HTTP API providers at runtime without touching
+ * the static PROVIDER_CONFIGS list. Provider rows live in the
+ * `custom_api_providers` SQL table (created on first use). Credentials
+ * referenced in the provider row continue to live in the existing secrets /
+ * credentials store — this table stores only key NAMES, never values.
+ *
+ * Scoping mirrors the `app_secrets` table: each row is scoped to a user
+ * (by email) or an organisation (by orgId).
+ *
+ * Supported auth kinds for custom providers:
+ *   - bearer         → Authorization: Bearer <credential>
+ *   - basic          → Authorization: Basic base64(user:pass)
+ *   - api-key-header → custom header: <credential>
+ *
+ * google-service-account and oauth-bearer are intentionally unsupported for
+ * custom providers because they require additional out-of-band setup that
+ * cannot be expressed in the simple header/key model.
+ */
+export type CustomProviderScope = "user" | "org";
+export type CustomProviderAuthKind = {
+    type: "bearer";
+    credentialKey: string;
+} | {
+    type: "basic";
+    usernameKey: string;
+    passwordKey: string;
+} | {
+    type: "api-key-header";
+    credentialKey: string;
+    headerName: string;
+} | {
+    type: "none";
+};
+export interface CustomProviderConfig {
+    id: string;
+    scope: CustomProviderScope;
+    scopeId: string;
+    label: string;
+    baseUrl: string;
+    auth: CustomProviderAuthKind;
+    docsUrls: string[];
+    allowedHostSuffixes: string[];
+    defaultHeaders: Record<string, string>;
+    notes: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface UpsertCustomProviderArgs {
+    scope: CustomProviderScope;
+    scopeId: string;
+    /** Slug used as the provider id (e.g. "my-api"). Must be lowercase, letters/digits/hyphens. */
+    id: string;
+    label: string;
+    baseUrl: string;
+    auth: CustomProviderAuthKind;
+    docsUrls?: string[];
+    allowedHostSuffixes?: string[];
+    defaultHeaders?: Record<string, string>;
+    notes?: string;
+}
+/**
+ * Validate and normalise a custom provider base URL. Throws when the URL is
+ * invalid, uses a non-http(s) scheme, or resolves to a private/internal host.
+ */
+export declare function validateCustomBaseUrl(rawUrl: string): Promise<URL>;
+/**
+ * Validate user-supplied allowed host suffixes. Each suffix must look like a
+ * real registrable domain (at least two labels) and must not be a bare TLD or
+ * shared-hosting public suffix where unrelated parties control subdomains.
+ */
+export declare function validateAllowedHostSuffixes(suffixes: string[]): string[];
+/**
+ * Create or update a custom provider. Validates the base URL against SSRF
+ * rules at write time. Returns the provider id.
+ */
+export declare function upsertCustomProvider(args: UpsertCustomProviderArgs): Promise<string>;
+/**
+ * Delete a custom provider. Returns true if a row was deleted.
+ */
+export declare function deleteCustomProvider(scope: CustomProviderScope, scopeId: string, id: string): Promise<boolean>;
+/**
+ * List all custom providers visible to a given (scope, scopeId) pair.
+ */
+export declare function listCustomProviders(scope: CustomProviderScope, scopeId: string): Promise<CustomProviderConfig[]>;
+/**
+ * Look up one custom provider. Returns null when not found.
+ */
+export declare function getCustomProvider(scope: CustomProviderScope, scopeId: string, id: string): Promise<CustomProviderConfig | null>;
+//# sourceMappingURL=custom-registry.d.ts.map

package/dist/provider-api/custom-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-registry.d.ts","sourceRoot":"","sources":["../../src/provider-api/custom-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AASH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,CAAC;AAEjD,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+CD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAkBxE;AAmFD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAkBxE;AAMD;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAQjC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAStC"}