agentvault 1.0.2 → 1.0.5

package/dist/src/backbone/services/communication.js

@@ -0,0 +1,107 @@
+/**
+ * Agent Communication Service
+ *
+ * Agent-to-agent messaging with support for direct messages, channels,
+ * threading, and priority levels.
+ *
+ * Default implementation uses an in-memory store; consumers can inject
+ * a database-backed adapter by implementing MessageStore.
+ */
+import { randomUUID } from 'node:crypto';
+/** In-memory implementation of MessageStore */
+export class InMemoryMessageStore {
+    messages = new Map();
+    async create(message) {
+        this.messages.set(message.id, message);
+        return message;
+    }
+    async getById(id) {
+        return this.messages.get(id) ?? null;
+    }
+    async listByChannel(companyId, channel) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (msg.companyId === companyId && msg.channel === channel) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async listInbox(companyId, agentId) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (msg.companyId === companyId && msg.toAgentId === agentId) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    async listSent(companyId, agentId) {
+        const results = [];
+        for (const msg of this.messages.values()) {
+            if (msg.companyId === companyId && msg.fromAgentId === agentId) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    async listThread(parentMessageId) {
+        const parent = this.messages.get(parentMessageId);
+        const results = parent ? [parent] : [];
+        for (const msg of this.messages.values()) {
+            if (msg.parentMessageId === parentMessageId) {
+                results.push(msg);
+            }
+        }
+        return results.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    }
+    async acknowledge(id, acknowledgedAt) {
+        const msg = this.messages.get(id);
+        if (!msg)
+            return null;
+        const updated = { ...msg, acknowledgedAt };
+        this.messages.set(id, updated);
+        return updated;
+    }
+}
+export class CommunicationService {
+    store;
+    constructor(store = new InMemoryMessageStore()) {
+        this.store = store;
+    }
+    async sendMessage(companyId, fromAgentId, input) {
+        const message = {
+            id: randomUUID(),
+            companyId,
+            fromAgentId,
+            toAgentId: input.toAgentId,
+            channel: input.channel,
+            parentMessageId: input.parentMessageId,
+            messageType: input.messageType,
+            subject: input.subject,
+            body: input.body,
+            priority: input.priority ?? 'normal',
+            referenceType: input.referenceType,
+            referenceId: input.referenceId,
+            metadata: input.metadata,
+            createdAt: new Date().toISOString(),
+        };
+        return this.store.create(message);
+    }
+    async getChannelMessages(companyId, channel) {
+        return this.store.listByChannel(companyId, channel);
+    }
+    async getInbox(companyId, agentId) {
+        return this.store.listInbox(companyId, agentId);
+    }
+    async getSentMessages(companyId, agentId) {
+        return this.store.listSent(companyId, agentId);
+    }
+    async getThread(messageId) {
+        return this.store.listThread(messageId);
+    }
+    async acknowledgeMessage(messageId) {
+        return this.store.acknowledge(messageId, new Date().toISOString());
+    }
+}
+//# sourceMappingURL=communication.js.map

package/dist/src/backbone/services/communication.js.map

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

package/dist/src/backbone/services/consensus.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Consensus Service
+ *
+ * Proposal and voting mechanism for agent governance with quorum resolution.
+ *
+ * Proposal lifecycle:  draft → open → passed | rejected | vetoed | expired
+ *
+ * Quorum types:
+ *   majority       – votesFor > votesAgainst
+ *   supermajority  – votesFor >= 2/3 of total votes
+ *   unanimous      – zero against votes, at least one for vote
+ *   board_approval – majority, but board can veto independently
+ *
+ * When a proposal passes with a linked knowledgeEntryId, the knowledge
+ * entry should be automatically ratified by the caller.
+ */
+import type { ConsensusProposal, ConsensusVote, CreateProposalInput, CastVoteInput } from '../types.js';
+import type { ProposalStatus } from '../constants.js';
+/** Storage adapter interface for consensus */
+export interface ConsensusStore {
+    listProposals(companyId: string, status?: ProposalStatus): Promise<ConsensusProposal[]>;
+    getProposal(id: string): Promise<ConsensusProposal | null>;
+    createProposal(proposal: ConsensusProposal): Promise<ConsensusProposal>;
+    updateProposal(id: string, partial: Partial<ConsensusProposal>): Promise<ConsensusProposal | null>;
+    listVotes(proposalId: string): Promise<ConsensusVote[]>;
+    getVoteByVoter(proposalId: string, voterId: string): Promise<ConsensusVote | null>;
+    createVote(vote: ConsensusVote): Promise<ConsensusVote>;
+}
+/** In-memory implementation of ConsensusStore */
+export declare class InMemoryConsensusStore implements ConsensusStore {
+    private proposals;
+    private votes;
+    listProposals(companyId: string, status?: ProposalStatus): Promise<ConsensusProposal[]>;
+    getProposal(id: string): Promise<ConsensusProposal | null>;
+    createProposal(proposal: ConsensusProposal): Promise<ConsensusProposal>;
+    updateProposal(id: string, partial: Partial<ConsensusProposal>): Promise<ConsensusProposal | null>;
+    listVotes(proposalId: string): Promise<ConsensusVote[]>;
+    getVoteByVoter(proposalId: string, voterId: string): Promise<ConsensusVote | null>;
+    createVote(vote: ConsensusVote): Promise<ConsensusVote>;
+}
+export declare class ConsensusService {
+    private store;
+    constructor(store?: ConsensusStore);
+    listProposals(companyId: string, status?: ProposalStatus): Promise<ConsensusProposal[]>;
+    getProposal(id: string): Promise<ConsensusProposal | null>;
+    createProposal(companyId: string, createdBy: string, input: CreateProposalInput): Promise<ConsensusProposal>;
+    /**
+     * Cast a vote on a proposal. Returns the updated proposal.
+     * Automatically resolves the proposal if quorum is reached.
+     */
+    castVote(proposalId: string, voterId: string, input: CastVoteInput): Promise<{
+        vote: ConsensusVote;
+        proposal: ConsensusProposal;
+    } | null>;
+    /** Open a draft proposal for voting */
+    openProposal(id: string): Promise<ConsensusProposal | null>;
+    /** Board veto — immediately sets status to vetoed */
+    vetoProposal(id: string): Promise<ConsensusProposal | null>;
+    listVotes(proposalId: string): Promise<ConsensusVote[]>;
+}
+//# sourceMappingURL=consensus.d.ts.map

package/dist/src/backbone/services/consensus.d.ts.map

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

package/dist/src/backbone/services/consensus.js

@@ -0,0 +1,210 @@
+/**
+ * Consensus Service
+ *
+ * Proposal and voting mechanism for agent governance with quorum resolution.
+ *
+ * Proposal lifecycle:  draft → open → passed | rejected | vetoed | expired
+ *
+ * Quorum types:
+ *   majority       – votesFor > votesAgainst
+ *   supermajority  – votesFor >= 2/3 of total votes
+ *   unanimous      – zero against votes, at least one for vote
+ *   board_approval – majority, but board can veto independently
+ *
+ * When a proposal passes with a linked knowledgeEntryId, the knowledge
+ * entry should be automatically ratified by the caller.
+ */
+import { randomUUID } from 'node:crypto';
+/** In-memory implementation of ConsensusStore */
+export class InMemoryConsensusStore {
+    proposals = new Map();
+    votes = new Map();
+    async listProposals(companyId, status) {
+        const results = [];
+        for (const p of this.proposals.values()) {
+            if (p.companyId !== companyId)
+                continue;
+            if (status && p.status !== status)
+                continue;
+            results.push(p);
+        }
+        return results.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    async getProposal(id) {
+        return this.proposals.get(id) ?? null;
+    }
+    async createProposal(proposal) {
+        this.proposals.set(proposal.id, proposal);
+        return proposal;
+    }
+    async updateProposal(id, partial) {
+        const existing = this.proposals.get(id);
+        if (!existing)
+            return null;
+        const updated = { ...existing, ...partial, updatedAt: new Date().toISOString() };
+        this.proposals.set(id, updated);
+        return updated;
+    }
+    async listVotes(proposalId) {
+        const results = [];
+        for (const v of this.votes.values()) {
+            if (v.proposalId === proposalId)
+                results.push(v);
+        }
+        return results;
+    }
+    async getVoteByVoter(proposalId, voterId) {
+        for (const v of this.votes.values()) {
+            if (v.proposalId === proposalId && v.voterId === voterId)
+                return v;
+        }
+        return null;
+    }
+    async createVote(vote) {
+        this.votes.set(vote.id, vote);
+        return vote;
+    }
+}
+/** Check if quorum is reached and determine outcome */
+function resolveQuorum(quorumType, votesFor, votesAgainst) {
+    const totalDecisive = votesFor + votesAgainst;
+    if (totalDecisive === 0)
+        return null;
+    switch (quorumType) {
+        case 'majority':
+        case 'board_approval':
+            if (votesFor > votesAgainst) {
+                return { resolved: true, status: 'passed' };
+            }
+            if (votesAgainst > votesFor) {
+                return { resolved: true, status: 'rejected' };
+            }
+            return null;
+        case 'supermajority': {
+            const total = votesFor + votesAgainst;
+            if (total > 0 && votesFor / total >= 2 / 3) {
+                return { resolved: true, status: 'passed' };
+            }
+            if (total > 0 && votesAgainst / total > 1 / 3) {
+                return { resolved: true, status: 'rejected' };
+            }
+            return null;
+        }
+        case 'unanimous':
+            if (votesAgainst > 0) {
+                return { resolved: true, status: 'rejected' };
+            }
+            if (votesFor > 0) {
+                return { resolved: true, status: 'passed' };
+            }
+            return null;
+        default:
+            return null;
+    }
+}
+export class ConsensusService {
+    store;
+    constructor(store = new InMemoryConsensusStore()) {
+        this.store = store;
+    }
+    async listProposals(companyId, status) {
+        return this.store.listProposals(companyId, status);
+    }
+    async getProposal(id) {
+        return this.store.getProposal(id);
+    }
+    async createProposal(companyId, createdBy, input) {
+        const now = new Date().toISOString();
+        const proposal = {
+            id: randomUUID(),
+            companyId,
+            title: input.title,
+            description: input.description,
+            proposalType: input.proposalType,
+            status: 'draft',
+            quorumType: input.quorumType ?? 'majority',
+            createdBy,
+            knowledgeEntryId: input.knowledgeEntryId,
+            votesFor: 0,
+            votesAgainst: 0,
+            votesAbstain: 0,
+            expiresAt: input.expiresAt,
+            metadata: input.metadata,
+            createdAt: now,
+            updatedAt: now,
+        };
+        return this.store.createProposal(proposal);
+    }
+    /**
+     * Cast a vote on a proposal. Returns the updated proposal.
+     * Automatically resolves the proposal if quorum is reached.
+     */
+    async castVote(proposalId, voterId, input) {
+        const proposal = await this.store.getProposal(proposalId);
+        if (!proposal)
+            return null;
+        if (proposal.status !== 'open') {
+            throw new Error(`Cannot vote on proposal with status "${proposal.status}"`);
+        }
+        const existingVote = await this.store.getVoteByVoter(proposalId, voterId);
+        if (existingVote) {
+            throw new Error('Voter has already cast a vote on this proposal');
+        }
+        const vote = {
+            id: randomUUID(),
+            proposalId,
+            voterId,
+            vote: input.vote,
+            reasoning: input.reasoning,
+            createdAt: new Date().toISOString(),
+        };
+        await this.store.createVote(vote);
+        // Update vote counts
+        const updates = {};
+        switch (input.vote) {
+            case 'for':
+                updates.votesFor = proposal.votesFor + 1;
+                break;
+            case 'against':
+                updates.votesAgainst = proposal.votesAgainst + 1;
+                break;
+            case 'abstain':
+                updates.votesAbstain = proposal.votesAbstain + 1;
+                break;
+        }
+        const updatedProposal = await this.store.updateProposal(proposalId, updates);
+        if (!updatedProposal)
+            return null;
+        // Check quorum
+        const resolution = resolveQuorum(updatedProposal.quorumType, updatedProposal.votesFor, updatedProposal.votesAgainst);
+        if (resolution?.resolved) {
+            const resolved = await this.store.updateProposal(proposalId, {
+                status: resolution.status,
+                resolvedAt: new Date().toISOString(),
+            });
+            return { vote, proposal: resolved ?? updatedProposal };
+        }
+        return { vote, proposal: updatedProposal };
+    }
+    /** Open a draft proposal for voting */
+    async openProposal(id) {
+        const proposal = await this.store.getProposal(id);
+        if (!proposal || proposal.status !== 'draft')
+            return null;
+        return this.store.updateProposal(id, { status: 'open' });
+    }
+    /** Board veto — immediately sets status to vetoed */
+    async vetoProposal(id) {
+        const proposal = await this.store.getProposal(id);
+        if (!proposal || (proposal.status !== 'open' && proposal.status !== 'draft'))
+            return null;
+        return this.store.updateProposal(id, {
+            status: 'vetoed',
+            resolvedAt: new Date().toISOString(),
+        });
+    }
+    async listVotes(proposalId) {
+        return this.store.listVotes(proposalId);
+    }
+}
+//# sourceMappingURL=consensus.js.map

package/dist/src/backbone/services/consensus.js.map

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

package/dist/src/backbone/services/index.d.ts

@@ -0,0 +1,10 @@
+export { MemoryService, InMemoryMemoryStore } from './memory.js';
+export type { MemoryStore } from './memory.js';
+export { KnowledgeService, InMemoryKnowledgeStore } from './knowledge.js';
+export type { KnowledgeStore, KnowledgeListFilters } from './knowledge.js';
+export { CommunicationService, InMemoryMessageStore } from './communication.js';
+export type { MessageStore } from './communication.js';
+export { ConsensusService, InMemoryConsensusStore } from './consensus.js';
+export type { ConsensusStore } from './consensus.js';
+export { VaultHealthService } from './vault-health.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/backbone/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/backbone/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3E,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/backbone/services/index.js

@@ -0,0 +1,6 @@
+export { MemoryService, InMemoryMemoryStore } from './memory.js';
+export { KnowledgeService, InMemoryKnowledgeStore } from './knowledge.js';
+export { CommunicationService, InMemoryMessageStore } from './communication.js';
+export { ConsensusService, InMemoryConsensusStore } from './consensus.js';
+export { VaultHealthService } from './vault-health.js';
+//# sourceMappingURL=index.js.map

package/dist/src/backbone/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/backbone/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/backbone/services/knowledge.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Knowledge Base Service
+ *
+ * Company-scoped shared knowledge base with status lifecycle:
+ *   draft → proposed → ratified → archived
+ *
+ * Default implementation uses an in-memory store; consumers can inject
+ * a database-backed adapter by implementing KnowledgeStore.
+ */
+import type { KnowledgeEntry, CreateKnowledgeEntryInput, UpdateKnowledgeEntryInput } from '../types.js';
+import type { KnowledgeStatus, KnowledgeCategory } from '../constants.js';
+export interface KnowledgeListFilters {
+    category?: KnowledgeCategory;
+    status?: KnowledgeStatus;
+    search?: string;
+}
+/** Storage adapter interface for knowledge entries */
+export interface KnowledgeStore {
+    list(companyId: string, filters?: KnowledgeListFilters): Promise<KnowledgeEntry[]>;
+    get(id: string): Promise<KnowledgeEntry | null>;
+    create(entry: KnowledgeEntry): Promise<KnowledgeEntry>;
+    update(id: string, partial: Partial<KnowledgeEntry>): Promise<KnowledgeEntry | null>;
+    delete(id: string): Promise<boolean>;
+}
+/** In-memory implementation of KnowledgeStore */
+export declare class InMemoryKnowledgeStore implements KnowledgeStore {
+    private entries;
+    list(companyId: string, filters?: KnowledgeListFilters): Promise<KnowledgeEntry[]>;
+    get(id: string): Promise<KnowledgeEntry | null>;
+    create(entry: KnowledgeEntry): Promise<KnowledgeEntry>;
+    update(id: string, partial: Partial<KnowledgeEntry>): Promise<KnowledgeEntry | null>;
+    delete(id: string): Promise<boolean>;
+}
+export declare class KnowledgeService {
+    private store;
+    constructor(store?: KnowledgeStore);
+    listKnowledge(companyId: string, filters?: KnowledgeListFilters): Promise<KnowledgeEntry[]>;
+    getKnowledge(id: string): Promise<KnowledgeEntry | null>;
+    createKnowledge(companyId: string, createdBy: string, input: CreateKnowledgeEntryInput): Promise<KnowledgeEntry>;
+    updateKnowledge(id: string, updatedBy: string, input: UpdateKnowledgeEntryInput): Promise<KnowledgeEntry | null>;
+    deleteKnowledge(id: string): Promise<boolean>;
+    ratifyKnowledge(id: string): Promise<KnowledgeEntry | null>;
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/src/backbone/services/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../../src/backbone/services/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACnF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC;AAED,iDAAiD;AACjD,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,OAAO,CAAqC;IAE9C,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoBlF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/C,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAKtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAQpF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG3C;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,KAAK;gBAAL,KAAK,GAAE,cAA6C;IAElE,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,cAAc,EAAE,CAAC;IAItB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIxD,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,cAAc,CAAC;IAmBpB,eAAe,CACnB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAW3B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAGlE"}

package/dist/src/backbone/services/knowledge.js

@@ -0,0 +1,99 @@
+/**
+ * Knowledge Base Service
+ *
+ * Company-scoped shared knowledge base with status lifecycle:
+ *   draft → proposed → ratified → archived
+ *
+ * Default implementation uses an in-memory store; consumers can inject
+ * a database-backed adapter by implementing KnowledgeStore.
+ */
+import { randomUUID } from 'node:crypto';
+/** In-memory implementation of KnowledgeStore */
+export class InMemoryKnowledgeStore {
+    entries = new Map();
+    async list(companyId, filters) {
+        const results = [];
+        for (const entry of this.entries.values()) {
+            if (entry.companyId !== companyId)
+                continue;
+            if (filters?.category && entry.category !== filters.category)
+                continue;
+            if (filters?.status && entry.status !== filters.status)
+                continue;
+            if (filters?.search) {
+                const term = filters.search.toLowerCase();
+                if (!entry.title.toLowerCase().includes(term) &&
+                    !entry.content.toLowerCase().includes(term)) {
+                    continue;
+                }
+            }
+            results.push(entry);
+        }
+        return results;
+    }
+    async get(id) {
+        return this.entries.get(id) ?? null;
+    }
+    async create(entry) {
+        this.entries.set(entry.id, entry);
+        return entry;
+    }
+    async update(id, partial) {
+        const existing = this.entries.get(id);
+        if (!existing)
+            return null;
+        const updated = { ...existing, ...partial, updatedAt: new Date().toISOString() };
+        this.entries.set(id, updated);
+        return updated;
+    }
+    async delete(id) {
+        return this.entries.delete(id);
+    }
+}
+export class KnowledgeService {
+    store;
+    constructor(store = new InMemoryKnowledgeStore()) {
+        this.store = store;
+    }
+    async listKnowledge(companyId, filters) {
+        return this.store.list(companyId, filters);
+    }
+    async getKnowledge(id) {
+        return this.store.get(id);
+    }
+    async createKnowledge(companyId, createdBy, input) {
+        const now = new Date().toISOString();
+        const entry = {
+            id: randomUUID(),
+            companyId,
+            title: input.title,
+            content: input.content,
+            category: input.category,
+            status: input.status ?? 'draft',
+            version: 1,
+            createdBy,
+            tags: input.tags,
+            metadata: input.metadata,
+            createdAt: now,
+            updatedAt: now,
+        };
+        return this.store.create(entry);
+    }
+    async updateKnowledge(id, updatedBy, input) {
+        const existing = await this.store.get(id);
+        if (!existing)
+            return null;
+        return this.store.update(id, {
+            ...input,
+            updatedBy,
+            version: existing.version + 1,
+        });
+    }
+    async deleteKnowledge(id) {
+        return this.store.delete(id);
+    }
+    async ratifyKnowledge(id) {
+        return this.store.update(id, { status: 'ratified' });
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/src/backbone/services/knowledge.js.map

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

package/dist/src/backbone/services/memory.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Agent Memory Service
+ *
+ * Per-agent key-value working memory with optional TTL expiration.
+ * Default implementation uses an in-memory store; consumers can inject
+ * a database-backed adapter by implementing MemoryStore.
+ */
+import type { AgentMemoryEntry, SetMemoryInput } from '../types.js';
+/** Storage adapter interface for memory entries */
+export interface MemoryStore {
+    list(companyId: string, agentId: string): Promise<AgentMemoryEntry[]>;
+    get(companyId: string, agentId: string, key: string): Promise<AgentMemoryEntry | null>;
+    upsert(companyId: string, agentId: string, entry: AgentMemoryEntry): Promise<AgentMemoryEntry>;
+    delete(companyId: string, agentId: string, key: string): Promise<boolean>;
+    purgeExpired(): Promise<number>;
+}
+/** In-memory implementation of MemoryStore */
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private entries;
+    private makeKey;
+    list(companyId: string, agentId: string): Promise<AgentMemoryEntry[]>;
+    get(companyId: string, agentId: string, key: string): Promise<AgentMemoryEntry | null>;
+    upsert(companyId: string, agentId: string, entry: AgentMemoryEntry): Promise<AgentMemoryEntry>;
+    delete(companyId: string, agentId: string, key: string): Promise<boolean>;
+    purgeExpired(): Promise<number>;
+}
+export declare class MemoryService {
+    private store;
+    constructor(store?: MemoryStore);
+    listMemory(companyId: string, agentId: string): Promise<AgentMemoryEntry[]>;
+    getMemory(companyId: string, agentId: string, key: string): Promise<AgentMemoryEntry | null>;
+    setMemory(companyId: string, agentId: string, input: SetMemoryInput): Promise<AgentMemoryEntry>;
+    deleteMemory(companyId: string, agentId: string, key: string): Promise<boolean>;
+    purgeExpired(): Promise<number>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/backbone/services/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/backbone/services/memory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEpE,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACtE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACvF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,8CAA8C;AAC9C,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,OAAO,CAAuC;IAEtD,OAAO,CAAC,OAAO;IAIT,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAcrE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAUtF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAK9F,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAWtC;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,KAAK;gBAAL,KAAK,GAAE,WAAuC;IAE5D,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAI3E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAI5F,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,gBAAgB,CAAC;IAsBtB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;CAGtC"}