@bpmsoftwaresolutions/ai-engine-client 1.1.71 → 1.1.74

package/src/constants/agent-communications.js

@@ -0,0 +1,40 @@
+export const AGENT_COMMUNICATION_CONTRACT_VERSION = 'v1';
+export const AGENT_COMMUNICATION_THREAD_TYPES = ['request', 'review', 'handoff', 'coordination', 'task', 'escalation'];
+export const AGENT_COMMUNICATION_MESSAGE_KINDS = [
+  'request',
+  'response',
+  'review',
+  'handoff',
+  'blocker',
+  'evidence',
+  'decision_request',
+  'task_request',
+  'review_request',
+  'evidence_response',
+];
+export const AGENT_COMMUNICATION_TRANSFER_KINDS = [
+  'upstream_remediation',
+  'review_request',
+  'handoff',
+  'coordination',
+  'evidence_delivery',
+];
+export const AGENT_COMMUNICATION_TRANSFER_MODES = ['bundle', 'artifact_refs', 'inline_payload'];
+export const AGENT_COMMUNICATION_TRANSFER_LIFECYCLE_STATES = [
+  'created',
+  'delivered',
+  'accepted',
+  'in_progress',
+  'responded',
+  'closed',
+  'failed',
+  'superseded',
+];
+export const AGENT_COMMUNICATION_TRANSFER_RECEIPT_TYPES = [
+  'delivery_receipt',
+  'acceptance_receipt',
+  'evidence_receipt',
+  'closure_receipt',
+  'failure_receipt',
+];
+export const AGENT_COMMUNICATION_RECIPIENT_MODES = ['role', 'agent_session'];

package/src/constants/client.js

@@ -0,0 +1,18 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const PACKAGE_JSON_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
+
+export const DEFAULT_TIMEOUT_MS = 30000;
+
+export function readPackageVersion() {
+  const packageJson = JSON.parse(fs.readFileSync(PACKAGE_JSON_PATH, 'utf8'));
+  const version = String(packageJson.version || '').trim();
+  if (!version) {
+    throw new Error(`Missing package version in ${PACKAGE_JSON_PATH}.`);
+  }
+  return version;
+}
+
+export const AI_ENGINE_CLIENT_VERSION = readPackageVersion();

package/src/constants/governance.js

@@ -0,0 +1,17 @@
+export const GOVERNED_MUTATION_REQUIRED_CAPABILITIES = [
+  'executeVerifiedMutation',
+  'post_mutation_verification',
+  'acceptance_check_read',
+  'artifact_manifest_read',
+  'decision_packet_read',
+  'claim_signoff',
+];
+
+export const AI_ENGINE_CLIENT_CAPABILITIES = [
+  ...GOVERNED_MUTATION_REQUIRED_CAPABILITIES,
+  'execution_eligibility_read',
+  'project_delivery_facade',
+  'workflow_resume_context_read',
+];
+
+export const TASK_BOUND_SUBSTRATE_EXECUTION_POLICY = 'task_bound_substrate_execution/v1';

package/src/constants/loga.js

@@ -0,0 +1,4 @@
+export const LOGA_CONTRACT = 'ai-engine-ui/v1';
+export const LOGA_INTERACTION_CONTRACT = 'loga-choreography/v1';
+export const LOGA_NAVIGATION_CONTRACT = 'loga-navigation/v1';
+export const LOGA_PROJECTION_WORKFLOW = 'loga-document-projection';

package/src/domains/actions.js

@@ -0,0 +1,5 @@
+export function createActionsDomain(client) {
+  return {
+    submit: (request) => client.submitActionIntent(request),
+  };
+}

package/src/domains/benchmarks.js

