@aifabrix/builder 2.54.1 → 2.55.0

package/lib/schema/role-assistant-test-case.schema.json

@@ -0,0 +1,408 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "aifabrix://schema/role-assistant-test-case",
+  "title": "Role Assistant Test Case",
+  "description": "Nested Role Assistant YAML cases (caseId, input, answers, expected).",
+  "type": "object",
+  "required": ["caseId"],
+  "additionalProperties": false,
+  "properties": {
+    "caseId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "input": { "$ref": "#/$defs/inputObject" },
+    "answers": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/waitResponse" }
+    },
+    "approvals": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/waitResponse" }
+    },
+    "preflight": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "evidence": { "$ref": "#/$defs/evidenceObject" }
+      }
+    },
+    "expected": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "soft": { "type": "boolean" },
+        "softNotes": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              { "type": "string" },
+              { "type": "object" }
+            ]
+          }
+        },
+        "honesty": { "$ref": "#/$defs/honestyObject" },
+        "lifecycleState": {
+          "type": "string",
+          "enum": [
+            "completed",
+            "question",
+            "approval-required",
+            "dependency",
+            "safe-stop",
+            "rejected",
+            "failed"
+          ]
+        },
+        "capabilities": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "allowed": { "$ref": "#/$defs/stringList" },
+            "required": { "$ref": "#/$defs/stringList" },
+            "forbidden": { "$ref": "#/$defs/stringList" }
+          }
+        },
+        "search": { "$ref": "#/$defs/searchObject" },
+        "skills": { "$ref": "#/$defs/skillsObject" },
+        "evidence": { "$ref": "#/$defs/evidenceObject" },
+        "bid": { "$ref": "#/$defs/bidObject" },
+        "facts": { "$ref": "#/$defs/openObject" },
+        "prohibited": {
+          "type": "array"
+        }
+      }
+    },
+    "metadata": { "$ref": "#/$defs/openObject" }
+  },
+  "$defs": {
+    "openObject": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "stringList": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "waitWhen": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "questionKey": { "type": "string" },
+        "requestKey": { "type": "string" },
+        "key": { "type": "string" },
+        "waitReason": { "type": "string" },
+        "capability": { "type": "string" }
+      }
+    },
+    "waitResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["when", "value"],
+      "properties": {
+        "when": { "$ref": "#/$defs/waitWhen" },
+        "value": {}
+      }
+    },
+    "inputObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "executionPath": {
+          "type": "string",
+          "enum": ["workHub", "work", "work.start", "intent", "search", "skills"]
+        },
+        "businessRoleRef": { "type": "string" },
+        "roleRef": { "type": "string" },
+        "digitalWorkerKey": { "type": "string" },
+        "assistantName": { "type": "string" },
+        "sourceType": { "type": "string" },
+        "message": { "type": "string" },
+        "content": {},
+        "text": { "type": "string" },
+        "prompt": { "type": "string" },
+        "objective": { "type": "string" },
+        "attachments": {},
+        "openapiDir": { "type": "string" },
+        "openapiFiles": { "type": "array" },
+        "comVocabulary": {},
+        "comModelRef": { "type": "string" },
+        "comModelVersion": { "type": "string" },
+        "sourceLanguage": { "type": "string" },
+        "responseLanguage": { "type": "string" },
+        "sourceMetadata": { "type": "object" },
+        "submissionId": { "type": "string" },
+        "activationId": { "type": "string" },
+        "workerTaskId": { "type": "string" },
+        "principalRef": { "type": "string" },
+        "certifyPillar": { "type": "string" },
+        "pillar": { "type": "string" },
+        "systemKey": { "type": "string" },
+        "targetSystemKey": { "type": "string" },
+        "integrationSystemKey": { "type": "string" },
+        "stampSuiteBid": { "type": "boolean" },
+        "suiteRunId": { "type": "string" },
+        "emittedBidPath": { "type": "string" },
+        "bidPath": { "type": "string" },
+        "emitBidFromAnswers": { "type": "boolean" },
+        "connectionRefs": { "type": "object" },
+        "openapiSourceRefs": { "type": "object" },
+        "requestedDepth": { "type": "string" },
+        "format": { "type": "string" },
+        "resourceType": { "type": "string" },
+        "operation": { "type": "string" },
+        "filters": { "type": "object" },
+        "fields": { "type": "array" },
+        "page": { "type": "number" },
+        "pageSize": { "type": "number" },
+        "graph": { "$ref": "#/$defs/searchGraph" },
+        "query": { "type": "string", "minLength": 1 },
+        "knowledgeKeys": { "$ref": "#/$defs/stringList" }
+      },
+      "allOf": [
+        {
+          "if": {
+            "anyOf": [
+              { "not": { "required": ["executionPath"] } },
+              {
+                "required": ["executionPath"],
+                "properties": {
+                  "executionPath": {
+                    "enum": ["workHub", "work", "work.start", "intent"]
+                  }
+                }
+              }
+            ]
+          },
+          "then": { "$ref": "#/$defs/inputWorkForbidsSearchKeys" }
+        },
+        {
+          "if": {
+            "required": ["executionPath"],
+            "properties": { "executionPath": { "const": "search" } }
+          },
+          "then": {
+            "allOf": [
+              { "$ref": "#/$defs/inputSearchForbidsWorkKeys" },
+              { "$ref": "#/$defs/inputSearchQueryRequiresGraph" }
+            ]
+          }
+        },
+        {
+          "if": {
+            "required": ["executionPath"],
+            "properties": { "executionPath": { "const": "skills" } }
+          },
+          "then": { "$ref": "#/$defs/inputSkillsForbidsWorkAndSearchKeys" }
+        }
+      ]
+    },
+    "inputWorkForbidsSearchKeys": {
+      "properties": {
+        "resourceType": false,
+        "operation": false,
+        "filters": false,
+        "fields": false,
+        "page": false,
+        "pageSize": false,
+        "graph": false,
+        "query": false,
+        "knowledgeKeys": false
+      }
+    },
+    "inputSearchForbidsWorkKeys": {
+      "properties": {
+        "message": false,
+        "content": false,
+        "text": false,
+        "prompt": false,
+        "objective": false,
+        "attachments": false,
+        "openapiDir": false,
+        "openapiFiles": false,
+        "comVocabulary": false,
+        "comModelRef": false,
+        "comModelVersion": false,
+        "sourceLanguage": false,
+        "responseLanguage": false,
+        "sourceMetadata": false,
+        "submissionId": false,
+        "activationId": false,
+        "workerTaskId": false,
+        "principalRef": false,
+        "certifyPillar": false,
+        "pillar": false,
+        "systemKey": false,
+        "targetSystemKey": false,
+        "integrationSystemKey": false,
+        "stampSuiteBid": false,
+        "suiteRunId": false,
+        "emittedBidPath": false,
+        "bidPath": false,
+        "emitBidFromAnswers": false,
+        "connectionRefs": false,
+        "openapiSourceRefs": false,
+        "requestedDepth": false,
+        "format": false
+      }
+    },
+    "inputSkillsForbidsWorkAndSearchKeys": {
+      "properties": {
+        "message": false,
+        "content": false,
+        "text": false,
+        "prompt": false,
+        "objective": false,
+        "attachments": false,
+        "openapiDir": false,
+        "openapiFiles": false,
+        "comVocabulary": false,
+        "comModelRef": false,
+        "comModelVersion": false,
+        "sourceLanguage": false,
+        "responseLanguage": false,
+        "sourceMetadata": false,
+        "submissionId": false,
+        "activationId": false,
+        "workerTaskId": false,
+        "principalRef": false,
+        "certifyPillar": false,
+        "pillar": false,
+        "systemKey": false,
+        "targetSystemKey": false,
+        "integrationSystemKey": false,
+        "stampSuiteBid": false,
+        "suiteRunId": false,
+        "emittedBidPath": false,
+        "bidPath": false,
+        "emitBidFromAnswers": false,
+        "connectionRefs": false,
+        "openapiSourceRefs": false,
+        "requestedDepth": false,
+        "format": false,
+        "operation": false,
+        "filters": false,
+        "fields": false,
+        "page": false,
+        "pageSize": false,
+        "graph": false,
+        "query": false,
+        "knowledgeKeys": false
+      }
+    },
+    "searchGraph": {
+      "oneOf": [
+        { "type": "boolean" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["depth"],
+          "properties": {
+            "depth": { "type": "integer", "const": 1 }
+          }
+        }
+      ]
+    },
+    "inputSearchQueryRequiresGraph": {
+      "if": {
+        "anyOf": [
+          { "required": ["query"] },
+          {
+            "required": ["knowledgeKeys"],
+            "properties": {
+              "knowledgeKeys": { "minItems": 1 }
+            }
+          }
+        ]
+      },
+      "then": {
+        "required": ["graph"],
+        "properties": {
+          "graph": { "not": { "const": false } }
+        }
+      }
+    },
+    "honestyObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "requireWorkResult": { "type": "boolean" },
+        "schemaVersion": { "type": "string" },
+        "requireCompletion": { "type": "boolean" },
+        "requireContributionObservation": { "type": "boolean" },
+        "minResourceChanges": { "type": "number" },
+        "softResourceChanges": { "type": "boolean" },
+        "forbidBuilderKeysInObjective": { "type": "boolean" }
+      }
+    },
+    "searchObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "statusCode": { "type": "number" },
+        "operation": { "type": "string" },
+        "resultMode": { "type": "string" },
+        "minRows": { "type": "number" },
+        "errorContains": { "type": "string" },
+        "graphDepth": { "type": "number" },
+        "relatedTypes": { "$ref": "#/$defs/stringList" },
+        "related": { "$ref": "#/$defs/searchRelatedObject" }
+      }
+    },
+    "searchRelatedHop": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "minRows": { "type": "number" },
+        "resultMode": { "type": "string" }
+      }
+    },
+    "searchRelatedObject": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": { "$ref": "#/$defs/searchRelatedHop" }
+    },
+    "skillsObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "resourceType": { "type": "string" },
+        "operations": { "$ref": "#/$defs/stringList" },
+        "filterFields": { "$ref": "#/$defs/stringList" },
+        "operationRequired": { "type": "boolean" }
+      }
+    },
+    "evidenceObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "requiredKeys": { "$ref": "#/$defs/stringList" },
+        "roleKey": { "type": "string" },
+        "resourceType": { "type": "string" },
+        "requireStatus": { "type": "string" }
+      }
+    },
+    "bidCapability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["datasource", "key"],
+      "properties": {
+        "datasource": { "type": "string", "minLength": 1 },
+        "key": { "type": "string", "minLength": 1 }
+      }
+    },
+    "bidObject": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "schemaName": { "type": "string" },
+        "schemaVersion": { "type": "string" },
+        "requireDefinitionHash": { "type": "boolean" },
+        "requireSuiteRunId": { "type": "boolean" },
+        "forbidGoldPaths": { "type": "boolean" },
+        "minDatasources": { "$ref": "#/$defs/stringList" },
+        "requireCapability": { "$ref": "#/$defs/bidCapability" }
+      }
+    }
+  }
+}

