@kortexya/reasoninglayer 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 // 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");
@@ -7391,6 +7391,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 */
@@ -13562,6 +13588,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. */
@@ -13650,6 +13835,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;
@@ -13825,6 +14014,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);
@@ -13868,6 +14058,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);
   }
 };
 
@@ -14009,6 +14201,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 = {
   /**
@@ -14288,9 +14486,9 @@ var SortBuilder = class _SortBuilder {
    * @example
    * ```typescript
    * builder.boundConstraint({
-   *   constraint_type: "upper",
+   *   constraintType: "upper",
    *   target: "end_date",
-   *   source_path: "company.dissolutionDate",
+   *   sourcePath: "company.dissolutionDate",
    * })
    * ```
    */
@@ -14416,6 +14614,7 @@ exports.Communities = communities_exports;
 exports.ConstraintViolationError = ConstraintViolationError;
 exports.Constraints = constraints_exports;
 exports.Control = control_exports;
+exports.Conversation = conversation_exports;
 exports.Discovery = discovery_exports;
 exports.Execution = execution_exports;
 exports.Extract = extract_exports;
@@ -14438,6 +14637,7 @@ exports.NeuroSymbolic = neuro_symbolic_exports;
 exports.NotFoundError = NotFoundError;
 exports.Ontology = ontology_exports;
 exports.Optimize = optimize_exports;
+exports.Osfql = osfql_exports;
 exports.Oversight = oversight_exports;
 exports.PlainValues = plain_values_exports;
 exports.Preferences = preferences_exports;