syncpoint-ai 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/operation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oBAAY,eAAe;IACzB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,SAAS,cAAc;CACxB;AAsBD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAET;AAID,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;EAM7C,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOrC,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAI9E,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,UAAU,GAAG,UAAU,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/kernel/operation.js

@@ -0,0 +1,88 @@
+/**
+ * Operation — generic operation protocol.
+ *
+ * Supports any operation type (e.g. "code_patch", "image_edit", "video_cut").
+ * Plugins define specific operation types and their validators.
+ */
+import { z } from "zod";
+import { ResourceRefSchema } from "./resource.js";
+// ── Status ──────────────────────────────────────────
+export var OperationStatus;
+(function (OperationStatus) {
+    OperationStatus["DRAFT"] = "DRAFT";
+    OperationStatus["SUBMITTED"] = "SUBMITTED";
+    OperationStatus["CONFLICTING"] = "CONFLICTING";
+    OperationStatus["APPROVED"] = "APPROVED";
+    OperationStatus["REJECTED"] = "REJECTED";
+    OperationStatus["APPLIED"] = "APPLIED";
+    OperationStatus["CANCELLED"] = "CANCELLED";
+})(OperationStatus || (OperationStatus = {}));
+// ── Transitions ─────────────────────────────────────
+const OPERATION_TRANSITIONS = {
+    [OperationStatus.DRAFT]: [OperationStatus.SUBMITTED, OperationStatus.CANCELLED],
+    [OperationStatus.SUBMITTED]: [
+        OperationStatus.APPROVED,
+        OperationStatus.REJECTED,
+        OperationStatus.CONFLICTING,
+        OperationStatus.CANCELLED,
+    ],
+    [OperationStatus.CONFLICTING]: [
+        OperationStatus.SUBMITTED,
+        OperationStatus.CANCELLED,
+    ],
+    [OperationStatus.APPROVED]: [OperationStatus.APPLIED, OperationStatus.CANCELLED],
+    [OperationStatus.REJECTED]: [OperationStatus.SUBMITTED, OperationStatus.CANCELLED],
+    [OperationStatus.APPLIED]: [],
+    [OperationStatus.CANCELLED]: [],
+};
+export function validateOperationTransition(from, to) {
+    return (OPERATION_TRANSITIONS[from] ?? []).includes(to);
+}
+// ── Schema ──────────────────────────────────────────
+export const OperationCheckItemSchema = z.object({
+    check: z.string(),
+    passed: z.boolean(),
+    detail: z.string(),
+});
+export const OperationConstraintViolationSchema = z.object({
+    rule: z.string(),
+    sourceMemoryId: z.string(),
+    projectionId: z.string(),
+    message: z.string(),
+    evidence: z.array(z.string()).optional(),
+});
+export const OperationCheckResultSchema = z.object({
+    allPassed: z.boolean(),
+    items: z.array(OperationCheckItemSchema),
+    targetResources: z.array(ResourceRefSchema),
+    uncoveredResources: z.array(ResourceRefSchema),
+    conflictingClaimIds: z.array(z.string()),
+    constraintViolations: z.array(OperationConstraintViolationSchema).optional(),
+});
+export const OperationSchema = z.object({
+    id: z.string(),
+    type: z.string().min(1),
+    actorId: z.string(),
+    taskId: z.string(),
+    sessionId: z.string().default(""),
+    title: z.string(),
+    summary: z.string(),
+    targetResources: z.array(ResourceRefSchema),
+    payloadRef: z.string().default(""),
+    status: z.nativeEnum(OperationStatus),
+    checkResult: OperationCheckResultSchema.nullable().default(null),
+    decisionSummary: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+export const OperationCreateSchema = z.object({
+    type: z.string().min(1),
+    actorId: z.string(),
+    taskId: z.string(),
+    sessionId: z.string().optional(),
+    title: z.string().min(1),
+    summary: z.string().default(""),
+    targetResources: z.array(ResourceRefSchema).default([]),
+    payloadRef: z.string().default(""),
+});
+//# sourceMappingURL=operation.js.map

package/dist/kernel/operation.js.map

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

package/dist/kernel/path-normalize.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Path normalization for cross-platform resource consistency.
+ *
+ * Ensures that different representations of the same file path
+ * are treated as the same resource, regardless of:
+ *   - Relative vs absolute paths
+ *   - Platform-specific separators (\ vs /)
+ *   - Case differences (on case-insensitive filesystems)
+ *   - Trailing slashes and redundant segments
+ *
+ * This module contains PURE functions with no I/O.
+ * Filesystem-dependent operations (symlink resolution, realpath)
+ * are provided by the server package.
+ */
+export interface NormalizePathOptions {
+    /** Project root directory (absolute path). Relative paths are resolved against this. */
+    projectRoot?: string;
+    /** Whether to normalize case to lowercase. Default: auto-detect based on platform. */
+    caseSensitive?: boolean;
+    /** Paths that should be treated as equivalent to the given canonical form. */
+    aliases?: Record<string, string>;
+}
+/**
+ * Normalize a path for use as a resource locator.
+ *
+ * - Converts to absolute path (if projectRoot is provided)
+ * - Resolves `.` and `..` segments
+ * - Converts all separators to POSIX `/`
+ * - Normalizes case on Windows (unless caseSensitive is true)
+ * - Removes trailing slashes
+ * - Applies path alias mappings
+ *
+ * This is a PURE function — no filesystem access.
+ */
+export declare function normalizeResourcePath(input: string, options?: NormalizePathOptions): string;
+/**
+ * Check if two paths refer to the same resource after normalization.
+ * Wrapper around normalizeResourcePath for convenience.
+ */
+export declare function arePathsEquivalent(a: string, b: string, options?: NormalizePathOptions): boolean;
+/**
+ * Produce a stable key for a resource locator that can be used as
+ * a Map key for conflict detection and claim lookups.
+ * This is the normalized path.
+ */
+export declare function toResourceLocatorKey(resourceType: string, locator: string, options?: NormalizePathOptions): string;
+//# sourceMappingURL=path-normalize.d.ts.map

package/dist/kernel/path-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-normalize.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/path-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,oBAAoB;IACnC,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,oBAAyB,GACjC,MAAM,CA0CR;AAyED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAET;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,oBAAyB,GACjC,MAAM,CAER"}

package/dist/kernel/path-normalize.js

@@ -0,0 +1,148 @@
+/**
+ * Path normalization for cross-platform resource consistency.
+ *
+ * Ensures that different representations of the same file path
+ * are treated as the same resource, regardless of:
+ *   - Relative vs absolute paths
+ *   - Platform-specific separators (\ vs /)
+ *   - Case differences (on case-insensitive filesystems)
+ *   - Trailing slashes and redundant segments
+ *
+ * This module contains PURE functions with no I/O.
+ * Filesystem-dependent operations (symlink resolution, realpath)
+ * are provided by the server package.
+ */
+// ── Path normalization (pure, no I/O) ───────────────────
+/**
+ * Normalize a path for use as a resource locator.
+ *
+ * - Converts to absolute path (if projectRoot is provided)
+ * - Resolves `.` and `..` segments
+ * - Converts all separators to POSIX `/`
+ * - Normalizes case on Windows (unless caseSensitive is true)
+ * - Removes trailing slashes
+ * - Applies path alias mappings
+ *
+ * This is a PURE function — no filesystem access.
+ */
+export function normalizeResourcePath(input, options = {}) {
+    let path = input.trim();
+    if (!path)
+        return "";
+    // URI-scheme locators (e.g. binary://, artifact://) are not file paths — return as-is
+    if (isUriScheme(path))
+        return path;
+    // Apply path aliases first (e.g., project-shortcut → real-path)
+    if (options.aliases) {
+        for (const [alias, target] of Object.entries(options.aliases)) {
+            if (path === alias || path.startsWith(alias + "/") || path.startsWith(alias + "\\")) {
+                path = target + path.slice(alias.length);
+                break;
+            }
+        }
+    }
+    // Resolve relative to project root
+    if (options.projectRoot && !isAbsolutePath(path)) {
+        path = joinPath(options.projectRoot, path);
+    }
+    // Normalize separators to POSIX
+    path = path.replace(/\\/g, "/");
+    // Resolve . and .. segments
+    path = resolveDotSegments(path);
+    // Remove trailing slash (unless root "/")
+    if (path.length > 1 && path.endsWith("/")) {
+        path = path.slice(0, -1);
+    }
+    // Case normalization (Windows is case-insensitive by default)
+    const caseSensitive = options.caseSensitive ?? !isWindowsPlatform();
+    if (!caseSensitive) {
+        path = path.toLowerCase();
+        // But preserve the drive letter uppercase on Windows (C: → c: is fine)
+    }
+    return path;
+}
+// ── Pure helpers ────────────────────────────────────────
+/** Check if a string is a URI-scheme locator (e.g. binary://, artifact://). */
+function isUriScheme(p) {
+    return /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(p);
+}
+/** Check if a path is absolute (cross-platform). */
+function isAbsolutePath(p) {
+    // POSIX absolute
+    if (p.startsWith("/"))
+        return true;
+    // Windows absolute: C:\ or \\server\share
+    if (/^[a-zA-Z]:[\\/]/.test(p))
+        return true;
+    if (p.startsWith("\\\\"))
+        return true;
+    return false;
+}
+/** Join path segments (pure, no fs). */
+function joinPath(...segments) {
+    return segments
+        .map(s => s.replace(/\\/g, "/").replace(/\/+$/, ""))
+        .filter(Boolean)
+        .join("/")
+        .replace(/^([a-zA-Z]):/, (_, drive) => drive.toUpperCase() + ":");
+}
+/** Resolve `.` and `..` segments in a path. */
+function resolveDotSegments(p) {
+    const isWindowsAbsolute = /^[a-zA-Z]:\//.test(p);
+    // Strip drive prefix before splitting so it doesn't become a segment
+    const drivePrefix = isWindowsAbsolute ? p.slice(0, 3) : "";
+    const strippedPath = isWindowsAbsolute ? p.slice(3) : p;
+    const parts = strippedPath.split("/");
+    const result = [];
+    for (const part of parts) {
+        if (part === "." || part === "")
+            continue;
+        if (part === "..") {
+            if (result.length > 0 && result[result.length - 1] !== "..") {
+                result.pop();
+            }
+            else if (!isWindowsAbsolute) {
+                result.push("..");
+            }
+        }
+        else {
+            result.push(part);
+        }
+    }
+    let resolved = result.join("/");
+    // Restore leading slash for POSIX absolute paths
+    if (p.startsWith("/")) {
+        resolved = "/" + resolved;
+    }
+    // Restore Windows drive prefix (e.g., "C:/")
+    if (isWindowsAbsolute) {
+        resolved = drivePrefix + resolved;
+    }
+    return resolved || (p.startsWith("/") ? "/" : ".");
+}
+function isWindowsPlatform() {
+    // Allow override via env for testing
+    if (process.env.SYNCPOINT_CASE_SENSITIVE === "true")
+        return false;
+    if (process.env.SYNCPOINT_CASE_SENSITIVE === "false")
+        return true;
+    return process.platform === "win32";
+}
+// ── Path equivalence ────────────────────────────────────
+/**
+ * Check if two paths refer to the same resource after normalization.
+ * Wrapper around normalizeResourcePath for convenience.
+ */
+export function arePathsEquivalent(a, b, options = {}) {
+    return normalizeResourcePath(a, options) === normalizeResourcePath(b, options);
+}
+// ── Locator key for resource maps ───────────────────────
+/**
+ * Produce a stable key for a resource locator that can be used as
+ * a Map key for conflict detection and claim lookups.
+ * This is the normalized path.
+ */
+export function toResourceLocatorKey(resourceType, locator, options = {}) {
+    return `${resourceType}:${normalizeResourcePath(locator, options)}`;
+}
+//# sourceMappingURL=path-normalize.js.map

package/dist/kernel/path-normalize.js.map

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

package/dist/kernel/playbook-action-kind.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Playbook Action Kind — shared kernel Zod enum for action types.
+ *
+ * Defines the canonical set of actions that the playbook engine can recommend.
+ * Moved to kernel to eliminate the semantic circular dependency between
+ * syncpoint-governance (which consumes action kinds in wake.ts) and
+ * syncpoint-adapters (which defines the playbook engine).
+ */
+import { z } from "zod";
+export declare const PlaybookActionKind: z.ZodEnum<["plan-tasks", "assign-roles", "advance-session", "accept-assignment", "start-work", "checkpoint", "complete-assignment", "address-changes", "start-review", "add-checklist", "add-evidence", "evaluate-gate", "approve-review", "block-review", "request-review", "handoff", "claim-resources", "sync-checkpoint", "wait", "session-completed", "no-action"]>;
+export type PlaybookActionKind = z.infer<typeof PlaybookActionKind>;
+//# sourceMappingURL=playbook-action-kind.d.ts.map

package/dist/kernel/playbook-action-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-action-kind.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/playbook-action-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB,0WAiC7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/kernel/playbook-action-kind.js

@@ -0,0 +1,39 @@
+/**
+ * Playbook Action Kind — shared kernel Zod enum for action types.
+ *
+ * Defines the canonical set of actions that the playbook engine can recommend.
+ * Moved to kernel to eliminate the semantic circular dependency between
+ * syncpoint-governance (which consumes action kinds in wake.ts) and
+ * syncpoint-adapters (which defines the playbook engine).
+ */
+import { z } from "zod";
+export const PlaybookActionKind = z.enum([
+    // Architect actions
+    "plan-tasks",
+    "assign-roles",
+    "advance-session",
+    // Executor actions
+    "accept-assignment",
+    "start-work",
+    "checkpoint",
+    "complete-assignment",
+    "address-changes",
+    // Reviewer actions
+    "start-review",
+    "add-checklist",
+    "add-evidence",
+    "evaluate-gate",
+    "approve-review",
+    "block-review",
+    // Shared actions
+    "request-review",
+    "handoff",
+    // Mode-specific sync actions
+    "claim-resources",
+    "sync-checkpoint",
+    // Terminal / informational
+    "wait",
+    "session-completed",
+    "no-action",
+]);
+//# sourceMappingURL=playbook-action-kind.js.map

package/dist/kernel/playbook-action-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-action-kind.js","sourceRoot":"","sources":["../../_build/src/kernel/playbook-action-kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,oBAAoB;IACpB,YAAY;IACZ,cAAc;IACd,iBAAiB;IAEjB,mBAAmB;IACnB,mBAAmB;IACnB,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,iBAAiB;IAEjB,mBAAmB;IACnB,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,cAAc;IAEd,iBAAiB;IACjB,gBAAgB;IAChB,SAAS;IAET,6BAA6B;IAC7B,iBAAiB;IACjB,iBAAiB;IAEjB,2BAA2B;IAC3B,MAAM;IACN,mBAAmB;IACnB,WAAW;CACZ,CAAC,CAAC"}

package/dist/kernel/relationship-mode.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Relationship Mode — explicit coordination patterns between agents.
+ *
+ * Three modes, each with distinct synchronization rules:
+ *
+ *   manager-delegate:  delegate → wait → report → review
+ *   peer-contract:     contract → parallel work → checkpoint sync → merge
+ *   handoff-resume:    snapshot → handoff → accept → resume
+ *
+ * Housed in kernel because both syncpoint-adapters (playbook engine) and
+ * syncpoint-governance (wake engine) depend on these types at runtime.
+ */
+import { z } from "zod";
+export declare enum RelationshipMode {
+    MANAGER_DELEGATE = "manager-delegate",
+    PEER_CONTRACT = "peer-contract",
+    HANDOFF_RESUME = "handoff-resume"
+}
+export declare const RelationshipModeSchema: z.ZodNativeEnum<typeof RelationshipMode>;
+/**
+ * The expected phase sequence for each mode.
+ * These are the "sync verbs" that wake/playbook should enforce.
+ */
+export declare const MODE_PHASE_FLOW: Record<RelationshipMode, string[]>;
+export interface ModeSyncRule {
+    /** Sync gate required before this phase? */
+    requiresSyncGate: boolean;
+    /** Resource claim required before work? */
+    requiresResourceClaim: boolean;
+    /** Checkpoint required before this phase? */
+    requiresCheckpoint: boolean;
+    /** Review required before advancing? */
+    requiresReview: boolean;
+    /** Can agents work in parallel? */
+    allowsParallelWork: boolean;
+}
+export declare const MODE_SYNC_RULES: Record<RelationshipMode, ModeSyncRule>;
+/**
+ * Which wake actions are valid for each mode.
+ * This is used by P4 to restrict wake generation.
+ */
+export declare const MODE_WAKE_VERBS: Record<RelationshipMode, string[]>;
+export type ModeActionVerdict = "allowed" | "recommended" | "blocked";
+/**
+ * Actions that MUST be performed before an agent can start work in this mode.
+ */
+export declare const REQUIRED_BEFORE_START: Record<RelationshipMode, string[]>;
+/**
+ * Actions that are recommended (but not required) in each mode.
+ */
+export declare const RECOMMENDED_ACTIONS: Record<RelationshipMode, string[]>;
+/**
+ * Actions that should NEVER be generated for this mode (in wake/playbook).
+ */
+export declare const FORBIDDEN_ACTIONS: Record<RelationshipMode, string[]>;
+/**
+ * Check if a wake action verb is valid for a given mode.
+ */
+export declare function isValidWakeVerb(mode: RelationshipMode, action: string): boolean;
+/**
+ * Get the sync rules for a given mode.
+ */
+export declare function getSyncRules(mode: RelationshipMode): ModeSyncRule;
+/**
+ * Get the expected phase flow for a given mode.
+ */
+export declare function getPhaseFlow(mode: RelationshipMode): string[];
+/**
+ * Get a human-readable description of a mode's coordination pattern.
+ */
+export declare function getModeDescription(mode: RelationshipMode): string;
+/**
+ * Determine if a given action is allowed, recommended, or blocked for a mode.
+ */
+export declare function isModeActionAllowed(mode: RelationshipMode, action: string): ModeActionVerdict;
+/**
+ * Get actions required before an agent can start work in this mode.
+ */
+export declare function getRequiredBeforeStart(mode: RelationshipMode): string[];
+/**
+ * Get recommended actions for a mode.
+ */
+export declare function getRecommendedActions(mode: RelationshipMode): string[];
+/**
+ * Get forbidden actions for a mode.
+ */
+export declare function getForbiddenActions(mode: RelationshipMode): string[];
+//# sourceMappingURL=relationship-mode.d.ts.map

package/dist/kernel/relationship-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-mode.d.ts","sourceRoot":"","sources":["../../_build/src/kernel/relationship-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,oBAAY,gBAAgB;IAC1B,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;CAClC;AAED,eAAO,MAAM,sBAAsB,0CAAiC,CAAC;AAIrE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CA2B9D,CAAC;AAIF,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAC;IAC1B,2CAA2C;IAC3C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,6CAA6C;IAC7C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wCAAwC;IACxC,cAAc,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAsBlE,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAiB9D,CAAC;AAIF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAWpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAUlE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAUhE,CAAC;AAIF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CASjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAI7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEpE"}