syncpoint-ai 0.1.0

package/dist/governance/wake.js

@@ -0,0 +1,205 @@
+/**
+ * Wake Engine — types, schemas, and pure computation for auto-wake orchestration.
+ *
+ * A WakeRequest is a first-class concept representing:
+ *   "This agent should be woken, with this context, to perform this action."
+ *
+ * The WakeEngine listens to state-change events, re-computes next actions
+ * for all session participants, and generates WakeRequests.
+ */
+import { z } from "zod";
+import { isValidWakeVerb, isModeActionAllowed, InvalidStateTransitionError } from "../kernel/index.js";
+// ── WakeRequest Status ─────────────────────────────────
+export var WakeRequestStatus;
+(function (WakeRequestStatus) {
+    WakeRequestStatus["QUEUED"] = "QUEUED";
+    WakeRequestStatus["DISPATCHED"] = "DISPATCHED";
+    WakeRequestStatus["RUNNING"] = "RUNNING";
+    WakeRequestStatus["DONE"] = "DONE";
+    WakeRequestStatus["FAILED"] = "FAILED";
+    WakeRequestStatus["SKIPPED"] = "SKIPPED";
+})(WakeRequestStatus || (WakeRequestStatus = {}));
+export const WAKE_REQUEST_TRANSITIONS = {
+    [WakeRequestStatus.QUEUED]: [WakeRequestStatus.DISPATCHED, WakeRequestStatus.SKIPPED],
+    [WakeRequestStatus.DISPATCHED]: [WakeRequestStatus.RUNNING, WakeRequestStatus.FAILED, WakeRequestStatus.SKIPPED],
+    [WakeRequestStatus.RUNNING]: [WakeRequestStatus.DONE, WakeRequestStatus.FAILED],
+    [WakeRequestStatus.DONE]: [],
+    [WakeRequestStatus.FAILED]: [WakeRequestStatus.QUEUED],
+    [WakeRequestStatus.SKIPPED]: [],
+};
+// ── Runner Mode ────────────────────────────────────────
+export const WakeRunnerMode = z.enum([
+    "manual", // Generate prompt/command for human to execute
+    "mcp", // Push via MCP resource for editor agent to pick up
+    // Future: "codex-cli", "claude-code", "cursor-agent"
+]);
+// ── WakeRequest Schema ─────────────────────────────────
+const nanoid12 = z.string().min(1).max(24);
+const isoDate = z.string().datetime({ offset: true });
+export const WakeRequestSchema = z.object({
+    id: nanoid12,
+    sessionId: nanoid12,
+    targetAgentId: nanoid12,
+    targetRole: z.string(),
+    action: z.string(), // PlaybookActionKind value
+    reason: z.string(),
+    triggerEventType: z.string(), // What event caused this wake
+    triggerEntityId: z.string(), // Entity ID that triggered it
+    taskId: nanoid12.nullable().default(null),
+    reviewRequestId: nanoid12.nullable().default(null),
+    promptHint: z.string().default(""), // Suggested MCP prompt name
+    mcpToolHint: z.string().default(""), // Suggested MCP tool
+    cliHint: z.string().default(""), // Suggested CLI command
+    runnerMode: WakeRunnerMode.default("manual"),
+    status: z.nativeEnum(WakeRequestStatus).default(WakeRequestStatus.QUEUED),
+    resultSummary: z.string().default(""),
+    createdAt: isoDate,
+    updatedAt: isoDate,
+});
+export const WakeRequestCreateSchema = z.object({
+    sessionId: nanoid12,
+    targetAgentId: nanoid12,
+    targetRole: z.string(),
+    action: z.string(),
+    reason: z.string(),
+    triggerEventType: z.string(),
+    triggerEntityId: z.string(),
+    taskId: nanoid12.nullable().default(null),
+    reviewRequestId: nanoid12.nullable().default(null),
+    promptHint: z.string().default(""),
+    mcpToolHint: z.string().default(""),
+    cliHint: z.string().default(""),
+    runnerMode: WakeRunnerMode.default("manual"),
+});
+// ── Orchestration Event Types for Wake ─────────────────
+export var OrchestrationEventType;
+(function (OrchestrationEventType) {
+    OrchestrationEventType["SESSION_CREATED"] = "SESSION_CREATED";
+    OrchestrationEventType["SESSION_ADVANCED"] = "SESSION_ADVANCED";
+    OrchestrationEventType["SESSION_CANCELLED"] = "SESSION_CANCELLED";
+    OrchestrationEventType["ROLE_ASSIGNED"] = "ROLE_ASSIGNED";
+    OrchestrationEventType["ASSIGNMENT_CREATED"] = "ASSIGNMENT_CREATED";
+    OrchestrationEventType["ASSIGNMENT_ACCEPTED"] = "ASSIGNMENT_ACCEPTED";
+    OrchestrationEventType["ASSIGNMENT_STARTED"] = "ASSIGNMENT_STARTED";
+    OrchestrationEventType["ASSIGNMENT_COMPLETED"] = "ASSIGNMENT_COMPLETED";
+    OrchestrationEventType["REVIEW_REQUESTED"] = "REVIEW_REQUESTED";
+    OrchestrationEventType["REVIEW_STARTED"] = "REVIEW_STARTED";
+    OrchestrationEventType["REVIEW_DECIDED"] = "REVIEW_DECIDED";
+    OrchestrationEventType["REVIEW_APPROVED"] = "REVIEW_APPROVED";
+    OrchestrationEventType["REVIEW_BLOCKED"] = "REVIEW_BLOCKED";
+})(OrchestrationEventType || (OrchestrationEventType = {}));
+export const DEFAULT_WAKE_RULES = [
+    // Session created → wake architect to plan
+    {
+        trigger: OrchestrationEventType.SESSION_CREATED,
+        targetRole: "architect",
+        action: "plan-tasks",
+        reason: "Session created. Plan tasks and assign agents.",
+        priority: 1,
+    },
+    // Session advanced to EXECUTING → wake executors to accept assignments
+    {
+        trigger: OrchestrationEventType.SESSION_ADVANCED,
+        targetRole: "executor",
+        action: "accept-assignment",
+        reason: "Session advanced to executing. Accept your assignment.",
+        priority: 1,
+        sessionStatus: "EXECUTING",
+    },
+    // Assignment created (task planned) → wake executor to accept
+    {
+        trigger: OrchestrationEventType.ASSIGNMENT_CREATED,
+        targetRole: "executor",
+        action: "accept-assignment",
+        reason: "New task assignment. Accept and begin work.",
+        priority: 1,
+    },
+    // Assignment completed → wake architect to request review
+    {
+        trigger: OrchestrationEventType.ASSIGNMENT_COMPLETED,
+        targetRole: "architect",
+        action: "request-review",
+        reason: "Executor completed assignment. Request a review.",
+        priority: 1,
+    },
+    // Review requested → wake reviewer to start review
+    {
+        trigger: OrchestrationEventType.REVIEW_REQUESTED,
+        targetRole: "reviewer",
+        action: "start-review",
+        reason: "Review requested. Start reviewing the task.",
+        priority: 1,
+    },
+    // Review approved → wake architect to advance session (final acceptance)
+    {
+        trigger: OrchestrationEventType.REVIEW_APPROVED,
+        targetRole: "architect",
+        action: "advance-session",
+        reason: "Review approved. Advance session to completion.",
+        priority: 1,
+    },
+    // Review blocked (changes requested) → wake executor to address changes
+    {
+        trigger: OrchestrationEventType.REVIEW_BLOCKED,
+        targetRole: "executor",
+        action: "address-changes",
+        reason: "Review blocked with change requests. Address and resubmit.",
+        priority: 1,
+    },
+];
+/**
+ * Every valid wake action must have synchronization semantics:
+ * it requires confirmation, handoff, review, or conflict resolution.
+ * This whitelist prevents "infinite auto-work" wakes.
+ */
+export const SYNC_VERB_WHITELIST = [
+    "plan", "accept", "checkpoint", "sync", "review",
+    "handoff", "resume", "approve",
+    // Mapped playbook actions
+    "plan-tasks", "accept-assignment", "start-review",
+    "request-review", "advance-session", "address-changes",
+    "claim-resources", "sync-checkpoint",
+];
+/**
+ * Pure function: given a trigger event and session context,
+ * compute which roles should be woken.
+ * Uses the default wake rules (can be extended with custom rules later).
+ */
+export function computeWakeTargets(ctx, rules = DEFAULT_WAKE_RULES) {
+    const targets = [];
+    for (const rule of rules) {
+        if (rule.trigger !== ctx.triggerEventType)
+            continue;
+        // Optional session status filter
+        if (rule.sessionStatus && rule.sessionStatus !== ctx.sessionStatus)
+            continue;
+        // Check if the target role exists in the session
+        const hasRole = ctx.roleBindings.some(rb => rb.role === rule.targetRole);
+        if (!hasRole)
+            continue;
+        // P4: Sync verb enforcement — only allow sync-semantic actions
+        if (!SYNC_VERB_WHITELIST.includes(rule.action))
+            continue;
+        // P4: Mode-aware verb filtering — if mode is set, filter by mode's allowed verbs
+        if (ctx.relationshipMode && !isValidWakeVerb(ctx.relationshipMode, rule.action))
+            continue;
+        // P3: Unified mode enforcement — block actions that FORBIDDEN_ACTIONS disallows
+        if (ctx.relationshipMode && isModeActionAllowed(ctx.relationshipMode, rule.action) === "blocked")
+            continue;
+        targets.push({
+            targetRole: rule.targetRole,
+            action: rule.action,
+            reason: rule.reason,
+            priority: rule.priority,
+        });
+    }
+    return targets.sort((a, b) => a.priority - b.priority);
+}
+// ── Validate WakeRequest Transition ────────────────────
+export function validateWakeRequestTransition(current, target) {
+    const allowed = WAKE_REQUEST_TRANSITIONS[current];
+    if (!allowed.includes(target)) {
+        throw new InvalidStateTransitionError("WakeRequest", current, target);
+    }
+}
+//# sourceMappingURL=wake.js.map

