syncpoint-ai 0.1.0

package/dist/server/application/negotiation-service.js

@@ -0,0 +1,206 @@
+/**
+ * Negotiation Service — orchestrates negotiation sessions bound to sync gates.
+ *
+ * API:
+ *   negStart(gateId, participantIds, config?)  — create session, start round 1
+ *   negMessage(sessionId, agentId, kind, content) — post message
+ *   negReconcile(sessionId) — evaluate liveness, advance/deadlock/timeout
+ *   negResolve(sessionId, agentId, summary) — human/owner resolves
+ *   negStatus(sessionId) — detailed status with messages
+ */
+import { NegotiationStatus, NegotiationMessageKind, DEFAULT_NEGOTIATION_CONFIG, validateNegotiationTransition, evaluateNegotiation, } from "../../adapters/index.js";
+import * as repo from "../repositories/negotiation-repository.js";
+import { sgResolve as gateResolve } from "./sync-gate-service.js";
+import { updateSyncGateStatus, getSyncGate } from "../repositories/sync-gate-repository.js";
+import { ConstraintViolationError, ForbiddenError, InvalidStateTransitionError, ResourceNotFoundError, ValidationError, SyncGateStatus, isGateBlocking, validateSyncGateTransition } from "../../kernel/index.js";
+/**
+ * Safe gate writeback — only writes if the gate is still blocking and the
+ * transition is valid. Prevents regressing an already-resolved gate.
+ */
+function safeGateTransition(gateId, target, summary) {
+    try {
+        const gate = getSyncGate(gateId);
+        if (!isGateBlocking(gate))
+            return;
+        if (!validateSyncGateTransition(gate.status, target))
+            return;
+        updateSyncGateStatus(gateId, target, summary);
+    }
+    catch { /* gate may not exist or other error — swallow */ }
+}
+// ── Start ────────────────────────────────────────────
+export function negStart(gateId, participantIds, config) {
+    if (participantIds.length < 2) {
+        throw new ValidationError("participantIds", "Negotiation requires at least 2 participants");
+    }
+    const existing = repo.getNegotiationSessionByGate(gateId);
+    if (existing && existing.status !== NegotiationStatus.RESOLVED && existing.status !== NegotiationStatus.ESCALATED) {
+        throw new ConstraintViolationError(["negotiation_unique_gate"], `Active negotiation already exists for gate ${gateId}: ${existing.id}`);
+    }
+    const merged = { ...DEFAULT_NEGOTIATION_CONFIG, ...config };
+    const deadlineAt = new Date(Date.now() + merged.negotiationDeadlineMinutes * 60_000).toISOString();
+    const session = repo.createNegotiationSession({
+        gateId,
+        participantIds,
+        configJson: merged,
+        deadlineAt,
+    });
+    // Immediately advance to ROUND_ACTIVE round 1
+    const updated = repo.updateNegotiationSession(session.id, {
+        status: NegotiationStatus.ROUND_ACTIVE,
+        currentRound: 1,
+        roundStartedAt: new Date().toISOString(),
+    });
+    return updated;
+}
+// ── Post message ─────────────────────────────────────
+export function negMessage(sessionId, agentId, kind, content) {
+    const session = repo.getNegotiationSession(sessionId);
+    if (!session)
+        throw new ResourceNotFoundError(sessionId);
+    // Validate kind
+    const validKinds = Object.values(NegotiationMessageKind);
+    if (!validKinds.includes(kind.toUpperCase())) {
+        throw new ValidationError("kind", `Invalid message kind: ${kind}. Valid: ${validKinds.join(", ")}`);
+    }
+    // Must be active
+    if (session.status !== NegotiationStatus.ROUND_ACTIVE &&
+        session.status !== NegotiationStatus.WAITING_FOR_RESPONSES) {
+        throw new InvalidStateTransitionError("negotiation", session.status, NegotiationStatus.ROUND_ACTIVE);
+    }
+    // Must be a participant
+    const participants = session.participantIds;
+    if (!participants.includes(agentId)) {
+        throw new ForbiddenError("neg_message", `Agent ${agentId} is not a participant in this negotiation`);
+    }
+    const msg = repo.createNegotiationMessage({
+        sessionId,
+        agentId,
+        round: session.currentRound,
+        kind: kind.toUpperCase(),
+        content,
+    });
+    // After posting, check if all participants have responded → transition to WAITING_FOR_RESPONSES
+    const messages = repo.listNegotiationMessages(sessionId);
+    const currentRoundMessages = messages.filter(m => m.round === session.currentRound);
+    const responded = new Set(currentRoundMessages.map(m => m.agentId));
+    if (responded.size >= participants.length &&
+        session.status === NegotiationStatus.ROUND_ACTIVE) {
+        repo.updateNegotiationSession(sessionId, {
+            status: NegotiationStatus.WAITING_FOR_RESPONSES,
+        });
+    }
+    return { message: msg, session: repo.getNegotiationSession(sessionId) };
+}
+// ── Reconcile (liveness evaluation) ──────────────────
+export function negReconcile(sessionId) {
+    const session = repo.getNegotiationSession(sessionId);
+    if (!session)
+        throw new ResourceNotFoundError(sessionId);
+    // Terminal states — nothing to do
+    if (session.status === NegotiationStatus.RESOLVED ||
+        session.status === NegotiationStatus.ESCALATED) {
+        return { session, action: "none", reason: "Terminal state" };
+    }
+    const messages = repo.listNegotiationMessages(sessionId);
+    const result = evaluateNegotiation(session, messages);
+    switch (result.action) {
+        case "resolved": {
+            const updated = repo.updateNegotiationSession(sessionId, {
+                status: NegotiationStatus.RESOLVED,
+                resolutionSummary: result.reason,
+            });
+            // Write back to parent gate: resolve it
+            try {
+                gateResolve(session.gateId, `Negotiation resolved: ${result.reason}`);
+            }
+            catch { /* gate may already be resolved */ }
+            return { session: updated, action: result.action, reason: result.reason };
+        }
+        case "timeout": {
+            const updated = repo.updateNegotiationSession(sessionId, {
+                status: NegotiationStatus.TIMED_OUT,
+            });
+            // Write back to parent gate: mark timed out
+            safeGateTransition(session.gateId, SyncGateStatus.CANCELLED, `Negotiation timed out: ${result.reason}`);
+            return { session: updated, action: result.action, reason: result.reason };
+        }
+        case "deadlock": {
+            const updated = repo.updateNegotiationSession(sessionId, {
+                status: NegotiationStatus.DEADLOCKED,
+            });
+            // Write back to parent gate: escalate on deadlock
+            safeGateTransition(session.gateId, SyncGateStatus.CANCELLED, `Negotiation deadlocked: ${result.reason}`);
+            return { session: updated, action: result.action, reason: result.reason };
+        }
+        case "advance_round": {
+            const newRound = session.currentRound + 1;
+            const updated = repo.updateNegotiationSession(sessionId, {
+                status: NegotiationStatus.ROUND_ACTIVE,
+                currentRound: newRound,
+                roundStartedAt: new Date().toISOString(),
+            });
+            return { session: updated, action: result.action, reason: result.reason };
+        }
+        default:
+            return { session, action: result.action, reason: result.reason };
+    }
+}
+// ── Human resolve ────────────────────────────────────
+export function negResolve(sessionId, agentId, summary) {
+    const session = repo.getNegotiationSession(sessionId);
+    if (!session)
+        throw new ResourceNotFoundError(sessionId);
+    // Can resolve from DEADLOCKED, TIMED_OUT, ESCALATED, or active states
+    if (session.status === NegotiationStatus.RESOLVED) {
+        throw new InvalidStateTransitionError("negotiation", NegotiationStatus.RESOLVED, "non_resolved");
+    }
+    const updated = repo.updateNegotiationSession(sessionId, {
+        status: NegotiationStatus.RESOLVED,
+        resolvedByAgentId: agentId,
+        resolutionSummary: summary,
+    });
+    // Write back to parent gate: resolve it
+    try {
+        gateResolve(session.gateId, `Negotiation resolved by ${agentId}: ${summary}`);
+    }
+    catch { /* gate may already be resolved */ }
+    return updated;
+}
+// ── Escalate ─────────────────────────────────────────
+export function negEscalate(sessionId) {
+    const session = repo.getNegotiationSession(sessionId);
+    if (!session)
+        throw new ResourceNotFoundError(sessionId);
+    if (!validateNegotiationTransition(session.status, NegotiationStatus.ESCALATED)) {
+        throw new InvalidStateTransitionError("negotiation", session.status, NegotiationStatus.ESCALATED);
+    }
+    const updated = repo.updateNegotiationSession(sessionId, {
+        status: NegotiationStatus.ESCALATED,
+    });
+    // Write back to parent gate: escalate
+    safeGateTransition(session.gateId, SyncGateStatus.CANCELLED, "Negotiation escalated");
+    return updated;
+}
+// ── Status ───────────────────────────────────────────
+export function negStatus(sessionId) {
+    // Lazy reconcile
+    const reconciled = negReconcile(sessionId);
+    const messages = repo.listNegotiationMessages(sessionId);
+    const session = reconciled.session;
+    const participants = session.participantIds;
+    const currentRoundMessages = messages.filter(m => m.round === session.currentRound);
+    const responded = new Set(currentRoundMessages.map(m => m.agentId));
+    const pendingParticipants = participants.filter(p => !responded.has(p));
+    return {
+        session,
+        messages,
+        currentRound: session.currentRound,
+        respondedAgentIds: [...responded],
+        pendingParticipantIds: pendingParticipants,
+        totalMessages: messages.length,
+        lastAction: reconciled.action,
+        lastReason: reconciled.reason,
+    };
+}
+//# sourceMappingURL=negotiation-service.js.map

