syncpoint-ai 0.1.0

package/dist/adapters/orchestration.d.ts

@@ -0,0 +1,280 @@
+/**
+ * Orchestration types — role profiles, sessions, task assignments, reviews.
+ * This is the protocol layer for v0.7 Role Orchestration.
+ * It does NOT define context rules (that's context-policy.ts).
+ */
+import { z } from "zod";
+import { RelationshipMode } from "./relationship-mode.js";
+export declare const OrchestratorRole: z.ZodEnum<["architect", "executor", "reviewer", "owner"]>;
+export type OrchestratorRole = z.infer<typeof OrchestratorRole>;
+export declare enum SessionStatus {
+    PLANNING = "PLANNING",
+    EXECUTING = "EXECUTING",
+    REVIEWING = "REVIEWING",
+    COMPLETED = "COMPLETED",
+    CANCELLED = "CANCELLED"
+}
+export declare const ReviewVerdict: z.ZodEnum<["approved", "request-changes", "rejected"]>;
+export type ReviewVerdict = z.infer<typeof ReviewVerdict>;
+export declare enum TaskAssignmentStatus {
+    PROPOSED = "PROPOSED",
+    ACCEPTED = "ACCEPTED",
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    CANCELLED = "CANCELLED"
+}
+export declare enum ReviewRequestStatus {
+    PENDING = "PENDING",
+    IN_PROGRESS = "IN_PROGRESS",
+    DECIDED = "DECIDED",
+    CANCELLED = "CANCELLED"
+}
+export declare const RoleProfileSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    agentId: z.ZodString;
+    role: z.ZodEnum<["architect", "executor", "reviewer", "owner"]>;
+    capabilities: z.ZodDefault<z.ZodString>;
+    assignedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    sessionId: string;
+    agentId: string;
+    role: "architect" | "executor" | "reviewer" | "owner";
+    capabilities: string;
+    assignedAt: string;
+}, {
+    id: string;
+    sessionId: string;
+    agentId: string;
+    role: "architect" | "executor" | "reviewer" | "owner";
+    assignedAt: string;
+    capabilities?: string | undefined;
+}>;
+export type RoleProfile = z.infer<typeof RoleProfileSchema>;
+export declare const RoleProfileCreateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    agentId: z.ZodString;
+    role: z.ZodEnum<["architect", "executor", "reviewer", "owner"]>;
+    capabilities: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    agentId: string;
+    role: "architect" | "executor" | "reviewer" | "owner";
+    capabilities: string;
+}, {
+    sessionId: string;
+    agentId: string;
+    role: "architect" | "executor" | "reviewer" | "owner";
+    capabilities?: string | undefined;
+}>;
+export type RoleProfileCreate = z.infer<typeof RoleProfileCreateSchema>;
+export declare const OrchestrationSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodNativeEnum<typeof SessionStatus>>;
+    relationshipMode: z.ZodDefault<z.ZodNativeEnum<typeof RelationshipMode>>;
+    architectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: SessionStatus;
+    id: string;
+    createdAt: string;
+    description: string;
+    updatedAt: string;
+    title: string;
+    createdBy: string;
+    relationshipMode: RelationshipMode;
+    architectId: string | null;
+}, {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    title: string;
+    status?: SessionStatus | undefined;
+    description?: string | undefined;
+    createdBy?: string | undefined;
+    relationshipMode?: RelationshipMode | undefined;
+    architectId?: string | null | undefined;
+}>;
+export type OrchestrationSession = z.infer<typeof OrchestrationSessionSchema>;
+export declare const OrchestrationSessionCreateSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    relationshipMode: z.ZodDefault<z.ZodNativeEnum<typeof RelationshipMode>>;
+    architectId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    createdBy: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    title: string;
+    createdBy: string;
+    relationshipMode: RelationshipMode;
+    architectId: string | null;
+}, {
+    title: string;
+    description?: string | undefined;
+    createdBy?: string | undefined;
+    relationshipMode?: RelationshipMode | undefined;
+    architectId?: string | null | undefined;
+}>;
+export type OrchestrationSessionCreate = z.infer<typeof OrchestrationSessionCreateSchema>;
+export declare const TaskAssignmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    assigneeAgentId: z.ZodString;
+    assignedBy: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodNativeEnum<typeof TaskAssignmentStatus>>;
+    notes: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: TaskAssignmentStatus;
+    id: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    notes: string;
+    assigneeAgentId: string;
+    assignedBy: string;
+}, {
+    id: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    assigneeAgentId: string;
+    status?: TaskAssignmentStatus | undefined;
+    notes?: string | undefined;
+    assignedBy?: string | undefined;
+}>;
+export type TaskAssignment = z.infer<typeof TaskAssignmentSchema>;
+export declare const TaskAssignmentCreateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    assigneeAgentId: z.ZodString;
+    assignedBy: z.ZodDefault<z.ZodString>;
+    notes: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    sessionId: string;
+    notes: string;
+    assigneeAgentId: string;
+    assignedBy: string;
+}, {
+    taskId: string;
+    sessionId: string;
+    assigneeAgentId: string;
+    notes?: string | undefined;
+    assignedBy?: string | undefined;
+}>;
+export type TaskAssignmentCreate = z.infer<typeof TaskAssignmentCreateSchema>;
+export declare const ReviewRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    reviewerAgentId: z.ZodString;
+    requestedBy: z.ZodDefault<z.ZodString>;
+    scope: z.ZodDefault<z.ZodString>;
+    status: z.ZodDefault<z.ZodNativeEnum<typeof ReviewRequestStatus>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: ReviewRequestStatus;
+    id: string;
+    scope: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    requestedBy: string;
+    reviewerAgentId: string;
+}, {
+    id: string;
+    taskId: string;
+    sessionId: string;
+    createdAt: string;
+    updatedAt: string;
+    reviewerAgentId: string;
+    status?: ReviewRequestStatus | undefined;
+    scope?: string | undefined;
+    requestedBy?: string | undefined;
+}>;
+export type ReviewRequest = z.infer<typeof ReviewRequestSchema>;
+export declare const ReviewRequestCreateSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    taskId: z.ZodString;
+    reviewerAgentId: z.ZodString;
+    requestedBy: z.ZodDefault<z.ZodString>;
+    scope: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    taskId: string;
+    sessionId: string;
+    requestedBy: string;
+    reviewerAgentId: string;
+}, {
+    taskId: string;
+    sessionId: string;
+    reviewerAgentId: string;
+    scope?: string | undefined;
+    requestedBy?: string | undefined;
+}>;
+export type ReviewRequestCreate = z.infer<typeof ReviewRequestCreateSchema>;
+export declare const ReviewDecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    reviewRequestId: z.ZodString;
+    verdict: z.ZodEnum<["approved", "request-changes", "rejected"]>;
+    summary: z.ZodString;
+    requestedChanges: z.ZodDefault<z.ZodString>;
+    decidedBy: z.ZodDefault<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    summary: string;
+    reviewRequestId: string;
+    requestedChanges: string;
+    decidedBy: string;
+    verdict: "approved" | "rejected" | "request-changes";
+}, {
+    id: string;
+    createdAt: string;
+    summary: string;
+    reviewRequestId: string;
+    verdict: "approved" | "rejected" | "request-changes";
+    requestedChanges?: string | undefined;
+    decidedBy?: string | undefined;
+}>;
+export type ReviewDecision = z.infer<typeof ReviewDecisionSchema>;
+export declare const ReviewDecisionCreateSchema: z.ZodObject<{
+    reviewRequestId: z.ZodString;
+    verdict: z.ZodEnum<["approved", "request-changes", "rejected"]>;
+    summary: z.ZodString;
+    requestedChanges: z.ZodDefault<z.ZodString>;
+    decidedBy: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    reviewRequestId: string;
+    requestedChanges: string;
+    decidedBy: string;
+    verdict: "approved" | "rejected" | "request-changes";
+}, {
+    summary: string;
+    reviewRequestId: string;
+    verdict: "approved" | "rejected" | "request-changes";
+    requestedChanges?: string | undefined;
+    decidedBy?: string | undefined;
+}>;
+export type ReviewDecisionCreate = z.infer<typeof ReviewDecisionCreateSchema>;
+export declare const SESSION_TRANSITIONS: Record<SessionStatus, SessionStatus[]>;
+export declare const TASK_ASSIGNMENT_TRANSITIONS: Record<TaskAssignmentStatus, TaskAssignmentStatus[]>;
+export declare const REVIEW_REQUEST_TRANSITIONS: Record<ReviewRequestStatus, ReviewRequestStatus[]>;
+export declare function validateSessionTransition(current: SessionStatus, target: SessionStatus): void;
+export declare function validateTaskAssignmentTransition(current: TaskAssignmentStatus, target: TaskAssignmentStatus): void;
+export declare function validateReviewRequestTransition(current: ReviewRequestStatus, target: ReviewRequestStatus): void;
+//# sourceMappingURL=orchestration.d.ts.map

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

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

