syncpoint-ai 0.1.0

package/dist/adapters/playbook-engine.js

@@ -0,0 +1,304 @@
+/**
+ * Playbook Engine — pure next-action computation.
+ *
+ * Given a session snapshot (status, roles, assignments, reviews, checklist/evidence state),
+ * returns the next recommended action for a specific agent.
+ * No side effects — all inputs are plain data.
+ */
+import { z } from "zod";
+import { SessionStatus, TaskAssignmentStatus, ReviewRequestStatus } from "./orchestration.js";
+import { ApprovalGateStatus, PlaybookActionKind } from "../kernel/index.js";
+import { RelationshipMode, MODE_SYNC_RULES, isModeActionAllowed } from "./relationship-mode.js";
+// Re-export PlaybookActionKind for backward compatibility
+// Note: only the value export is needed — it provides both the Zod schema and inferred type
+export { PlaybookActionKind };
+// ── NextAction Schema ───────────────────────────────
+export const NextActionSchema = z.object({
+    action: PlaybookActionKind,
+    reason: z.string(),
+    /** CLI command suggestion */
+    cliHint: z.string(),
+    /** MCP tool suggestion */
+    mcpToolHint: z.string(),
+    /** Priority: 1 = immediate, 2 = soon, 3 = optional */
+    priority: z.number().int().min(1).max(3),
+    /** Entity IDs relevant to this action */
+    targetIds: z.record(z.string()).default({}),
+});
+// ── Pure Computation ────────────────────────────────
+/**
+ * Compute the next recommended action(s) for an agent within a session.
+ * Returns actions sorted by priority (most urgent first).
+ */
+export function computeNextActions(snap) {
+    const actions = [];
+    const { sessionStatus, agentId, agentRoles } = snap;
+    // Terminal states
+    if (sessionStatus === SessionStatus.COMPLETED) {
+        return [{ action: "session-completed", reason: "Session is completed.", cliHint: "", mcpToolHint: "", priority: 3, targetIds: {} }];
+    }
+    if (sessionStatus === SessionStatus.CANCELLED) {
+        return [{ action: "no-action", reason: "Session is cancelled.", cliHint: "", mcpToolHint: "", priority: 3, targetIds: {} }];
+    }
+    const isArchitect = agentRoles.includes("architect");
+    const isExecutor = agentRoles.includes("executor");
+    const isReviewer = agentRoles.includes("reviewer");
+    const myAssignments = snap.assignments.filter(a => a.assigneeAgentId === agentId);
+    const myReviews = snap.reviews.filter(r => r.reviewerAgentId === agentId);
+    // ── PLANNING phase ──
+    if (sessionStatus === SessionStatus.PLANNING) {
+        if (isArchitect) {
+            if (snap.assignments.length === 0) {
+                actions.push({
+                    action: "plan-tasks",
+                    reason: "No tasks planned yet. Create tasks and assign them.",
+                    cliHint: "syncpoint session plan --session <id> --task <id> --assignee <agentId>",
+                    mcpToolHint: "syncpoint_session_plan_task",
+                    priority: 1,
+                    targetIds: { sessionId: snap.sessionId },
+                });
+            }
+            else {
+                actions.push({
+                    action: "advance-session",
+                    reason: "Tasks are planned. Advance session to EXECUTING.",
+                    cliHint: "syncpoint session advance --session <id>",
+                    mcpToolHint: "syncpoint_session_advance",
+                    priority: 1,
+                    targetIds: { sessionId: snap.sessionId },
+                });
+            }
+        }
+        else {
+            actions.push({
+                action: "wait",
+                reason: "Waiting for architect to plan tasks.",
+                cliHint: "syncpoint session status --session <id>",
+                mcpToolHint: "syncpoint_session_status",
+                priority: 3,
+                targetIds: { sessionId: snap.sessionId },
+            });
+        }
+    }
+    // ── Mode rules ──
+    const mode = snap.relationshipMode ?? RelationshipMode.MANAGER_DELEGATE;
+    const syncRules = MODE_SYNC_RULES[mode];
+    // ── EXECUTING phase ──
+    if (sessionStatus === SessionStatus.EXECUTING) {
+        // Executor: accept / start / complete assignments
+        if (isExecutor) {
+            for (const a of myAssignments) {
+                if (a.status === TaskAssignmentStatus.PROPOSED) {
+                    actions.push({
+                        action: "accept-assignment",
+                        reason: `Assignment ${a.id} is proposed. Accept it to begin.`,
+                        cliHint: `syncpoint session accept --assignment ${a.id}`,
+                        mcpToolHint: "syncpoint_session_accept",
+                        priority: 1,
+                        targetIds: { assignmentId: a.id, taskId: a.taskId },
+                    });
+                }
+                else if (a.status === TaskAssignmentStatus.ACCEPTED) {
+                    // peer-contract: claim resources before starting work
+                    const hasClaims = (snap.activeClaimTaskIds ?? []).includes(a.taskId);
+                    if (syncRules.requiresResourceClaim && !hasClaims) {
+                        actions.push({
+                            action: "claim-resources",
+                            reason: `Mode ${mode}: claim resource ownership before starting work on task ${a.taskId}.`,
+                            cliHint: `syncpoint rc claim --agent ${agentId} --task ${a.taskId} --resources "..."`,
+                            mcpToolHint: "syncpoint_rc_claim",
+                            priority: 1,
+                            targetIds: { assignmentId: a.id, taskId: a.taskId },
+                        });
+                        // claim-resources is required before start — don't suggest start-work yet
+                    }
+                    else {
+                        actions.push({
+                            action: "start-work",
+                            reason: `Assignment ${a.id} is accepted. Start working on it.`,
+                            cliHint: `syncpoint session start --assignment ${a.id}`,
+                            mcpToolHint: "syncpoint_session_start",
+                            priority: 1,
+                            targetIds: { assignmentId: a.id, taskId: a.taskId },
+                        });
+                    }
+                }
+                else if (a.status === TaskAssignmentStatus.IN_PROGRESS) {
+                    // Check for open change requests addressed to this task
+                    const relatedReview = snap.reviews.find(r => r.taskId === a.taskId);
+                    const hasOpenChanges = relatedReview && (snap.openChanges[relatedReview.id] ?? 0) > 0;
+                    if (hasOpenChanges) {
+                        actions.push({
+                            action: "address-changes",
+                            reason: `Open change requests on task ${a.taskId}. Address them before completing.`,
+                            cliHint: `syncpoint review changes-address --change <changeId>`,
+                            mcpToolHint: "syncpoint_review_changes_address",
+                            priority: 1,
+                            targetIds: { taskId: a.taskId, reviewRequestId: relatedReview.id },
+                        });
+                    }
+                    else {
+                        actions.push({
+                            action: "checkpoint",
+                            reason: `Task ${a.taskId} is in progress. Save a checkpoint or complete.`,
+                            cliHint: `syncpoint loop checkpoint --agent ${agentId} --task ${a.taskId} --summary "..."`,
+                            mcpToolHint: "syncpoint_loop_checkpoint",
+                            priority: 2,
+                            targetIds: { assignmentId: a.id, taskId: a.taskId },
+                        });
+                        // peer-contract: suggest sync checkpoint for parallel coordination
+                        if (syncRules.requiresSyncGate) {
+                            actions.push({
+                                action: "sync-checkpoint",
+                                reason: `Mode ${mode}: consider requesting sync if file overlap detected.`,
+                                cliHint: `syncpoint sync request --task ${a.taskId} --agent ${agentId} --reason "checkpoint_required"`,
+                                mcpToolHint: "syncpoint_sync_request",
+                                priority: 2,
+                                targetIds: { assignmentId: a.id, taskId: a.taskId },
+                            });
+                        }
+                        // handoff-resume: suggest handoff instead of complete
+                        if (mode === RelationshipMode.HANDOFF_RESUME) {
+                            actions.push({
+                                action: "handoff",
+                                reason: `Mode ${mode}: hand off to next agent when ready.`,
+                                cliHint: `syncpoint loop handoff --task ${a.taskId} --from ${agentId} --to <nextAgentId>`,
+                                mcpToolHint: "syncpoint_loop_handoff",
+                                priority: 2,
+                                targetIds: { assignmentId: a.id, taskId: a.taskId },
+                            });
+                        }
+                        actions.push({
+                            action: "complete-assignment",
+                            reason: `Task ${a.taskId} is in progress. Complete if done.`,
+                            cliHint: `syncpoint session complete --assignment ${a.id}`,
+                            mcpToolHint: "syncpoint_session_complete",
+                            priority: 2,
+                            targetIds: { assignmentId: a.id, taskId: a.taskId },
+                        });
+                    }
+                }
+            }
+        }
+        // Architect: request review when all tasks completed, or advance
+        if (isArchitect) {
+            const allCompleted = snap.assignments.length > 0 &&
+                snap.assignments.every(a => a.status === TaskAssignmentStatus.COMPLETED);
+            if (allCompleted) {
+                const unreviewedTasks = snap.assignments
+                    .filter(a => !snap.reviews.some(r => r.taskId === a.taskId))
+                    .map(a => a.taskId);
+                if (unreviewedTasks.length > 0) {
+                    actions.push({
+                        action: "request-review",
+                        reason: `${unreviewedTasks.length} completed task(s) need review.`,
+                        cliHint: `syncpoint session review --session <id> --task <taskId> --reviewer <agentId>`,
+                        mcpToolHint: "syncpoint_session_request_review",
+                        priority: 1,
+                        targetIds: { sessionId: snap.sessionId, taskIds: unreviewedTasks.join(",") },
+                    });
+                }
+                else {
+                    actions.push({
+                        action: "advance-session",
+                        reason: "All tasks completed and reviews requested. Advance to REVIEWING.",
+                        cliHint: `syncpoint session advance --session <id>`,
+                        mcpToolHint: "syncpoint_session_advance",
+                        priority: 1,
+                        targetIds: { sessionId: snap.sessionId },
+                    });
+                }
+            }
+        }
+    }
+    // ── REVIEWING phase ──
+    if (sessionStatus === SessionStatus.REVIEWING) {
+        if (isReviewer) {
+            for (const r of myReviews) {
+                if (r.status === ReviewRequestStatus.PENDING) {
+                    actions.push({
+                        action: "start-review",
+                        reason: `Review ${r.id} is pending. Start reviewing task ${r.taskId}.`,
+                        cliHint: `syncpoint session start-review --review ${r.id}`,
+                        mcpToolHint: "syncpoint_session_start_review",
+                        priority: 1,
+                        targetIds: { reviewRequestId: r.id, taskId: r.taskId },
+                    });
+                }
+                else if (r.status === ReviewRequestStatus.IN_PROGRESS) {
+                    const gate = snap.gates[r.id];
+                    if (!gate || gate.status === ApprovalGateStatus.BLOCKED) {
+                        // Gate missing or blocked — suggest adding checklist + evidence
+                        actions.push({
+                            action: "add-checklist",
+                            reason: gate ? `Gate BLOCKED: ${gate.reasons.join("; ")}. Add/update checklist items.` : `Review ${r.id} in progress. Add checklist items.`,
+                            cliHint: `syncpoint review checklist-add --review ${r.id} --title "..."`,
+                            mcpToolHint: "syncpoint_review_checklist_add",
+                            priority: 1,
+                            targetIds: { reviewRequestId: r.id },
+                        });
+                        actions.push({
+                            action: "add-evidence",
+                            reason: gate ? `Gate BLOCKED: ${gate.reasons.join("; ")}. Add evidence.` : `Review ${r.id} in progress. Record evidence.`,
+                            cliHint: `syncpoint review evidence-add --review ${r.id} --kind test --title "..." --content "..."`,
+                            mcpToolHint: "syncpoint_review_evidence_add",
+                            priority: 1,
+                            targetIds: { reviewRequestId: r.id },
+                        });
+                        if (gate) {
+                            actions.push({
+                                action: "block-review",
+                                reason: `Gate blocked. Consider blocking with change requests.`,
+                                cliHint: `syncpoint review block --review ${r.id} --summary "..." --changes "..."`,
+                                mcpToolHint: "syncpoint_review_block",
+                                priority: 2,
+                                targetIds: { reviewRequestId: r.id },
+                            });
+                        }
+                    }
+                    else if (gate.status === ApprovalGateStatus.PASSED) {
+                        actions.push({
+                            action: "approve-review",
+                            reason: `Gate PASSED for review ${r.id}. Approve to proceed.`,
+                            cliHint: `syncpoint review approve --review ${r.id} --summary "..."`,
+                            mcpToolHint: "syncpoint_review_approve",
+                            priority: 1,
+                            targetIds: { reviewRequestId: r.id },
+                        });
+                    }
+                }
+            }
+        }
+        // Architect: advance after all reviews decided
+        if (isArchitect) {
+            const allDecided = snap.reviews.length > 0 &&
+                snap.reviews.every(r => r.status === ReviewRequestStatus.DECIDED);
+            if (allDecided) {
+                actions.push({
+                    action: "advance-session",
+                    reason: "All reviews decided. Advance session.",
+                    cliHint: `syncpoint session advance --session <id>`,
+                    mcpToolHint: "syncpoint_session_advance",
+                    priority: 1,
+                    targetIds: { sessionId: snap.sessionId },
+                });
+            }
+        }
+    }
+    // Filter out actions that are blocked by the current mode
+    const filtered = actions.filter(a => isModeActionAllowed(mode, a.action) !== "blocked");
+    // Sort by priority
+    filtered.sort((a, b) => a.priority - b.priority);
+    if (filtered.length === 0) {
+        return [{
+                action: "wait",
+                reason: "No actionable items for this agent right now.",
+                cliHint: `syncpoint session status --session ${snap.sessionId}`,
+                mcpToolHint: "syncpoint_session_status",
+                priority: 3,
+                targetIds: { sessionId: snap.sessionId },
+            }];
+    }
+    return filtered;
+}
+//# sourceMappingURL=playbook-engine.js.map