package/dist/server/application/negotiation-service.js.map

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

package/dist/server/application/operation-service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Operation Service — generic operation lifecycle management.
+ *
+ * Use cases:
+ *   opCreate   — create a draft operation
+ *   opSubmit   — submit for checking (DRAFT → SUBMITTED)
+ *   opCheck    — run validators
+ *   opApprove  — approve a submitted operation
+ *   opReject   — reject a submitted operation
+ *   opApply    — mark an approved operation as applied
+ *   opCancel   — cancel an operation
+ *   opStatus   — get operation with check result
+ *   opList     — list operations with filters
+ */
+import type { Operation, OperationCheckResult, ResourceRef } from "../../kernel/index.js";
+export interface OperationCreateInput {
+    type: string;
+    actorId: string;
+    taskId: string;
+    sessionId?: string;
+    title: string;
+    summary?: string;
+    targetResources?: ResourceRef[];
+    payloadRef?: string;
+}
+export interface OperationStatusResult {
+    operation: Operation;
+    checkResult: OperationCheckResult | null;
+}
+/**
+ * Create a draft operation.
+ */
+export declare function opCreate(input: OperationCreateInput): Operation;
+/**
+ * Submit a draft operation for checking (DRAFT → SUBMITTED).
+ * Automatically runs validators.
+ */
+export declare function opSubmit(operationId: string): OperationStatusResult;
+/**
+ * Run validators on an operation.
+ */
+export declare function opCheck(operationId: string): OperationStatusResult;
+/**
+ * Approve a submitted operation.
+ */
+export declare function opApprove(operationId: string, actorId: string, summary?: string): Operation;
+/**
+ * Reject a submitted operation.
+ */
+export declare function opReject(operationId: string, actorId: string, reason?: string): Operation;
+/**
+ * Mark an approved operation as applied.
+ * Runs a final constraint check (action: "operation_apply") before allowing apply.
+ */
+export declare function opApply(operationId: string): Operation;
+/**
+ * Cancel an operation.
+ */
+export declare function opCancel(operationId: string, reason?: string): Operation;
+/**
+ * Get operation status with parsed check result.
+ */
+export declare function opStatus(operationId: string): OperationStatusResult;
+/**
+ * List operations with optional filters.
+ */
+export declare function opList(opts?: {
+    type?: string;
+    actorId?: string;
+    taskId?: string;
+    sessionId?: string;
+    status?: string;
+}): Operation[];
+//# sourceMappingURL=operation-service.d.ts.map