@@ -0,0 +1,13 @@
+export function createBenchmarksDomain(client) {
+  return {
+    getSessionPerformanceMetrics: (request) => client.getSessionPerformanceMetrics(request),
+    captureBenchmarkSnapshot: (body) => client.captureBenchmarkSnapshot(body),
+    listBenchmarks: (request) => client.listBenchmarks(request),
+    getBenchmarkMetrics: (benchmarkName) => client.getBenchmarkMetrics(benchmarkName),
+    getBenchmarkDelta: (request) => client.getBenchmarkDelta(request),
+    getBenchmarkTrend: (request) => client.getBenchmarkTrend(request),
+    getPerformanceDashboard: (request) => client.getPerformanceDashboard(request),
+    listRecentBenchmarkRuns: (request) => client.listRecentBenchmarkRuns(request),
+    getBenchmarkRun: (benchmarkRunId) => client.getBenchmarkRun(benchmarkRunId),
+  };
+}

package/src/domains/capabilities.js

@@ -0,0 +1,7 @@
+export function createCapabilitiesDomain(client) {
+  return {
+    listCapabilities: () => client.listCapabilities(),
+    createCapability: (body) => client.createCapability(body),
+    testCapability: (capabilityId, body) => client.testCapability(capabilityId, body),
+  };
+}

package/src/domains/context-assembly.js

@@ -0,0 +1,10 @@
+export function createContextAssemblyDomain(client) {
+  return {
+    getContextAssemblyContract: (workflowRunId, request) => client.getContextAssemblyContract(workflowRunId, request),
+    getContextAssemblyStatus: (workflowRunId, request) => client.getContextAssemblyStatus(workflowRunId, request),
+    getOperatorContext: (workflowRunId, request) => client.getOperatorContext(workflowRunId, request),
+    getContextFragments: (workflowRunId, request) => client.getContextFragments(workflowRunId, request),
+    getContextReuse: (workflowRunId, request) => client.getContextReuse(workflowRunId, request),
+    listPromptAssemblies: (workflowRunId) => client.listPromptAssemblies(workflowRunId),
+  };
+}

package/src/domains/database/backups.js

@@ -0,0 +1,11 @@
+export function createDatabaseBackupsDomain(client) {
+  return {
+    createDatabaseBackup: (request) => client.createDatabaseBackup(request),
+    listDatabaseBackups: (request) => client.listDatabaseBackups(request),
+    getDatabaseBackup: (request) => client.getDatabaseBackup(request),
+    listDatabaseBackupOperations: (request) => client.listDatabaseBackupOperations(request),
+    runAzureSqlBacpacBackup: (request) => client.runAzureSqlBacpacBackup(request),
+    listAzureSqlBacpacBackups: (request) => client.listAzureSqlBacpacBackups(request),
+    listAzureSqlBacpacBackupOperations: (request) => client.listAzureSqlBacpacBackupOperations(request),
+  };
+}

package/src/domains/database.js

@@ -0,0 +1,14 @@
+import { createDatabaseBackupsDomain } from './database/backups.js';
+
+export function createDatabaseDomain(client) {
+  return {
+    createDatabaseBackup: (request) => client.createDatabaseBackup(request),
+    listDatabaseBackups: (request) => client.listDatabaseBackups(request),
+    getDatabaseBackup: (request) => client.getDatabaseBackup(request),
+    listDatabaseBackupOperations: (request) => client.listDatabaseBackupOperations(request),
+    runAzureSqlBacpacBackup: (request) => client.runAzureSqlBacpacBackup(request),
+    listAzureSqlBacpacBackups: (request) => client.listAzureSqlBacpacBackups(request),
+    listAzureSqlBacpacBackupOperations: (request) => client.listAzureSqlBacpacBackupOperations(request),
+    backups: createDatabaseBackupsDomain(client),
+  };
+}

package/src/domains/design-intelligence.js

