@yoda.digital/iris-gateway 1.13.3

package/dist/proactive/store.js

@@ -0,0 +1,186 @@
+import { randomUUID } from "node:crypto";
+export class IntentStore {
+    db;
+    constructor(vaultDb) {
+        this.db = vaultDb.raw();
+    }
+    // ── Intents (active layer) ──
+    addIntent(params) {
+        const id = randomUUID();
+        this.db
+            .prepare(`INSERT INTO proactive_intents
+         (id, session_id, channel_id, chat_id, sender_id, what, why, category, confidence, execute_at, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, params.sessionId, params.channelId, params.chatId, params.senderId, params.what, params.why ?? null, params.category ?? null, params.confidence ?? 0.8, params.executeAt, Date.now());
+        return id;
+    }
+    listPendingIntents(limit = 10) {
+        const rows = this.db
+            .prepare(`SELECT * FROM proactive_intents
+         WHERE executed_at IS NULL AND execute_at <= ?
+         ORDER BY execute_at ASC LIMIT ?`)
+            .all(Date.now(), limit);
+        return rows.map((r) => this.toIntent(r));
+    }
+    listAllPending(limit = 20) {
+        return {
+            intents: this.listPendingIntents(limit),
+            triggers: this.listPendingTriggers(limit),
+        };
+    }
+    cancelIntent(id) {
+        const result = this.db
+            .prepare("UPDATE proactive_intents SET executed_at = ?, result = 'cancelled' WHERE id = ? AND executed_at IS NULL")
+            .run(Date.now(), id);
+        return result.changes > 0;
+    }
+    markIntentExecuted(id, result) {
+        this.db
+            .prepare("UPDATE proactive_intents SET executed_at = ?, result = ? WHERE id = ?")
+            .run(Date.now(), result, id);
+    }
+    // ── Triggers (passive layer) ──
+    addTrigger(params) {
+        const id = randomUUID();
+        this.db
+            .prepare(`INSERT INTO proactive_triggers
+         (id, type, channel_id, chat_id, sender_id, context, execute_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`)
+            .run(id, params.type, params.channelId, params.chatId, params.senderId, params.context, params.executeAt);
+        return id;
+    }
+    listPendingTriggers(limit = 10) {
+        const rows = this.db
+            .prepare(`SELECT * FROM proactive_triggers
+         WHERE executed_at IS NULL AND execute_at <= ?
+         ORDER BY execute_at ASC LIMIT ?`)
+            .all(Date.now(), limit);
+        return rows.map((r) => this.toTrigger(r));
+    }
+    hasPendingTrigger(senderId, type) {
+        const row = this.db
+            .prepare("SELECT 1 FROM proactive_triggers WHERE sender_id = ? AND type = ? AND executed_at IS NULL LIMIT 1")
+            .get(senderId, type);
+        return row !== undefined;
+    }
+    markTriggerExecuted(id, result) {
+        this.db
+            .prepare("UPDATE proactive_triggers SET executed_at = ?, result = ? WHERE id = ?")
+            .run(Date.now(), result, id);
+    }
+    // ── Engagement tracking + soft quotas ──
+    logProactiveMessage(params) {
+        const id = randomUUID();
+        this.db
+            .prepare(`INSERT INTO proactive_log (id, sender_id, channel_id, type, source_id, sent_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(id, params.senderId, params.channelId, params.type, params.sourceId, Date.now());
+        return id;
+    }
+    markEngaged(senderId, channelId) {
+        this.db
+            .prepare(`UPDATE proactive_log SET engaged = 1, engagement_at = ?
+         WHERE id = (
+           SELECT id FROM proactive_log
+           WHERE sender_id = ? AND channel_id = ? AND engaged = 0
+           ORDER BY sent_at DESC LIMIT 1
+         )`)
+            .run(Date.now(), senderId, channelId);
+    }
+    getQuotaStatus(senderId, channelId, perUserPerDay) {
+        const todayStart = new Date();
+        todayStart.setHours(0, 0, 0, 0);
+        const row = this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM proactive_log
+         WHERE sender_id = ? AND channel_id = ? AND sent_at >= ?`)
+            .get(senderId, channelId, todayStart.getTime());
+        const sentToday = row.cnt;
+        const rate = this.getEngagementRate(senderId, channelId);
+        return {
+            allowed: sentToday < perUserPerDay,
+            sentToday,
+            limit: perUserPerDay,
+            engagementRate: rate,
+        };
+    }
+    getEngagementRate(senderId, channelId) {
+        const thirtyDaysAgo = Date.now() - 30 * 86_400_000;
+        const row = this.db
+            .prepare(`SELECT COUNT(*) as total, SUM(engaged) as engaged FROM proactive_log
+         WHERE sender_id = ? AND channel_id = ? AND sent_at >= ?`)
+            .get(senderId, channelId, thirtyDaysAgo);
+        if (row.total === 0)
+            return 0;
+        return (row.engaged ?? 0) / row.total;
+    }
+    getGlobalQuotaToday() {
+        const todayStart = new Date();
+        todayStart.setHours(0, 0, 0, 0);
+        const row = this.db
+            .prepare("SELECT COUNT(*) as cnt FROM proactive_log WHERE sent_at >= ?")
+            .get(todayStart.getTime());
+        return row.cnt;
+    }
+    // ── Dormant user detection ──
+    listDormantUsers(thresholdMs, limit) {
+        const cutoff = Date.now() - thresholdMs;
+        const rows = this.db
+            .prepare(`SELECT sender_id, channel_id, name, last_seen FROM profiles
+         WHERE last_seen < ? AND last_seen > 0
+         AND sender_id NOT IN (
+           SELECT sender_id FROM proactive_triggers
+           WHERE type = 'dormant_user' AND executed_at IS NULL
+         )
+         ORDER BY last_seen ASC LIMIT ?`)
+            .all(cutoff, limit);
+        return rows.map((r) => ({
+            senderId: r["sender_id"],
+            channelId: r["channel_id"],
+            name: r["name"] ?? null,
+            lastSeen: r["last_seen"],
+        }));
+    }
+    // ── Cleanup ──
+    purgeExpired(maxAgeMs) {
+        const cutoff = Date.now() - maxAgeMs;
+        const intents = this.db
+            .prepare("DELETE FROM proactive_intents WHERE executed_at IS NULL AND execute_at < ?")
+            .run(cutoff);
+        const triggers = this.db
+            .prepare("DELETE FROM proactive_triggers WHERE executed_at IS NULL AND execute_at < ?")
+            .run(cutoff);
+        return intents.changes + triggers.changes;
+    }
+    // ── Row mappers ──
+    toIntent(row) {
+        return {
+            id: row["id"],
+            sessionId: row["session_id"],
+            channelId: row["channel_id"],
+            chatId: row["chat_id"],
+            senderId: row["sender_id"],
+            what: row["what"],
+            why: row["why"] ?? null,
+            category: row["category"] ?? null,
+            confidence: row["confidence"],
+            executeAt: row["execute_at"],
+            executedAt: row["executed_at"] ?? null,
+            result: row["result"] ?? null,
+            createdAt: row["created_at"],
+        };
+    }
+    toTrigger(row) {
+        return {
+            id: row["id"],
+            type: row["type"],
+            channelId: row["channel_id"],
+            chatId: row["chat_id"],
+            senderId: row["sender_id"],
+            context: row["context"],
+            executeAt: row["execute_at"],
+            executedAt: row["executed_at"] ?? null,
+            result: row["result"] ?? null,
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/proactive/store.js.map

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

package/dist/proactive/types.d.ts

@@ -0,0 +1,91 @@
+export interface ProactiveIntent {
+    readonly id: string;
+    readonly sessionId: string;
+    readonly channelId: string;
+    readonly chatId: string;
+    readonly senderId: string;
+    readonly what: string;
+    readonly why: string | null;
+    readonly category?: string | null;
+    readonly confidence: number;
+    readonly executeAt: number;
+    readonly executedAt: number | null;
+    readonly result: string | null;
+    readonly createdAt: number;
+}
+export interface ProactiveTrigger {
+    readonly id: string;
+    readonly type: "dormant_user" | "unanswered" | "engagement_drop" | "external";
+    readonly channelId: string;
+    readonly chatId: string;
+    readonly senderId: string;
+    readonly context: string;
+    readonly executeAt: number;
+    readonly executedAt: number | null;
+    readonly result: string | null;
+}
+export interface ProactiveLogEntry {
+    readonly id: string;
+    readonly senderId: string;
+    readonly channelId: string;
+    readonly type: "intent" | "trigger";
+    readonly sourceId: string;
+    readonly sentAt: number;
+    readonly engaged: boolean;
+    readonly engagementAt: number | null;
+}
+export interface QuotaStatus {
+    readonly allowed: boolean;
+    readonly sentToday: number;
+    readonly limit: number;
+    readonly engagementRate: number;
+}
+export interface DormantUser {
+    readonly senderId: string;
+    readonly channelId: string;
+    readonly name: string | null;
+    readonly lastSeen: number;
+}
+export interface AddIntentParams {
+    readonly sessionId: string;
+    readonly channelId: string;
+    readonly chatId: string;
+    readonly senderId: string;
+    readonly what: string;
+    readonly why?: string | null;
+    readonly confidence?: number;
+    readonly executeAt: number;
+    readonly category?: string;
+}
+export interface AddTriggerParams {
+    readonly type: ProactiveTrigger["type"];
+    readonly channelId: string;
+    readonly chatId: string;
+    readonly senderId: string;
+    readonly context: string;
+    readonly executeAt: number;
+}
+export interface ProactiveConfig {
+    readonly enabled: boolean;
+    readonly pollIntervalMs: number;
+    readonly passiveScanIntervalMs: number;
+    readonly softQuotas: {
+        readonly perUserPerDay: number;
+        readonly globalPerDay: number;
+    };
+    readonly dormancy: {
+        readonly enabled: boolean;
+        readonly thresholdMs: number;
+    };
+    readonly intentDefaults: {
+        readonly minDelayMs: number;
+        readonly maxAgeMs: number;
+        readonly defaultConfidence: number;
+        readonly confidenceThreshold: number;
+    };
+    readonly quietHours: {
+        readonly start: number;
+        readonly end: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/proactive/types.d.ts.map

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

package/dist/proactive/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/proactive/types.js.map

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

package/dist/sdk/client.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Iris Gateway SDK — typed HTTP client for tool-server (port 19877).
+ * Use this for out-of-process plugins and external integrations.
+ *
+ * @example
+ * import IrisClient from "./sdk/client.js";
+ * const iris = new IrisClient({ baseUrl: "http://localhost:19877" });
+ * const { results } = await iris.vault.search({ query: "project goals", limit: 5 });
+ */
+export interface IrisClientOptions {
+    /** Base URL of the tool-server. Default: http://localhost:19877 */
+    baseUrl?: string;
+    /** Groups all requests into a single execution trace for debugging */
+    turnId?: string;
+    /** Bearer token (future use — no auth middleware on port 19877 by default) */
+    token?: string;
+}
+export interface VaultSearchParams {
+    query: string;
+    limit?: number;
+    sessionId?: string;
+}
+export interface VaultSearchResult {
+    results: Array<{
+        id: string;
+        content: string;
+        score: number;
+        source: string;
+    }>;
+}
+export interface VaultStoreParams {
+    sessionId: string;
+    content: string;
+    type?: string;
+    source?: string;
+}
+export interface VaultStoreResult {
+    id: string;
+    ok: boolean;
+}
+export interface VaultExtractParams {
+    sessionId: string;
+    context: string[];
+}
+export interface VaultExtractResult {
+    facts: Array<{
+        content: string;
+        type: string;
+    }>;
+}
+export interface VaultContextParams {
+    sessionId: string;
+    query?: string;
+}
+export interface VaultContextResult {
+    context: string;
+}
+export interface SendMessageParams {
+    channel: string;
+    to: string;
+    text: string;
+    replyToId?: string;
+}
+export interface SendMessageResult {
+    ok: boolean;
+    messageId?: string;
+}
+export interface PolicyCheckParams {
+    tool: string;
+    sessionId?: string;
+    args?: Record<string, unknown>;
+}
+export interface PolicyCheckResult {
+    allowed: boolean;
+    reason?: string;
+    modified?: Record<string, unknown>;
+}
+export interface AuditLogParams {
+    tool: string;
+    sessionId?: string;
+    args?: unknown;
+    result?: unknown;
+    durationMs?: number;
+    turnId?: string;
+}
+export interface AuditLogResult {
+    ok: boolean;
+}
+export interface AuditStep {
+    id: number;
+    timestamp: number;
+    sessionId: string | null;
+    tool: string;
+    args: string | null;
+    result: string | null;
+    durationMs: number | null;
+    turnId: string | null;
+    stepIndex: number | null;
+}
+export interface TraceResult {
+    turnId: string;
+    steps: AuditStep[];
+}
+export interface TracesListResult {
+    entries: AuditStep[];
+}
+export interface PolicyStatus {
+    rules: unknown[];
+    enabled: boolean;
+}
+export interface HeartbeatStatus {
+    status: string;
+    lastRun?: number;
+}
+export interface GoalCreateParams {
+    sessionId: string;
+    channelId: string;
+    senderId: string;
+    content: string;
+    category?: string;
+}
+export interface GoalCreateResult {
+    id: string;
+    ok: boolean;
+}
+export interface SystemContextParams {
+    sessionId: string;
+    senderId: string;
+    channelId: string;
+}
+export interface SystemContextResult {
+    context: string;
+}
+export interface ProactiveIntentParams {
+    sessionId: string;
+    senderId: string;
+    channelId: string;
+    chatId: string;
+    what: string;
+    why?: string;
+    category?: string;
+    confidence?: number;
+}
+export interface ProactiveIntentResult {
+    id: string;
+    ok: boolean;
+}
+type HttpGet = <T>(path: string) => Promise<T>;
+type HttpPost = <T>(path: string, body: unknown) => Promise<T>;
+type HttpDelete = <T>(path: string) => Promise<T>;
+interface Transport {
+    get: HttpGet;
+    post: HttpPost;
+    delete: HttpDelete;
+}
+declare class VaultApi {
+    private readonly t;
+    constructor(t: Transport);
+    search(p: VaultSearchParams): Promise<VaultSearchResult>;
+    store(p: VaultStoreParams): Promise<VaultStoreResult>;
+    extract(p: VaultExtractParams): Promise<VaultExtractResult>;
+    context(p: VaultContextParams): Promise<VaultContextResult>;
+    storeBatch(p: {
+        entries: VaultStoreParams[];
+    }): Promise<{
+        ok: boolean;
+        count: number;
+    }>;
+    deleteMemory(id: string): Promise<{
+        ok: boolean;
+    }>;
+}
+declare class ChannelsApi {
+    private readonly t;
+    constructor(t: Transport);
+    sendMessage(p: SendMessageParams): Promise<SendMessageResult>;
+    listChannels(): Promise<{
+        channels: string[];
+    }>;
+}
+declare class GovernanceApi {
+    private readonly t;
+    constructor(t: Transport);
+    checkPolicy(p: PolicyCheckParams): Promise<PolicyCheckResult>;
+    logAudit(p: AuditLogParams): Promise<AuditLogResult>;
+    getTrace(turnId: string): Promise<TraceResult>;
+    listTraces(p?: {
+        session?: string;
+        limit?: number;
+    }): Promise<TracesListResult>;
+    getPolicyStatus(): Promise<PolicyStatus>;
+}
+declare class IntelligenceApi {
+    private readonly t;
+    constructor(t: Transport);
+    systemContext(p: SystemContextParams): Promise<SystemContextResult>;
+    createGoal(p: GoalCreateParams): Promise<GoalCreateResult>;
+    listGoals(p: {
+        sessionId: string;
+    }): Promise<{
+        goals: unknown[];
+    }>;
+}
+declare class SystemApi {
+    private readonly t;
+    constructor(t: Transport);
+    proactiveIntent(p: ProactiveIntentParams): Promise<ProactiveIntentResult>;
+    heartbeatStatus(): Promise<HeartbeatStatus>;
+}
+export declare class IrisClient {
+    readonly vault: VaultApi;
+    readonly channels: ChannelsApi;
+    readonly governance: GovernanceApi;
+    readonly intelligence: IntelligenceApi;
+    readonly system: SystemApi;
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(opts?: IrisClientOptions);
+    private request;
+}
+export default IrisClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/sdk/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sdk/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,iBAAiB;IAAI,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AACzF,MAAM,WAAW,iBAAiB;IAAI,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE;AAEtH,MAAM,WAAW,gBAAgB;IAAK,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAC1G,MAAM,WAAW,gBAAgB;IAAK,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE;AAE/D,MAAM,WAAW,kBAAkB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;AAC5E,MAAM,WAAW,kBAAkB;IAAG,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE;AAEvF,MAAM,WAAW,kBAAkB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE;AACzE,MAAM,WAAW,kBAAkB;IAAG,OAAO,EAAE,MAAM,CAAA;CAAE;AAEvD,MAAM,WAAW,iBAAiB;IAAI,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AACrG,MAAM,WAAW,iBAAiB;IAAI,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAEvE,MAAM,WAAW,iBAAiB;IAAI,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AACxG,MAAM,WAAW,iBAAiB;IAAI,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AAE7G,MAAM,WAAW,cAAc;IAAO,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAChJ,MAAM,WAAW,cAAc;IAAO,EAAE,EAAE,OAAO,CAAA;CAAE;AAEnD,MAAM,WAAW,SAAS;IAAY,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AACrO,MAAM,WAAW,WAAW;IAAU,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE;AAC1E,MAAM,WAAW,gBAAgB;IAAK,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE;AAC5D,MAAM,WAAW,YAAY;IAAS,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE;AAC1E,MAAM,WAAW,eAAe;IAAM,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAExE,MAAM,WAAW,gBAAgB;IAAK,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;AAClI,MAAM,WAAW,gBAAgB;IAAK,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE;AAE/D,MAAM,WAAW,mBAAmB;IAAK,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AACjG,MAAM,WAAW,mBAAmB;IAAK,OAAO,EAAE,MAAM,CAAA;CAAE;AAE1D,MAAM,WAAW,qBAAqB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACrL,MAAM,WAAW,qBAAqB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE;AAIlE,KAAK,OAAO,GAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,KAAoB,OAAO,CAAC,CAAC,CAAC,CAAC;AACjE,KAAK,QAAQ,GAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AACjE,KAAK,UAAU,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,KAAoB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjE,UAAU,SAAS;IAAG,GAAG,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE;AAIxE,cAAM,QAAQ;IACA,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,MAAM,CAAC,CAAC,EAAE,iBAAiB,GAAqB,OAAO,CAAC,iBAAiB,CAAC;IAC1E,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAuB,OAAO,CAAC,gBAAgB,CAAC;IACzE,OAAO,CAAC,CAAC,EAAE,kBAAkB,GAAmB,OAAO,CAAC,kBAAkB,CAAC;IAC3E,OAAO,CAAC,CAAC,EAAE,kBAAkB,GAAmB,OAAO,CAAC,kBAAkB,CAAC;IAC3E,UAAU,CAAC,CAAC,EAAE;QAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAyB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;CACzE;AAED,cAAM,WAAW;IACH,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,WAAW,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC7D,YAAY,IAAuB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnE;AAED,cAAM,aAAa;IACL,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,WAAW,CAAC,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAC7D,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAS,OAAO,CAAC,cAAc,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAY,OAAO,CAAC,WAAW,CAAC;IACvD,UAAU,CAAC,CAAC,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO/E,eAAe,IAAoB,OAAO,CAAC,YAAY,CAAC;CACzD;AAED,cAAM,eAAe;IACP,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,aAAa,CAAC,CAAC,EAAE,mBAAmB,GAAK,OAAO,CAAC,mBAAmB,CAAC;IACrE,UAAU,CAAC,CAAC,EAAE,gBAAgB,GAAW,OAAO,CAAC,gBAAgB,CAAC;IAClE,SAAS,CAAC,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAO,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CACvE;AAED,cAAM,SAAS;IACD,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAAD,CAAC,EAAE,SAAS;IAEzC,eAAe,CAAC,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IACzE,eAAe,IAA4B,OAAO,CAAC,eAAe,CAAC;CACpE;AAID,qBAAa,UAAU;IACrB,QAAQ,CAAC,KAAK,EAAS,QAAQ,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAM,WAAW,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAI,aAAa,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAQ,SAAS,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,IAAI,GAAE,iBAAsB;YAmB1B,OAAO;CAYtB;AAED,eAAe,UAAU,CAAC"}

package/dist/sdk/client.js

@@ -0,0 +1,108 @@
+/**
+ * Iris Gateway SDK — typed HTTP client for tool-server (port 19877).
+ * Use this for out-of-process plugins and external integrations.
+ *
+ * @example
+ * import IrisClient from "./sdk/client.js";
+ * const iris = new IrisClient({ baseUrl: "http://localhost:19877" });
+ * const { results } = await iris.vault.search({ query: "project goals", limit: 5 });
+ */
+// ── Namespaced API classes ────────────────────────────────────────────────────
+class VaultApi {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    search(p) { return this.t.post("/vault/search", p); }
+    store(p) { return this.t.post("/vault/store", p); }
+    extract(p) { return this.t.post("/vault/extract", p); }
+    context(p) { return this.t.post("/vault/context", p); }
+    storeBatch(p) { return this.t.post("/vault/store-batch", p); }
+    deleteMemory(id) { return this.t.delete(`/vault/memory/${id}`); }
+}
+class ChannelsApi {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    sendMessage(p) { return this.t.post("/tool/send-message", p); }
+    listChannels() { return this.t.get("/tool/list-channels"); }
+}
+class GovernanceApi {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    checkPolicy(p) { return this.t.post("/policy/check-tool", p); }
+    logAudit(p) { return this.t.post("/audit/log", p); }
+    getTrace(turnId) { return this.t.get(`/traces/${turnId}`); }
+    listTraces(p) {
+        const qs = new URLSearchParams();
+        if (p?.session)
+            qs.set("session", p.session);
+        if (p?.limit)
+            qs.set("limit", String(p.limit));
+        const q = qs.toString();
+        return this.t.get(`/traces${q ? "?" + q : ""}`);
+    }
+    getPolicyStatus() { return this.t.get("/policy/status"); }
+}
+class IntelligenceApi {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    systemContext(p) { return this.t.post("/session/system-context", p); }
+    createGoal(p) { return this.t.post("/goals/create", p); }
+    listGoals(p) { return this.t.post("/goals/list", p); }
+}
+class SystemApi {
+    t;
+    constructor(t) {
+        this.t = t;
+    }
+    proactiveIntent(p) { return this.t.post("/proactive/intent", p); }
+    heartbeatStatus() { return this.t.get("/heartbeat/status"); }
+}
+// ── Main client ───────────────────────────────────────────────────────────────
+export class IrisClient {
+    vault;
+    channels;
+    governance;
+    intelligence;
+    system;
+    baseUrl;
+    headers;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? "http://localhost:19877").replace(/\/$/, "");
+        this.headers = {
+            "Content-Type": "application/json",
+            ...(opts.turnId ? { "x-turn-id": opts.turnId } : {}),
+            ...(opts.token ? { "Authorization": `Bearer ${opts.token}` } : {}),
+        };
+        const t = {
+            get: (path) => this.request("GET", path),
+            post: (path, body) => this.request("POST", path, body),
+            delete: (path) => this.request("DELETE", path),
+        };
+        this.vault = new VaultApi(t);
+        this.channels = new ChannelsApi(t);
+        this.governance = new GovernanceApi(t);
+        this.intelligence = new IntelligenceApi(t);
+        this.system = new SystemApi(t);
+    }
+    async request(method, path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: this.headers,
+            body: body != null ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new Error(`Iris SDK: ${method} ${path} → ${res.status} ${text.slice(0, 200)}`);
+        }
+        return res.json();
+    }
+}
+export default IrisClient;
+//# sourceMappingURL=client.js.map

package/dist/sdk/client.js.map

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

package/dist/security/allowlist-store.d.ts

@@ -0,0 +1,17 @@
+export interface AllowlistEntry {
+    readonly channelId: string;
+    readonly senderId: string;
+    readonly approvedBy?: string;
+    readonly approvedAt: number;
+}
+export declare class AllowlistStore {
+    private readonly filePath;
+    constructor(dataDir: string);
+    isAllowed(channelId: string, senderId: string): Promise<boolean>;
+    add(channelId: string, senderId: string, approvedBy?: string): Promise<void>;
+    remove(channelId: string, senderId: string): Promise<boolean>;
+    list(channelId: string): Promise<AllowlistEntry[]>;
+    private readEntries;
+    private writeEntries;
+}
+//# sourceMappingURL=allowlist-store.d.ts.map

package/dist/security/allowlist-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"allowlist-store.d.ts","sourceRoot":"","sources":["../../src/security/allowlist-store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,MAAM;IAKrB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAOhE,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAaV,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY7D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAK1C,WAAW;YASX,YAAY;CAG3B"}