package/dist/adapters/orchestration.js

@@ -0,0 +1,176 @@
+/**
+ * Orchestration types — role profiles, sessions, task assignments, reviews.
+ * This is the protocol layer for v0.7 Role Orchestration.
+ * It does NOT define context rules (that's context-policy.ts).
+ */
+import { z } from "zod";
+import { RelationshipMode } from "./relationship-mode.js";
+// ── Enums ────────────────────────────────────────────
+export const OrchestratorRole = z.enum([
+    "architect",
+    "executor",
+    "reviewer",
+    "owner",
+]);
+export var SessionStatus;
+(function (SessionStatus) {
+    SessionStatus["PLANNING"] = "PLANNING";
+    SessionStatus["EXECUTING"] = "EXECUTING";
+    SessionStatus["REVIEWING"] = "REVIEWING";
+    SessionStatus["COMPLETED"] = "COMPLETED";
+    SessionStatus["CANCELLED"] = "CANCELLED";
+})(SessionStatus || (SessionStatus = {}));
+export const ReviewVerdict = z.enum([
+    "approved",
+    "request-changes",
+    "rejected",
+]);
+export var TaskAssignmentStatus;
+(function (TaskAssignmentStatus) {
+    TaskAssignmentStatus["PROPOSED"] = "PROPOSED";
+    TaskAssignmentStatus["ACCEPTED"] = "ACCEPTED";
+    TaskAssignmentStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    TaskAssignmentStatus["COMPLETED"] = "COMPLETED";
+    TaskAssignmentStatus["CANCELLED"] = "CANCELLED";
+})(TaskAssignmentStatus || (TaskAssignmentStatus = {}));
+export var ReviewRequestStatus;
+(function (ReviewRequestStatus) {
+    ReviewRequestStatus["PENDING"] = "PENDING";
+    ReviewRequestStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    ReviewRequestStatus["DECIDED"] = "DECIDED";
+    ReviewRequestStatus["CANCELLED"] = "CANCELLED";
+})(ReviewRequestStatus || (ReviewRequestStatus = {}));
+// ── Schemas ──────────────────────────────────────────
+const nanoid12 = z.string().min(1).max(24);
+const isoDate = z.string().datetime({ offset: true });
+// ── RoleProfile ──────────────────────────────────────
+export const RoleProfileSchema = z.object({
+    id: nanoid12,
+    sessionId: nanoid12,
+    agentId: nanoid12,
+    role: OrchestratorRole,
+    capabilities: z.string().default(""),
+    assignedAt: isoDate,
+});
+export const RoleProfileCreateSchema = z.object({
+    sessionId: nanoid12,
+    agentId: nanoid12,
+    role: OrchestratorRole,
+    capabilities: z.string().default(""),
+});
+// ── OrchestrationSession ─────────────────────────────
+export const OrchestrationSessionSchema = z.object({
+    id: nanoid12,
+    title: z.string().min(1),
+    description: z.string().default(""),
+    status: z.nativeEnum(SessionStatus).default(SessionStatus.PLANNING),
+    relationshipMode: z.nativeEnum(RelationshipMode).default(RelationshipMode.MANAGER_DELEGATE),
+    architectId: nanoid12.nullable().default(null),
+    createdBy: z.string().default(""),
+    createdAt: isoDate,
+    updatedAt: isoDate,
+});
+export const OrchestrationSessionCreateSchema = z.object({
+    title: z.string().min(1),
+    description: z.string().default(""),
+    relationshipMode: z.nativeEnum(RelationshipMode).default(RelationshipMode.MANAGER_DELEGATE),
+    architectId: nanoid12.nullable().default(null),
+    createdBy: z.string().default(""),
+});
+// ── TaskAssignment ───────────────────────────────────
+export const TaskAssignmentSchema = z.object({
+    id: nanoid12,
+    sessionId: nanoid12,
+    taskId: nanoid12,
+    assigneeAgentId: nanoid12,
+    assignedBy: z.string().default(""),
+    status: z.nativeEnum(TaskAssignmentStatus).default(TaskAssignmentStatus.PROPOSED),
+    notes: z.string().default(""),
+    createdAt: isoDate,
+    updatedAt: isoDate,
+});
+export const TaskAssignmentCreateSchema = z.object({
+    sessionId: nanoid12,
+    taskId: nanoid12,
+    assigneeAgentId: nanoid12,
+    assignedBy: z.string().default(""),
+    notes: z.string().default(""),
+});
+// ── ReviewRequest ────────────────────────────────────
+export const ReviewRequestSchema = z.object({
+    id: nanoid12,
+    sessionId: nanoid12,
+    taskId: nanoid12,
+    reviewerAgentId: nanoid12,
+    requestedBy: z.string().default(""),
+    scope: z.string().default(""),
+    status: z.nativeEnum(ReviewRequestStatus).default(ReviewRequestStatus.PENDING),
+    createdAt: isoDate,
+    updatedAt: isoDate,
+});
+export const ReviewRequestCreateSchema = z.object({
+    sessionId: nanoid12,
+    taskId: nanoid12,
+    reviewerAgentId: nanoid12,
+    requestedBy: z.string().default(""),
+    scope: z.string().default(""),
+});
+// ── ReviewDecision ───────────────────────────────────
+export const ReviewDecisionSchema = z.object({
+    id: nanoid12,
+    reviewRequestId: nanoid12,
+    verdict: ReviewVerdict,
+    summary: z.string().min(1),
+    requestedChanges: z.string().default(""),
+    decidedBy: z.string().default(""),
+    createdAt: isoDate,
+});
+export const ReviewDecisionCreateSchema = z.object({
+    reviewRequestId: nanoid12,
+    verdict: ReviewVerdict,
+    summary: z.string().min(1),
+    requestedChanges: z.string().default(""),
+    decidedBy: z.string().default(""),
+});
+// ── State Transitions ────────────────────────────────
+export const SESSION_TRANSITIONS = {
+    [SessionStatus.PLANNING]: [SessionStatus.EXECUTING, SessionStatus.CANCELLED],
+    [SessionStatus.EXECUTING]: [SessionStatus.REVIEWING, SessionStatus.PLANNING, SessionStatus.CANCELLED],
+    [SessionStatus.REVIEWING]: [SessionStatus.EXECUTING, SessionStatus.COMPLETED, SessionStatus.CANCELLED],
+    [SessionStatus.COMPLETED]: [],
+    [SessionStatus.CANCELLED]: [],
+};
+export const TASK_ASSIGNMENT_TRANSITIONS = {
+    [TaskAssignmentStatus.PROPOSED]: [TaskAssignmentStatus.ACCEPTED, TaskAssignmentStatus.CANCELLED],
+    [TaskAssignmentStatus.ACCEPTED]: [TaskAssignmentStatus.IN_PROGRESS, TaskAssignmentStatus.CANCELLED],
+    [TaskAssignmentStatus.IN_PROGRESS]: [TaskAssignmentStatus.COMPLETED, TaskAssignmentStatus.CANCELLED],
+    [TaskAssignmentStatus.COMPLETED]: [],
+    [TaskAssignmentStatus.CANCELLED]: [],
+};
+export const REVIEW_REQUEST_TRANSITIONS = {
+    [ReviewRequestStatus.PENDING]: [ReviewRequestStatus.IN_PROGRESS, ReviewRequestStatus.CANCELLED],
+    [ReviewRequestStatus.IN_PROGRESS]: [ReviewRequestStatus.DECIDED, ReviewRequestStatus.CANCELLED],
+    [ReviewRequestStatus.DECIDED]: [],
+    [ReviewRequestStatus.CANCELLED]: [],
+};
+// ── Validation ───────────────────────────────────────
+import { InvalidTransition } from "./states.js";
+export function validateSessionTransition(current, target) {
+    const allowed = SESSION_TRANSITIONS[current];
+    if (!allowed.includes(target)) {
+        throw new InvalidTransition("session", current, target);
+    }
+}
+export function validateTaskAssignmentTransition(current, target) {
+    const allowed = TASK_ASSIGNMENT_TRANSITIONS[current];
+    if (!allowed.includes(target)) {
+        throw new InvalidTransition("task_assignment", current, target);
+    }
+}
+export function validateReviewRequestTransition(current, target) {
+    const allowed = REVIEW_REQUEST_TRANSITIONS[current];
+    if (!allowed.includes(target)) {
+        throw new InvalidTransition("review_request", current, target);
+    }
+}
+//# sourceMappingURL=orchestration.js.map