package/dist/adapters/playbook-engine.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * Relationship Mode — re-exports from syncpoint-kernel (canonical source).
+ *
+ * Previously defined locally; now delegates to kernel to prevent
+ * circular dependencies between governance and adapters.
+ */
+export { RelationshipMode, RelationshipModeSchema, MODE_PHASE_FLOW, MODE_SYNC_RULES, MODE_WAKE_VERBS, REQUIRED_BEFORE_START, RECOMMENDED_ACTIONS, FORBIDDEN_ACTIONS, isValidWakeVerb, getSyncRules, getPhaseFlow, getModeDescription, isModeActionAllowed, getRequiredBeforeStart, getRecommendedActions, getForbiddenActions, } from "../kernel/index.js";
+export type { ModeSyncRule, ModeActionVerdict } from "../kernel/index.js";
+//# sourceMappingURL=relationship-mode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-mode.d.ts","sourceRoot":"","sources":["../../_build/src/adapters/relationship-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/adapters/relationship-mode.js

@@ -0,0 +1,8 @@
+/**
+ * Relationship Mode — re-exports from syncpoint-kernel (canonical source).
+ *
+ * Previously defined locally; now delegates to kernel to prevent
+ * circular dependencies between governance and adapters.
+ */
+export { RelationshipMode, RelationshipModeSchema, MODE_PHASE_FLOW, MODE_SYNC_RULES, MODE_WAKE_VERBS, REQUIRED_BEFORE_START, RECOMMENDED_ACTIONS, FORBIDDEN_ACTIONS, isValidWakeVerb, getSyncRules, getPhaseFlow, getModeDescription, isModeActionAllowed, getRequiredBeforeStart, getRecommendedActions, getForbiddenActions, } from "../kernel/index.js";
+//# sourceMappingURL=relationship-mode.js.map