package/dist/server/application/operation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-service.d.ts","sourceRoot":"","sources":["../../../_build/src/server/application/operation-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAuC,oBAAoB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAQ/H,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC1C;AAID;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,SAAS,CA4B/D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAcnE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CA2DlE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAoB3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAoBzF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAsBtD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAcxE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAGnE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,CAAC,EAAE;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,SAAS,EAAE,CAEd"}

package/dist/server/application/operation-service.js

@@ -0,0 +1,219 @@
+/**
+ * Operation Service — generic operation lifecycle management.
+ *
+ * Use cases:
+ *   opCreate   — create a draft operation
+ *   opSubmit   — submit for checking (DRAFT → SUBMITTED)
+ *   opCheck    — run validators
+ *   opApprove  — approve a submitted operation
+ *   opReject   — reject a submitted operation
+ *   opApply    — mark an approved operation as applied
+ *   opCancel   — cancel an operation
+ *   opStatus   — get operation with check result
+ *   opList     — list operations with filters
+ */
+import { evaluateConstraints } from "../../governance/index.js";
+import { ConstraintViolationError, InvalidStateTransitionError, OperationStatus, validateOperationTransition, runOperationValidation, normalizeResourcePath, EventType } from "../../kernel/index.js";
+import * as protocolRepo from "../repositories/_exports/protocol.js";
+import { logEvent } from "../repositories/_shared.js";
+import { buildProjection } from "./reality-projection-service.js";
+import { getProjectRoot } from "./path-resolver.js";
+// ── Use Cases ──────────────────────────────────────────
+/**
+ * Create a draft operation.
+ */
+export function opCreate(input) {
+    // Normalize file target resources to absolute paths for consistent
+    // comparison with normalized claim locators
+    const root = getProjectRoot();
+    const normalizedResources = input.targetResources?.map(r => ({
+        ...r,
+        locator: r.type === "file" ? normalizeResourcePath(r.locator, { projectRoot: root }) : r.locator,
+    })) ?? [];
+    const operation = protocolRepo.createOperation({
+        type: input.type,
+        actorId: input.actorId,
+        taskId: input.taskId,
+        sessionId: input.sessionId,
+        title: input.title,
+        summary: input.summary ?? "",
+        targetResources: normalizedResources,
+        payloadRef: input.payloadRef ?? "",
+    });
+    logEvent(EventType.OPERATION_CREATED, "operation", operation.id, JSON.stringify({ type: input.type, title: input.title }));
+    return operation;
+}
+/**
+ * Submit a draft operation for checking (DRAFT → SUBMITTED).
+ * Automatically runs validators.
+ */
+export function opSubmit(operationId) {
+    let operation = protocolRepo.getOperation(operationId);
+    if (!validateOperationTransition(operation.status, OperationStatus.SUBMITTED)) {
+        throw new InvalidStateTransitionError("operation", operation.status, OperationStatus.SUBMITTED);
+    }
+    operation = protocolRepo.updateOperation(operationId, {
+        status: OperationStatus.SUBMITTED,
+    });
+    logEvent(EventType.OPERATION_SUBMITTED, "operation", operationId, "");
+    return opCheck(operationId);
+}
+/**
+ * Run validators on an operation.
+ */
+export function opCheck(operationId) {
+    const operation = protocolRepo.getOperation(operationId);
+    // Collect claims for the actor
+    const actorClaims = protocolRepo.listActiveResourceClaims({
+        sessionId: operation.sessionId || undefined,
+    }).filter(c => c.actorId === operation.actorId);
+    const allActiveClaims = protocolRepo.listActiveResourceClaims({
+        sessionId: operation.sessionId || undefined,
+    });
+    const items = runOperationValidation({
+        operation,
+        actorClaims,
+        allActiveClaims,
+    });
+    // Run Constraint Runtime evaluation
+    const constraintViolations = runConstraintCheck(operation, "operation_submit");
+    if (constraintViolations.length > 0) {
+        items.push({
+            check: "constraint_runtime",
+            passed: false,
+            detail: `Blocked by ${constraintViolations.length} constraint violation(s): ${constraintViolations.map(v => v.rule).join(", ")}`,
+        });
+    }
+    const allPassed = items.every(i => i.passed);
+    const checkResult = {
+        allPassed,
+        items,
+        targetResources: operation.targetResources,
+        uncoveredResources: [],
+        conflictingClaimIds: [],
+        ...(constraintViolations.length > 0 ? { constraintViolations } : {}),
+    };
+    // Auto-move to CONFLICTING if checks fail
+    let status = operation.status;
+    if (!allPassed && operation.status === OperationStatus.SUBMITTED) {
+        status = OperationStatus.CONFLICTING;
+    }
+    const updated = protocolRepo.updateOperation(operationId, {
+        checkResult,
+        status,
+    });
+    logEvent(EventType.OPERATION_CHECKED, "operation", operationId, JSON.stringify({ allPassed }));
+    return { operation: updated, checkResult };
+}
+/**
+ * Approve a submitted operation.
+ */
+export function opApprove(operationId, actorId, summary) {
+    const operation = protocolRepo.getOperation(operationId);
+    if (!validateOperationTransition(operation.status, OperationStatus.APPROVED)) {
+        throw new InvalidStateTransitionError("operation", operation.status, OperationStatus.APPROVED);
+    }
+    const updated = protocolRepo.updateOperation(operationId, {
+        status: OperationStatus.APPROVED,
+        decisionSummary: summary ?? `Approved by ${actorId}`,
+    });
+    logEvent(EventType.OPERATION_APPROVED, "operation", operationId, JSON.stringify({ actorId, summary: summary ?? "" }));
+    return updated;
+}
+/**
+ * Reject a submitted operation.
+ */
+export function opReject(operationId, actorId, reason) {
+    const operation = protocolRepo.getOperation(operationId);
+    if (!validateOperationTransition(operation.status, OperationStatus.REJECTED)) {
+        throw new InvalidStateTransitionError("operation", operation.status, OperationStatus.REJECTED);
+    }
+    const updated = protocolRepo.updateOperation(operationId, {
+        status: OperationStatus.REJECTED,
+        decisionSummary: reason ?? `Rejected by ${actorId}`,
+    });
+    logEvent(EventType.OPERATION_REJECTED, "operation", operationId, JSON.stringify({ actorId, reason: reason ?? "" }));
+    return updated;
+}
+/**
+ * Mark an approved operation as applied.
+ * Runs a final constraint check (action: "operation_apply") before allowing apply.
+ */
+export function opApply(operationId) {
+    const operation = protocolRepo.getOperation(operationId);
+    if (!validateOperationTransition(operation.status, OperationStatus.APPLIED)) {
+        throw new InvalidStateTransitionError("operation", operation.status, OperationStatus.APPLIED);
+    }
+    // Final constraint check before apply
+    const violations = runConstraintCheck(operation, "operation_apply");
+    if (violations.length > 0) {
+        throw new ConstraintViolationError(violations.map(v => v.rule), `Cannot apply operation ${operationId}: ${violations.map(v => v.message).join("; ")}`);
+    }
+    const updated = protocolRepo.updateOperation(operationId, {
+        status: OperationStatus.APPLIED,
+    });
+    logEvent(EventType.OPERATION_APPLIED, "operation", operationId, "");
+    return updated;
+}
+/**
+ * Cancel an operation.
+ */
+export function opCancel(operationId, reason) {
+    const operation = protocolRepo.getOperation(operationId);
+    if (!validateOperationTransition(operation.status, OperationStatus.CANCELLED)) {
+        throw new InvalidStateTransitionError("operation", operation.status, OperationStatus.CANCELLED);
+    }
+    const updated = protocolRepo.updateOperation(operationId, {
+        status: OperationStatus.CANCELLED,
+        decisionSummary: reason ?? "",
+    });
+    logEvent(EventType.OPERATION_CANCELLED, "operation", operationId, reason ?? "");
+    return updated;
+}
+/**
+ * Get operation status with parsed check result.
+ */
+export function opStatus(operationId) {
+    const operation = protocolRepo.getOperation(operationId);
+    return { operation, checkResult: operation.checkResult };
+}
+/**
+ * List operations with optional filters.
+ */
+export function opList(opts) {
+    return protocolRepo.listOperations(opts);
+}
+// ── Constraint Runtime Helper ─────────────────────────
+/**
+ * Run constraint runtime evaluation for an operation.
+ * Returns blockers (empty array = no violations).
+ * Fail-closed: returns a synthetic blocker when projection is unavailable.
+ */
+function runConstraintCheck(operation, action) {
+    try {
+        const touchedResources = operation.targetResources;
+        if (!touchedResources.length)
+            return [];
+        const projection = buildProjection({
+            taskId: operation.taskId,
+            workingResources: touchedResources.map(r => r.locator),
+        });
+        // touchedResources are already normalized by opCreate
+        const decision = evaluateConstraints({
+            action,
+            projection,
+            touchedResources,
+        });
+        return decision.blockers;
+    }
+    catch (err) {
+        // Fail-closed: projection unavailable — block operation
+        return [{
+                rule: "projection_unavailable",
+                sourceMemoryId: "",
+                projectionId: "",
+                message: `Cannot evaluate constraints: projection unavailable (${err instanceof Error ? err.message : "unknown error"})`,
+            }];
+    }
+}
+//# sourceMappingURL=operation-service.js.map

