@kortexya/reasoninglayer 0.4.1 → 0.5.0

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/config.ts
-var SDK_VERSION = "0.4.1";
+var SDK_VERSION = "0.5.0";
 function resolveConfig(config) {
   if (!config.baseUrl) {
     throw new Error("ClientConfig.baseUrl is required");
@@ -7389,6 +7389,32 @@ var Rag = class {
   });
 };
 
+// src/api-spec/generated/Osfql.ts
+var Osfql = class {
+  http;
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * @description Parses, compiles, and executes an OSFQL program against the caller's tenant-isolated knowledge base. Supports all OSFQL statement types: MATCH, INSERT, RETRACT, DERIVE, UNIFY, AWAIT, COUNTERFACTUAL, CAUSES. # Examples ```json { "query": "INSERT person(name: \"Alice\", age: 30);" } ``` ```json { "query": "MATCH person(name: ?N, age: ?A) WHERE ?A > 18;" } ```
+   *
+   * @tags osfql
+   * @name ExecuteOsfql
+   * @summary Execute an OSFQL program.
+   * @request POST:/api/v1/osfql
+   * @secure
+   */
+  executeOsfql = (data, params = {}) => this.http.request({
+    path: `/api/v1/osfql`,
+    method: "POST",
+    body: data,
+    secure: true,
+    type: "application/json" /* Json */,
+    format: "json",
+    ...params
+  });
+};
+
 // src/resources/sorts.ts
 var SortsClient = class {
   /** @internal */
@@ -13560,6 +13586,165 @@ function extractNumericValue(features, featureName) {
   return null;
 }
 
+// src/resources/osfql.ts
+var OsfqlClient = class {
+  /** @internal */
+  api;
+  /** @internal */
+  constructor(api) {
+    this.api = api;
+  }
+  /**
+   * Execute an OSFQL program.
+   *
+   * @param query - The OSFQL program text (one or more statements separated by `;`).
+   * @returns The execution result including variable bindings, produced term IDs,
+   *   defined sort IDs, diagnostics, and statement count.
+   * @throws {ApiError} If the request fails.
+   *
+   * @remarks
+   * The query is parsed, compiled, and executed against the caller's tenant-isolated
+   * knowledge base. Results include variable bindings from MATCH queries and IDs of
+   * any terms or sorts created by INSERT, DERIVE, or DEFINE statements.
+   *
+   * @example
+   * ```typescript
+   * // Insert a record and query it back
+   * const result = await client.osfql.execute(
+   *   'INSERT person(name: "Alice", age: 30); MATCH person(name: ?N);'
+   * );
+   * console.log(result.success);          // true
+   * console.log(result.bindings);         // [{ N: { type: "string", value: "Alice" } }]
+   * console.log(result.producedTermIds);  // ["<uuid>"]
+   * console.log(result.statementCount);   // 2
+   * ```
+   */
+  async execute(query) {
+    const response = await this.api.executeOsfql({ query });
+    return response.data;
+  }
+};
+
+// src/resources/conversation.ts
+var ConversationClient = class {
+  /** @internal */
+  http;
+  /** @internal */
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Send a natural language message and receive OSFQL-powered results.
+   *
+   * @param request - The conversation message request.
+   * @returns The assistant's response including generated OSFQL, query results, and suggestions.
+   * @throws {ApiError} If the request fails.
+   *
+   * @remarks
+   * The conversation service:
+   * 1. Classifies the intent (query, insert, define, etc.)
+   * 2. Generates OSFQL from the natural language
+   * 3. Executes the OSFQL against the knowledge base
+   * 4. Self-corrects up to 3 times if execution fails
+   * 5. Returns results + the generated OSFQL + suggestions
+   *
+   * Reuse `conversationId` from a previous response for multi-turn context.
+   *
+   * @example
+   * ```typescript
+   * // First message — starts a new conversation
+   * const first = await client.conversation.sendMessage({
+   *   message: 'Who are the prime suspects?',
+   * });
+   * console.log(first.osfqlExecuted);   // "PROVE prime_suspect(name: ?N, motive: ?M);"
+   * console.log(first.queryResults);    // [{ N: ..., M: ... }, ...]
+   *
+   * // Follow-up — reuses conversation context
+   * const followUp = await client.conversation.sendMessage({
+   *   message: 'Which of them had a key?',
+   *   conversationId: first.conversationId,
+   * });
+   * ```
+   */
+  async sendMessage(request) {
+    const response = await this.http.request({
+      path: "/api/v1/conversation/message",
+      method: "POST",
+      body: request,
+      secure: true,
+      type: "application/json" /* Json */,
+      format: "json"
+    });
+    return response.data;
+  }
+  /**
+   * List recent conversations for the authenticated user.
+   *
+   * @returns List of conversation summaries.
+   * @throws {ApiError} If the request fails.
+   *
+   * @example
+   * ```typescript
+   * const { conversations } = await client.conversation.listConversations();
+   * for (const c of conversations) {
+   *   console.log(`${c.id}: ${c.turnCount} turns (${c.createdAt})`);
+   * }
+   * ```
+   */
+  async listConversations() {
+    const response = await this.http.request({
+      path: "/api/v1/conversation/history",
+      method: "GET",
+      secure: true,
+      format: "json"
+    });
+    return response.data;
+  }
+  /**
+   * Get all turns for a conversation.
+   *
+   * @param conversationId - The conversation ID.
+   * @returns All turns in the conversation.
+   * @throws {ApiError} If the request fails.
+   *
+   * @example
+   * ```typescript
+   * const { turns } = await client.conversation.getTurns('conv-uuid');
+   * for (const turn of turns) {
+   *   console.log(`[${turn.role}] ${turn.content}`);
+   *   if (turn.osfql) console.log(`  OSFQL: ${turn.osfql}`);
+   * }
+   * ```
+   */
+  async getTurns(conversationId) {
+    const response = await this.http.request({
+      path: `/api/v1/conversation/${encodeURIComponent(conversationId)}/turns`,
+      method: "GET",
+      secure: true,
+      format: "json"
+    });
+    return response.data;
+  }
+  /**
+   * Delete a conversation and all its turns.
+   *
+   * @param conversationId - The conversation ID to delete.
+   * @throws {ApiError} If the request fails.
+   *
+   * @example
+   * ```typescript
+   * await client.conversation.deleteConversation('conv-uuid');
+   * ```
+   */
+  async deleteConversation(conversationId) {
+    await this.http.request({
+      path: `/api/v1/conversation/${encodeURIComponent(conversationId)}`,
+      method: "DELETE",
+      secure: true
+    });
+  }
+};
+
 // src/client.ts
 var ReasoningLayerClient = class {
   /** Sort (type hierarchy) operations. */
@@ -13648,6 +13833,10 @@ var ReasoningLayerClient = class {
   rag;
   /** Linear program optimization (CLP(Q) simplex solver via backward chaining). */
   optimize;
+  /** OSFQL (OSF Query Language) execution operations. */
+  osfql;
+  /** Conversational AI operations (NL → OSFQL with self-correction). */
+  conversation;
   // ─── Group Caches ─────────────────────────────────────────────────
   _core;
   _ai;
@@ -13823,6 +14012,7 @@ var ReasoningLayerClient = class {
     const generatedOntology = new Ontology(generatedHttp);
     const generatedGeneration = new Generation(generatedHttp);
     const generatedRag = new Rag(generatedHttp);
+    const generatedOsfql = new Osfql(generatedHttp);
     this.sorts = new SortsClient(generatedSorts, generatedTypes, resolved.tenantId);
     this.terms = new TermsClient(generatedTerms);
     this.inference = new InferenceClient(generatedInference, resolved.tenantId);
@@ -13866,6 +14056,8 @@ var ReasoningLayerClient = class {
     this.generation = new GenerationClient(generatedGeneration);
     this.rag = new RagClient(generatedRag);
     this.optimize = new OptimizeClient(generatedInference, generatedSorts, generatedQuery, generatedTerms, resolved.tenantId);
+    this.osfql = new OsfqlClient(generatedOsfql);
+    this.conversation = new ConversationClient(generatedHttp);
   }
 };
 
@@ -14007,6 +14199,12 @@ var ilp_exports = {};
 // src/types/plain-values.ts
 var plain_values_exports = {};
 
+// src/types/osfql.ts
+var osfql_exports = {};
+
+// src/types/conversation.ts
+var conversation_exports = {};
+
 // src/builders/value.ts
 var Value = {
   /**
@@ -14286,9 +14484,9 @@ var SortBuilder = class _SortBuilder {
    * @example
    * ```typescript
    * builder.boundConstraint({
-   *   constraint_type: "upper",
+   *   constraintType: "upper",
    *   target: "end_date",
-   *   source_path: "company.dissolutionDate",
+   *   sourcePath: "company.dissolutionDate",
    * })
    * ```
    */
@@ -14400,6 +14598,6 @@ function discriminateFeatureValue(value) {
   );
 }
 
-export { action_reviews_exports as ActionReviews, admin_exports as Admin, analysis_exports as Analysis, ApiError, AuthenticationError, BadRequestError, cdl_exports as CDL, causal_exports as Causal, cognitive_exports as Cognitive, collections_exports as Collections, communities_exports as Communities, ConstraintViolationError, constraints_exports as Constraints, control_exports as Control, discovery_exports as Discovery, execution_exports as Execution, extract_exports as Extract, ForbiddenError, functions_exports as Functions, fuzzy_exports as Fuzzy, FuzzyShape, generation_exports as Generation, health_exports as Health, homoiconic_exports as Homoiconic, ilp_exports as ILP, image_extraction_exports as ImageExtraction, inference_exports as Inference, ingestion_exports as Ingestion, InternalServerError, LP, namespaces_exports as Namespaces, NetworkError, neuro_symbolic_exports as NeuroSymbolic, NotFoundError, ontology_exports as Ontology, optimize_exports as Optimize, oversight_exports as Oversight, plain_values_exports as PlainValues, preferences_exports as Preferences, proof_engine_exports as ProofEngine, query_exports as Query, rag_exports as RAG, RateLimitError, reasoning_exports as Reasoning, ReasoningLayerClient, ReasoningLayerError, reviews_exports as Reviews, row_exports as Row, SDK_VERSION, scenarios_exports as Scenarios, SortBuilder, sorts_exports as Sorts, sources_exports as Sources, spaces_exports as Spaces, statistical_exports as Statistical, synthetic_exports as Synthetic, terms_exports as Terms, TimeoutError, utilities_exports as Utilities, ValidationError, Value, values_exports as Values, visualization_exports as Visualization, WebSocketClient, WebSocketConnection, webhook_actions_exports as WebhookActions, allen, constrained, discriminateFeatureValue, guard, isConstrainedPlainVar, isPsiTermInput, isTaggedValueDto, isUuid, psi, toTaggedFeatures, toTaggedValue, toTermInputDto, toUntaggedFeatures, toUntaggedValue };
+export { action_reviews_exports as ActionReviews, admin_exports as Admin, analysis_exports as Analysis, ApiError, AuthenticationError, BadRequestError, cdl_exports as CDL, causal_exports as Causal, cognitive_exports as Cognitive, collections_exports as Collections, communities_exports as Communities, ConstraintViolationError, constraints_exports as Constraints, control_exports as Control, conversation_exports as Conversation, discovery_exports as Discovery, execution_exports as Execution, extract_exports as Extract, ForbiddenError, functions_exports as Functions, fuzzy_exports as Fuzzy, FuzzyShape, generation_exports as Generation, health_exports as Health, homoiconic_exports as Homoiconic, ilp_exports as ILP, image_extraction_exports as ImageExtraction, inference_exports as Inference, ingestion_exports as Ingestion, InternalServerError, LP, namespaces_exports as Namespaces, NetworkError, neuro_symbolic_exports as NeuroSymbolic, NotFoundError, ontology_exports as Ontology, optimize_exports as Optimize, osfql_exports as Osfql, oversight_exports as Oversight, plain_values_exports as PlainValues, preferences_exports as Preferences, proof_engine_exports as ProofEngine, query_exports as Query, rag_exports as RAG, RateLimitError, reasoning_exports as Reasoning, ReasoningLayerClient, ReasoningLayerError, reviews_exports as Reviews, row_exports as Row, SDK_VERSION, scenarios_exports as Scenarios, SortBuilder, sorts_exports as Sorts, sources_exports as Sources, spaces_exports as Spaces, statistical_exports as Statistical, synthetic_exports as Synthetic, terms_exports as Terms, TimeoutError, utilities_exports as Utilities, ValidationError, Value, values_exports as Values, visualization_exports as Visualization, WebSocketClient, WebSocketConnection, webhook_actions_exports as WebhookActions, allen, constrained, discriminateFeatureValue, guard, isConstrainedPlainVar, isPsiTermInput, isTaggedValueDto, isUuid, psi, toTaggedFeatures, toTaggedValue, toTermInputDto, toUntaggedFeatures, toUntaggedValue };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map