@@ -0,0 +1,16 @@
+export function createDesignIntelligenceDomain(client) {
+  return {
+    getDesignIntelligenceDashboard: () => client.getDesignIntelligenceDashboard(),
+    listDesignDecisions: () => client.listDesignDecisions(),
+    getDesignDecision: (decisionId) => client.getDesignDecision(decisionId),
+    getDesignDecisionVariants: (decisionId) => client.getDesignDecisionVariants(decisionId),
+    getDesignDecisionCritique: (decisionId) => client.getDesignDecisionCritique(decisionId),
+    getDesignDecisionLineage: (decisionId) => client.getDesignDecisionLineage(decisionId),
+    listDesignPatterns: () => client.listDesignPatterns(),
+    getDecisionLabCanvas: () => client.getDecisionLabCanvas(),
+    getDesignRecommendations: () => client.getDesignRecommendations(),
+    getDesignPromotions: () => client.getDesignPromotions(),
+    previewDesignPromotion: (body) => client.previewDesignPromotion(body),
+    getDesignIntelligenceMetrics: () => client.getDesignIntelligenceMetrics(),
+  };
+}

package/src/domains/execution-telemetry.js

@@ -0,0 +1,8 @@
+export function createExecutionTelemetryDomain(client) {
+  return {
+    getCurrent: () => client.getExecutionTelemetryCurrent(),
+    listProcessRuns: (request) => client.listExecutionProcessRuns(request),
+    getProcessRun: (processRunId) => client.getExecutionProcessRun(processRunId),
+    getGeneratedExecutionUsability: (request) => client.getGeneratedExecutionUsability(request),
+  };
+}

package/src/domains/gateway.js

@@ -0,0 +1,8 @@
+export function createGatewayDomain(client) {
+  return {
+    query: (request) => client.query(request),
+    runReportDefinition: (request) => client.runReportDefinition(request),
+    renderProjection: (request) => client.renderProjection(request),
+    submitActionIntent: (request) => client.submitActionIntent(request),
+  };
+}

package/src/domains/health.js

@@ -0,0 +1,5 @@
+export function createHealthDomain(client) {
+  return {
+    ping: () => client.ping(),
+  };
+}

package/src/domains/implementation-tasks.js

@@ -0,0 +1,10 @@
+export function createImplementationTasksDomain(client) {
+  return {
+    createImplementationTask: (implementationItemId, request) => client.createImplementationTask(implementationItemId, request),
+    listImplementationTasks: (implementationItemId) => client.listImplementationTasks(implementationItemId),
+    listImplementationSubtasks: (taskId) => client.listImplementationSubtasks(taskId),
+    updateImplementationTask: (taskId, updates) => client.updateImplementationTask(taskId, updates),
+    assignImplementationTask: (taskId, request) => client.assignImplementationTask(taskId, request),
+    completeImplementationTask: (taskId, request) => client.completeImplementationTask(taskId, request),
+  };
+}

package/src/domains/loga.js

@@ -0,0 +1,13 @@
+export function createLogaDomain(client) {
+  return {
+    submitUxGateRemediation: (payload) => client.submitUxGateRemediation(payload),
+    listUxGateRemediations: (query) => client.listUxGateRemediations(query),
+    getUxGateRemediation: (remediationId) => client.getUxGateRemediation(remediationId),
+    appendUxRemediationTicketNote: (remediationId, payload) => client.appendUxRemediationTicketNote(remediationId, payload),
+    listUxRemediationTicketNotes: (remediationId) => client.listUxRemediationTicketNotes(remediationId),
+    promoteUxGateRemediationImplementationCandidate: (remediationId, payload) =>
+      client.promoteUxGateRemediationImplementationCandidate(remediationId, payload),
+    getUxGateRemediationProjection: (remediationId) => client.getLogaUxGateRemediationProjection(remediationId),
+    getGeneratedExecutionUsabilityProjection: (query) => client.getLogaGeneratedExecutionUsabilityProjection(query),
+  };
+}

package/src/domains/notes-lab.js

@@ -0,0 +1,7 @@
+export function createNotesLabDomain(client) {
+  return {
+    getNotesLabConfig: () => client.getNotesLabConfig(),
+    submitNote: (body) => client.submitNote(body),
+    approveNoteReview: (body) => client.approveNoteReview(body),
+  };
+}

