@subcortex-ai/sdk 0.1.2 → 0.2.0

package/dist/index.d.cts

@@ -517,6 +517,8 @@ interface RegisterPersonInput {
     details?: string;
     /** Confidence level */
     confidence?: ConfidenceLevel | number;
+    /** Session ID for experience binding */
+    sessionId?: string;
 }
 /** Result of person registration */
 interface RegisterPersonResult {
@@ -1053,6 +1055,7 @@ interface ComposedInstructions {
     modelProvider: string;
     modelId: string;
     temperature: number;
+    maxTokens: number;
     voiceId: string;
 }
 /**
@@ -1287,6 +1290,197 @@ declare class IntakeNamespace {
     /** Get intake processing stats for an agent. */
     stats(agentId: string): Promise<IntakeStats>;
 }
+interface Experience {
+    id: string;
+    tenant_id: string;
+    agent_id: string | null;
+    session_id: string;
+    start_time: string;
+    end_time: string | null;
+    assertion_ids: string[];
+    relationship_ids: string[];
+    summary: string | null;
+    topic: string | null;
+    emotional_arc: string | null;
+}
+declare class ExperiencesNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** List experiences, optionally filtered by subject. */
+    list(input?: {
+        subject?: string;
+        limit?: number;
+        tenantId?: string;
+    }): Promise<Experience[]>;
+    /** Get a single experience by ID. */
+    get(experienceId: string, options?: {
+        tenantId?: string;
+    }): Promise<Experience>;
+}
+interface RecallResult {
+    assertion_id: string;
+    score: number;
+    subject: string;
+    predicate: string;
+    snippet: string;
+}
+interface RecallSearchInput {
+    query: string;
+    limit?: number;
+    tenantId?: string;
+}
+interface RecallSearchResponse {
+    results: RecallResult[];
+    total_hits: number;
+}
+declare class RecallNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** BM25 full-text search across assertions. */
+    search(input: RecallSearchInput): Promise<RecallSearchResponse>;
+}
+interface GraphPath {
+    subjects: string[];
+    total_confidence: number;
+    length: number;
+}
+interface FindPathsInput {
+    from: string;
+    to: string;
+    maxDepth?: number;
+    minConfidence?: number;
+    /** "shortest" | "highest_confidence" | "all" */
+    strategy?: string;
+    tenantId?: string;
+}
+interface TraversalNode {
+    subject: string;
+    depth: number;
+    path_confidence: number;
+}
+interface TraversalResult {
+    nodes: TraversalNode[];
+    edge_count: number;
+    depth_reached: number;
+    truncated: boolean;
+}
+interface TraverseInput {
+    startSubject: string;
+    maxDepth?: number;
+    relationshipTypes?: string[];
+    minConfidence?: number;
+    maxNodes?: number;
+    tenantId?: string;
+}
+declare class GraphNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Find paths between two subjects. */
+    findPaths(input: FindPathsInput): Promise<GraphPath[]>;
+    /** BFS traversal from a starting subject. */
+    traverse(input: TraverseInput): Promise<TraversalResult>;
+}
+interface TemporalSnapshot {
+    subject: string;
+    point: string;
+    assertions: Assertion[];
+}
+interface TemporalRange {
+    subject: string;
+    start: string;
+    end: string;
+    assertions: Assertion[];
+}
+declare class TemporalNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Get assertions valid at a specific point in time. */
+    at(subject: string, point: Date | string, options?: {
+        tenantId?: string;
+    }): Promise<TemporalSnapshot>;
+    /** Get assertions within a date range. */
+    range(subject: string, start: Date | string, end: Date | string, options?: {
+        tenantId?: string;
+    }): Promise<TemporalRange>;
+}
+interface SearchResult {
+    assertion_id: string;
+    similarity: number;
+}
+interface SemanticSearchInput {
+    embedding: number[];
+    topK?: number;
+    tenantId?: string;
+}
+declare class SearchNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Semantic nearest-neighbor search over assertion embeddings. */
+    semantic(input: SemanticSearchInput): Promise<SearchResult[]>;
+}
+interface CreateEntityInput {
+    /** Entity name (used as the subject identifier, e.g. "Project") */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Entity type classification (e.g. "model", "workflow", "reference") */
+    type?: string;
+    /** Override default tenant */
+    tenantId?: string;
+}
+interface AddPropertyInput {
+    /** Entity name this property belongs to */
+    entityName: string;
+    /** Property name */
+    name: string;
+    /** Property field type (e.g. "string", "number", "date", "boolean", "reference") */
+    fieldType: string;
+    /** Whether this property is required */
+    required?: boolean;
+    /** Override default tenant */
+    tenantId?: string;
+}
+interface EntityDescription {
+    subject: string;
+    name: string;
+    type: string | null;
+    description: string | null;
+    properties: Array<{
+        name: string;
+        fieldType: string | null;
+        required: boolean;
+    }>;
+    relationships: Array<{
+        type: string;
+        target: string;
+        confidence: number;
+    }>;
+}
+declare class EntitiesNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Create an entity with optional description and type. */
+    create(input: CreateEntityInput): Promise<Assertion>;
+    /** Add a property to an entity. */
+    addProperty(input: AddPropertyInput): Promise<{
+        assertion: Assertion;
+        relationship: Relationship;
+    }>;
+    /** Describe an entity by reconstructing its properties and relationships from assertions. */
+    describe(entityName: string, options?: {
+        tenantId?: string;
+    }): Promise<EntityDescription>;
+    /** List all entities for a tenant (subjects with entity: prefix that have a type predicate). */
+    list(options?: {
+        tenantId?: string;
+    }): Promise<Assertion[]>;
+}
 declare class SubCortexClient {
     /** Assertion operations (low-level knowledge primitives) */
     readonly assertions: AssertionsNamespace;
@@ -1302,6 +1496,18 @@ declare class SubCortexClient {
     readonly users: UsersNamespace;
     /** Emotional signals — record, query, and resolve */
     readonly signals: SignalsNamespace;
+    /** Graph queries — pathfinding and traversal */
+    readonly graph: GraphNamespace;
+    /** Temporal queries — point-in-time snapshots and range queries */
+    readonly temporal: TemporalNamespace;
+    /** Semantic search over assertion embeddings */
+    readonly search: SearchNamespace;
+    /** BM25 full-text recall search */
+    readonly recall: RecallNamespace;
+    /** Episodic memory — experiences grouped by session */
+    readonly experiences: ExperiencesNamespace;
+    /** Entity schema management — create, describe, and manage data models */
+    readonly entities: EntitiesNamespace;
     private readonly http;
     constructor(options: SubCortexClientOptions);
     /** Check SubCortex server health. */
@@ -1450,4 +1656,4 @@ declare class SubCortexTimeoutError extends SubCortexNetworkError {
     constructor(timeoutMs: number);
 }
 
-export { type AgentCapability, type AgentConfig, type AgentInstructions, type AgentMemoryPolicy, type AgentModelConfig, type AgentPersonality, AgentsNamespace, type Assertion, AssertionsNamespace, type BatchResult, CONTEXT_SCHEMA_VERSION, type CandidateAssertion, type ComposedInstructions, ConfidenceLevel, type ConfidenceScore, ConfidenceScores, type ConflictItem, type ConnectedPerson, type ContextFormat, type ContextFormatOptions, type CreateAgentInput, type CreateAssertionInput, type CreateRelationshipInput, EntityPredicate, EntityRelationship, EventPredicate, type HealthResponse, type IdentifyUserInput, IdentityPredicate, IntakeNamespace, type IntakeResponseItem, type IntakeResult, type IntakeStats, type IntakeSubmission, MULTI_VALUE_PREDICATES, MemoryNamespace, MemoryPredicate, NEGATIVE_SIGNALS, OrgRelationship, POSITIVE_SIGNALS, type PaginatedResponse, Predicates, type Provenance, RELATIONSHIP_LABELS, REVERSE_RELATIONSHIPS, RapportPredicate, type RecordRapportInput, type RecordSignalInput, type RegisterPersonInput, type RegisterPersonResult, type Relationship, RelationshipTypes, RelationshipsNamespace, type ResolveSignalInput, type RetryConfig, SIGNAL_DECAY_CONFIG, SYSTEM_SIGNAL_TYPES, type SignalEntry, type SignalQueryOptions, type SignalSnapshot, type SignalType, SignalsNamespace, type StoreMemoryInput, SubCortexAuthenticationError, SubCortexAuthorizationError, SubCortexClient, type SubCortexClientOptions, SubCortexConflictError, SubCortexError, SubCortexNetworkError, SubCortexNotFoundError, SubCortexRateLimitError, SubCortexServerError, SubCortexTimeoutError, SubCortexValidationError, SubjectPrefix, type SupersedeAssertionInput, type SystemSignalType, type TemporalBounds, type Trajectory, type UpdateAgentInput, type UserIdentification, type UserMemory, UsersNamespace, WorkPredicate, confidenceToScore, formatContext, getDecayHalfLife, isValidSignalType, scoreToConfidence, subject, toContextXml };
+export { type AddPropertyInput, type AgentCapability, type AgentConfig, type AgentInstructions, type AgentMemoryPolicy, type AgentModelConfig, type AgentPersonality, AgentsNamespace, type Assertion, AssertionsNamespace, type BatchResult, CONTEXT_SCHEMA_VERSION, type CandidateAssertion, type ComposedInstructions, ConfidenceLevel, type ConfidenceScore, ConfidenceScores, type ConflictItem, type ConnectedPerson, type ContextFormat, type ContextFormatOptions, type CreateAgentInput, type CreateAssertionInput, type CreateEntityInput, type CreateRelationshipInput, EntitiesNamespace, type EntityDescription, EntityPredicate, EntityRelationship, EventPredicate, type Experience, ExperiencesNamespace, type FindPathsInput, GraphNamespace, type GraphPath, type HealthResponse, type IdentifyUserInput, IdentityPredicate, IntakeNamespace, type IntakeResponseItem, type IntakeResult, type IntakeStats, type IntakeSubmission, MULTI_VALUE_PREDICATES, MemoryNamespace, MemoryPredicate, NEGATIVE_SIGNALS, OrgRelationship, POSITIVE_SIGNALS, type PaginatedResponse, Predicates, type Provenance, RELATIONSHIP_LABELS, REVERSE_RELATIONSHIPS, RapportPredicate, RecallNamespace, type RecallResult, type RecallSearchInput, type RecallSearchResponse, type RecordRapportInput, type RecordSignalInput, type RegisterPersonInput, type RegisterPersonResult, type Relationship, RelationshipTypes, RelationshipsNamespace, type ResolveSignalInput, type RetryConfig, SIGNAL_DECAY_CONFIG, SYSTEM_SIGNAL_TYPES, SearchNamespace, type SearchResult, type SemanticSearchInput, type SignalEntry, type SignalQueryOptions, type SignalSnapshot, type SignalType, SignalsNamespace, type StoreMemoryInput, SubCortexAuthenticationError, SubCortexAuthorizationError, SubCortexClient, type SubCortexClientOptions, SubCortexConflictError, SubCortexError, SubCortexNetworkError, SubCortexNotFoundError, SubCortexRateLimitError, SubCortexServerError, SubCortexTimeoutError, SubCortexValidationError, SubjectPrefix, type SupersedeAssertionInput, type SystemSignalType, type TemporalBounds, TemporalNamespace, type TemporalRange, type TemporalSnapshot, type Trajectory, type TraversalNode, type TraversalResult, type TraverseInput, type UpdateAgentInput, type UserIdentification, type UserMemory, UsersNamespace, WorkPredicate, confidenceToScore, formatContext, getDecayHalfLife, isValidSignalType, scoreToConfidence, subject, toContextXml };

package/dist/index.d.ts

@@ -517,6 +517,8 @@ interface RegisterPersonInput {
     details?: string;
     /** Confidence level */
     confidence?: ConfidenceLevel | number;
+    /** Session ID for experience binding */
+    sessionId?: string;
 }
 /** Result of person registration */
 interface RegisterPersonResult {
@@ -1053,6 +1055,7 @@ interface ComposedInstructions {
     modelProvider: string;
     modelId: string;
     temperature: number;
+    maxTokens: number;
     voiceId: string;
 }
 /**
@@ -1287,6 +1290,197 @@ declare class IntakeNamespace {
     /** Get intake processing stats for an agent. */
     stats(agentId: string): Promise<IntakeStats>;
 }
+interface Experience {
+    id: string;
+    tenant_id: string;
+    agent_id: string | null;
+    session_id: string;
+    start_time: string;
+    end_time: string | null;
+    assertion_ids: string[];
+    relationship_ids: string[];
+    summary: string | null;
+    topic: string | null;
+    emotional_arc: string | null;
+}
+declare class ExperiencesNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** List experiences, optionally filtered by subject. */
+    list(input?: {
+        subject?: string;
+        limit?: number;
+        tenantId?: string;
+    }): Promise<Experience[]>;
+    /** Get a single experience by ID. */
+    get(experienceId: string, options?: {
+        tenantId?: string;
+    }): Promise<Experience>;
+}
+interface RecallResult {
+    assertion_id: string;
+    score: number;
+    subject: string;
+    predicate: string;
+    snippet: string;
+}
+interface RecallSearchInput {
+    query: string;
+    limit?: number;
+    tenantId?: string;
+}
+interface RecallSearchResponse {
+    results: RecallResult[];
+    total_hits: number;
+}
+declare class RecallNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** BM25 full-text search across assertions. */
+    search(input: RecallSearchInput): Promise<RecallSearchResponse>;
+}
+interface GraphPath {
+    subjects: string[];
+    total_confidence: number;
+    length: number;
+}
+interface FindPathsInput {
+    from: string;
+    to: string;
+    maxDepth?: number;
+    minConfidence?: number;
+    /** "shortest" | "highest_confidence" | "all" */
+    strategy?: string;
+    tenantId?: string;
+}
+interface TraversalNode {
+    subject: string;
+    depth: number;
+    path_confidence: number;
+}
+interface TraversalResult {
+    nodes: TraversalNode[];
+    edge_count: number;
+    depth_reached: number;
+    truncated: boolean;
+}
+interface TraverseInput {
+    startSubject: string;
+    maxDepth?: number;
+    relationshipTypes?: string[];
+    minConfidence?: number;
+    maxNodes?: number;
+    tenantId?: string;
+}
+declare class GraphNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Find paths between two subjects. */
+    findPaths(input: FindPathsInput): Promise<GraphPath[]>;
+    /** BFS traversal from a starting subject. */
+    traverse(input: TraverseInput): Promise<TraversalResult>;
+}
+interface TemporalSnapshot {
+    subject: string;
+    point: string;
+    assertions: Assertion[];
+}
+interface TemporalRange {
+    subject: string;
+    start: string;
+    end: string;
+    assertions: Assertion[];
+}
+declare class TemporalNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Get assertions valid at a specific point in time. */
+    at(subject: string, point: Date | string, options?: {
+        tenantId?: string;
+    }): Promise<TemporalSnapshot>;
+    /** Get assertions within a date range. */
+    range(subject: string, start: Date | string, end: Date | string, options?: {
+        tenantId?: string;
+    }): Promise<TemporalRange>;
+}
+interface SearchResult {
+    assertion_id: string;
+    similarity: number;
+}
+interface SemanticSearchInput {
+    embedding: number[];
+    topK?: number;
+    tenantId?: string;
+}
+declare class SearchNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Semantic nearest-neighbor search over assertion embeddings. */
+    semantic(input: SemanticSearchInput): Promise<SearchResult[]>;
+}
+interface CreateEntityInput {
+    /** Entity name (used as the subject identifier, e.g. "Project") */
+    name: string;
+    /** Human-readable description */
+    description?: string;
+    /** Entity type classification (e.g. "model", "workflow", "reference") */
+    type?: string;
+    /** Override default tenant */
+    tenantId?: string;
+}
+interface AddPropertyInput {
+    /** Entity name this property belongs to */
+    entityName: string;
+    /** Property name */
+    name: string;
+    /** Property field type (e.g. "string", "number", "date", "boolean", "reference") */
+    fieldType: string;
+    /** Whether this property is required */
+    required?: boolean;
+    /** Override default tenant */
+    tenantId?: string;
+}
+interface EntityDescription {
+    subject: string;
+    name: string;
+    type: string | null;
+    description: string | null;
+    properties: Array<{
+        name: string;
+        fieldType: string | null;
+        required: boolean;
+    }>;
+    relationships: Array<{
+        type: string;
+        target: string;
+        confidence: number;
+    }>;
+}
+declare class EntitiesNamespace {
+    private http;
+    private tenantId;
+    constructor(http: HttpTransport, tenantId: string);
+    /** Create an entity with optional description and type. */
+    create(input: CreateEntityInput): Promise<Assertion>;
+    /** Add a property to an entity. */
+    addProperty(input: AddPropertyInput): Promise<{
+        assertion: Assertion;
+        relationship: Relationship;
+    }>;
+    /** Describe an entity by reconstructing its properties and relationships from assertions. */
+    describe(entityName: string, options?: {
+        tenantId?: string;
+    }): Promise<EntityDescription>;
+    /** List all entities for a tenant (subjects with entity: prefix that have a type predicate). */
+    list(options?: {
+        tenantId?: string;
+    }): Promise<Assertion[]>;
+}
 declare class SubCortexClient {
     /** Assertion operations (low-level knowledge primitives) */
     readonly assertions: AssertionsNamespace;
@@ -1302,6 +1496,18 @@ declare class SubCortexClient {
     readonly users: UsersNamespace;
     /** Emotional signals — record, query, and resolve */
     readonly signals: SignalsNamespace;
+    /** Graph queries — pathfinding and traversal */
+    readonly graph: GraphNamespace;
+    /** Temporal queries — point-in-time snapshots and range queries */
+    readonly temporal: TemporalNamespace;
+    /** Semantic search over assertion embeddings */
+    readonly search: SearchNamespace;
+    /** BM25 full-text recall search */
+    readonly recall: RecallNamespace;
+    /** Episodic memory — experiences grouped by session */
+    readonly experiences: ExperiencesNamespace;
+    /** Entity schema management — create, describe, and manage data models */
+    readonly entities: EntitiesNamespace;
     private readonly http;
     constructor(options: SubCortexClientOptions);
     /** Check SubCortex server health. */
@@ -1450,4 +1656,4 @@ declare class SubCortexTimeoutError extends SubCortexNetworkError {
     constructor(timeoutMs: number);
 }
 
-export { type AgentCapability, type AgentConfig, type AgentInstructions, type AgentMemoryPolicy, type AgentModelConfig, type AgentPersonality, AgentsNamespace, type Assertion, AssertionsNamespace, type BatchResult, CONTEXT_SCHEMA_VERSION, type CandidateAssertion, type ComposedInstructions, ConfidenceLevel, type ConfidenceScore, ConfidenceScores, type ConflictItem, type ConnectedPerson, type ContextFormat, type ContextFormatOptions, type CreateAgentInput, type CreateAssertionInput, type CreateRelationshipInput, EntityPredicate, EntityRelationship, EventPredicate, type HealthResponse, type IdentifyUserInput, IdentityPredicate, IntakeNamespace, type IntakeResponseItem, type IntakeResult, type IntakeStats, type IntakeSubmission, MULTI_VALUE_PREDICATES, MemoryNamespace, MemoryPredicate, NEGATIVE_SIGNALS, OrgRelationship, POSITIVE_SIGNALS, type PaginatedResponse, Predicates, type Provenance, RELATIONSHIP_LABELS, REVERSE_RELATIONSHIPS, RapportPredicate, type RecordRapportInput, type RecordSignalInput, type RegisterPersonInput, type RegisterPersonResult, type Relationship, RelationshipTypes, RelationshipsNamespace, type ResolveSignalInput, type RetryConfig, SIGNAL_DECAY_CONFIG, SYSTEM_SIGNAL_TYPES, type SignalEntry, type SignalQueryOptions, type SignalSnapshot, type SignalType, SignalsNamespace, type StoreMemoryInput, SubCortexAuthenticationError, SubCortexAuthorizationError, SubCortexClient, type SubCortexClientOptions, SubCortexConflictError, SubCortexError, SubCortexNetworkError, SubCortexNotFoundError, SubCortexRateLimitError, SubCortexServerError, SubCortexTimeoutError, SubCortexValidationError, SubjectPrefix, type SupersedeAssertionInput, type SystemSignalType, type TemporalBounds, type Trajectory, type UpdateAgentInput, type UserIdentification, type UserMemory, UsersNamespace, WorkPredicate, confidenceToScore, formatContext, getDecayHalfLife, isValidSignalType, scoreToConfidence, subject, toContextXml };
+export { type AddPropertyInput, type AgentCapability, type AgentConfig, type AgentInstructions, type AgentMemoryPolicy, type AgentModelConfig, type AgentPersonality, AgentsNamespace, type Assertion, AssertionsNamespace, type BatchResult, CONTEXT_SCHEMA_VERSION, type CandidateAssertion, type ComposedInstructions, ConfidenceLevel, type ConfidenceScore, ConfidenceScores, type ConflictItem, type ConnectedPerson, type ContextFormat, type ContextFormatOptions, type CreateAgentInput, type CreateAssertionInput, type CreateEntityInput, type CreateRelationshipInput, EntitiesNamespace, type EntityDescription, EntityPredicate, EntityRelationship, EventPredicate, type Experience, ExperiencesNamespace, type FindPathsInput, GraphNamespace, type GraphPath, type HealthResponse, type IdentifyUserInput, IdentityPredicate, IntakeNamespace, type IntakeResponseItem, type IntakeResult, type IntakeStats, type IntakeSubmission, MULTI_VALUE_PREDICATES, MemoryNamespace, MemoryPredicate, NEGATIVE_SIGNALS, OrgRelationship, POSITIVE_SIGNALS, type PaginatedResponse, Predicates, type Provenance, RELATIONSHIP_LABELS, REVERSE_RELATIONSHIPS, RapportPredicate, RecallNamespace, type RecallResult, type RecallSearchInput, type RecallSearchResponse, type RecordRapportInput, type RecordSignalInput, type RegisterPersonInput, type RegisterPersonResult, type Relationship, RelationshipTypes, RelationshipsNamespace, type ResolveSignalInput, type RetryConfig, SIGNAL_DECAY_CONFIG, SYSTEM_SIGNAL_TYPES, SearchNamespace, type SearchResult, type SemanticSearchInput, type SignalEntry, type SignalQueryOptions, type SignalSnapshot, type SignalType, SignalsNamespace, type StoreMemoryInput, SubCortexAuthenticationError, SubCortexAuthorizationError, SubCortexClient, type SubCortexClientOptions, SubCortexConflictError, SubCortexError, SubCortexNetworkError, SubCortexNotFoundError, SubCortexRateLimitError, SubCortexServerError, SubCortexTimeoutError, SubCortexValidationError, SubjectPrefix, type SupersedeAssertionInput, type SystemSignalType, type TemporalBounds, TemporalNamespace, type TemporalRange, type TemporalSnapshot, type Trajectory, type TraversalNode, type TraversalResult, type TraverseInput, type UpdateAgentInput, type UserIdentification, type UserMemory, UsersNamespace, WorkPredicate, confidenceToScore, formatContext, getDecayHalfLife, isValidSignalType, scoreToConfidence, subject, toContextXml };