@dbos-inc/dbos-enterprise 5.3.1-preview → 5.4.1-preview

package/dist/src/export.js

@@ -0,0 +1,190 @@
+"use strict";
+// Workflow export and import: a workflow and its children, with every row they own, as one portable value.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importWorkflow = exports.exportWorkflow = void 0;
+const error_1 = require("@dbos-inc/dbos-sdk/internal/error");
+async function exportWorkflow(sysdb, workflowID, exportChildren = false) {
+    const workflowIDs = [workflowID];
+    if (exportChildren) {
+        workflowIDs.push(...(await sysdb.getWorkflowChildren(workflowID)));
+    }
+    const exportedWorkflows = [];
+    const client = await sysdb.connect();
+    try {
+        for (const wfID of workflowIDs) {
+            // Export workflow_status
+            const statusResult = await client.query(
+            // creator_xid and owner_xid are intentionally omitted: they are transient
+            // tokens, not logical workflow state, and a source database's
+            // tokens are meaningless in the target.
+            `SELECT
+          ws.workflow_uuid, ws.status, ws.name, ws.authenticated_user, ws.assumed_role,
+          ws.authenticated_roles,
+          COALESCE(wo.output, ws.output) AS output, COALESCE(wo.error, ws.error) AS error,
+          ws.executor_id,
+          ws.created_at, ws.updated_at, ws.application_version, ws.application_id,
+          ws.class_name, ws.config_name, ws.recovery_attempts, ws.queue_name,
+          ws.workflow_timeout_ms, ws.workflow_deadline_epoch_ms, ws.started_at_epoch_ms,
+          ws.deduplication_id, COALESCE(wi.inputs, ws.inputs) AS inputs,
+          ws.priority, ws.queue_partition_key, ws.forked_from,
+          ws.parent_workflow_id, ws.serialization, ws.delay_until_epoch_ms,
+          ws.was_forked_from, ws.rate_limited, ws.completed_at, ws.attributes, ws.schedule_name,
+          ws.debounce_deadline_epoch_ms, ws.is_debounced, ws.application_name
+        FROM "${sysdb.schemaName}".workflow_status ws
+        LEFT JOIN "${sysdb.schemaName}".workflow_input wi ON wi.workflow_uuid = ws.workflow_uuid
+        LEFT JOIN "${sysdb.schemaName}".workflow_output wo ON wo.workflow_uuid = ws.workflow_uuid
+        WHERE ws.workflow_uuid = $1`, [wfID]);
+            if (statusResult.rows.length === 0) {
+                throw new error_1.DBOSNonExistentWorkflowError(`Workflow ${wfID} does not exist`);
+            }
+            const workflowStatus = statusResult.rows[0];
+            // Export operation_outputs
+            const outputsResult = await client.query(`SELECT
+          workflow_uuid, function_id, function_name, output, error,
+          child_workflow_id, started_at_epoch_ms, completed_at_epoch_ms,
+          serialization, application_name
+        FROM "${sysdb.schemaName}".operation_outputs
+        WHERE workflow_uuid = $1`, [wfID]);
+            // Export workflow_events
+            const eventsResult = await client.query(`SELECT workflow_uuid, key, value, serialization
+        FROM "${sysdb.schemaName}".workflow_events
+        WHERE workflow_uuid = $1`, [wfID]);
+            // Export workflow_events_history
+            const historyResult = await client.query(`SELECT workflow_uuid, function_id, key, value, serialization
+        FROM "${sysdb.schemaName}".workflow_events_history
+        WHERE workflow_uuid = $1`, [wfID]);
+            // Export streams
+            const streamsResult = await client.query(`SELECT workflow_uuid, key, value, "offset", function_id, serialization
+        FROM "${sysdb.schemaName}".streams
+        WHERE workflow_uuid = $1`, [wfID]);
+            exportedWorkflows.push({
+                workflow_status: workflowStatus,
+                operation_outputs: outputsResult.rows,
+                workflow_events: eventsResult.rows,
+                workflow_events_history: historyResult.rows,
+                streams: streamsResult.rows,
+            });
+        }
+    }
+    finally {
+        client.release();
+    }
+    return exportedWorkflows;
+}
+exports.exportWorkflow = exportWorkflow;
+async function importWorkflow(sysdb, workflows) {
+    const client = await sysdb.connect();
+    try {
+        await client.query('BEGIN');
+        for (const workflow of workflows) {
+            const status = workflow.workflow_status;
+            // Import workflow_status
+            await client.query(`INSERT INTO "${sysdb.schemaName}".workflow_status (
+          workflow_uuid, status, name, authenticated_user, assumed_role,
+          authenticated_roles, output, error, executor_id,
+          created_at, updated_at, application_version, application_id,
+          class_name, config_name, recovery_attempts, queue_name,
+          workflow_timeout_ms, workflow_deadline_epoch_ms, started_at_epoch_ms,
+          deduplication_id, inputs, priority, queue_partition_key, forked_from,
+          parent_workflow_id, serialization, delay_until_epoch_ms,
+          was_forked_from, rate_limited, completed_at, attributes, schedule_name,
+          debounce_deadline_epoch_ms, is_debounced, application_name
+        ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24, $25, $26, $27, $28, $29, $30, $31, $32, $33, $34, $35, $36)`, [
+                status.workflow_uuid,
+                status.status,
+                status.name,
+                status.authenticated_user,
+                status.assumed_role,
+                status.authenticated_roles,
+                // Legacy columns: the payloads live in their own tables.
+                null,
+                null,
+                status.executor_id,
+                status.created_at,
+                status.updated_at,
+                status.application_version,
+                status.application_id,
+                status.class_name,
+                status.config_name,
+                status.recovery_attempts,
+                status.queue_name,
+                status.workflow_timeout_ms,
+                status.workflow_deadline_epoch_ms,
+                status.started_at_epoch_ms,
+                status.deduplication_id,
+                null,
+                status.priority,
+                status.queue_partition_key,
+                status.forked_from,
+                status.parent_workflow_id,
+                status.serialization,
+                status.delay_until_epoch_ms ?? null,
+                // NOT NULL columns: fall back to FALSE for payloads exported before
+                // these fields were included.
+                status.was_forked_from ?? false,
+                status.rate_limited ?? false,
+                status.completed_at ?? null,
+                status.attributes ? JSON.stringify(status.attributes) : null,
+                status.schedule_name ?? null,
+                status.debounce_deadline_epoch_ms ?? null,
+                status.is_debounced ?? false,
+                status.application_name ?? null,
+            ]);
+            // Retention starts at import: the original timestamps are long past the cutoff
+            // and would be collected immediately.
+            await client.query(`INSERT INTO "${sysdb.schemaName}".workflow_input (workflow_uuid, inputs, retention_timestamp)
+         VALUES ($1, $2, (EXTRACT(EPOCH FROM now()) * 1000)::bigint)`, [status.workflow_uuid, status.inputs]);
+            if (status.output !== null || status.error !== null) {
+                await client.query(`INSERT INTO "${sysdb.schemaName}".workflow_output (workflow_uuid, output, error, retention_timestamp)
+           VALUES ($1, $2, $3, (EXTRACT(EPOCH FROM now()) * 1000)::bigint)`, [status.workflow_uuid, status.output, status.error]);
+            }
+            // Import operation_outputs
+            for (const output of workflow.operation_outputs) {
+                await client.query(`INSERT INTO "${sysdb.schemaName}".operation_outputs (
+            workflow_uuid, function_id, function_name, output, error,
+            child_workflow_id, started_at_epoch_ms, completed_at_epoch_ms,
+            serialization, application_name, retention_timestamp
+          ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, (EXTRACT(EPOCH FROM now()) * 1000)::bigint)`, [
+                    output.workflow_uuid,
+                    output.function_id,
+                    output.function_name,
+                    output.output,
+                    output.error,
+                    output.child_workflow_id,
+                    output.started_at_epoch_ms,
+                    output.completed_at_epoch_ms,
+                    output.serialization,
+                    output.application_name ?? null,
+                ]);
+            }
+            // Import workflow_events
+            for (const event of workflow.workflow_events) {
+                await client.query(`INSERT INTO "${sysdb.schemaName}".workflow_events (
+            workflow_uuid, key, value, serialization
+          ) VALUES ($1, $2, $3, $4)`, [event.workflow_uuid, event.key, event.value, event.serialization]);
+            }
+            // Import workflow_events_history
+            for (const history of workflow.workflow_events_history) {
+                await client.query(`INSERT INTO "${sysdb.schemaName}".workflow_events_history (
+            workflow_uuid, function_id, key, value, serialization
+          ) VALUES ($1, $2, $3, $4, $5)`, [history.workflow_uuid, history.function_id, history.key, history.value, history.serialization]);
+            }
+            // Import streams
+            for (const stream of workflow.streams) {
+                await client.query(`INSERT INTO "${sysdb.schemaName}".streams (
+            workflow_uuid, key, value, "offset", function_id, serialization
+          ) VALUES ($1, $2, $3, $4, $5, $6)`, [stream.workflow_uuid, stream.key, stream.value, stream.offset, stream.function_id, stream.serialization]);
+            }
+        }
+        await client.query('COMMIT');
+    }
+    catch (error) {
+        await client.query('ROLLBACK');
+        throw error;
+    }
+    finally {
+        client.release();
+    }
+}
+exports.importWorkflow = importWorkflow;
+//# sourceMappingURL=export.js.map