package/dist/governance/wake.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SyncPoint — consolidated public API.
+ * All coordination primitives, server, CLI, MCP, and SDK in one package.
+ */
+export * from "./kernel/index.js";
+export * from "./context/index.js";
+export * from "./governance/index.js";
+export * from "./adapters/index.js";
+export * from "./core/index.js";
+export { registerCodePlugin, isCodePluginRegistered } from "./plugins/code/index.js";
+export { registerGenericAgentPlugin, isGenericAgentPluginRegistered } from "./plugins/generic-agent/index.js";
+export * from "./sdk/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../_build/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAG9G,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * SyncPoint — consolidated public API.
+ * All coordination primitives, server, CLI, MCP, and SDK in one package.
+ */
+// ── Kernel (pure types, schemas, state machines) ──
+export * from "./kernel/index.js";
+// ── Context & Memory ──
+export * from "./context/index.js";
+// ── Governance (review, wake, constraints) ──
+export * from "./governance/index.js";
+// ── Adapters (manifests, negotiation, orchestration) ──
+export * from "./adapters/index.js";
+// ── Core (unified config, facade) ──
+export * from "./core/index.js";
+// ── Plugins ──
+export { registerCodePlugin, isCodePluginRegistered } from "./plugins/code/index.js";
+export { registerGenericAgentPlugin, isGenericAgentPluginRegistered } from "./plugins/generic-agent/index.js";
+// ── SDK (typed client) ──
+export * from "./sdk/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../_build/src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qDAAqD;AACrD,cAAc,mBAAmB,CAAC;AAElC,yBAAyB;AACzB,cAAc,oBAAoB,CAAC;AAEnC,+CAA+C;AAC/C,cAAc,uBAAuB,CAAC;AAEtC,yDAAyD;AACzD,cAAc,qBAAqB,CAAC;AAEpC,sCAAsC;AACtC,cAAc,iBAAiB,CAAC;AAEhC,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAE9G,2BAA2B;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/kernel/approval-gate.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Approval Gate — shared kernel types for review approval gates.
+ *
+ * ApprovalGateStatus and ApprovalGateResult are kernel-level types because both
+ * syncpoint-governance (review workflow) and syncpoint-adapters (playbook engine)
+ * depend on them at runtime. Housing them in kernel breaks the circular dependency
+ * between governance ↔ adapters.
+ */
+import { z } from "zod";
+export declare enum ApprovalGateStatus {
+    PENDING = "PENDING",
+    PASSED = "PASSED",
+    BLOCKED = "BLOCKED",
+    WAIVED = "WAIVED"
+}
+export declare const ApprovalGateResultSchema: z.ZodObject<{
+    status: z.ZodNativeEnum<typeof ApprovalGateStatus>;
+    reasons: z.ZodArray<z.ZodString, "many">;
+    checklistTotal: z.ZodNumber;
+    checklistPassed: z.ZodNumber;
+    checklistFailed: z.ZodNumber;
+    checklistWaived: z.ZodNumber;
+    checklistOpen: z.ZodNumber;
+    evidenceCount: z.ZodNumber;
+    openChangeRequests: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    status: ApprovalGateStatus;
+    reasons: string[];
+    checklistTotal: number;
+    checklistPassed: number;
+    checklistFailed: number;
+    checklistWaived: number;
+    checklistOpen: number;
+    evidenceCount: number;
+    openChangeRequests: number;
+}, {
+    status: ApprovalGateStatus;
+    reasons: string[];
+    checklistTotal: number;
+    checklistPassed: number;
+    checklistFailed: number;
+    checklistWaived: number;
+    checklistOpen: number;
+    evidenceCount: number;
+    openChangeRequests: number;
+}>;
+export type ApprovalGateResult = z.infer<typeof ApprovalGateResultSchema>;
+//# sourceMappingURL=approval-gate.d.ts.map

