agent-inbox 0.0.1 → 0.1.2

package/dist/types.d.ts

@@ -0,0 +1,261 @@
+export type AgentStatus = "active" | "idle" | "offline";
+export interface Agent {
+    agent_id: string;
+    display_name?: string;
+    program?: string;
+    model?: string;
+    scope: string;
+    status: AgentStatus;
+    metadata: Record<string, unknown>;
+    registered_at: string;
+    last_active_at: string;
+}
+export type MessageContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "data";
+    schema?: string;
+    data: unknown;
+} | {
+    type: "event";
+    event: string;
+    data?: unknown;
+} | {
+    type: "reference";
+    uri: string;
+    label?: string;
+} | {
+    type: string;
+    [key: string]: unknown;
+};
+export type RecipientKind = "to" | "cc" | "bcc";
+export type Importance = "low" | "normal" | "high" | "urgent";
+export interface Recipient {
+    agent_id: string;
+    kind: RecipientKind;
+    delivered_at?: string;
+    read_at?: string;
+    ack_at?: string;
+}
+export interface Message {
+    id: string;
+    scope: string;
+    sender_id: string;
+    recipients: Recipient[];
+    subject?: string;
+    content: MessageContent;
+    thread_tag?: string;
+    in_reply_to?: string;
+    conversation_id?: string;
+    importance: Importance;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export type ConversationStatus = "active" | "completed" | "archived";
+export interface Participant {
+    agent_id: string;
+    role?: string;
+    joined_at: string;
+}
+export interface Conversation {
+    id: string;
+    scope: string;
+    subject?: string;
+    status: ConversationStatus;
+    participants: Participant[];
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export type ContentType = "text" | "data" | "event" | "reference" | string;
+export interface Turn {
+    id: string;
+    conversation_id: string;
+    participant_id: string;
+    source_message_id?: string;
+    content_type: ContentType;
+    content: MessageContent;
+    thread_id?: string;
+    in_reply_to?: string;
+    created_at: string;
+}
+export interface Thread {
+    id: string;
+    conversation_id: string;
+    root_turn_id: string;
+    parent_thread_id?: string;
+    subject?: string;
+    created_at: string;
+}
+export interface IpcSendCommand {
+    action: "send";
+    from: string;
+    to: string | string[] | {
+        agent_id: string;
+        kind?: RecipientKind;
+    }[];
+    payload: unknown;
+    scope?: string;
+    threadTag?: string;
+    inReplyTo?: string;
+    importance?: Importance;
+    meta?: Record<string, unknown>;
+}
+export interface IpcEmitCommand {
+    action: "emit";
+    event: unknown;
+    meta?: Record<string, unknown>;
+}
+export interface IpcNotifyCommand {
+    action: "notify";
+    event: {
+        type: string;
+        agent?: {
+            agentId: string;
+            name?: string;
+            role?: string;
+            scopes?: string[];
+            metadata?: Record<string, unknown>;
+        };
+        agentId?: string;
+        reason?: string;
+        [key: string]: unknown;
+    };
+}
+export interface IpcCheckInboxCommand {
+    action: "check_inbox";
+    agentId?: string;
+    scope?: string;
+    unreadOnly?: boolean;
+    clear?: boolean;
+}
+export interface IpcPingCommand {
+    action: "ping";
+}
+export type IpcCommand = IpcSendCommand | IpcEmitCommand | IpcNotifyCommand | IpcCheckInboxCommand | IpcPingCommand;
+export interface IpcResponse {
+    ok: boolean;
+    messageId?: string;
+    messages?: Message[];
+    error?: string;
+    pid?: number;
+}
+export type WarmAgentStatus = "active" | "away" | "expired";
+export interface AgentRegistryConfig {
+    /** Time after disconnect before away → expired (default: 60000ms) */
+    gracePeriodMs: number;
+    /** How long to keep expired entries for audit (default: 3600000ms) */
+    retainExpiredMs: number;
+    /** Flush queued messages when agent reconnects (default: true) */
+    requeueOnReconnect: boolean;
+}
+export interface FederatedAddress {
+    agent?: string;
+    system?: string;
+    scope?: string;
+}
+export interface FederationPeerConfig {
+    systemId: string;
+    url: string;
+    auth?: FederationAuth;
+    exposure?: ExposurePolicy;
+}
+export interface FederationAuth {
+    method: "bearer" | "api-key" | "mtls" | "did:wba" | "none";
+    token?: string;
+    key?: string;
+}
+export type ExposureLevel = "none" | "gateway" | "tagged" | "all";
+export interface ExposurePolicy {
+    agents: ExposureLevel;
+    scopes?: string[];
+    events?: ExposureLevel;
+}
+export interface FederationLink {
+    peerId: string;
+    sessionId: string;
+    status: "connected" | "disconnected" | "authenticating";
+    exposure: ExposurePolicy;
+    url: string;
+    connectedAt?: string;
+}
+export interface SystemId {
+    id: string;
+    source: "config" | "map" | "auto";
+}
+export interface FederationRoutingConfig {
+    strategy: "table" | "broadcast" | "hierarchical";
+    /** Routing entry TTL in ms (default: 300000) */
+    tableTTL?: number;
+    /** Re-query peers on cache miss before failing (default: true) */
+    refreshOnMiss?: boolean;
+    /** Ms to wait for first responder in broadcast mode (default: 5000) */
+    broadcastTimeout?: number;
+    /** System IDs of upstream hubs for hierarchical routing */
+    upstream?: string[];
+}
+export interface DeliveryQueueConfig {
+    persistence: "memory" | "sqlite";
+    /** Max age before dropping in ms (default: 86400000 / 24h) */
+    maxTTL: number;
+    /** Max messages per destination (default: 10000) */
+    maxQueueSize: number;
+    retryStrategy: "exponential" | "fixed";
+    /** Base retry interval in ms (default: 1000) */
+    retryBaseInterval: number;
+    /** Max retries, 0 = unlimited until TTL (default: 0) */
+    retryMaxAttempts: number;
+    /** Drain queue when connection restored (default: true) */
+    flushOnReconnect: boolean;
+    overflow: "drop-oldest" | "drop-newest" | "reject-new";
+}
+export interface FederationTrustPolicy {
+    /** System IDs or URLs allowed to connect (Layer 1 — implemented) */
+    allowedServers: string[];
+    /** Local scope → allowed remote scopes (Layer 2 — stub) */
+    scopePermissions: Record<string, string[]>;
+    /** Require tokens for cross-server delivery (Layer 3 — stub) */
+    requireAuth: boolean;
+    authMethod?: "bearer" | "api-key" | "mtls" | "did:wba";
+    authTokens?: Record<string, string>;
+}
+export interface FederationConfig {
+    systemId?: string;
+    peers?: FederationPeerConfig[];
+    routing?: Partial<FederationRoutingConfig>;
+    deliveryQueue?: Partial<DeliveryQueueConfig>;
+    trust?: Partial<FederationTrustPolicy>;
+    registry?: Partial<AgentRegistryConfig>;
+}
+export interface RoutingEntry {
+    agentId: string;
+    peerId: string;
+    lastSeen: string;
+    status: WarmAgentStatus;
+}
+export interface QueuedMessage {
+    id: string;
+    peerId: string;
+    message: Message;
+    enqueuedAt: string;
+    attempts: number;
+    lastAttempt?: string;
+    nextRetry?: string;
+}
+export interface InboxConfig {
+    socketPath?: string;
+    scope?: string;
+    map?: {
+        enabled: boolean;
+        server?: string;
+        scope?: string;
+        systemId?: string;
+        auth?: {
+            token?: string;
+            param?: string;
+        };
+    };
+    federation?: FederationConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// Core types for Agent Inbox
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6BAA6B"}