package/src/domains/operator/current-project.js

@@ -0,0 +1,5 @@
+export function createCurrentProjectDomain(client) {
+  return {
+    currentProjectStatus: (request) => client.currentProjectStatus(request),
+  };
+}

package/src/domains/operator-status.js

@@ -0,0 +1,15 @@
+export function createOperatorStatusDomain(client) {
+  return {
+    currentWorkflowStatus: () => client.currentWorkflowStatus(),
+    currentArchitectureIntegrityStatus: () => client.currentArchitectureIntegrityStatus(),
+    currentSecurityGovernanceStatus: (request) => client.currentSecurityGovernanceStatus(request),
+    getExecutionTelemetryCurrent: () => client.getExecutionTelemetryCurrent(),
+    listExecutionProcessRuns: (request) => client.listExecutionProcessRuns(request),
+    getExecutionProcessRun: (processRunId) => client.getExecutionProcessRun(processRunId),
+    getGeneratedExecutionUsability: (request) => client.getGeneratedExecutionUsability(request),
+    getLogaGeneratedExecutionUsabilityProjection: (request) => client.getLogaGeneratedExecutionUsabilityProjection(request),
+    getAntiPatternRules: () => client.getAntiPatternRules(),
+    currentCodebaseShapeStatus: () => client.currentCodebaseShapeStatus(),
+    getLatestMemoryProjection: () => client.getLatestMemoryProjection(),
+  };
+}

package/src/domains/performance.js

@@ -0,0 +1,8 @@
+export function createPerformanceDomain(client) {
+  return {
+    getSessionPerformanceMetrics: (request) => client.getSessionPerformanceMetrics(request),
+    getBenchmarkDelta: (request) => client.getBenchmarkDelta(request),
+    getBenchmarkTrend: (request) => client.getBenchmarkTrend(request),
+    getPerformanceDashboard: (request) => client.getPerformanceDashboard(request),
+  };
+}

package/src/domains/projections.js

@@ -0,0 +1,13 @@
+export function createProjectionsDomain(client) {
+  return {
+    render: (request) => client.renderProjection(request),
+    getTransferHomeProjection: () => client.getLogaTransferHomeProjection(),
+    getTransferInboxProjection: (query) => client.getLogaTransferInboxProjection(query),
+    getTransferPacketProjection: (workTransferPacketId) => client.getLogaTransferPacketProjection(workTransferPacketId),
+    getTransferChannelProjection: (transferChannelId) => client.getTransferChannelProjection(transferChannelId),
+    getTransferNegotiationEventsProjection: (query) => client.getLogaTransferNegotiationEventsProjection(query),
+    getTransferFrictionLaneProjection: (query) => client.getLogaTransferFrictionLaneProjection(query),
+    getTransferReceiptsProjection: (query) => client.getLogaTransferReceiptsProjection(query),
+    getTransferClosureReviewProjection: (workTransferPacketId) => client.getLogaTransferClosureReviewProjection(workTransferPacketId),
+  };
+}

package/src/domains/repo.js