package/dist/src/export.js.map

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

package/dist/src/fork.d.ts

@@ -0,0 +1,11 @@
+import type { SystemDatabase } from '@dbos-inc/dbos-sdk/internal/system_database';
+export declare function forkFromFailure(sysdb: SystemDatabase, workflowIDs: string[], options?: {
+    applicationVersion?: string;
+    queueName?: string;
+    queuePartitionKey?: string;
+    fromLastFailure?: boolean;
+    fromLastStep?: boolean;
+    fromStep?: number;
+    fromStepName?: string;
+}): Promise<string[]>;
+//# sourceMappingURL=fork.d.ts.map

package/dist/src/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/fork.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAElF,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE;IACP,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CAClB,GACL,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDnB"}

package/dist/src/fork.js

@@ -0,0 +1,63 @@
+"use strict";
+// Fork workflows at a chosen step, or just before their last failure.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forkFromFailure = void 0;
+const node_crypto_1 = require("node:crypto");
+async function forkFromFailure(sysdb, workflowIDs, options = {}) {
+    const modes = [
+        options.fromLastFailure ?? false,
+        options.fromLastStep ?? false,
+        options.fromStep !== undefined,
+        options.fromStepName !== undefined,
+    ].filter(Boolean).length;
+    if (modes !== 1) {
+        throw new Error('Exactly one of fromLastFailure, fromLastStep, fromStep, or fromStepName must be specified');
+    }
+    let startSteps;
+    if (options.fromStep !== undefined) {
+        startSteps = Array(workflowIDs.length).fill(options.fromStep);
+    }
+    else {
+        let query;
+        const params = [workflowIDs];
+        if (options.fromLastFailure) {
+            query = `SELECT workflow_uuid,
+                      COALESCE(
+                        MAX(function_id) FILTER (WHERE error IS NOT NULL),
+                        MAX(function_id)
+                      ) AS start_step
+               FROM "${sysdb.schemaName}".operation_outputs
+               WHERE workflow_uuid = ANY($1)
+               GROUP BY workflow_uuid`;
+        }
+        else if (options.fromLastStep) {
+            query = `SELECT workflow_uuid, MAX(function_id) AS start_step
+               FROM "${sysdb.schemaName}".operation_outputs
+               WHERE workflow_uuid = ANY($1)
+               GROUP BY workflow_uuid`;
+        }
+        else {
+            // fromStepName
+            query = `SELECT workflow_uuid, MAX(function_id) AS start_step
+               FROM "${sysdb.schemaName}".operation_outputs
+               WHERE workflow_uuid = ANY($1) AND function_name = $2
+               GROUP BY workflow_uuid`;
+            params.push(options.fromStepName);
+        }
+        const result = await sysdb.pool.query(query, params);
+        const startStepByID = new Map(result.rows.map((r) => [r.workflow_uuid, Number(r.start_step)]));
+        if (options.fromStepName !== undefined) {
+            for (const wid of workflowIDs) {
+                if (!startStepByID.has(wid)) {
+                    throw new Error(`Workflow ${wid} has no step named '${options.fromStepName}'`);
+                }
+            }
+        }
+        // A workflow with no recorded steps has nothing to resume from, so restart it from the beginning.
+        startSteps = workflowIDs.map((wid) => startStepByID.get(wid) ?? 0);
+    }
+    const forkedIDs = workflowIDs.map(() => (0, node_crypto_1.randomUUID)());
+    return sysdb.bulkForkWorkflows(workflowIDs, forkedIDs, startSteps, options);
+}
+exports.forkFromFailure = forkFromFailure;
+//# sourceMappingURL=fork.js.map

