oceanbus 0.3.3 → 0.4.0

package/dist/roster/search.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.search = search;
+exports.getById = getById;
+exports.findByAgentId = findByAgentId;
+exports.findByOpenId = findByOpenId;
+exports.list = list;
+exports.slugFromName = slugFromName;
+exports.findDuplicates = findDuplicates;
+exports.dismissHintsForContact = dismissHintsForContact;
+function toMatchEntry(c, field, highlight) {
+    return {
+        id: c.id,
+        name: c.name,
+        matchField: field,
+        highlight,
+        tags: c.tags,
+        notes: c.notes.slice(0, 80),
+        agents: c.agents,
+        source: c.source,
+    };
+}
+/** Normalize a string for fuzzy matching: lowercase, remove spaces and punctuation */
+function normalize(s) {
+    return s
+        .toLowerCase()
+        .replace(/[\s\-_.,;:!?()（）【】《》""'·•]+/g, '')
+        .trim();
+}
+/** Check if target contains query as a substring (after normalization) */
+function containsNormalized(target, query) {
+    return normalize(target).includes(normalize(query));
+}
+/**
+ * Search contacts with conservative fuzzy matching.
+ * Exact: query matches id, name, or any alias exactly (case-insensitive).
+ * Fuzzy: query is a substring of name or alias (after normalizing spaces/punctuation).
+ * byTag: query matches any tag.
+ * byNote: query appears in notes.
+ *
+ * The result is a structured candidate set — disambiguation is the LLM's job.
+ */
+function search(contacts, query) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return { query, exact: [], fuzzy: [], byTag: [], byNote: [] };
+    }
+    const qLower = trimmed.toLowerCase();
+    const exactIds = new Set();
+    const fuzzyIds = new Set();
+    const byTagIds = new Set();
+    const byNoteIds = new Set();
+    const active = contacts.filter(c => c.status === 'active' || c.status === 'pending');
+    for (const c of active) {
+        // Exact: id, name, aliases
+        if (c.id.toLowerCase() === qLower) {
+            exactIds.add(c.id);
+            continue;
+        }
+        if (c.name.toLowerCase() === qLower) {
+            exactIds.add(c.id);
+            continue;
+        }
+        if (c.aliases.some(a => a.toLowerCase() === qLower)) {
+            exactIds.add(c.id);
+            continue;
+        }
+        // Fuzzy: name or alias contains query after normalization
+        if (containsNormalized(c.name, trimmed)) {
+            fuzzyIds.add(c.id);
+            continue;
+        }
+        if (c.aliases.some(a => containsNormalized(a, trimmed))) {
+            fuzzyIds.add(c.id);
+            continue;
+        }
+        // By tag
+        if (c.tags.some(t => t.toLowerCase().includes(qLower))) {
+            byTagIds.add(c.id);
+        }
+        // By note
+        if (c.notes.toLowerCase().includes(qLower)) {
+            byNoteIds.add(c.id);
+        }
+    }
+    const contactMap = new Map(active.map(c => [c.id, c]));
+    const build = (ids, field, getHighlight) => Array.from(ids)
+        .map(id => contactMap.get(id))
+        .filter(Boolean)
+        .map(c => toMatchEntry(c, field, getHighlight(c)))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        query: trimmed,
+        exact: build(exactIds, 'name', c => c.name),
+        fuzzy: build(fuzzyIds, 'name', c => c.name),
+        byTag: build(byTagIds, 'tag', c => c.tags.find(t => t.toLowerCase().includes(qLower)) || ''),
+        byNote: build(byNoteIds, 'note', c => {
+            const idx = c.notes.toLowerCase().indexOf(qLower);
+            const start = Math.max(0, idx - 10);
+            const end = Math.min(c.notes.length, idx + qLower.length + 30);
+            return (start > 0 ? '…' : '') + c.notes.slice(start, end) + (end < c.notes.length ? '…' : '');
+        }),
+    };
+}
+function getById(contacts, id) {
+    return contacts.find(c => c.id === id && c.status !== 'archived') || null;
+}
+function findByAgentId(contacts, indexes, agentId) {
+    const contactId = indexes.byAgentId[agentId];
+    if (!contactId)
+        return null;
+    return getById(contacts, contactId);
+}
+function findByOpenId(contacts, indexes, openId) {
+    const contactId = indexes.byOpenId[openId];
+    if (!contactId)
+        return null;
+    return getById(contacts, contactId);
+}
+function list(contacts, filter) {
+    let result = contacts.filter(c => c.status !== 'archived');
+    if (filter?.status) {
+        result = result.filter(c => c.status === filter.status);
+    }
+    if (filter?.source) {
+        result = result.filter(c => c.source === filter.source);
+    }
+    if (filter?.tags && filter.tags.length > 0) {
+        result = result.filter(c => filter.tags.some(t => c.tags.includes(t)));
+    }
+    const sortBy = filter?.sortBy || 'name';
+    const order = filter?.order || 'asc';
+    result.sort((a, b) => {
+        const cmp = sortBy === 'name'
+            ? a.name.localeCompare(b.name)
+            : new Date(b[sortBy]).getTime() - new Date(a[sortBy]).getTime();
+        return order === 'asc' ? cmp : -cmp;
+    });
+    const offset = filter?.offset || 0;
+    const limit = filter?.limit;
+    if (offset > 0)
+        result = result.slice(offset);
+    if (limit !== undefined)
+        result = result.slice(0, limit);
+    return result;
+}
+/** Generate a slug from a Chinese or English name */
+function slugFromName(name) {
+    // Keep alphanumeric, Chinese chars, hyphens; replace spaces with hyphens
+    return name
+        .trim()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-zA-Z0-9一-鿿\-_]/g, '')
+        .toLowerCase()
+        || `contact_${Date.now()}`;
+}
+// ── Duplicate detection ──
+/**
+ * Check if a new or updated contact looks like a duplicate of an existing one.
+ * Rules (in priority order):
+ *   1. Same OpenID — high confidence (0.95)
+ *   2. Same AgentID — high confidence (0.90)
+ *   3. Name highly similar — medium confidence (0.60–0.85)
+ *
+ * Returns hints for NEW potential duplicates not already in existingHints.
+ */
+function findDuplicates(incoming, existingContacts, existingHints, now) {
+    const newHints = [];
+    const active = existingContacts.filter(c => c.status === 'active' && c.id !== incoming.id);
+    const hintedThisCall = new Set();
+    for (const c of active) {
+        // Already has a hint for this pair (from existing or this call)?
+        const pairKey = incoming.id < c.id ? `${incoming.id}|${c.id}` : `${c.id}|${incoming.id}`;
+        const alreadyHinted = existingHints.some(h => (h.contactA === incoming.id && h.contactB === c.id) ||
+            (h.contactA === c.id && h.contactB === incoming.id)) || hintedThisCall.has(pairKey);
+        if (alreadyHinted)
+            continue;
+        let matched = false;
+        // Rule 1: Same OpenID
+        for (const a of incoming.agents) {
+            if (!a.openId || matched)
+                break;
+            for (const b of c.agents) {
+                if (!b.openId)
+                    continue;
+                if (a.openId === b.openId) {
+                    newHints.push(makeHint(incoming.id, c.id, 'same_openid', `Both have OpenID ${a.openId.slice(0, 16)}...`, 0.95, now));
+                    hintedThisCall.add(pairKey);
+                    matched = true;
+                    break;
+                }
+            }
+        }
+        // Rule 2: Same AgentID
+        if (!matched) {
+            for (const a of incoming.agents) {
+                if (!a.agentId || matched)
+                    break;
+                for (const b of c.agents) {
+                    if (!b.agentId)
+                        continue;
+                    if (a.agentId === b.agentId) {
+                        newHints.push(makeHint(incoming.id, c.id, 'same_agentId', `Both have Agent ID ${a.agentId.slice(0, 12)}...`, 0.90, now));
+                        hintedThisCall.add(pairKey);
+                        matched = true;
+                        break;
+                    }
+                }
+            }
+        }
+        // Rule 3: Name similarity (after normalization)
+        if (!matched) {
+            const sim = nameSimilarity(incoming.name, c.name);
+            if (sim >= 0.75 && !hasSameOpenIdOrAgentId(incoming, c)) {
+                newHints.push(makeHint(incoming.id, c.id, 'name_similarity', `Names similar (score ${sim.toFixed(2)}): "${incoming.name}" ≈ "${c.name}"`, sim, now));
+                hintedThisCall.add(pairKey);
+            }
+        }
+    }
+    return newHints;
+}
+/** Dismiss a hint (called after user decides keep-separate or after merge) */
+function dismissHintsForContact(hints, contactId) {
+    return hints.filter(h => h.contactA !== contactId && h.contactB !== contactId);
+}
+function makeHint(a, b, reason, detail, confidence, now) {
+    // Canonical order: smaller id first
+    const [contactA, contactB] = a < b ? [a, b] : [b, a];
+    return { contactA, contactB, reason, detail, confidence, createdAt: now };
+}
+function hasSameOpenIdOrAgentId(a, b) {
+    const aOpenIds = new Set(a.agents.map(x => x.openId).filter(Boolean));
+    const bOpenIds = new Set(b.agents.map(x => x.openId).filter(Boolean));
+    for (const oid of aOpenIds) {
+        if (bOpenIds.has(oid))
+            return true;
+    }
+    const aAgentIds = new Set(a.agents.map(x => x.agentId).filter(Boolean));
+    const bAgentIds = new Set(b.agents.map(x => x.agentId).filter(Boolean));
+    for (const aid of aAgentIds) {
+        if (bAgentIds.has(aid))
+            return true;
+    }
+    return false;
+}
+function nameSimilarity(a, b) {
+    const na = normalize(a);
+    const nb = normalize(b);
+    if (na === nb)
+        return 1.0;
+    if (na.length === 0 || nb.length === 0)
+        return 0;
+    // Simple edit distance normalized
+    const dist = editDistance(na, nb);
+    const maxLen = Math.max(na.length, nb.length);
+    return 1 - dist / maxLen;
+}
+function editDistance(a, b) {
+    const m = a.length, n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+        }
+    }
+    return dp[m][n];
+}
+//# sourceMappingURL=search.js.map

