mindgraph 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -41,19 +41,16 @@ interface PathStep {
 interface IngestRequest {
     action: "source" | "snippet" | "observation";
     label: string;
-    content: string;
+    summary?: string;
     source_uid?: string;
-    medium?: string;
-    url?: string;
-    timestamp?: number;
     confidence?: number;
     salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface EntityRequest {
     action: "create" | "alias" | "resolve" | "fuzzy_resolve" | "merge" | "relate";
     label?: string;
-    entity_type?: string;
     text?: string;
     canonical_uid?: string;
     alias_score?: number;
@@ -63,50 +60,54 @@ interface EntityRequest {
     source_uid?: string;
     target_uid?: string;
     edge_type?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ArgumentRequest {
     claim: {
         label: string;
-        content: string;
         confidence?: number;
+        props?: Record<string, unknown>;
     };
     evidence?: {
         label: string;
-        description: string;
-        evidence_type?: string;
+        props?: Record<string, unknown>;
     }[];
     warrant?: {
         label: string;
-        principle: string;
+        props?: Record<string, unknown>;
     };
     argument?: {
         label: string;
-        summary: string;
+        props?: Record<string, unknown>;
     };
     refutes_uid?: string;
     extends_uid?: string;
+    supersedes_uid?: string;
+    contradicts_uid?: string;
     source_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface InquiryRequest {
     action: "hypothesis" | "theory" | "paradigm" | "anomaly" | "assumption" | "question" | "open_question";
     label: string;
-    content: string;
-    status?: string;
+    summary?: string;
     anomalous_to_uid?: string;
     assumes_uid?: string[];
     tests_uid?: string;
     addresses_uid?: string;
+    supersedes_uid?: string;
+    produces_uid?: string;
     confidence?: number;
     salience?: number;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface StructureRequest {
-    action: "concept" | "pattern" | "mechanism" | "model" | "model_evaluation" | "analogy" | "inference_chain" | "reasoning_strategy" | "sensitivity_analysis" | "theorem" | "equation";
+    action: "concept" | "pattern" | "mechanism" | "model" | "model_evaluation" | "analogy" | "inference_chain" | "reasoning_strategy" | "sensitivity_analysis" | "theorem" | "equation" | "method" | "experiment";
     label: string;
-    content: string;
     summary?: string;
     analogous_to_uid?: string;
     transfers_to_uid?: string[];
@@ -115,125 +116,137 @@ interface StructureRequest {
     chain_steps?: string[];
     derived_from_uid?: string[];
     proven_by_uid?: string;
+    method_uid?: string;
+    describes_uid?: string;
+    part_of_uid?: string;
+    supersedes_uid?: string;
+    produces_uid?: string;
     related_uids?: string[];
     confidence?: number;
+    salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface CommitmentRequest {
     action: "goal" | "project" | "milestone";
     label: string;
-    description: string;
-    priority?: string;
-    status?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     parent_uid?: string;
-    due_date?: number;
     motivated_by_uid?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface DeliberationRequest {
     action: "open_decision" | "add_option" | "add_constraint" | "resolve" | "get_open";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     decision_uid?: string;
     chosen_option_uid?: string;
-    resolution_rationale?: string;
-    constraint_type?: string;
     blocks_uid?: string;
     informs_uid?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ProcedureRequest {
     action: "create_flow" | "add_step" | "add_affordance" | "add_control";
     label: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     flow_uid?: string;
-    step_order?: number;
     previous_step_uid?: string;
-    affordance_type?: string;
-    control_type?: string;
     uses_affordance_uids?: string[];
     goal_uid?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface RiskRequest {
     action: "assess" | "get_assessments";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     assessed_uid?: string;
-    severity?: string;
-    likelihood?: number;
-    mitigations?: string[];
-    residual_risk?: number;
     filter_uid?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface SessionRequest {
-    action: "open" | "trace" | "close";
+    action: "open" | "trace" | "close" | "journal";
     label?: string;
-    focus?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     session_uid?: string;
-    trace_content?: string;
-    trace_type?: string;
     relevant_node_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface DistillRequest {
     label: string;
-    content: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     summarizes_uids?: string[];
     session_uid?: string;
-    importance?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface MemoryConfigRequest {
     action: "set_preference" | "get_preferences" | "set_policy" | "get_policies";
     label?: string;
-    key?: string;
-    value?: string;
-    policy_content?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface PlanRequest {
     action: "create_task" | "create_plan" | "add_step" | "update_status" | "get_plan";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     goal_uid?: string;
     task_uid?: string;
     plan_uid?: string;
-    step_order?: number;
     depends_on_uids?: string[];
     target_uid?: string;
     status?: string;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface GovernanceRequest {
     action: "create_policy" | "set_budget" | "request_approval" | "resolve_approval" | "get_pending";
     label?: string;
-    policy_content?: string;
-    budget_type?: string;
-    budget_limit?: number;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     governed_uid?: string;
     approval_uid?: string;
     approved?: boolean;
-    resolution_note?: string;
     requires_plan_uid?: string;
-    approval_request?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ExecutionRequest {
     action: "start" | "complete" | "fail" | "register_agent" | "get_executions";
     label?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     plan_uid?: string;
     executor_uid?: string;
     execution_uid?: string;
-    outcome?: string;
     produces_node_uid?: string;
-    error_description?: string;
-    agent_name?: string;
-    agent_role?: string;
     filter_plan_uid?: string;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface RetrieveRequest {
@@ -321,7 +334,7 @@ declare class MindGraph {
     ingest(req: IngestRequest): Promise<unknown>;
     entity(req: EntityRequest): Promise<unknown>;
     /** Convenience: create or find an entity by label. */
-    findOrCreateEntity(label: string, entityType?: string, agentId?: string): Promise<GraphNode & {
+    findOrCreateEntity(label: string, props?: Record<string, unknown>, agentId?: string): Promise<GraphNode & {
         created: boolean;
     }>;
     argue(req: ArgumentRequest): Promise<unknown>;
@@ -332,6 +345,14 @@ declare class MindGraph {
     procedure(req: ProcedureRequest): Promise<unknown>;
     risk(req: RiskRequest): Promise<unknown>;
     session(req: SessionRequest): Promise<unknown>;
+    journal(label: string, props: Record<string, unknown>, options?: {
+        summary?: string;
+        session_uid?: string;
+        relevant_node_uids?: string[];
+        confidence?: number;
+        salience?: number;
+        agent_id?: string;
+    }): Promise<unknown>;
     distill(req: DistillRequest): Promise<unknown>;
     memoryConfig(req: MemoryConfigRequest): Promise<unknown>;
     plan(req: PlanRequest): Promise<unknown>;

package/dist/index.d.ts

@@ -41,19 +41,16 @@ interface PathStep {
 interface IngestRequest {
     action: "source" | "snippet" | "observation";
     label: string;
-    content: string;
+    summary?: string;
     source_uid?: string;
-    medium?: string;
-    url?: string;
-    timestamp?: number;
     confidence?: number;
     salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface EntityRequest {
     action: "create" | "alias" | "resolve" | "fuzzy_resolve" | "merge" | "relate";
     label?: string;
-    entity_type?: string;
     text?: string;
     canonical_uid?: string;
     alias_score?: number;
@@ -63,50 +60,54 @@ interface EntityRequest {
     source_uid?: string;
     target_uid?: string;
     edge_type?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ArgumentRequest {
     claim: {
         label: string;
-        content: string;
         confidence?: number;
+        props?: Record<string, unknown>;
     };
     evidence?: {
         label: string;
-        description: string;
-        evidence_type?: string;
+        props?: Record<string, unknown>;
     }[];
     warrant?: {
         label: string;
-        principle: string;
+        props?: Record<string, unknown>;
     };
     argument?: {
         label: string;
-        summary: string;
+        props?: Record<string, unknown>;
     };
     refutes_uid?: string;
     extends_uid?: string;
+    supersedes_uid?: string;
+    contradicts_uid?: string;
     source_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface InquiryRequest {
     action: "hypothesis" | "theory" | "paradigm" | "anomaly" | "assumption" | "question" | "open_question";
     label: string;
-    content: string;
-    status?: string;
+    summary?: string;
     anomalous_to_uid?: string;
     assumes_uid?: string[];
     tests_uid?: string;
     addresses_uid?: string;
+    supersedes_uid?: string;
+    produces_uid?: string;
     confidence?: number;
     salience?: number;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface StructureRequest {
-    action: "concept" | "pattern" | "mechanism" | "model" | "model_evaluation" | "analogy" | "inference_chain" | "reasoning_strategy" | "sensitivity_analysis" | "theorem" | "equation";
+    action: "concept" | "pattern" | "mechanism" | "model" | "model_evaluation" | "analogy" | "inference_chain" | "reasoning_strategy" | "sensitivity_analysis" | "theorem" | "equation" | "method" | "experiment";
     label: string;
-    content: string;
     summary?: string;
     analogous_to_uid?: string;
     transfers_to_uid?: string[];
@@ -115,125 +116,137 @@ interface StructureRequest {
     chain_steps?: string[];
     derived_from_uid?: string[];
     proven_by_uid?: string;
+    method_uid?: string;
+    describes_uid?: string;
+    part_of_uid?: string;
+    supersedes_uid?: string;
+    produces_uid?: string;
     related_uids?: string[];
     confidence?: number;
+    salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface CommitmentRequest {
     action: "goal" | "project" | "milestone";
     label: string;
-    description: string;
-    priority?: string;
-    status?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     parent_uid?: string;
-    due_date?: number;
     motivated_by_uid?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface DeliberationRequest {
     action: "open_decision" | "add_option" | "add_constraint" | "resolve" | "get_open";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     decision_uid?: string;
     chosen_option_uid?: string;
-    resolution_rationale?: string;
-    constraint_type?: string;
     blocks_uid?: string;
     informs_uid?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ProcedureRequest {
     action: "create_flow" | "add_step" | "add_affordance" | "add_control";
     label: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     flow_uid?: string;
-    step_order?: number;
     previous_step_uid?: string;
-    affordance_type?: string;
-    control_type?: string;
     uses_affordance_uids?: string[];
     goal_uid?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface RiskRequest {
     action: "assess" | "get_assessments";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     assessed_uid?: string;
-    severity?: string;
-    likelihood?: number;
-    mitigations?: string[];
-    residual_risk?: number;
     filter_uid?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface SessionRequest {
-    action: "open" | "trace" | "close";
+    action: "open" | "trace" | "close" | "journal";
     label?: string;
-    focus?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     session_uid?: string;
-    trace_content?: string;
-    trace_type?: string;
     relevant_node_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface DistillRequest {
     label: string;
-    content: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     summarizes_uids?: string[];
     session_uid?: string;
-    importance?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface MemoryConfigRequest {
     action: "set_preference" | "get_preferences" | "set_policy" | "get_policies";
     label?: string;
-    key?: string;
-    value?: string;
-    policy_content?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface PlanRequest {
     action: "create_task" | "create_plan" | "add_step" | "update_status" | "get_plan";
     label?: string;
-    description?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     goal_uid?: string;
     task_uid?: string;
     plan_uid?: string;
-    step_order?: number;
     depends_on_uids?: string[];
     target_uid?: string;
     status?: string;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface GovernanceRequest {
     action: "create_policy" | "set_budget" | "request_approval" | "resolve_approval" | "get_pending";
     label?: string;
-    policy_content?: string;
-    budget_type?: string;
-    budget_limit?: number;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     governed_uid?: string;
     approval_uid?: string;
     approved?: boolean;
-    resolution_note?: string;
     requires_plan_uid?: string;
-    approval_request?: string;
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface ExecutionRequest {
     action: "start" | "complete" | "fail" | "register_agent" | "get_executions";
     label?: string;
+    summary?: string;
+    confidence?: number;
+    salience?: number;
     plan_uid?: string;
     executor_uid?: string;
     execution_uid?: string;
-    outcome?: string;
     produces_node_uid?: string;
-    error_description?: string;
-    agent_name?: string;
-    agent_role?: string;
     filter_plan_uid?: string;
     related_uids?: string[];
+    props?: Record<string, unknown>;
     agent_id?: string;
 }
 interface RetrieveRequest {
@@ -321,7 +334,7 @@ declare class MindGraph {
     ingest(req: IngestRequest): Promise<unknown>;
     entity(req: EntityRequest): Promise<unknown>;
     /** Convenience: create or find an entity by label. */
-    findOrCreateEntity(label: string, entityType?: string, agentId?: string): Promise<GraphNode & {
+    findOrCreateEntity(label: string, props?: Record<string, unknown>, agentId?: string): Promise<GraphNode & {
         created: boolean;
     }>;
     argue(req: ArgumentRequest): Promise<unknown>;
@@ -332,6 +345,14 @@ declare class MindGraph {
     procedure(req: ProcedureRequest): Promise<unknown>;
     risk(req: RiskRequest): Promise<unknown>;
     session(req: SessionRequest): Promise<unknown>;
+    journal(label: string, props: Record<string, unknown>, options?: {
+        summary?: string;
+        session_uid?: string;
+        relevant_node_uids?: string[];
+        confidence?: number;
+        salience?: number;
+        agent_id?: string;
+    }): Promise<unknown>;
     distill(req: DistillRequest): Promise<unknown>;
     memoryConfig(req: MemoryConfigRequest): Promise<unknown>;
     plan(req: PlanRequest): Promise<unknown>;

package/dist/index.js

@@ -100,11 +100,11 @@ var MindGraph = class {
     return this.post("/reality/entity", req);
   }
   /** Convenience: create or find an entity by label. */
-  async findOrCreateEntity(label, entityType = "other", agentId) {
+  async findOrCreateEntity(label, props, agentId) {
     return this.post("/reality/entity", {
       action: "create",
       label,
-      entity_type: entityType,
+      props: { entity_type: "other", ...props },
       agent_id: agentId
     });
   }
@@ -136,6 +136,14 @@ var MindGraph = class {
   async session(req) {
     return this.post("/memory/session", req);
   }
+  async journal(label, props, options) {
+    return this.post("/memory/session", {
+      action: "journal",
+      label,
+      props,
+      ...options
+    });
+  }
   async distill(req) {
     return this.post("/memory/distill", req);
   }

package/dist/index.mjs

@@ -73,11 +73,11 @@ var MindGraph = class {
     return this.post("/reality/entity", req);
   }
   /** Convenience: create or find an entity by label. */
-  async findOrCreateEntity(label, entityType = "other", agentId) {
+  async findOrCreateEntity(label, props, agentId) {
     return this.post("/reality/entity", {
       action: "create",
       label,
-      entity_type: entityType,
+      props: { entity_type: "other", ...props },
       agent_id: agentId
     });
   }
@@ -109,6 +109,14 @@ var MindGraph = class {
   async session(req) {
     return this.post("/memory/session", req);
   }
+  async journal(label, props, options) {
+    return this.post("/memory/session", {
+      action: "journal",
+      label,
+      props,
+      ...options
+    });
+  }
   async distill(req) {
     return this.post("/memory/distill", req);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript client for the MindGraph Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",