package/dist/src/fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.js","sourceRoot":"","sources":["../../src/fork.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE,6CAAyC;AAGlC,KAAK,UAAU,eAAe,CACnC,KAAqB,EACrB,WAAqB,EACrB,UAQI,EAAE;IAEN,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,eAAe,IAAI,KAAK;QAChC,OAAO,CAAC,YAAY,IAAI,KAAK;QAC7B,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC9B,OAAO,CAAC,YAAY,KAAK,SAAS;KACnC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,2FAA2F,CAAC,CAAC;IAC/G,CAAC;IAED,IAAI,UAAoB,CAAC;IAEzB,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnC,UAAU,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAa,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,IAAI,KAAa,CAAC;QAClB,MAAM,MAAM,GAAc,CAAC,WAAW,CAAC,CAAC;QAExC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5B,KAAK,GAAG;;;;;uBAKS,KAAK,CAAC,UAAU;;sCAED,CAAC;QACnC,CAAC;aAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAChC,KAAK,GAAG;uBACS,KAAK,CAAC,UAAU;;sCAED,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,eAAe;YACf,KAAK,GAAG;uBACS,KAAK,CAAC,UAAU;;sCAED,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAgD,KAAK,EAAE,MAAM,CAAC,CAAC;QACpG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACvC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;gBAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,YAAY,GAAG,uBAAuB,OAAO,CAAC,YAAY,GAAG,CAAC,CAAC;gBACjF,CAAC;YACH,CAAC;QACH,CAAC;QACD,kGAAkG;QAClG,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAA,wBAAU,GAAE,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,iBAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AArED,0CAqEC"}