package/lib/search/dataplane-context.js

@@ -0,0 +1,23 @@
+/**
+ * Dataplane auth/url resolution for search commands.
+ *
+ * @fileoverview Thin wrapper over protection dataplane context
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { resolveProtectionDataplaneContext } = require('../protection/auth-context');
+
+/**
+ * @param {Object} [options]
+ * @returns {Promise<{ environment: string, controllerUrl: string, dataplaneUrl: string, authConfig: Object }>}
+ */
+async function resolveSearchDataplaneContext(options = {}) {
+  return resolveProtectionDataplaneContext(options);
+}
+
+module.exports = {
+  resolveSearchDataplaneContext
+};

package/lib/search/search-args.js

@@ -0,0 +1,211 @@
+/**
+ * Map CLI flags onto the published work.search request body.
+ *
+ * @fileoverview Flag parse/merge for aifabrix search (fail closed)
+ * @author AI Fabrix Team
+ * @version 1.0.0
+ */
+
+'use strict';
+
+const { SearchCliError } = require('./search-errors');
+
+/**
+ * @param {...*} values
+ * @returns {string}
+ */
+function firstTrimmed(...values) {
+  for (const value of values) {
+    if (typeof value === 'string' && value.trim()) {
+      return value.trim();
+    }
+  }
+  return '';
+}
+
+/**
+ * @param {Object} options
+ * @returns {string}
+ */
+function roleRefFromOptions(options) {
+  return firstTrimmed(options && options.role, options && options.roleRef);
+}
+
+/**
+ * @param {Object} options
+ * @returns {string}
+ */
+function resourceTypeFromOptions(options) {
+  return firstTrimmed(options && options.resourceType, options && options.type);
+}
+
+/**
+ * @param {string} raw
+ * @param {string} label
+ * @returns {Object}
+ */
+function parseJsonObject(raw, label) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new SearchCliError(`${label} must be a JSON object.`);
+  }
+  if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+    throw new SearchCliError(`${label} must be a JSON object.`);
+  }
+  return parsed;
+}
+
+/**
+ * @param {string} filePath
+ * @param {string} label
+ * @param {{ readFileSync: Function }} fsApi
+ * @returns {Object}
+ */
+function readJsonObjectFile(filePath, label, fsApi) {
+  let raw;
+  try {
+    raw = fsApi.readFileSync(filePath, 'utf8');
+  } catch {
+    throw new SearchCliError(`Cannot read ${label}: ${filePath}`);
+  }
+  return parseJsonObject(String(raw), label);
+}
+
+/**
+ * @param {Object} options
+ * @param {{ readFileSync: Function }} fsApi
+ * @returns {Object|undefined}
+ */
+function resolveFilters(options, fsApi) {
+  const inline = options && options.filters;
+  const filePath = options && options.filtersFile;
+  if (inline && filePath) {
+    throw new SearchCliError('Use either --filters or --filters-file, not both.');
+  }
+  if (inline) {
+    return parseJsonObject(String(inline), '--filters');
+  }
+  if (filePath) {
+    return readJsonObjectFile(filePath, '--filters-file', fsApi);
+  }
+  return undefined;
+}
+
+/**
+ * @param {*} value
+ * @param {string} label
+ * @param {number} min
+ * @param {number} [max]
+ * @returns {number|undefined}
+ */
+function parseBoundedInt(value, label, min, max) {
+  if (value === undefined || value === null || value === '') {
+    return undefined;
+  }
+  const n = Number(value);
+  const inMax = max === undefined || n <= max;
+  if (!Number.isInteger(n) || n < min || !inMax) {
+    const range = max === undefined ? `≥ ${min}` : `${min}–${max}`;
+    throw new SearchCliError(`${label} must be an integer ${range}.`);
+  }
+  return n;
+}
+
+/**
+ * @param {*} csv
+ * @returns {string[]|undefined}
+ */
+function parseFieldsCsv(csv) {
+  if (csv === undefined || csv === null || csv === '') {
+    return undefined;
+  }
+  const fields = String(csv)
+    .split(',')
+    .map((part) => part.trim())
+    .filter(Boolean);
+  return fields.length ? fields : undefined;
+}
+
+/**
+ * @param {*} value
+ * @returns {string[]|undefined}
+ */
+function parseKnowledgeKeys(value) {
+  const raw = Array.isArray(value) ? value : value ? [value] : [];
+  const keys = raw.map((item) => String(item || '').trim()).filter(Boolean);
+  return keys.length ? keys : undefined;
+}
+
+/**
+ * @param {Object} body
+ * @param {Object} options
+ * @param {{ readFileSync: Function }} fsApi
+ */
+function assignFlagFields(body, options, fsApi) {
+  const roleRef = roleRefFromOptions(options);
+  const resourceType = resourceTypeFromOptions(options);
+  const operation = firstTrimmed(options && options.operation);
+  if (roleRef) body.roleRef = roleRef;
+  if (resourceType) body.resourceType = resourceType;
+  if (operation) body.operation = operation;
+  const filters = resolveFilters(options, fsApi);
+  if (filters) body.filters = filters;
+  const page = parseBoundedInt(options && options.page, '--page', 1);
+  if (page !== undefined) body.page = page;
+  const pageSize = parseBoundedInt(options && options.pageSize, '--page-size', 1, 100);
+  if (pageSize !== undefined) body.pageSize = pageSize;
+  if (typeof (options && options.sort) === 'string' && options.sort.trim()) {
+    body.sort = options.sort.trim();
+  }
+}
+
+/**
+ * @param {Object} body
+ * @param {Object} options
+ */
+function assignOptionalSearchFields(body, options) {
+  const fields = parseFieldsCsv(options && options.fields);
+  if (fields) body.fields = fields;
+  if (options && options.graph === true) {
+    body.graph = { depth: 1 };
+  }
+  if (typeof (options && options.query) === 'string' && options.query.trim()) {
+    body.query = options.query.trim();
+  }
+  const knowledgeKeys = parseKnowledgeKeys(options && options.knowledgeKey);
+  if (knowledgeKeys) body.knowledgeKeys = knowledgeKeys;
+}
+
+/**
+ * Flags first, then --body file (file wins on conflict). Local-only; no HTTP.
+ *
+ * @param {Object} options
+ * @param {{ readFileSync: Function }} fsApi
+ * @returns {Object}
+ */
+function buildSearchBody(options, fsApi) {
+  const body = {};
+  assignFlagFields(body, options, fsApi);
+  assignOptionalSearchFields(body, options);
+  const bodyFile = options && options.body;
+  if (bodyFile) {
+    const fromFile = readJsonObjectFile(bodyFile, '--body', fsApi);
+    Object.assign(body, fromFile);
+  }
+  return body;
+}
+
+module.exports = {
+  firstTrimmed,
+  roleRefFromOptions,
+  resourceTypeFromOptions,
+  parseJsonObject,
+  readJsonObjectFile,
+  resolveFilters,
+  parseBoundedInt,
+  parseFieldsCsv,
+  parseKnowledgeKeys,
+  buildSearchBody
+};