package/dist/adapters/relationship-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-mode.js","sourceRoot":"","sources":["../../_build/src/adapters/relationship-mode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/adapters/runtime.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Runtime — represents a real execution entry point (editor window, daemon, cloud).
+ *
+ * A runtime is the physical process that connects to SyncPoint via MCP/CLI/SDK.
+ * Binding an agent to a runtime means "this connection speaks as that agent."
+ */
+import { z } from "zod";
+import { ForbiddenError } from "../kernel/index.js";
+export declare enum RuntimeStatus {
+    ACTIVE = "ACTIVE",
+    DISCONNECTED = "DISCONNECTED"
+}
+export declare enum RuntimeKind {
+    LOCAL_MCP = "local-mcp",
+    DAEMON = "daemon",
+    CLOUD = "cloud"
+}
+export declare const RuntimeSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeKind>>;
+    provider: z.ZodDefault<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    workspaceRoot: z.ZodDefault<z.ZodString>;
+    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeStatus>>;
+    lastSeenAt: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: RuntimeStatus;
+    id: string;
+    createdAt: string;
+    kind: RuntimeKind;
+    agentId: string | null;
+    name: string;
+    provider: string;
+    host: string;
+    workspaceRoot: string;
+    lastSeenAt: string;
+}, {
+    id: string;
+    createdAt: string;
+    name: string;
+    status?: RuntimeStatus | undefined;
+    kind?: RuntimeKind | undefined;
+    agentId?: string | null | undefined;
+    provider?: string | undefined;
+    host?: string | undefined;
+    workspaceRoot?: string | undefined;
+    lastSeenAt?: string | undefined;
+}>;
+export type Runtime = z.infer<typeof RuntimeSchema>;
+export declare const RuntimeCreateSchema: z.ZodObject<{
+    name: z.ZodString;
+    kind: z.ZodDefault<z.ZodNativeEnum<typeof RuntimeKind>>;
+    provider: z.ZodDefault<z.ZodString>;
+    host: z.ZodDefault<z.ZodString>;
+    workspaceRoot: z.ZodDefault<z.ZodString>;
+    agentId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    kind: RuntimeKind;
+    agentId: string | null;
+    name: string;
+    provider: string;
+    host: string;
+    workspaceRoot: string;
+}, {
+    name: string;
+    kind?: RuntimeKind | undefined;
+    agentId?: string | null | undefined;
+    provider?: string | undefined;
+    host?: string | undefined;
+    workspaceRoot?: string | undefined;
+}>;
+export type RuntimeCreate = z.infer<typeof RuntimeCreateSchema>;
+export interface BoundIdentity {
+    agentId: string;
+    runtimeId: string | null;
+    source: "env-agent" | "env-runtime";
+}
+export interface IdentityEnv {
+    SYNCPOINT_AGENT_ID?: string;
+    SYNCPOINT_RUNTIME_ID?: string;
+}
+/**
+ * Resolve the effective agent identity from environment + optional parameter.
+ *
+ * Priority:
+ *   1. SYNCPOINT_AGENT_ID env → bound agent (reject mismatched param)
+ *   2. SYNCPOINT_RUNTIME_ID env → look up agent from runtime (caller supplies resolver)
+ *
+ * Returns null if no identity can be resolved.
+ * Throws if inputAgentId conflicts with bound identity.
+ */
+export declare function resolveIdentity(env: IdentityEnv, inputAgentId: string | undefined, runtimeAgentLookup?: (runtimeId: string) => string | null): BoundIdentity | null;
+export declare class IdentityConflictError extends ForbiddenError {
+    boundAgentId: string;
+    requestedAgentId: string;
+    constructor(boundAgentId: string, requestedAgentId: string);
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/adapters/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../_build/src/adapters/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,oBAAY,aAAa;IACvB,MAAM,WAAW;IACjB,YAAY,iBAAiB;CAC9B;AAED,oBAAY,WAAW;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB;AAID,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,EAChB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACxD,aAAa,GAAG,IAAI,CAwBtB;AAID,qBAAa,qBAAsB,SAAQ,cAAc;IAE9C,YAAY,EAAE,MAAM;IACpB,gBAAgB,EAAE,MAAM;gBADxB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM;CAQlC"}

package/dist/adapters/runtime.js

@@ -0,0 +1,85 @@
+/**
+ * Runtime — represents a real execution entry point (editor window, daemon, cloud).
+ *
+ * A runtime is the physical process that connects to SyncPoint via MCP/CLI/SDK.
+ * Binding an agent to a runtime means "this connection speaks as that agent."
+ */
+import { z } from "zod";
+import { ForbiddenError } from "../kernel/index.js";
+// ── Status ──────────────────────────────────────────────
+export var RuntimeStatus;
+(function (RuntimeStatus) {
+    RuntimeStatus["ACTIVE"] = "ACTIVE";
+    RuntimeStatus["DISCONNECTED"] = "DISCONNECTED";
+})(RuntimeStatus || (RuntimeStatus = {}));
+export var RuntimeKind;
+(function (RuntimeKind) {
+    RuntimeKind["LOCAL_MCP"] = "local-mcp";
+    RuntimeKind["DAEMON"] = "daemon";
+    RuntimeKind["CLOUD"] = "cloud";
+})(RuntimeKind || (RuntimeKind = {}));
+// ── Schema ──────────────────────────────────────────────
+export const RuntimeSchema = z.object({
+    id: z.string(),
+    name: z.string().min(1),
+    kind: z.nativeEnum(RuntimeKind).default(RuntimeKind.LOCAL_MCP),
+    provider: z.string().default(""),
+    host: z.string().default(""),
+    workspaceRoot: z.string().default(""),
+    agentId: z.string().nullable().default(null),
+    status: z.nativeEnum(RuntimeStatus).default(RuntimeStatus.ACTIVE),
+    lastSeenAt: z.string().default(""),
+    createdAt: z.string(),
+});
+export const RuntimeCreateSchema = z.object({
+    name: z.string().min(1),
+    kind: z.nativeEnum(RuntimeKind).default(RuntimeKind.LOCAL_MCP),
+    provider: z.string().default(""),
+    host: z.string().default(""),
+    workspaceRoot: z.string().default(""),
+    agentId: z.string().nullable().default(null),
+});
+/**
+ * Resolve the effective agent identity from environment + optional parameter.
+ *
+ * Priority:
+ *   1. SYNCPOINT_AGENT_ID env → bound agent (reject mismatched param)
+ *   2. SYNCPOINT_RUNTIME_ID env → look up agent from runtime (caller supplies resolver)
+ *
+ * Returns null if no identity can be resolved.
+ * Throws if inputAgentId conflicts with bound identity.
+ */
+export function resolveIdentity(env, inputAgentId, runtimeAgentLookup) {
+    const envAgentId = env.SYNCPOINT_AGENT_ID;
+    const envRuntimeId = env.SYNCPOINT_RUNTIME_ID;
+    // Case 1: explicit SYNCPOINT_AGENT_ID
+    if (envAgentId) {
+        if (inputAgentId && inputAgentId !== envAgentId) {
+            throw new IdentityConflictError(envAgentId, inputAgentId);
+        }
+        return { agentId: envAgentId, runtimeId: envRuntimeId ?? null, source: "env-agent" };
+    }
+    // Case 2: SYNCPOINT_RUNTIME_ID → resolve agent
+    if (envRuntimeId && runtimeAgentLookup) {
+        const resolved = runtimeAgentLookup(envRuntimeId);
+        if (resolved) {
+            if (inputAgentId && inputAgentId !== resolved) {
+                throw new IdentityConflictError(resolved, inputAgentId);
+            }
+            return { agentId: resolved, runtimeId: envRuntimeId, source: "env-runtime" };
+        }
+    }
+    return null;
+}
+// ── Errors ──────────────────────────────────────────────
+export class IdentityConflictError extends ForbiddenError {
+    boundAgentId;
+    requestedAgentId;
+    constructor(boundAgentId, requestedAgentId) {
+        super("identity switch", `connection bound to "${boundAgentId}" but requested "${requestedAgentId}"`);
+        this.boundAgentId = boundAgentId;
+        this.requestedAgentId = requestedAgentId;
+        this.name = "IdentityConflictError";
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/adapters/runtime.js.map

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

package/dist/adapters/states.d.ts

@@ -0,0 +1,65 @@
+/**
+ * SyncPoint Core — types, state machine, protocol, Zod schemas.
+ *
+ * This package has NO Node-specific or editor-specific dependencies.
+ * It defines the collaboration protocol in a language-agnostic way.
+ */
+export declare enum AgentStatus {
+    IDLE = "IDLE",
+    RUNNING = "RUNNING",
+    CHECKPOINT = "CHECKPOINT",
+    WAITING_SYNC = "WAITING_SYNC",
+    BLOCKED = "BLOCKED",
+    WAITING_REVIEW = "WAITING_REVIEW",
+    HANDOFF = "HANDOFF",
+    DONE = "DONE"
+}
+export declare enum TaskStatus {
+    OPEN = "OPEN",
+    ASSIGNED = "ASSIGNED",
+    NEEDS_CONTRACT = "NEEDS_CONTRACT",
+    CONTRACT_REVIEW = "CONTRACT_REVIEW",
+    READY_TO_WORK = "READY_TO_WORK",
+    IN_PROGRESS = "IN_PROGRESS",
+    NEEDS_SYNC = "NEEDS_SYNC",
+    BLOCKED = "BLOCKED",
+    REVIEWING = "REVIEWING",
+    DONE = "DONE",
+    CANCELLED = "CANCELLED"
+}
+export declare enum HandoffStatus {
+    PENDING = "PENDING",
+    ACCEPTED = "ACCEPTED",
+    REJECTED = "REJECTED",
+    DONE = "DONE"
+}
+export declare enum ContractStatus {
+    DRAFT = "DRAFT",
+    REVIEWING = "REVIEWING",
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    ACTIVE = "ACTIVE",
+    CLOSED = "CLOSED"
+}
+export declare enum DiaryEntryType {
+    NOTE = "NOTE",
+    REPORT = "REPORT",
+    DECISION = "DECISION",
+    RISK = "RISK"
+}
+export { EventType } from "../kernel/index.js";
+export declare const AGENT_TRANSITIONS: Record<AgentStatus, AgentStatus[]>;
+export declare const TASK_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;
+export declare const CONTRACT_TRANSITIONS: Record<ContractStatus, ContractStatus[]>;
+import { InvalidStateTransitionError } from "../kernel/index.js";
+/**
+ * @deprecated Use InvalidStateTransitionError from syncpoint-kernel directly.
+ * Kept for backward compatibility.
+ */
+export declare class InvalidTransition extends InvalidStateTransitionError {
+    constructor(entity: string, fromState: string, toState: string);
+}
+export declare function validateAgentTransition(current: AgentStatus, target: AgentStatus): void;
+export declare function validateTaskTransition(current: TaskStatus, target: TaskStatus): void;
+export declare function validateContractTransition(current: ContractStatus, target: ContractStatus): void;
+//# sourceMappingURL=states.d.ts.map

package/dist/adapters/states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"states.d.ts","sourceRoot":"","sources":["../../_build/src/adapters/states.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,oBAAY,WAAW;IACrB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,OAAO,YAAY;IACnB,IAAI,SAAS;CACd;AAED,oBAAY,UAAU;IACpB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,oBAAY,aAAa;IACvB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,oBAAY,cAAc;IACxB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAGD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,EAAE,CAShE,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAY7D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,CAOzE,CAAC;AAIF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,2BAA2B;gBACpD,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAG/D;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAKvF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAKpF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAKhG"}