@@ -0,0 +1,25 @@
+export function createRepoDomain(client) {
+  return {
+    listRepositories: (request) => client.listRepositories(request),
+    getRepository: (repositoryId) => client.getRepository(repositoryId),
+    listProjects: (request) => client.listProjects(request),
+    getProject: (projectId) => client.getProject(projectId),
+    listCodeFiles: (request) => client.listCodeFiles(request),
+    getCodeFile: (fileId) => client.getCodeFile(fileId),
+    getCodeFileContentWindow: (fileId, request) => client.getCodeFileContentWindow(fileId, request),
+    listCodeSymbolsByFile: (fileId, request) => client.listCodeSymbolsByFile(fileId, request),
+    getCodeSymbol: (symbolId, request) => client.getCodeSymbol(symbolId, request),
+    searchSymbols: (request) => client.searchSymbols(request),
+    getSymbolRelationships: (symbolId, request) => client.getSymbolRelationships(symbolId, request),
+    listCodeRelationships: (request) => client.listCodeRelationships(request),
+    listActionObservations: (request) => client.listActionObservations(request),
+    listCodebaseShapeFindings: (request) => client.listCodebaseShapeFindings(request),
+    listObjectFlowObservations: (request) => client.listObjectFlowObservations(request),
+    getChangeAnalysis: (request) => client.getChangeAnalysis(request),
+    listRefactorCandidates: (request) => client.listRefactorCandidates(request),
+    analyzeRefactorCandidate: (request) => client.analyzeRefactorCandidate(request),
+    getRepoRetrievalPacket: (retrievalPacketId) => client.getRepoRetrievalPacket(retrievalPacketId),
+    getRepoRetrievalPacketFragments: (retrievalPacketId) => client.getRepoRetrievalPacketFragments(retrievalPacketId),
+    evaluateProposalScope: (request) => client.evaluateProposalScope(request),
+  };
+}

package/src/domains/reports.js

@@ -0,0 +1,5 @@
+export function createReportsDomain(client) {
+  return {
+    run: (request) => client.runReportDefinition(request),
+  };
+}

package/src/domains/retrieval-management.js

@@ -0,0 +1,14 @@
+export function createRetrievalManagementDomain(client) {
+  return {
+    getRetrievalStatus: () => client.getRetrievalStatus(),
+    getRetrievalProfileMetrics: () => client.getRetrievalProfileMetrics(),
+    getRetrievalFeedbackMetrics: () => client.getRetrievalFeedbackMetrics(),
+    getRetrievalQuery: (retrievalQueryId) => client.getRetrievalQuery(retrievalQueryId),
+    getRetrievalPacket: (retrievalPacketId) => client.getRetrievalPacket(retrievalPacketId),
+    generateRetrievalCandidates: (body) => client.generateRetrievalCandidates(body),
+    selectRetrievalPacket: (body) => client.selectRetrievalPacket(body),
+    recordRetrievalFeedback: (body) => client.recordRetrievalFeedback(body),
+    deriveRetrievalOptimizationCandidates: (body) => client.deriveRetrievalOptimizationCandidates(body),
+    validatePromptAssembly: (body) => client.validatePromptAssembly(body),
+  };
+}

package/src/domains/retrieval-wrapper.js

@@ -0,0 +1,7 @@
+export function createRetrievalWrapperDomain(client) {
+  return {
+    getCommandCard: (request) => client.getCommandCard(request),
+    getSymbolDefinition: (request) => client.getSymbolDefinition(request),
+    getRelatedCode: (request) => client.getRelatedCode(request),
+  };
+}

package/src/domains/script-discovery.js

@@ -0,0 +1,9 @@
+export function createScriptDiscoveryDomain(client) {
+  return {
+    scanScripts: (body) => client.scanScripts(body),
+    listDiscoveredScriptAssets: (request) => client.listDiscoveredScriptAssets(request),
+    listDiscoveredCapabilities: (request) => client.listDiscoveredCapabilities(request),
+    listWorkflowCandidates: (request) => client.listWorkflowCandidates(request),
+    promoteWorkflowCandidate: (workflowCandidateId, body) => client.promoteWorkflowCandidate(workflowCandidateId, body),
+  };
+}

package/src/domains/scripts.js

@@ -0,0 +1,8 @@
+export function createScriptsDomain(client) {
+  return {
+    generate: (payload) => client.generateScript(payload),
+    render: (scriptId) => client.renderScript(scriptId),
+    submitArtifact: (scriptId, payload) => client.submitScriptArtifact(scriptId, payload),
+    getRunEvidence: (query) => client.getScriptRunEvidence(query),
+  };
+}

package/src/domains/search-contacts.js

