@amigo-ai/platform-sdk 0.1.0

package/dist/types/resources/world.d.ts

@@ -0,0 +1,177 @@
+import type { Entity, WorldEvent, TimelineEntry, SimilarEntitiesResponse, CreateEntityRequest, UpdateEntityRequest, EmitEventRequest, MergeEntitiesRequest, PaginatedResponse, EntityType } from '../types/api.js';
+import type { EntityId } from '../core/branded-types.js';
+import { WorkspaceScopedResource } from './base.js';
+import type { ListParams } from '../core/utils.js';
+export interface ListEntitiesParams extends ListParams {
+    entity_type?: EntityType;
+    canonical_id?: string;
+    search?: string;
+    source_system?: string;
+    tags?: string;
+}
+export interface TimelineParams {
+    limit?: number;
+    event_type?: string;
+    start_date?: string;
+    end_date?: string;
+}
+export interface EntityRelationship {
+    id: string;
+    source_entity_id: string;
+    target_entity_id: string;
+    relationship_type: string;
+    confidence: number;
+    properties: Record<string, unknown>;
+    created_at: string;
+}
+export interface EntityType_ {
+    type: string;
+    count: number;
+    schema: Record<string, unknown> | null;
+}
+export interface EntityGraph {
+    nodes: Array<{
+        entity: Entity;
+        depth: number;
+    }>;
+    edges: Array<EntityRelationship>;
+}
+export interface EntityProvenance {
+    entity_id: string;
+    sources: Array<{
+        system: string;
+        external_id: string | null;
+        first_seen_at: string;
+        last_seen_at: string;
+        event_count: number;
+    }>;
+}
+export interface EntityLineage {
+    entity_id: string;
+    merged_into: string | null;
+    merged_from: string[];
+    canonical_id: string | null;
+}
+export interface SyncEvent {
+    id: string;
+    entity_id: string;
+    sink: string;
+    status: 'pending' | 'synced' | 'failed' | 'retrying';
+    error: string | null;
+    attempts: number;
+    created_at: string;
+    synced_at: string | null;
+}
+export interface SyncStatusBySink {
+    sink: string;
+    pending: number;
+    synced: number;
+    failed: number;
+    last_synced_at: string | null;
+}
+export interface SourceBreakdown {
+    source: string;
+    entity_count: number;
+    event_count: number;
+    last_seen_at: string | null;
+}
+export interface EntityStats {
+    total_entities: number;
+    total_events: number;
+    entity_types: Array<{
+        type: string;
+        count: number;
+    }>;
+    sources: Array<{
+        source: string;
+        count: number;
+    }>;
+}
+export interface SearchEntitiesParams {
+    q: string;
+    entity_type?: EntityType;
+    limit?: number;
+}
+export interface ListSyncEventsParams extends ListParams {
+    sink?: string;
+    status?: string;
+    start_date?: string;
+    end_date?: string;
+}
+export interface DuplicatesParams extends ListParams {
+    entity_type?: EntityType;
+    min_confidence?: number;
+}
+/**
+ * World Model — entities, events, relationships, and the entity timeline.
+ *
+ * The world model is the core knowledge graph of the platform. Entities
+ * represent real-world objects (patients, contacts, calls). Events record
+ * observations about entities over time.
+ */
+export declare class WorldResource extends WorkspaceScopedResource {
+    /** Create a new entity */
+    createEntity(body: CreateEntityRequest): Promise<Entity>;
+    /** List entities with optional filtering */
+    listEntities(params?: ListEntitiesParams): Promise<PaginatedResponse<Entity>>;
+    /** Get a single entity */
+    getEntity(entityId: EntityId | string): Promise<Entity>;
+    /** Update entity properties */
+    updateEntity(entityId: EntityId | string, body: UpdateEntityRequest): Promise<Entity>;
+    /** Get all relationships for an entity */
+    getRelationships(entityId: EntityId | string): Promise<EntityRelationship[]>;
+    /** Get the knowledge graph centered on an entity (entity + neighbors + edges) */
+    getGraph(entityId: EntityId | string): Promise<EntityGraph>;
+    /** Get provenance — which source systems contributed data for an entity */
+    getProvenance(entityId: EntityId | string): Promise<EntityProvenance>;
+    /** Get lineage — merge history and canonical identity for an entity */
+    getLineage(entityId: EntityId | string): Promise<EntityLineage>;
+    /** Get merged entities for a canonical entity */
+    getMerged(entityId: EntityId | string): Promise<Entity[]>;
+    /** List registered entity types with counts and schemas */
+    listEntityTypes(): Promise<EntityType_[]>;
+    /** List potential duplicate entity pairs for review or merging */
+    listDuplicates(params?: DuplicatesParams): Promise<PaginatedResponse<{
+        entity_a: Entity;
+        entity_b: Entity;
+        confidence: number;
+    }>>;
+    /** Semantic (vector) search over entities */
+    search(params: SearchEntitiesParams): Promise<Array<{
+        entity: Entity;
+        score: number;
+    }>>;
+    /**
+     * Emit an event for an entity.
+     * Events flow to Delta via ZeroBus for downstream analytics.
+     */
+    emitEvent(body: EmitEventRequest): Promise<WorldEvent>;
+    /** Get the event timeline for an entity (reverse-chronological) */
+    getTimeline(entityId: EntityId | string, params?: TimelineParams): Promise<TimelineEntry[]>;
+    /** Get AI-derived intelligence for an entity */
+    getIntelligence(entityId: EntityId | string): Promise<Record<string, unknown>>;
+    /** Find entities similar to a given entity using vector similarity */
+    getSimilar(entityId: EntityId | string, limit?: number): Promise<SimilarEntitiesResponse>;
+    /** Merge multiple entities into one canonical entity */
+    merge(body: MergeEntitiesRequest): Promise<Entity>;
+    /** Get sync status grouped by sink (Lakebase, Delta, etc.) */
+    getSyncStatusBySink(): Promise<SyncStatusBySink[]>;
+    /** List sync events with status filtering */
+    listSyncEvents(params?: ListSyncEventsParams): Promise<PaginatedResponse<SyncEvent>>;
+    /** Get current sync queue depth */
+    getSyncQueueDepth(): Promise<{
+        depth: number;
+        oldest_pending_at: string | null;
+    }>;
+    /** Retry a single failed sync event */
+    retrySyncEvent(eventId: string): Promise<SyncEvent>;
+    /** Retry all failed sync events */
+    retryAllSyncEvents(): Promise<{
+        queued: number;
+    }>;
+    /** Get aggregate entity and event statistics */
+    getStats(): Promise<EntityStats>;
+    /** Get entity counts broken down by source system */
+    getSourceBreakdown(): Promise<SourceBreakdown[]>;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/types/resources/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../../src/resources/world.ts"],"names":[],"mappings":"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"}