package/dist/kernel/approval-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-gate.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAID,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/kernel/approval-gate.js

@@ -0,0 +1,30 @@
+/**
+ * Approval Gate — shared kernel types for review approval gates.
+ *
+ * ApprovalGateStatus and ApprovalGateResult are kernel-level types because both
+ * syncpoint-governance (review workflow) and syncpoint-adapters (playbook engine)
+ * depend on them at runtime. Housing them in kernel breaks the circular dependency
+ * between governance ↔ adapters.
+ */
+import { z } from "zod";
+// ── ApprovalGateStatus ────────────────────────────────
+export var ApprovalGateStatus;
+(function (ApprovalGateStatus) {
+    ApprovalGateStatus["PENDING"] = "PENDING";
+    ApprovalGateStatus["PASSED"] = "PASSED";
+    ApprovalGateStatus["BLOCKED"] = "BLOCKED";
+    ApprovalGateStatus["WAIVED"] = "WAIVED";
+})(ApprovalGateStatus || (ApprovalGateStatus = {}));
+// ── ApprovalGateResult ────────────────────────────────
+export const ApprovalGateResultSchema = z.object({
+    status: z.nativeEnum(ApprovalGateStatus),
+    reasons: z.array(z.string()),
+    checklistTotal: z.number(),
+    checklistPassed: z.number(),
+    checklistFailed: z.number(),
+    checklistWaived: z.number(),
+    checklistOpen: z.number(),
+    evidenceCount: z.number(),
+    openChangeRequests: z.number(),
+});
+//# sourceMappingURL=approval-gate.js.map