@@ -0,0 +1,7 @@
+export function createSearchContactsDomain(client) {
+  return {
+    search: (query) => client.search(query),
+    getOrganization: (entityId) => client.getOrganization(entityId),
+    getContact: (contactId) => client.getContact(contactId),
+  };
+}

package/src/domains/self-learning.js

@@ -0,0 +1,10 @@
+export function createSelfLearningDomain(client) {
+  return {
+    getSelfLearningPosture: (request) => client.getSelfLearningPosture(request),
+    listLearningRecords: (request) => client.listLearningRecords(request),
+    getLearningRecord: (learningRecordId) => client.getLearningRecord(learningRecordId),
+    listPromotionCandidates: (request) => client.listPromotionCandidates(request),
+    getPromotionCandidate: (candidateKey) => client.getPromotionCandidate(candidateKey),
+    listPromotionFlows: (request) => client.listPromotionFlows(request),
+  };
+}

package/src/domains/self-optimization.js

@@ -0,0 +1,8 @@
+export function createSelfOptimizationDomain(client) {
+  return {
+    getSelfOptimizationDashboard: () => client.getSelfOptimizationDashboard(),
+    getSelfOptimizationCandidateQueue: (request) => client.getSelfOptimizationCandidateQueue(request),
+    getSelfOptimizationBacklogPosture: (request) => client.getSelfOptimizationBacklogPosture(request),
+    getSelfOptimizationPendingHandoffs: (request) => client.getSelfOptimizationPendingHandoffs(request),
+  };
+}

package/src/domains/skill-governance.js

@@ -0,0 +1,7 @@
+export function createSkillGovernanceDomain(client) {
+  return {
+    createSkillGovernanceChange: (body) => client.createSkillGovernanceChange(body),
+    listSkillGovernanceChanges: (request) => client.listSkillGovernanceChanges(request),
+    getSkillGovernanceChange: (governanceChangeId) => client.getSkillGovernanceChange(governanceChangeId),
+  };
+}

package/src/domains/skills.js

@@ -0,0 +1,13 @@
+export function createSkillsDomain(client) {
+  return {
+    currentSkillRegistryStatus: () => client.currentSkillRegistryStatus(),
+    getSkillContract: (request) => client.getSkillContract(request),
+    getSkillGovernance: (request) => client.getSkillGovernance(request),
+    createSkillContractDraft: (body) => client.createSkillContractDraft(body),
+    recordSkillPatternReview: (skillVersionId, body) => client.recordSkillPatternReview(skillVersionId, body),
+    approveSkillContract: (skillVersionId, body) => client.approveSkillContract(skillVersionId, body),
+    createWorkflowSkillContract: (body) => client.createWorkflowSkillContract(body),
+    listWorkflowSkillBindings: (workflowId, request) => client.listWorkflowSkillBindings(workflowId, request),
+    seedFrequentOperationSkills: (request) => client.seedFrequentOperationSkills(request),
+  };
+}

package/src/domains/tool-registry.js

@@ -0,0 +1,14 @@
+export function createToolRegistryDomain(client) {
+  return {
+    currentToolRegistryStatus: () => client.currentToolRegistryStatus(),
+    getWorkflowToolRegistry: (request) => client.getWorkflowToolRegistry(request),
+    currentAssistantToolContext: () => client.currentAssistantToolContext(),
+    getTool: (toolKey) => client.getTool(toolKey),
+    getToolHistory: (toolKey) => client.getToolHistory(toolKey),
+    getToolInvocations: (toolKey) => client.getToolInvocations(toolKey),
+    getToolGovernance: (toolKey) => client.getToolGovernance(toolKey),
+    getToolEventReplayBundle: (toolEventSummaryId) => client.getToolEventReplayBundle(toolEventSummaryId),
+    createToolReviewDecision: (toolKey, body) => client.createToolReviewDecision(toolKey, body),
+    createToolGateDecision: (toolKey, body) => client.createToolGateDecision(toolKey, body),
+  };
+}