package/dist/adapters/orchestration.js.map

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

package/dist/adapters/playbook-engine.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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 { PlaybookActionKind } from "../kernel/index.js";
+import type { ApprovalGateResult } from "../kernel/index.js";
+import { RelationshipMode } from "./relationship-mode.js";
+export { PlaybookActionKind };
+export declare const NextActionSchema: z.ZodObject<{
+    action: 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"]>;
+    reason: z.ZodString;
+    /** CLI command suggestion */
+    cliHint: z.ZodString;
+    /** MCP tool suggestion */
+    mcpToolHint: z.ZodString;
+    /** Priority: 1 = immediate, 2 = soon, 3 = optional */
+    priority: z.ZodNumber;
+    /** Entity IDs relevant to this action */
+    targetIds: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    action: "checkpoint" | "handoff" | "plan-tasks" | "assign-roles" | "advance-session" | "accept-assignment" | "start-work" | "complete-assignment" | "address-changes" | "start-review" | "add-checklist" | "add-evidence" | "evaluate-gate" | "approve-review" | "block-review" | "request-review" | "claim-resources" | "sync-checkpoint" | "wait" | "session-completed" | "no-action";
+    mcpToolHint: string;
+    cliHint: string;
+    priority: number;
+    targetIds: Record<string, string>;
+}, {
+    reason: string;
+    action: "checkpoint" | "handoff" | "plan-tasks" | "assign-roles" | "advance-session" | "accept-assignment" | "start-work" | "complete-assignment" | "address-changes" | "start-review" | "add-checklist" | "add-evidence" | "evaluate-gate" | "approve-review" | "block-review" | "request-review" | "claim-resources" | "sync-checkpoint" | "wait" | "session-completed" | "no-action";
+    mcpToolHint: string;
+    cliHint: string;
+    priority: number;
+    targetIds?: Record<string, string> | undefined;
+}>;
+export type NextAction = z.infer<typeof NextActionSchema>;
+export interface SessionSnapshot {
+    sessionId: string;
+    sessionStatus: SessionStatus;
+    agentId: string;
+    agentRoles: string[];
+    assignments: Array<{
+        id: string;
+        taskId: string;
+        assigneeAgentId: string;
+        status: TaskAssignmentStatus;
+    }>;
+    reviews: Array<{
+        id: string;
+        taskId: string;
+        reviewerAgentId: string;
+        status: ReviewRequestStatus;
+    }>;
+    /** Per-review gate status (only for reviews assigned to this agent) */
+    gates: Record<string, ApprovalGateResult>;
+    /** Open change request count per review request */
+    openChanges: Record<string, number>;
+    /** Relationship mode for this session (optional, defaults to manager-delegate) */
+    relationshipMode?: RelationshipMode;
+    /** Task IDs for which this agent already has active file claims */
+    activeClaimTaskIds?: string[];
+}
+/**
+ * Compute the next recommended action(s) for an agent within a session.
+ * Returns actions sorted by priority (most urgent first).
+ */
+export declare function computeNextActions(snap: SessionSnapshot): NextAction[];
+//# sourceMappingURL=playbook-engine.d.ts.map

package/dist/adapters/playbook-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-engine.d.ts","sourceRoot":"","sources":["../../_build/src/adapters/playbook-engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAsB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAwC,MAAM,wBAAwB,CAAC;AAIhG,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAI9B,eAAO,MAAM,gBAAgB;;;IAG3B,6BAA6B;;IAE7B,0BAA0B;;IAE1B,sDAAsD;;IAEtD,yCAAyC;;;;;;;;;;;;;;;;EAEzC,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAI1D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,WAAW,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,oBAAoB,CAAC;KAC9B,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,MAAM,EAAE,mBAAmB,CAAC;KAC7B,CAAC,CAAC;IAEH,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAE1C,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEpC,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,EAAE,CAmRtE"}