package/dist/kernel/approval-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-gate.js","sourceRoot":"","sources":["../../_build/src/kernel/approval-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,yDAAyD;AAEzD,MAAM,CAAN,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;IACjB,yCAAmB,CAAA;IACnB,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,KAAlB,kBAAkB,QAK7B;AAED,yDAAyD;AAEzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC/B,CAAC,CAAC"}

package/dist/kernel/errors.d.ts

@@ -0,0 +1,126 @@
+/**
+ * SyncPoint structured error hierarchy.
+ *
+ * Every SyncPoint error has a machine-readable code, a user-facing
+ * message, an HTTP status code for API responses, and a retryability
+ * flag for automatic recovery logic.
+ *
+ * Usage:
+ *   throw new ResourceConflictError("src/auth.ts", "agent-3");
+ *
+ * In tRPC error formatter:
+ *   if (err instanceof SyncPointError) {
+ *     return { code: err.code, message: err.userMessage, ... };
+ *   }
+ */
+export declare abstract class SyncPointError extends Error {
+    /** Stable machine-readable error code (e.g. "RESOURCE_CONFLICT"). */
+    abstract readonly code: string;
+    /** HTTP status code for API responses. */
+    abstract readonly httpStatus: number;
+    /** Human-readable message for end users (non-technical). */
+    abstract readonly userMessage: string;
+    /** Optional suggestion for how to resolve the issue. */
+    abstract readonly suggestion: string | undefined;
+    /** Whether the operation can be retried. */
+    abstract readonly retryable: boolean;
+    constructor(message: string);
+}
+export declare class ResourceConflictError extends SyncPointError {
+    readonly resourcePath: string;
+    readonly claimedBy: string;
+    readonly code = "RESOURCE_CONFLICT";
+    readonly httpStatus = 409;
+    readonly retryable = true;
+    readonly suggestion: string;
+    constructor(resourcePath: string, claimedBy: string);
+    get userMessage(): string;
+}
+export declare class ResourceNotFoundError extends SyncPointError {
+    readonly resourceId: string;
+    readonly code = "RESOURCE_NOT_FOUND";
+    readonly httpStatus = 404;
+    readonly retryable = false;
+    readonly suggestion = "Check the resource identifier and try again.";
+    constructor(resourceId: string);
+    get userMessage(): string;
+}
+export declare class ConstraintViolationError extends SyncPointError {
+    readonly violatedRules: string[];
+    readonly resourcePath: string;
+    readonly code = "CONSTRAINT_VIOLATION";
+    readonly httpStatus = 403;
+    readonly retryable = false;
+    readonly suggestion: string;
+    constructor(violatedRules: string[], resourcePath: string);
+    get userMessage(): string;
+}
+export declare class UnauthorizedError extends SyncPointError {
+    readonly code = "UNAUTHORIZED";
+    readonly httpStatus = 401;
+    readonly retryable = false;
+    readonly suggestion = "Provide a valid x-caller-id header or agent token.";
+    constructor();
+    get userMessage(): string;
+}
+export declare class ForbiddenError extends SyncPointError {
+    readonly operation: string;
+    readonly reason?: string | undefined;
+    readonly code = "FORBIDDEN";
+    readonly httpStatus = 403;
+    readonly retryable = false;
+    readonly suggestion: string;
+    constructor(operation: string, reason?: string | undefined);
+    get userMessage(): string;
+}
+export declare class InvalidStateTransitionError extends SyncPointError {
+    readonly entity: string;
+    readonly fromState: string;
+    readonly toState: string;
+    readonly code = "INVALID_STATE_TRANSITION";
+    readonly httpStatus = 409;
+    readonly retryable = false;
+    readonly suggestion: string;
+    constructor(entity: string, fromState: string, toState: string);
+    get userMessage(): string;
+}
+export declare class ValidationError extends SyncPointError {
+    readonly field: string;
+    readonly issue: string;
+    readonly code = "VALIDATION_ERROR";
+    readonly httpStatus = 400;
+    readonly retryable = false;
+    readonly suggestion: string;
+    constructor(field: string, issue: string);
+    get userMessage(): string;
+}
+export declare class DatabaseError extends SyncPointError {
+    readonly operation: string;
+    readonly cause?: unknown | undefined;
+    readonly code = "DATABASE_ERROR";
+    readonly httpStatus = 500;
+    readonly retryable = true;
+    readonly suggestion = "The operation may succeed if retried. If the problem persists, check the database integrity.";
+    constructor(operation: string, cause?: unknown | undefined);
+    get userMessage(): string;
+}
+export declare class OperationTimeoutError extends SyncPointError {
+    readonly operation: string;
+    readonly timeoutMs: number;
+    readonly code = "OPERATION_TIMEOUT";
+    readonly httpStatus = 504;
+    readonly retryable = true;
+    readonly suggestion: string;
+    constructor(operation: string, timeoutMs: number);
+    get userMessage(): string;
+}
+export declare class InternalError extends SyncPointError {
+    readonly cause?: unknown | undefined;
+    readonly code = "INTERNAL_ERROR";
+    readonly httpStatus = 500;
+    readonly retryable = false;
+    readonly suggestion = "Please report this error to the SyncPoint maintainers.";
+    constructor(cause?: unknown | undefined);
+    get userMessage(): string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/kernel/errors.d.ts.map

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