@bpmsoftwaresolutions/ai-engine-client 1.1.85 → 1.1.87

package/src/domains/workflows.js

@@ -0,0 +1,99 @@
+export function createWorkflowsDomain(client) {
+  return {
+    listWorkflows({ status, includeSteps } = {}) {
+      return client._request('/api/workflows', {
+        query: { status, include_steps: includeSteps },
+      });
+    },
+
+    createWorkflow({ name, slug, description, goal, governanceProfile, steps = [] } = {}) {
+      return client._request('/api/workflows', {
+        method: 'POST',
+        body: { name, slug, description, goal, governance_profile: governanceProfile, steps },
+      });
+    },
+
+    getWorkflow(workflowId) {
+      return client._request(`/api/workflows/${workflowId}`);
+    },
+
+    replaceWorkflowSteps(workflowId, steps) {
+      return client._request(`/api/workflows/${workflowId}/steps`, { method: 'PUT', body: { steps } });
+    },
+
+    publishWorkflow(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/publish`, { method: 'POST' });
+    },
+
+    cloneWorkflow(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/clone`, { method: 'POST' });
+    },
+
+    evaluateWorkflowGovernance(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/evaluate`, { method: 'POST' });
+    },
+
+    listWorkflowGovernanceDecisions(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/decisions`);
+    },
+
+    getWorkflowGovernanceSimulation(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/simulation`);
+    },
+
+    listWorkflowGovernanceBundles(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/bundles`);
+    },
+
+    listWorkflowGovernanceApprovals(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/approvals`);
+    },
+
+    listWorkflowGovernanceEvents(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/events`);
+    },
+
+    getWorkflowGovernanceReview(workflowId) {
+      return client._request(`/api/workflows/${workflowId}/governance/review`);
+    },
+
+    createWorkflowGovernanceReviewDecision(workflowId, body) {
+      return client._request(`/api/workflows/${workflowId}/governance/review-decisions`, {
+        method: 'POST',
+        body,
+      });
+    },
+
+    createWorkflowRun(body) {
+      return client._request('/api/workflow-runs', { method: 'POST', body });
+    },
+
+    getWorkflowRun(workflowRunId) {
+      return client._request(`/api/workflow-runs/${workflowRunId}`);
+    },
+
+    listWorkflowArtifacts(workflowRunId) {
+      return client._request(`/api/workflow-runs/${workflowRunId}/artifacts`);
+    },
+
+    getWorkflowRunSubstrate(workflowRunId) {
+      return client._request(`/api/workflow-runs/${workflowRunId}/substrate`);
+    },
+
+    getWorkflowPlayback(workflowRunId) {
+      return client._request(`/api/operator/workflow-runs/${workflowRunId}/playback`);
+    },
+
+    resumeWorkflowRun(workflowRunId, body = {}) {
+      return client._request(`/api/workflow-runs/${workflowRunId}/resume`, { method: 'POST', body });
+    },
+
+    listRecentInspectorRuns({ limit } = {}) {
+      return client._request('/api/workflow-inspector/runs/recent', { query: { limit } });
+    },
+
+    inspectWorkflowRun(workflowRunId) {
+      return client._request(`/api/workflow-inspector/runs/${workflowRunId}`);
+    },
+  };
+}

package/src/index.js

@@ -1,5 +1,5 @@
 export { AIEngineClient, createAIEngineClient } from './client.js';
-export const AI_ENGINE_CLIENT_VERSION = '1.1.85';
+export const AI_ENGINE_CLIENT_VERSION = '1.1.87';
 export { GOVERNED_MUTATION_REQUIRED_CAPABILITIES, AI_ENGINE_CLIENT_CAPABILITIES, TASK_BOUND_SUBSTRATE_EXECUTION_POLICY } from './constants/governance.js';
 export { LOGA_CONTRACT, LOGA_INTERACTION_CONTRACT, LOGA_NAVIGATION_CONTRACT, LOGA_PROJECTION_WORKFLOW } from './constants/loga.js';
 export {

package/src/utils/communication.js

@@ -0,0 +1,92 @@
+import {
+  AGENT_COMMUNICATION_MESSAGE_KINDS,
+  AGENT_COMMUNICATION_RECIPIENT_MODES,
+  AGENT_COMMUNICATION_THREAD_TYPES,
+  AGENT_COMMUNICATION_TRANSFER_KINDS,
+  AGENT_COMMUNICATION_TRANSFER_LIFECYCLE_STATES,
+  AGENT_COMMUNICATION_TRANSFER_MODES,
+  AGENT_COMMUNICATION_TRANSFER_RECEIPT_TYPES,
+} from '../constants/agent-communications.js';
+
+function normalizeEnum(value, allowedValues, fallback, label, aliases = {}) {
+  const text = String(value || '').trim();
+  if (!text) return fallback;
+  const normalized = aliases[text.toLowerCase()] || text;
+  if (allowedValues.includes(normalized)) return normalized;
+  const lower = normalized.toLowerCase();
+  const match = allowedValues.find((item) => item.toLowerCase() === lower);
+  if (match) return match;
+  throw new Error(`Invalid ${label || 'value'}: ${value}`);
+}
+
+export function cleanText(value) {
+  const text = String(value || '').trim();
+  return text || null;
+}
+
+export function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function normalizeThreadType(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_THREAD_TYPES, 'coordination', 'thread_type', {
+    task_request: 'request',
+    task: 'request',
+    review_request: 'review',
+    handoff_request: 'handoff',
+  });
+}
+
+export function normalizeMessageKind(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_MESSAGE_KINDS, 'request', 'message_kind', {
+    task: 'request',
+    note: 'request',
+    update: 'response',
+  });
+}
+
+export function normalizeConnectionFirstMessageKind(value, transferKind) {
+  const text = cleanText(value);
+  if (!text) return normalizeMessageKind(transferKind === 'handoff' ? 'handoff' : 'request');
+  const normalized = text.toLowerCase();
+  const aliases = {
+    connection_request: 'request',
+    connection_accepted: 'response',
+    connection_acceptance: 'response',
+    handoff_request: 'handoff',
+    handoff_acceptance: 'response',
+    handoff_response: 'response',
+    acceptance: 'response',
+    decline: 'response',
+  };
+  const candidate = aliases[normalized] || text;
+  try {
+    return normalizeMessageKind(candidate);
+  } catch (error) {
+    void error;
+    return normalizeMessageKind(transferKind === 'handoff' ? 'handoff' : 'request');
+  }
+}
+
+export function normalizeTransferKind(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_TRANSFER_KINDS, 'upstream_remediation', 'transfer_kind', {
+    remediation_request: 'upstream_remediation',
+    review: 'review_request',
+  });
+}
+
+export function normalizeTransferMode(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_TRANSFER_MODES, 'inline_payload', 'transfer_mode');
+}
+
+export function normalizeTransferLifecycleStatus(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_TRANSFER_LIFECYCLE_STATES, 'created', 'lifecycle_status');
+}
+
+export function normalizeTransferReceiptType(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_TRANSFER_RECEIPT_TYPES, 'delivery_receipt', 'receipt_type');
+}
+
+export function normalizeRecipientMode(value) {
+  return normalizeEnum(value, AGENT_COMMUNICATION_RECIPIENT_MODES, 'role', 'recipient_mode');
+}