@bpmsoftwaresolutions/ai-engine-client 1.1.71 → 1.1.73

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/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/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/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/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/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/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),
+  };
+}