package/dist/server/application/operation-service.js.map

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

package/dist/server/application/orchestration-service.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Orchestration Service — role orchestration use cases.
+ * CLI, MCP, and tRPC all share this layer.
+ */
+import type { OrchestrationSession, RoleProfile, TaskAssignment, ReviewRequest, ReviewDecision, OrchestratorRole, ReviewVerdict } from "../../adapters/index.js";
+import type { PreparedContext } from "../../context/index.js";
+export interface CreateSessionInput {
+    title: string;
+    description?: string;
+    relationshipMode?: string;
+    architectId?: string;
+    createdBy?: string;
+}
+export interface CreateSessionResult {
+    ok: true;
+    session: OrchestrationSession;
+    architectRole?: RoleProfile;
+}
+export interface AssignRoleInput {
+    sessionId: string;
+    agentId: string;
+    role: OrchestratorRole;
+    capabilities?: string;
+}
+export interface PlanTaskInput {
+    sessionId: string;
+    taskId: string;
+    assigneeAgentId: string;
+    assignedBy?: string;
+    notes?: string;
+}
+export interface RequestReviewInput {
+    sessionId: string;
+    taskId: string;
+    reviewerAgentId: string;
+    requestedBy?: string;
+    scope?: string;
+}
+export interface SubmitReviewInput {
+    reviewRequestId: string;
+    verdict: ReviewVerdict;
+    summary: string;
+    requestedChanges?: string;
+    decidedBy?: string;
+}
+export interface SessionStatusResult {
+    session: OrchestrationSession;
+    roles: RoleProfile[];
+    assignments: TaskAssignment[];
+    reviews: ReviewRequest[];
+    decisions: ReviewDecision[];
+}
+export interface AdvanceSessionResult {
+    session: OrchestrationSession;
+    transitioned: boolean;
+    reason: string;
+}
+/**
+ * Create a new orchestration session. Optionally assign architect role.
+ */
+export declare function orchCreateSession(input: CreateSessionInput): CreateSessionResult;
+/**
+ * Assign a role to an agent within a session.
+ */
+export declare function orchAssignRole(input: AssignRoleInput): RoleProfile;
+/**
+ * Plan a task: create assignment within a session.
+ * Also assigns the task to the agent via existing repo.
+ */
+export declare function orchPlanTask(input: PlanTaskInput): TaskAssignment;
+/**
+ * Accept a task assignment — agent confirms they will work on it.
+ */
+export declare function orchAcceptAssignment(assignmentId: string): TaskAssignment;
+/**
+ * Start working on an assigned task.
+ */
+export declare function orchStartAssignment(assignmentId: string): TaskAssignment;
+/**
+ * Complete a task assignment.
+ */
+export declare function orchCompleteAssignment(assignmentId: string): TaskAssignment;
+/**
+ * Request a review for a task.
+ */
+export declare function orchRequestReview(input: RequestReviewInput): ReviewRequest;
+/**
+ * Start a review (reviewer picks up the request).
+ */
+export declare function orchStartReview(reviewRequestId: string): ReviewRequest;
+/**
+ * Submit a review decision.
+ */
+export declare function orchSubmitReview(input: SubmitReviewInput): {
+    decision: ReviewDecision;
+    reviewRequest: ReviewRequest;
+};
+/**
+ * Get full session status with all roles, assignments, reviews, decisions.
+ */
+export declare function orchGetSessionStatus(sessionId: string): SessionStatusResult;
+/**
+ * Advance session status based on current state of assignments and reviews.
+ */
+export declare function orchAdvanceSession(sessionId: string): AdvanceSessionResult;
+/**
+ * Prepare reviewer context for a task within a session, reusing Context Policy.
+ */
+export declare function orchPrepareReviewContext(taskId: string, reviewerAgentId: string): PreparedContext;
+/**
+ * Cancel a session.
+ */
+export declare function orchCancelSession(sessionId: string): OrchestrationSession;
+//# sourceMappingURL=orchestration-service.d.ts.map

package/dist/server/application/orchestration-service.d.ts.map

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