package/dist/src/index.d.ts

@@ -1,2 +1,3 @@
-export { describeExecutor, ExecutorInfo } from './scratch';
+export { AutoUpgradePass } from './auto_upgrade';
+export { ConductorWebsocket } from './conductor/conductor';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.describeExecutor = void 0;
-var scratch_1 = require("./scratch");
-Object.defineProperty(exports, "describeExecutor", { enumerable: true, get: function () { return scratch_1.describeExecutor; } });
+exports.ConductorWebsocket = exports.AutoUpgradePass = void 0;
+var auto_upgrade_1 = require("./auto_upgrade");
+Object.defineProperty(exports, "AutoUpgradePass", { enumerable: true, get: function () { return auto_upgrade_1.AutoUpgradePass; } });
+var conductor_1 = require("./conductor/conductor");
+Object.defineProperty(exports, "ConductorWebsocket", { enumerable: true, get: function () { return conductor_1.ConductorWebsocket; } });
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAA2D;AAAlD,2GAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,+CAAiD;AAAxC,+GAAA,eAAe,OAAA;AACxB,mDAA2D;AAAlD,+GAAA,kBAAkB,OAAA"}

package/dist/src/observability.d.ts

@@ -0,0 +1,82 @@
+import { type SystemDatabase } from '@dbos-inc/dbos-sdk/internal/system_database';
+export interface MetricData {
+    metricType: string;
+    metricName: string;
+    value: number;
+}
+export interface GetStepAggregatesInput {
+    groupByFunctionName?: boolean;
+    groupByStatus?: boolean;
+    selectCount?: boolean;
+    selectMaxDurationMs?: boolean;
+    timeBucketSizeMs?: number;
+    status?: string[];
+    functionName?: string[];
+    workflowIdPrefix?: string[];
+    completedAfter?: string;
+    completedBefore?: string;
+    applicationName?: string[];
+}
+export interface GetWorkflowAggregatesInput {
+    groupByStatus?: boolean;
+    groupByName?: boolean;
+    groupByQueueName?: boolean;
+    groupByExecutorId?: boolean;
+    groupByApplicationVersion?: boolean;
+    groupByApplicationName?: boolean;
+    selectCount?: boolean;
+    selectMinCreatedAt?: boolean;
+    selectMaxQueueWaitMs?: boolean;
+    selectMaxTotalLatencyMs?: boolean;
+    timeBucketSizeMs?: number;
+    status?: string[];
+    startTime?: string;
+    endTime?: string;
+    completedAfter?: string;
+    completedBefore?: string;
+    dequeuedAfter?: string;
+    dequeuedBefore?: string;
+    name?: string[];
+    appVersion?: string[];
+    executorId?: string[];
+    queueName?: string[];
+    workflowIdPrefix?: string[];
+    workflowIDs?: string[];
+    authenticatedUser?: string[];
+    forkedFrom?: string[];
+    wasForkedFrom?: boolean;
+    isFork?: boolean;
+    parentWorkflowID?: string[];
+    hasParent?: boolean;
+    attributes?: Record<string, unknown>;
+    scheduleName?: string[];
+    applicationName?: string[];
+}
+export interface StepAggregateRow {
+    group: Record<string, string | null>;
+    count: number | null;
+    maxDurationMs: number | null;
+}
+export interface WorkflowAggregateRow {
+    group: Record<string, string | null>;
+    count: number | null;
+    minCreatedAt: number | null;
+    maxQueueWaitMs: number | null;
+    maxTotalLatencyMs: number | null;
+}
+export interface GetPendingWorkflowsOutput {
+    workflowUUID: string;
+}
+export declare function getPendingWorkflows(sysdb: SystemDatabase, executorID: string, appVersion: string): Promise<GetPendingWorkflowsOutput[]>;
+export declare function getAllEvents(sysdb: SystemDatabase, workflowID: string): Promise<Record<string, unknown>>;
+export declare function getAllNotifications(sysdb: SystemDatabase, workflowID: string): Promise<{
+    topic: string | null;
+    message: unknown;
+    createdAtEpochMs: number;
+    consumed: boolean;
+}[]>;
+export declare function getAllStreamEntries(sysdb: SystemDatabase, workflowID: string): Promise<Record<string, unknown[]>>;
+export declare function getWorkflowAggregates(sysdb: SystemDatabase, input: GetWorkflowAggregatesInput): Promise<WorkflowAggregateRow[]>;
+export declare function getStepAggregates(sysdb: SystemDatabase, input: GetStepAggregatesInput): Promise<StepAggregateRow[]>;
+export declare function getMetrics(sysdb: SystemDatabase, startTime: string, endTime: string, applicationName?: string[]): Promise<MetricData[]>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/observability.d.ts.map

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