package/dist/roster/search.js.map

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

package/dist/roster/store.d.ts

@@ -0,0 +1,14 @@
+import type { RosterData } from '../types/roster';
+export declare class RosterStore {
+    private filePath;
+    private data;
+    constructor(filePath?: string);
+    getPath(): string;
+    load(): Promise<RosterData>;
+    save(data: RosterData): Promise<void>;
+    private flush;
+    /** Clear in-memory cache (force re-read on next load) */
+    invalidate(): void;
+    delete(): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/roster/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/roster/store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AA8BlD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAA2B;gBAE3B,QAAQ,CAAC,EAAE,MAAM;IAI7B,OAAO,IAAI,MAAM;IAIX,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAc3B,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;YAM7B,KAAK;IAOnB,yDAAyD;IACzD,UAAU,IAAI,IAAI;IAIZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAM9B"}

package/dist/roster/store.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RosterStore = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CURRENT_VERSION = 2;
+function getDefaultRosterDir() {
+    return path.join(os.homedir(), '.oceanbus');
+}
+function emptyRoster() {
+    return {
+        version: CURRENT_VERSION,
+        updatedAt: new Date().toISOString(),
+        contacts: [],
+        identities: [],
+        autoDiscovery: {
+            enabled: true,
+            minMentions: 3,
+            sources: ['chat.log', 'user-messages'],
+            ignoreList: ['我', '你', '他', '她', '它', '我们', '你们', '他们', '她们', '大家', '自己', '别人', '谁', '什么', '怎么'],
+            pending: [],
+        },
+        indexes: {
+            byTag: {},
+            byAgentId: {},
+            byOpenId: {},
+        },
+        duplicateHints: [],
+    };
+}
+class RosterStore {
+    filePath;
+    data = null;
+    constructor(filePath) {
+        this.filePath = filePath || path.join(getDefaultRosterDir(), 'roster.json');
+    }
+    getPath() {
+        return this.filePath;
+    }
+    async load() {
+        if (this.data)
+            return this.data;
+        try {
+            const raw = await fs.promises.readFile(this.filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.data = migrate(parsed);
+            return this.data;
+        }
+        catch {
+            this.data = emptyRoster();
+            await this.flush();
+            return this.data;
+        }
+    }
+    async save(data) {
+        data.updatedAt = new Date().toISOString();
+        this.data = data;
+        await this.flush();
+    }
+    async flush() {
+        const dir = path.dirname(this.filePath);
+        await fs.promises.mkdir(dir, { recursive: true });
+        const content = JSON.stringify(this.data, null, 2);
+        await fs.promises.writeFile(this.filePath, content, { mode: 0o600 });
+    }
+    /** Clear in-memory cache (force re-read on next load) */
+    invalidate() {
+        this.data = null;
+    }
+    async delete() {
+        try {
+            await fs.promises.unlink(this.filePath);
+        }
+        catch { /* already gone */ }
+        this.data = null;
+    }
+}
+exports.RosterStore = RosterStore;
+function migrate(data) {
+    if (!data.version || data.version < 2) {
+        return migrateV1toV2(data);
+    }
+    return data;
+}
+function migrateV1toV2(data) {
+    const now = new Date().toISOString();
+    // v1→v2: ensure indexes, autoDiscovery, identities, provenance, duplicateHints exist
+    return {
+        version: 2,
+        updatedAt: data.updatedAt || now,
+        contacts: (data.contacts || []).map(c => ({
+            ...c,
+            status: c.status || 'active',
+            apps: c.apps || {},
+            aliases: c.aliases || [],
+            provenance: c.provenance || { account: c.source || 'manual', sourceId: null, firstSeenAt: c.createdAt || now, lastVerifiedAt: c.createdAt || now },
+        })),
+        identities: data.identities || [],
+        autoDiscovery: data.autoDiscovery || emptyRoster().autoDiscovery,
+        indexes: data.indexes || rebuildIndexes(data.contacts || []),
+        duplicateHints: data.duplicateHints || [],
+    };
+}
+function rebuildIndexes(contacts) {
+    const indexes = { byTag: {}, byAgentId: {}, byOpenId: {} };
+    for (const c of contacts) {
+        for (const tag of c.tags) {
+            if (!indexes.byTag[tag])
+                indexes.byTag[tag] = [];
+            if (!indexes.byTag[tag].includes(c.id))
+                indexes.byTag[tag].push(c.id);
+        }
+        for (const a of c.agents) {
+            indexes.byAgentId[a.agentId] = c.id;
+            indexes.byOpenId[a.openId] = c.id;
+        }
+    }
+    return indexes;
+}
+//# sourceMappingURL=store.js.map

package/dist/roster/store.js.map

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

package/dist/types/index.d.ts

@@ -4,4 +4,5 @@ export * from './messaging';
 export * from './crypto';
 export * from './l1';
 export * from './config';
+export * from './roster';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/dist/types/index.js

@@ -20,4 +20,5 @@ __exportStar(require("./messaging"), exports);
 __exportStar(require("./crypto"), exports);
 __exportStar(require("./l1"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./roster"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,0CAAwB;AACxB,8CAA4B;AAC5B,2CAAyB;AACzB,uCAAqB;AACrB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,0CAAwB;AACxB,8CAA4B;AAC5B,2CAAyB;AACzB,uCAAqB;AACrB,2CAAyB;AACzB,2CAAyB"}

package/dist/types/roster.d.ts

@@ -0,0 +1,123 @@
+export interface AgentRef {
+    agentId: string;
+    openId: string;
+    purpose: string;
+    isDefault: boolean;
+}
+/** Per-app data stored under contacts[].apps[appName] */
+export type AppData = Record<string, unknown>;
+export type ContactSource = 'manual' | 'yellow-pages' | 'auto-discovery' | 'chat';
+export type ContactStatus = 'active' | 'pending' | 'archived';
+/** Rich source tracking — tells us WHERE the contact came from and WHEN. */
+export interface Provenance {
+    account: ContactSource;
+    sourceId: string | null;
+    firstSeenAt: string;
+    lastVerifiedAt: string;
+}
+export interface Contact {
+    id: string;
+    name: string;
+    agents: AgentRef[];
+    tags: string[];
+    aliases: string[];
+    notes: string;
+    lastContactAt: string;
+    source: ContactSource;
+    provenance?: Provenance;
+    status: ContactStatus;
+    createdAt: string;
+    updatedAt: string;
+    apps: Record<string, AppData>;
+}
+export interface NewContact {
+    name: string;
+    id?: string;
+    agents?: AgentRef[];
+    aliases?: string[];
+    tags?: string[];
+    notes?: string;
+    source: ContactSource;
+    status?: ContactStatus;
+}
+export interface ContactPatch {
+    name?: string;
+    agents?: AgentRef[];
+    aliases?: string[];
+    tags?: string[];
+    notes?: string;
+    source?: ContactSource;
+    status?: ContactStatus;
+    lastContactAt?: string;
+}
+export interface UserIdentity {
+    id: string;
+    name: string;
+    purpose: string;
+    agents: AgentRef[];
+}
+export interface PendingEntry {
+    id: string;
+    name: string;
+    mentionCount: number;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    contexts: string[];
+}
+export interface AutoDiscoveryConfig {
+    enabled: boolean;
+    minMentions: number;
+    sources: string[];
+    ignoreList: string[];
+    pending: PendingEntry[];
+}
+export interface RosterIndexes {
+    byTag: Record<string, string[]>;
+    byAgentId: Record<string, string>;
+    byOpenId: Record<string, string>;
+}
+export interface MatchEntry {
+    id: string;
+    name: string;
+    matchField: 'id' | 'name' | 'alias' | 'tag' | 'note';
+    highlight: string;
+    tags: string[];
+    notes: string;
+    agents: AgentRef[];
+    source: ContactSource;
+}
+export interface SearchResult {
+    query: string;
+    exact: MatchEntry[];
+    fuzzy: MatchEntry[];
+    byTag: MatchEntry[];
+    byNote: MatchEntry[];
+}
+export type DuplicateReason = 'same_openid' | 'same_agentId' | 'name_similarity';
+export interface DuplicateHint {
+    contactA: string;
+    contactB: string;
+    reason: DuplicateReason;
+    detail: string;
+    confidence: number;
+    createdAt: string;
+}
+export interface RosterFilter {
+    tags?: string[];
+    source?: string;
+    status?: string;
+    sortBy?: 'name' | 'lastContactAt' | 'createdAt';
+    order?: 'asc' | 'desc';
+    limit?: number;
+    offset?: number;
+}
+export interface RosterData {
+    version: number;
+    updatedAt: string;
+    contacts: Contact[];
+    identities: UserIdentity[];
+    autoDiscovery: AutoDiscoveryConfig;
+    indexes: RosterIndexes;
+    duplicateHints: DuplicateHint[];
+}
+//# sourceMappingURL=roster.d.ts.map

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

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

package/dist/types/roster.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Agent reference ──
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=roster.js.map

package/dist/types/roster.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oceanbus",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "OceanBus AI Agent Communication & Trust Infrastructure SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",