@sonzai-labs/agents 1.0.8 → 1.0.9

package/dist/index.d.cts

@@ -288,6 +288,40 @@ interface RelationshipResponse extends Record<string, unknown> {
 }
 interface HabitsResponse extends Record<string, unknown> {
 }
+interface Habit {
+    id?: string;
+    agent_id: string;
+    user_id?: string;
+    name: string;
+    category: string;
+    description: string;
+    display_name?: string;
+    strength: number;
+    formed: boolean;
+    observation_count: number;
+    last_reinforced_at?: string;
+    formed_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CreateHabitOptions {
+    userId?: string;
+    name: string;
+    category?: string;
+    description?: string;
+    displayName?: string;
+    strength?: number;
+}
+interface UpdateHabitOptions {
+    userId?: string;
+    category?: string;
+    description?: string;
+    displayName?: string;
+    strength?: number;
+}
+interface DeleteHabitOptions {
+    userId?: string;
+}
 type GoalType = "personal_growth" | "skill_mastery" | "relationship" | "learning_discovery";
 type GoalStatus = "active" | "achieved" | "abandoned";
 type GoalPriority = 0 | 1 | 2;
@@ -348,6 +382,34 @@ interface UsersResponse extends Record<string, unknown> {
 }
 interface ConstellationResponse extends Record<string, unknown> {
 }
+interface ConstellationNode {
+    node_id: string;
+    agent_id: string;
+    user_id?: string;
+    node_type: string;
+    label: string;
+    description?: string;
+    significance: number;
+    mention_count: number;
+    brightness: number;
+    first_mentioned_at?: string;
+    last_mentioned_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CreateConstellationNodeOptions {
+    userId?: string;
+    nodeType?: string;
+    label: string;
+    description?: string;
+    significance?: number;
+}
+interface UpdateConstellationNodeOptions {
+    label?: string;
+    description?: string;
+    significance?: number;
+    nodeType?: string;
+}
 interface BreakthroughsResponse extends Record<string, unknown> {
 }
 interface WakeupsResponse extends Record<string, unknown> {
@@ -788,6 +850,24 @@ interface FactListOptions {
     limit?: number;
     offset?: number;
 }
+interface CreateFactOptions {
+    content: string;
+    userId?: string;
+    factType?: string;
+    importance?: number;
+    confidence?: number;
+    entities?: string[];
+    nodeId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateFactOptions {
+    content?: string;
+    factType?: string;
+    importance?: number;
+    confidence?: number;
+    entities?: string[];
+    metadata?: Record<string, unknown>;
+}
 interface MemoryResetOptions {
     userId?: string;
     instanceId?: string;
@@ -2000,6 +2080,12 @@ declare class Memory {
     listFacts(agentId: string, options?: FactListOptions): Promise<FactListResponse>;
     /** Reset (delete) all memory for an agent, optionally scoped to a user. */
     reset(agentId: string, options?: MemoryResetOptions): Promise<MemoryResetResponse>;
+    /** Create a new fact for an agent. Facts are tagged source_type='manual'. */
+    createFact(agentId: string, options: CreateFactOptions): Promise<AtomicFact>;
+    /** Update an existing fact by ID. */
+    updateFact(agentId: string, factId: string, options: UpdateFactOptions): Promise<AtomicFact>;
+    /** Delete a fact by ID. */
+    deleteFact(agentId: string, factId: string): Promise<void>;
     /** Get the version history of a specific fact. */
     getFactHistory(agentId: string, factId: string): Promise<FactHistoryResponse>;
 }
@@ -2264,6 +2350,12 @@ declare class Agents {
     getMoodAggregate(agentId: string, options?: ContextDataOptions): Promise<MoodAggregateResponse>;
     getRelationships(agentId: string, options?: ContextDataOptions): Promise<RelationshipResponse>;
     getHabits(agentId: string, options?: ContextDataOptions): Promise<HabitsResponse>;
+    /** Create a habit for an agent. Set userId for a per-user habit. */
+    createHabit(agentId: string, options: CreateHabitOptions): Promise<Habit>;
+    /** Update an existing habit by name. */
+    updateHabit(agentId: string, habitName: string, options: UpdateHabitOptions): Promise<Habit>;
+    /** Delete a habit. Set userId for per-user habits. */
+    deleteHabit(agentId: string, habitName: string, options?: DeleteHabitOptions): Promise<void>;
     getGoals(agentId: string, options?: ContextDataOptions): Promise<GoalsResponse>;
     /** Create a goal for an agent. Set userId to create a per-user goal. */
     createGoal(agentId: string, options: CreateGoalOptions): Promise<Goal>;
@@ -2276,6 +2368,12 @@ declare class Agents {
     getUsers(agentId: string): Promise<UsersResponse>;
     /** Get constellation data for an agent. */
     getConstellation(agentId: string, options?: ContextDataOptions): Promise<ConstellationResponse>;
+    /** Create a constellation node (lore) for an agent. */
+    createConstellationNode(agentId: string, options: CreateConstellationNodeOptions): Promise<ConstellationNode>;
+    /** Update an existing constellation node. */
+    updateConstellationNode(agentId: string, nodeId: string, options: UpdateConstellationNodeOptions): Promise<ConstellationNode>;
+    /** Delete a constellation node. */
+    deleteConstellationNode(agentId: string, nodeId: string): Promise<void>;
     /** Get breakthroughs for an agent. */
     getBreakthroughs(agentId: string, options?: ContextDataOptions): Promise<BreakthroughsResponse>;
     /** List agents with optional pagination, search, and project filtering. */
@@ -2565,4 +2663,4 @@ declare class StreamError extends SonzaiError {
     constructor(message: string);
 }
 
-export { APIError, type AcknowledgeAllOptions, type AcknowledgeNotificationsOptions, type AcknowledgeResponse, type AddContentOptions, type AddContentResponse, type Agent, type AgentCapabilities, type AgentIndex, type AgentInstance, type AgentKBSearchOptions, type AgentKBSearchResponse, type AgentKBSearchResult, type AgentListOptions, type AgentListResponse, type AgentToolCapabilities, type AtomicFact, AuthenticationError, BadRequestError, type BatchImportOptions, type BatchImportResponse, type BatchImportUser, type BatchPersonalityEntry, type BatchPersonalityResponse, type Big5, type Big5Scores, type Big5Trait, type BreakthroughsResponse, type ChatChoice, type ChatMessage, type ChatOptions, type ChatResponse, type ChatStreamEvent, type ChatUsage, type ConsolidateOptions, type ConsolidateResponse, type ConstellationResponse, type ContextDataOptions, type CreateAgentOptions, type CreateAnalyticsRuleOptions, type CreateCustomToolOptions, type CreateGoalOptions, type CreateSchemaOptions, type CustomLLMConfigResponse, type CustomState, type CustomStateCreateOptions, type CustomStateDeleteByKeyOptions, type CustomStateGetByKeyOptions, type CustomStateListOptions, type CustomStateListResponse, type CustomStateUpdateOptions, type CustomStateUpsertOptions, type CustomToolDefinition, type CustomToolListResponse, type DeleteGoalOptions, type DeliveryAttemptsResponse, type DialogueOptions, type DialogueResponse, type DiaryResponse, type EnrichedContextResponse, type EvalCategory, type EvalOnlyOptions, type EvalRun, type EvalRunListOptions, type EvalRunListResponse, type EvalTemplate, type EvalTemplateCategory, type EvalTemplateCreateOptions, type EvalTemplateListResponse, type EvalTemplateUpdateOptions, type EvaluateOptions, type EvaluationResult, type ExtractionDimensionDelta, type ExtractionFact, type ExtractionHabit, type ExtractionInnerThoughts, type ExtractionInterest, type ExtractionMoodDelta, type ExtractionPersonalityDelta, type ExtractionProactive, type ExtractionRecurring, type ExtractionRelationshipDelta, type Fact, type FactHistoryResponse, type FactListOptions, type FactListResponse, type GenerateAvatarOptions, type GenerateAvatarResponse, type GenerateBioOptions, type GenerateBioResponse, type GenerateCharacterOptions, type GenerateCharacterResponse, type GenerateSeedMemoriesOptions, type GenerateSeedMemoriesResponse, type GeneratedGoal, type GetContextOptions, type Goal, type GoalPriority, type GoalStatus, type GoalType, type GoalsResponse, type HabitsResponse, type IdentityMemory, type ImageGenerateOptions, type ImageGenerateResponse, type ImportJob, type ImportJobListResponse, type InitialGoal, type InsertFactDetail, type InsertFactEntry, type InsertFactsOptions, type InsertFactsResponse, type InsertRelEntry, type InstanceCreateOptions, type InstanceListResponse, type InterestsResponse, InternalServerError, type InventoryBatchImportOptions, type InventoryBatchImportResponse, type InventoryBatchItem, type InventoryDirectUpdateOptions, type InventoryDirectUpdateResponse, type InventoryGroupResult, type InventoryItem, type InventoryQueryOptions, type InventoryQueryResponse, type InventoryUpdateOptions, type InventoryUpdateResponse, type KBAnalyticsRule, type KBAnalyticsRuleListResponse, type KBBulkUpdateEntry, type KBBulkUpdateOptions, type KBBulkUpdateResponse, type KBCandidate, type KBConversionStats, type KBConversionsResponse, type KBDocument, type KBDocumentListResponse, type KBEdge, type KBEntitySchema, type KBNode, type KBNodeDetailResponse, type KBNodeHistory, type KBNodeHistoryResponse, type KBNodeListResponse, type KBRecommendationScore, type KBRecommendationsResponse, type KBRelatedNode, type KBResolutionInfo, type KBSchemaField, type KBSchemaListResponse, type KBSearchOptions, type KBSearchResponse, type KBSearchResult, type KBSimilarityConfig, type KBStats, type KBTrendAggregation, type KBTrendRanking, type KBTrendRankingsResponse, type KBTrendsResponse, type ListAllFactsOptions, type ListAllFactsResponse, type LoreGenerationContext, type MemoryListOptions, type MemoryNode, type MemoryResetOptions, type MemoryResetResponse, type MemoryResponse, type MemorySearchOptions, type MemorySearchResponse, type MemorySearchResult, type MemorySummary, type MemoryTimelineOptions, type MemoryTimelineResponse, type ModelsProviderEntry, type ModelsResponse, type MoodAggregateResponse, type MoodResponse, NotFoundError, type Notification, type NotificationListOptions, type NotificationListResponse, PermissionDeniedError, type PersonalityBehaviors, type PersonalityDelta, type PersonalityDimensions, type PersonalityGetOptions, type PersonalityPreferences, type PersonalityProfile, type PersonalityResponse, type PersonalityShift, type PersonalityUpdateOptions, type PersonalityUpdateResponse, type PrimeContentBlock, type PrimeUserMetadata, type PrimeUserOptions, type PrimeUserResponse, type ProcessOptions, type ProcessResponse, type ProcessSideEffectsSummary, type ProjectConfigEntry, type ProjectConfigListResponse, type ProjectNotificationListOptions, type ProjectNotificationListResponse, RateLimitError, type RecentShiftsResponse, type RecordFeedbackOptions, type RelationshipResponse, type RunEvalOptions, type RunRef, type SDKBehavioralTraits, type SDKInteractionPreferences, type SDKPersonalityDimensions, type STTOptions, type STTResponse, type ScheduleWakeupOptions, type ScheduledWakeup, type SeedMemoriesOptions, type SeedMemoriesResponse, type SeedMemory, type SessionEndOptions, type SessionResponse, type SessionStartOptions, type SetConfigOptions, type SetCustomLLMOptions, type SetSessionToolsOptions, type SetStatusOptions, type SetStatusResponse, type SideEffectExtraction, type SignificantMoment, type SignificantMomentsResponse, type SimulateOptions, type SimulationConfig, type SimulationEvent, type SimulationSession, Sonzai, type SonzaiConfig, SonzaiError, type StoredFact, StreamError, type StructuredColumnMapping, type StructuredImportSpec, type SummariesOptions, type SummariesResponse, type TTSOptions, type TTSResponse, type TimeMachineMoodSnapshot, type TimeMachineOptions, type TimeMachineResponse, type TimelineSession, type ToolDefinition, type ToolSchema, type ToolSchemasResponse, type TriggerEventOptions, type TriggerEventResponse, type UpdateAgentOptions, type UpdateAnalyticsRuleOptions, type UpdateCapabilitiesOptions, type UpdateCustomToolOptions, type UpdateGoalOptions, type UpdateInstanceOptions, type UpdateMetadataOptions, type UpdateMetadataResponse, type UpdateProjectOptions, type UpdateProjectResponse, type UserOverlayDetailResponse, type UserOverlayOptions, type UserOverlaysListResponse, type UserPersona, type UserPersonalityOverlay, type UserPrimingMetadata, type UsersResponse, type VoiceEntry, type VoiceListOptions, type VoiceListResponse, type VoiceStreamEvent, VoiceStreamInstance, type VoiceStreamToken, type VoiceTokenOptions, type VoiceUsage, type WakeupsResponse, type WebhookDeliveryAttempt, type WebhookEndpoint, type WebhookListResponse, type WebhookRegisterOptions, type WebhookRegisterResponse };
+export { APIError, type AcknowledgeAllOptions, type AcknowledgeNotificationsOptions, type AcknowledgeResponse, type AddContentOptions, type AddContentResponse, type Agent, type AgentCapabilities, type AgentIndex, type AgentInstance, type AgentKBSearchOptions, type AgentKBSearchResponse, type AgentKBSearchResult, type AgentListOptions, type AgentListResponse, type AgentToolCapabilities, type AtomicFact, AuthenticationError, BadRequestError, type BatchImportOptions, type BatchImportResponse, type BatchImportUser, type BatchPersonalityEntry, type BatchPersonalityResponse, type Big5, type Big5Scores, type Big5Trait, type BreakthroughsResponse, type ChatChoice, type ChatMessage, type ChatOptions, type ChatResponse, type ChatStreamEvent, type ChatUsage, type ConsolidateOptions, type ConsolidateResponse, type ConstellationNode, type ConstellationResponse, type ContextDataOptions, type CreateAgentOptions, type CreateAnalyticsRuleOptions, type CreateConstellationNodeOptions, type CreateCustomToolOptions, type CreateFactOptions, type CreateGoalOptions, type CreateHabitOptions, type CreateSchemaOptions, type CustomLLMConfigResponse, type CustomState, type CustomStateCreateOptions, type CustomStateDeleteByKeyOptions, type CustomStateGetByKeyOptions, type CustomStateListOptions, type CustomStateListResponse, type CustomStateUpdateOptions, type CustomStateUpsertOptions, type CustomToolDefinition, type CustomToolListResponse, type DeleteGoalOptions, type DeleteHabitOptions, type DeliveryAttemptsResponse, type DialogueOptions, type DialogueResponse, type DiaryResponse, type EnrichedContextResponse, type EvalCategory, type EvalOnlyOptions, type EvalRun, type EvalRunListOptions, type EvalRunListResponse, type EvalTemplate, type EvalTemplateCategory, type EvalTemplateCreateOptions, type EvalTemplateListResponse, type EvalTemplateUpdateOptions, type EvaluateOptions, type EvaluationResult, type ExtractionDimensionDelta, type ExtractionFact, type ExtractionHabit, type ExtractionInnerThoughts, type ExtractionInterest, type ExtractionMoodDelta, type ExtractionPersonalityDelta, type ExtractionProactive, type ExtractionRecurring, type ExtractionRelationshipDelta, type Fact, type FactHistoryResponse, type FactListOptions, type FactListResponse, type GenerateAvatarOptions, type GenerateAvatarResponse, type GenerateBioOptions, type GenerateBioResponse, type GenerateCharacterOptions, type GenerateCharacterResponse, type GenerateSeedMemoriesOptions, type GenerateSeedMemoriesResponse, type GeneratedGoal, type GetContextOptions, type Goal, type GoalPriority, type GoalStatus, type GoalType, type GoalsResponse, type Habit, type HabitsResponse, type IdentityMemory, type ImageGenerateOptions, type ImageGenerateResponse, type ImportJob, type ImportJobListResponse, type InitialGoal, type InsertFactDetail, type InsertFactEntry, type InsertFactsOptions, type InsertFactsResponse, type InsertRelEntry, type InstanceCreateOptions, type InstanceListResponse, type InterestsResponse, InternalServerError, type InventoryBatchImportOptions, type InventoryBatchImportResponse, type InventoryBatchItem, type InventoryDirectUpdateOptions, type InventoryDirectUpdateResponse, type InventoryGroupResult, type InventoryItem, type InventoryQueryOptions, type InventoryQueryResponse, type InventoryUpdateOptions, type InventoryUpdateResponse, type KBAnalyticsRule, type KBAnalyticsRuleListResponse, type KBBulkUpdateEntry, type KBBulkUpdateOptions, type KBBulkUpdateResponse, type KBCandidate, type KBConversionStats, type KBConversionsResponse, type KBDocument, type KBDocumentListResponse, type KBEdge, type KBEntitySchema, type KBNode, type KBNodeDetailResponse, type KBNodeHistory, type KBNodeHistoryResponse, type KBNodeListResponse, type KBRecommendationScore, type KBRecommendationsResponse, type KBRelatedNode, type KBResolutionInfo, type KBSchemaField, type KBSchemaListResponse, type KBSearchOptions, type KBSearchResponse, type KBSearchResult, type KBSimilarityConfig, type KBStats, type KBTrendAggregation, type KBTrendRanking, type KBTrendRankingsResponse, type KBTrendsResponse, type ListAllFactsOptions, type ListAllFactsResponse, type LoreGenerationContext, type MemoryListOptions, type MemoryNode, type MemoryResetOptions, type MemoryResetResponse, type MemoryResponse, type MemorySearchOptions, type MemorySearchResponse, type MemorySearchResult, type MemorySummary, type MemoryTimelineOptions, type MemoryTimelineResponse, type ModelsProviderEntry, type ModelsResponse, type MoodAggregateResponse, type MoodResponse, NotFoundError, type Notification, type NotificationListOptions, type NotificationListResponse, PermissionDeniedError, type PersonalityBehaviors, type PersonalityDelta, type PersonalityDimensions, type PersonalityGetOptions, type PersonalityPreferences, type PersonalityProfile, type PersonalityResponse, type PersonalityShift, type PersonalityUpdateOptions, type PersonalityUpdateResponse, type PrimeContentBlock, type PrimeUserMetadata, type PrimeUserOptions, type PrimeUserResponse, type ProcessOptions, type ProcessResponse, type ProcessSideEffectsSummary, type ProjectConfigEntry, type ProjectConfigListResponse, type ProjectNotificationListOptions, type ProjectNotificationListResponse, RateLimitError, type RecentShiftsResponse, type RecordFeedbackOptions, type RelationshipResponse, type RunEvalOptions, type RunRef, type SDKBehavioralTraits, type SDKInteractionPreferences, type SDKPersonalityDimensions, type STTOptions, type STTResponse, type ScheduleWakeupOptions, type ScheduledWakeup, type SeedMemoriesOptions, type SeedMemoriesResponse, type SeedMemory, type SessionEndOptions, type SessionResponse, type SessionStartOptions, type SetConfigOptions, type SetCustomLLMOptions, type SetSessionToolsOptions, type SetStatusOptions, type SetStatusResponse, type SideEffectExtraction, type SignificantMoment, type SignificantMomentsResponse, type SimulateOptions, type SimulationConfig, type SimulationEvent, type SimulationSession, Sonzai, type SonzaiConfig, SonzaiError, type StoredFact, StreamError, type StructuredColumnMapping, type StructuredImportSpec, type SummariesOptions, type SummariesResponse, type TTSOptions, type TTSResponse, type TimeMachineMoodSnapshot, type TimeMachineOptions, type TimeMachineResponse, type TimelineSession, type ToolDefinition, type ToolSchema, type ToolSchemasResponse, type TriggerEventOptions, type TriggerEventResponse, type UpdateAgentOptions, type UpdateAnalyticsRuleOptions, type UpdateCapabilitiesOptions, type UpdateConstellationNodeOptions, type UpdateCustomToolOptions, type UpdateFactOptions, type UpdateGoalOptions, type UpdateHabitOptions, type UpdateInstanceOptions, type UpdateMetadataOptions, type UpdateMetadataResponse, type UpdateProjectOptions, type UpdateProjectResponse, type UserOverlayDetailResponse, type UserOverlayOptions, type UserOverlaysListResponse, type UserPersona, type UserPersonalityOverlay, type UserPrimingMetadata, type UsersResponse, type VoiceEntry, type VoiceListOptions, type VoiceListResponse, type VoiceStreamEvent, VoiceStreamInstance, type VoiceStreamToken, type VoiceTokenOptions, type VoiceUsage, type WakeupsResponse, type WebhookDeliveryAttempt, type WebhookEndpoint, type WebhookListResponse, type WebhookRegisterOptions, type WebhookRegisterResponse };

package/dist/index.d.ts

@@ -288,6 +288,40 @@ interface RelationshipResponse extends Record<string, unknown> {
 }
 interface HabitsResponse extends Record<string, unknown> {
 }
+interface Habit {
+    id?: string;
+    agent_id: string;
+    user_id?: string;
+    name: string;
+    category: string;
+    description: string;
+    display_name?: string;
+    strength: number;
+    formed: boolean;
+    observation_count: number;
+    last_reinforced_at?: string;
+    formed_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CreateHabitOptions {
+    userId?: string;
+    name: string;
+    category?: string;
+    description?: string;
+    displayName?: string;
+    strength?: number;
+}
+interface UpdateHabitOptions {
+    userId?: string;
+    category?: string;
+    description?: string;
+    displayName?: string;
+    strength?: number;
+}
+interface DeleteHabitOptions {
+    userId?: string;
+}
 type GoalType = "personal_growth" | "skill_mastery" | "relationship" | "learning_discovery";
 type GoalStatus = "active" | "achieved" | "abandoned";
 type GoalPriority = 0 | 1 | 2;
@@ -348,6 +382,34 @@ interface UsersResponse extends Record<string, unknown> {
 }
 interface ConstellationResponse extends Record<string, unknown> {
 }
+interface ConstellationNode {
+    node_id: string;
+    agent_id: string;
+    user_id?: string;
+    node_type: string;
+    label: string;
+    description?: string;
+    significance: number;
+    mention_count: number;
+    brightness: number;
+    first_mentioned_at?: string;
+    last_mentioned_at?: string;
+    created_at?: string;
+    updated_at?: string;
+}
+interface CreateConstellationNodeOptions {
+    userId?: string;
+    nodeType?: string;
+    label: string;
+    description?: string;
+    significance?: number;
+}
+interface UpdateConstellationNodeOptions {
+    label?: string;
+    description?: string;
+    significance?: number;
+    nodeType?: string;
+}
 interface BreakthroughsResponse extends Record<string, unknown> {
 }
 interface WakeupsResponse extends Record<string, unknown> {
@@ -788,6 +850,24 @@ interface FactListOptions {
     limit?: number;
     offset?: number;
 }
+interface CreateFactOptions {
+    content: string;
+    userId?: string;
+    factType?: string;
+    importance?: number;
+    confidence?: number;
+    entities?: string[];
+    nodeId?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateFactOptions {
+    content?: string;
+    factType?: string;
+    importance?: number;
+    confidence?: number;
+    entities?: string[];
+    metadata?: Record<string, unknown>;
+}
 interface MemoryResetOptions {
     userId?: string;
     instanceId?: string;
@@ -2000,6 +2080,12 @@ declare class Memory {
     listFacts(agentId: string, options?: FactListOptions): Promise<FactListResponse>;
     /** Reset (delete) all memory for an agent, optionally scoped to a user. */
     reset(agentId: string, options?: MemoryResetOptions): Promise<MemoryResetResponse>;
+    /** Create a new fact for an agent. Facts are tagged source_type='manual'. */
+    createFact(agentId: string, options: CreateFactOptions): Promise<AtomicFact>;
+    /** Update an existing fact by ID. */
+    updateFact(agentId: string, factId: string, options: UpdateFactOptions): Promise<AtomicFact>;
+    /** Delete a fact by ID. */
+    deleteFact(agentId: string, factId: string): Promise<void>;
     /** Get the version history of a specific fact. */
     getFactHistory(agentId: string, factId: string): Promise<FactHistoryResponse>;
 }
@@ -2264,6 +2350,12 @@ declare class Agents {
     getMoodAggregate(agentId: string, options?: ContextDataOptions): Promise<MoodAggregateResponse>;
     getRelationships(agentId: string, options?: ContextDataOptions): Promise<RelationshipResponse>;
     getHabits(agentId: string, options?: ContextDataOptions): Promise<HabitsResponse>;
+    /** Create a habit for an agent. Set userId for a per-user habit. */
+    createHabit(agentId: string, options: CreateHabitOptions): Promise<Habit>;
+    /** Update an existing habit by name. */
+    updateHabit(agentId: string, habitName: string, options: UpdateHabitOptions): Promise<Habit>;
+    /** Delete a habit. Set userId for per-user habits. */
+    deleteHabit(agentId: string, habitName: string, options?: DeleteHabitOptions): Promise<void>;
     getGoals(agentId: string, options?: ContextDataOptions): Promise<GoalsResponse>;
     /** Create a goal for an agent. Set userId to create a per-user goal. */
     createGoal(agentId: string, options: CreateGoalOptions): Promise<Goal>;
@@ -2276,6 +2368,12 @@ declare class Agents {
     getUsers(agentId: string): Promise<UsersResponse>;
     /** Get constellation data for an agent. */
     getConstellation(agentId: string, options?: ContextDataOptions): Promise<ConstellationResponse>;
+    /** Create a constellation node (lore) for an agent. */
+    createConstellationNode(agentId: string, options: CreateConstellationNodeOptions): Promise<ConstellationNode>;
+    /** Update an existing constellation node. */
+    updateConstellationNode(agentId: string, nodeId: string, options: UpdateConstellationNodeOptions): Promise<ConstellationNode>;
+    /** Delete a constellation node. */
+    deleteConstellationNode(agentId: string, nodeId: string): Promise<void>;
     /** Get breakthroughs for an agent. */
     getBreakthroughs(agentId: string, options?: ContextDataOptions): Promise<BreakthroughsResponse>;
     /** List agents with optional pagination, search, and project filtering. */
@@ -2565,4 +2663,4 @@ declare class StreamError extends SonzaiError {
     constructor(message: string);
 }
 
-export { APIError, type AcknowledgeAllOptions, type AcknowledgeNotificationsOptions, type AcknowledgeResponse, type AddContentOptions, type AddContentResponse, type Agent, type AgentCapabilities, type AgentIndex, type AgentInstance, type AgentKBSearchOptions, type AgentKBSearchResponse, type AgentKBSearchResult, type AgentListOptions, type AgentListResponse, type AgentToolCapabilities, type AtomicFact, AuthenticationError, BadRequestError, type BatchImportOptions, type BatchImportResponse, type BatchImportUser, type BatchPersonalityEntry, type BatchPersonalityResponse, type Big5, type Big5Scores, type Big5Trait, type BreakthroughsResponse, type ChatChoice, type ChatMessage, type ChatOptions, type ChatResponse, type ChatStreamEvent, type ChatUsage, type ConsolidateOptions, type ConsolidateResponse, type ConstellationResponse, type ContextDataOptions, type CreateAgentOptions, type CreateAnalyticsRuleOptions, type CreateCustomToolOptions, type CreateGoalOptions, type CreateSchemaOptions, type CustomLLMConfigResponse, type CustomState, type CustomStateCreateOptions, type CustomStateDeleteByKeyOptions, type CustomStateGetByKeyOptions, type CustomStateListOptions, type CustomStateListResponse, type CustomStateUpdateOptions, type CustomStateUpsertOptions, type CustomToolDefinition, type CustomToolListResponse, type DeleteGoalOptions, type DeliveryAttemptsResponse, type DialogueOptions, type DialogueResponse, type DiaryResponse, type EnrichedContextResponse, type EvalCategory, type EvalOnlyOptions, type EvalRun, type EvalRunListOptions, type EvalRunListResponse, type EvalTemplate, type EvalTemplateCategory, type EvalTemplateCreateOptions, type EvalTemplateListResponse, type EvalTemplateUpdateOptions, type EvaluateOptions, type EvaluationResult, type ExtractionDimensionDelta, type ExtractionFact, type ExtractionHabit, type ExtractionInnerThoughts, type ExtractionInterest, type ExtractionMoodDelta, type ExtractionPersonalityDelta, type ExtractionProactive, type ExtractionRecurring, type ExtractionRelationshipDelta, type Fact, type FactHistoryResponse, type FactListOptions, type FactListResponse, type GenerateAvatarOptions, type GenerateAvatarResponse, type GenerateBioOptions, type GenerateBioResponse, type GenerateCharacterOptions, type GenerateCharacterResponse, type GenerateSeedMemoriesOptions, type GenerateSeedMemoriesResponse, type GeneratedGoal, type GetContextOptions, type Goal, type GoalPriority, type GoalStatus, type GoalType, type GoalsResponse, type HabitsResponse, type IdentityMemory, type ImageGenerateOptions, type ImageGenerateResponse, type ImportJob, type ImportJobListResponse, type InitialGoal, type InsertFactDetail, type InsertFactEntry, type InsertFactsOptions, type InsertFactsResponse, type InsertRelEntry, type InstanceCreateOptions, type InstanceListResponse, type InterestsResponse, InternalServerError, type InventoryBatchImportOptions, type InventoryBatchImportResponse, type InventoryBatchItem, type InventoryDirectUpdateOptions, type InventoryDirectUpdateResponse, type InventoryGroupResult, type InventoryItem, type InventoryQueryOptions, type InventoryQueryResponse, type InventoryUpdateOptions, type InventoryUpdateResponse, type KBAnalyticsRule, type KBAnalyticsRuleListResponse, type KBBulkUpdateEntry, type KBBulkUpdateOptions, type KBBulkUpdateResponse, type KBCandidate, type KBConversionStats, type KBConversionsResponse, type KBDocument, type KBDocumentListResponse, type KBEdge, type KBEntitySchema, type KBNode, type KBNodeDetailResponse, type KBNodeHistory, type KBNodeHistoryResponse, type KBNodeListResponse, type KBRecommendationScore, type KBRecommendationsResponse, type KBRelatedNode, type KBResolutionInfo, type KBSchemaField, type KBSchemaListResponse, type KBSearchOptions, type KBSearchResponse, type KBSearchResult, type KBSimilarityConfig, type KBStats, type KBTrendAggregation, type KBTrendRanking, type KBTrendRankingsResponse, type KBTrendsResponse, type ListAllFactsOptions, type ListAllFactsResponse, type LoreGenerationContext, type MemoryListOptions, type MemoryNode, type MemoryResetOptions, type MemoryResetResponse, type MemoryResponse, type MemorySearchOptions, type MemorySearchResponse, type MemorySearchResult, type MemorySummary, type MemoryTimelineOptions, type MemoryTimelineResponse, type ModelsProviderEntry, type ModelsResponse, type MoodAggregateResponse, type MoodResponse, NotFoundError, type Notification, type NotificationListOptions, type NotificationListResponse, PermissionDeniedError, type PersonalityBehaviors, type PersonalityDelta, type PersonalityDimensions, type PersonalityGetOptions, type PersonalityPreferences, type PersonalityProfile, type PersonalityResponse, type PersonalityShift, type PersonalityUpdateOptions, type PersonalityUpdateResponse, type PrimeContentBlock, type PrimeUserMetadata, type PrimeUserOptions, type PrimeUserResponse, type ProcessOptions, type ProcessResponse, type ProcessSideEffectsSummary, type ProjectConfigEntry, type ProjectConfigListResponse, type ProjectNotificationListOptions, type ProjectNotificationListResponse, RateLimitError, type RecentShiftsResponse, type RecordFeedbackOptions, type RelationshipResponse, type RunEvalOptions, type RunRef, type SDKBehavioralTraits, type SDKInteractionPreferences, type SDKPersonalityDimensions, type STTOptions, type STTResponse, type ScheduleWakeupOptions, type ScheduledWakeup, type SeedMemoriesOptions, type SeedMemoriesResponse, type SeedMemory, type SessionEndOptions, type SessionResponse, type SessionStartOptions, type SetConfigOptions, type SetCustomLLMOptions, type SetSessionToolsOptions, type SetStatusOptions, type SetStatusResponse, type SideEffectExtraction, type SignificantMoment, type SignificantMomentsResponse, type SimulateOptions, type SimulationConfig, type SimulationEvent, type SimulationSession, Sonzai, type SonzaiConfig, SonzaiError, type StoredFact, StreamError, type StructuredColumnMapping, type StructuredImportSpec, type SummariesOptions, type SummariesResponse, type TTSOptions, type TTSResponse, type TimeMachineMoodSnapshot, type TimeMachineOptions, type TimeMachineResponse, type TimelineSession, type ToolDefinition, type ToolSchema, type ToolSchemasResponse, type TriggerEventOptions, type TriggerEventResponse, type UpdateAgentOptions, type UpdateAnalyticsRuleOptions, type UpdateCapabilitiesOptions, type UpdateCustomToolOptions, type UpdateGoalOptions, type UpdateInstanceOptions, type UpdateMetadataOptions, type UpdateMetadataResponse, type UpdateProjectOptions, type UpdateProjectResponse, type UserOverlayDetailResponse, type UserOverlayOptions, type UserOverlaysListResponse, type UserPersona, type UserPersonalityOverlay, type UserPrimingMetadata, type UsersResponse, type VoiceEntry, type VoiceListOptions, type VoiceListResponse, type VoiceStreamEvent, VoiceStreamInstance, type VoiceStreamToken, type VoiceTokenOptions, type VoiceUsage, type WakeupsResponse, type WebhookDeliveryAttempt, type WebhookEndpoint, type WebhookListResponse, type WebhookRegisterOptions, type WebhookRegisterResponse };
+export { APIError, type AcknowledgeAllOptions, type AcknowledgeNotificationsOptions, type AcknowledgeResponse, type AddContentOptions, type AddContentResponse, type Agent, type AgentCapabilities, type AgentIndex, type AgentInstance, type AgentKBSearchOptions, type AgentKBSearchResponse, type AgentKBSearchResult, type AgentListOptions, type AgentListResponse, type AgentToolCapabilities, type AtomicFact, AuthenticationError, BadRequestError, type BatchImportOptions, type BatchImportResponse, type BatchImportUser, type BatchPersonalityEntry, type BatchPersonalityResponse, type Big5, type Big5Scores, type Big5Trait, type BreakthroughsResponse, type ChatChoice, type ChatMessage, type ChatOptions, type ChatResponse, type ChatStreamEvent, type ChatUsage, type ConsolidateOptions, type ConsolidateResponse, type ConstellationNode, type ConstellationResponse, type ContextDataOptions, type CreateAgentOptions, type CreateAnalyticsRuleOptions, type CreateConstellationNodeOptions, type CreateCustomToolOptions, type CreateFactOptions, type CreateGoalOptions, type CreateHabitOptions, type CreateSchemaOptions, type CustomLLMConfigResponse, type CustomState, type CustomStateCreateOptions, type CustomStateDeleteByKeyOptions, type CustomStateGetByKeyOptions, type CustomStateListOptions, type CustomStateListResponse, type CustomStateUpdateOptions, type CustomStateUpsertOptions, type CustomToolDefinition, type CustomToolListResponse, type DeleteGoalOptions, type DeleteHabitOptions, type DeliveryAttemptsResponse, type DialogueOptions, type DialogueResponse, type DiaryResponse, type EnrichedContextResponse, type EvalCategory, type EvalOnlyOptions, type EvalRun, type EvalRunListOptions, type EvalRunListResponse, type EvalTemplate, type EvalTemplateCategory, type EvalTemplateCreateOptions, type EvalTemplateListResponse, type EvalTemplateUpdateOptions, type EvaluateOptions, type EvaluationResult, type ExtractionDimensionDelta, type ExtractionFact, type ExtractionHabit, type ExtractionInnerThoughts, type ExtractionInterest, type ExtractionMoodDelta, type ExtractionPersonalityDelta, type ExtractionProactive, type ExtractionRecurring, type ExtractionRelationshipDelta, type Fact, type FactHistoryResponse, type FactListOptions, type FactListResponse, type GenerateAvatarOptions, type GenerateAvatarResponse, type GenerateBioOptions, type GenerateBioResponse, type GenerateCharacterOptions, type GenerateCharacterResponse, type GenerateSeedMemoriesOptions, type GenerateSeedMemoriesResponse, type GeneratedGoal, type GetContextOptions, type Goal, type GoalPriority, type GoalStatus, type GoalType, type GoalsResponse, type Habit, type HabitsResponse, type IdentityMemory, type ImageGenerateOptions, type ImageGenerateResponse, type ImportJob, type ImportJobListResponse, type InitialGoal, type InsertFactDetail, type InsertFactEntry, type InsertFactsOptions, type InsertFactsResponse, type InsertRelEntry, type InstanceCreateOptions, type InstanceListResponse, type InterestsResponse, InternalServerError, type InventoryBatchImportOptions, type InventoryBatchImportResponse, type InventoryBatchItem, type InventoryDirectUpdateOptions, type InventoryDirectUpdateResponse, type InventoryGroupResult, type InventoryItem, type InventoryQueryOptions, type InventoryQueryResponse, type InventoryUpdateOptions, type InventoryUpdateResponse, type KBAnalyticsRule, type KBAnalyticsRuleListResponse, type KBBulkUpdateEntry, type KBBulkUpdateOptions, type KBBulkUpdateResponse, type KBCandidate, type KBConversionStats, type KBConversionsResponse, type KBDocument, type KBDocumentListResponse, type KBEdge, type KBEntitySchema, type KBNode, type KBNodeDetailResponse, type KBNodeHistory, type KBNodeHistoryResponse, type KBNodeListResponse, type KBRecommendationScore, type KBRecommendationsResponse, type KBRelatedNode, type KBResolutionInfo, type KBSchemaField, type KBSchemaListResponse, type KBSearchOptions, type KBSearchResponse, type KBSearchResult, type KBSimilarityConfig, type KBStats, type KBTrendAggregation, type KBTrendRanking, type KBTrendRankingsResponse, type KBTrendsResponse, type ListAllFactsOptions, type ListAllFactsResponse, type LoreGenerationContext, type MemoryListOptions, type MemoryNode, type MemoryResetOptions, type MemoryResetResponse, type MemoryResponse, type MemorySearchOptions, type MemorySearchResponse, type MemorySearchResult, type MemorySummary, type MemoryTimelineOptions, type MemoryTimelineResponse, type ModelsProviderEntry, type ModelsResponse, type MoodAggregateResponse, type MoodResponse, NotFoundError, type Notification, type NotificationListOptions, type NotificationListResponse, PermissionDeniedError, type PersonalityBehaviors, type PersonalityDelta, type PersonalityDimensions, type PersonalityGetOptions, type PersonalityPreferences, type PersonalityProfile, type PersonalityResponse, type PersonalityShift, type PersonalityUpdateOptions, type PersonalityUpdateResponse, type PrimeContentBlock, type PrimeUserMetadata, type PrimeUserOptions, type PrimeUserResponse, type ProcessOptions, type ProcessResponse, type ProcessSideEffectsSummary, type ProjectConfigEntry, type ProjectConfigListResponse, type ProjectNotificationListOptions, type ProjectNotificationListResponse, RateLimitError, type RecentShiftsResponse, type RecordFeedbackOptions, type RelationshipResponse, type RunEvalOptions, type RunRef, type SDKBehavioralTraits, type SDKInteractionPreferences, type SDKPersonalityDimensions, type STTOptions, type STTResponse, type ScheduleWakeupOptions, type ScheduledWakeup, type SeedMemoriesOptions, type SeedMemoriesResponse, type SeedMemory, type SessionEndOptions, type SessionResponse, type SessionStartOptions, type SetConfigOptions, type SetCustomLLMOptions, type SetSessionToolsOptions, type SetStatusOptions, type SetStatusResponse, type SideEffectExtraction, type SignificantMoment, type SignificantMomentsResponse, type SimulateOptions, type SimulationConfig, type SimulationEvent, type SimulationSession, Sonzai, type SonzaiConfig, SonzaiError, type StoredFact, StreamError, type StructuredColumnMapping, type StructuredImportSpec, type SummariesOptions, type SummariesResponse, type TTSOptions, type TTSResponse, type TimeMachineMoodSnapshot, type TimeMachineOptions, type TimeMachineResponse, type TimelineSession, type ToolDefinition, type ToolSchema, type ToolSchemasResponse, type TriggerEventOptions, type TriggerEventResponse, type UpdateAgentOptions, type UpdateAnalyticsRuleOptions, type UpdateCapabilitiesOptions, type UpdateConstellationNodeOptions, type UpdateCustomToolOptions, type UpdateFactOptions, type UpdateGoalOptions, type UpdateHabitOptions, type UpdateInstanceOptions, type UpdateMetadataOptions, type UpdateMetadataResponse, type UpdateProjectOptions, type UpdateProjectResponse, type UserOverlayDetailResponse, type UserOverlayOptions, type UserOverlaysListResponse, type UserPersona, type UserPersonalityOverlay, type UserPrimingMetadata, type UsersResponse, type VoiceEntry, type VoiceListOptions, type VoiceListResponse, type VoiceStreamEvent, VoiceStreamInstance, type VoiceStreamToken, type VoiceTokenOptions, type VoiceUsage, type WakeupsResponse, type WebhookDeliveryAttempt, type WebhookEndpoint, type WebhookListResponse, type WebhookRegisterOptions, type WebhookRegisterResponse };

package/dist/index.js

@@ -69,7 +69,7 @@ var HTTPClient = class {
     this.headers = {
       Authorization: `Bearer ${options.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "sonzai-typescript/1.0.3"
+      "User-Agent": "sonzai-typescript/1.0.9"
     };
     this.timeout = options.timeout;
     this.maxRetries = options.maxRetries;
@@ -555,6 +555,41 @@ var Memory = class {
       }
     );
   }
+  /** Create a new fact for an agent. Facts are tagged source_type='manual'. */
+  async createFact(agentId, options) {
+    const body = {
+      content: options.content
+    };
+    if (options.userId) body.user_id = options.userId;
+    if (options.factType) body.fact_type = options.factType;
+    if (options.importance != null) body.importance = options.importance;
+    if (options.confidence != null) body.confidence = options.confidence;
+    if (options.entities) body.entities = options.entities;
+    if (options.nodeId) body.node_id = options.nodeId;
+    if (options.metadata) body.metadata = options.metadata;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/memory/facts`,
+      body
+    );
+  }
+  /** Update an existing fact by ID. */
+  async updateFact(agentId, factId, options) {
+    const body = {};
+    if (options.content) body.content = options.content;
+    if (options.factType) body.fact_type = options.factType;
+    if (options.importance != null) body.importance = options.importance;
+    if (options.confidence != null) body.confidence = options.confidence;
+    if (options.entities) body.entities = options.entities;
+    if (options.metadata) body.metadata = options.metadata;
+    return this.http.put(
+      `/api/v1/agents/${agentId}/memory/facts/${factId}`,
+      body
+    );
+  }
+  /** Delete a fact by ID. */
+  async deleteFact(agentId, factId) {
+    await this.http.delete(`/api/v1/agents/${agentId}/memory/facts/${factId}`);
+  }
   /** Get the version history of a specific fact. */
   async getFactHistory(agentId, factId) {
     return this.http.get(`/api/v1/agents/${agentId}/memory/fact/${factId}/history`);
@@ -1391,6 +1426,43 @@ var Agents = class {
       instance_id: options.instanceId
     });
   }
+  /** Create a habit for an agent. Set userId for a per-user habit. */
+  async createHabit(agentId, options) {
+    const body = {
+      name: options.name
+    };
+    if (options.userId) body.user_id = options.userId;
+    if (options.category) body.category = options.category;
+    if (options.description) body.description = options.description;
+    if (options.displayName) body.display_name = options.displayName;
+    if (options.strength != null) body.strength = options.strength;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/habits`,
+      body
+    );
+  }
+  /** Update an existing habit by name. */
+  async updateHabit(agentId, habitName, options) {
+    const body = {};
+    if (options.userId) body.user_id = options.userId;
+    if (options.category) body.category = options.category;
+    if (options.description) body.description = options.description;
+    if (options.displayName) body.display_name = options.displayName;
+    if (options.strength != null) body.strength = options.strength;
+    return this.http.put(
+      `/api/v1/agents/${agentId}/habits/${encodeURIComponent(habitName)}`,
+      body
+    );
+  }
+  /** Delete a habit. Set userId for per-user habits. */
+  async deleteHabit(agentId, habitName, options = {}) {
+    const params = {};
+    if (options.userId) params.user_id = options.userId;
+    await this.http.delete(
+      `/api/v1/agents/${agentId}/habits/${encodeURIComponent(habitName)}`,
+      params
+    );
+  }
   async getGoals(agentId, options = {}) {
     return this.http.get(`/api/v1/agents/${agentId}/goals`, {
       user_id: options.userId,
@@ -1457,6 +1529,38 @@ var Agents = class {
       instance_id: options.instanceId
     });
   }
+  /** Create a constellation node (lore) for an agent. */
+  async createConstellationNode(agentId, options) {
+    const body = {
+      label: options.label
+    };
+    if (options.userId) body.user_id = options.userId;
+    if (options.nodeType) body.node_type = options.nodeType;
+    if (options.description) body.description = options.description;
+    if (options.significance != null) body.significance = options.significance;
+    return this.http.post(
+      `/api/v1/agents/${agentId}/constellation/nodes`,
+      body
+    );
+  }
+  /** Update an existing constellation node. */
+  async updateConstellationNode(agentId, nodeId, options) {
+    const body = {};
+    if (options.label) body.label = options.label;
+    if (options.description) body.description = options.description;
+    if (options.significance != null) body.significance = options.significance;
+    if (options.nodeType) body.node_type = options.nodeType;
+    return this.http.put(
+      `/api/v1/agents/${agentId}/constellation/nodes/${nodeId}`,
+      body
+    );
+  }
+  /** Delete a constellation node. */
+  async deleteConstellationNode(agentId, nodeId) {
+    await this.http.delete(
+      `/api/v1/agents/${agentId}/constellation/nodes/${nodeId}`
+    );
+  }
   /** Get breakthroughs for an agent. */
   async getBreakthroughs(agentId, options = {}) {
     return this.http.get(`/api/v1/agents/${agentId}/breakthroughs`, {