81441ee9af
* feat(paperclip): add hindsight-paperclip TypeScript integration
Adds long-term memory for Paperclip AI agents via a lightweight
TypeScript/Node.js npm package with no runtime dependencies.
- recall() / retain() functions for heartbeat lifecycle hooks
- createMemoryMiddleware() for Express HTTP adapter agents
- Bank ID strategy: paperclip::{companyId}::{agentId} (configurable)
- Skill file for agents to call Hindsight REST API directly
- 27 unit tests covering bank derivation, recall, and retain
- Docs page at sdks/integrations/paperclip
* Remove skills file from paperclip integration
* Rename package to @vectorize-io/hindsight-paperclip
42 lines
1.5 KiB
TypeScript
42 lines
1.5 KiB
TypeScript
import { describe, it, expect } from 'vitest';
|
|
import { deriveBankId } from '../src/bank.js';
|
|
import { loadConfig } from '../src/config.js';
|
|
|
|
describe('deriveBankId', () => {
|
|
const ctx = { companyId: 'co-123', agentId: 'ag-456' };
|
|
|
|
it('default: paperclip::companyId::agentId', () => {
|
|
const config = loadConfig();
|
|
expect(deriveBankId(ctx, config)).toBe('paperclip::co-123::ag-456');
|
|
});
|
|
|
|
it('company-only granularity', () => {
|
|
const config = loadConfig({ bankGranularity: ['company'] });
|
|
expect(deriveBankId(ctx, config)).toBe('paperclip::co-123');
|
|
});
|
|
|
|
it('agent-only granularity', () => {
|
|
const config = loadConfig({ bankGranularity: ['agent'] });
|
|
expect(deriveBankId(ctx, config)).toBe('paperclip::ag-456');
|
|
});
|
|
|
|
it('custom prefix', () => {
|
|
const config = loadConfig({ bankIdPrefix: 'myapp' });
|
|
expect(deriveBankId(ctx, config)).toBe('myapp::co-123::ag-456');
|
|
});
|
|
|
|
it('empty prefix with default granularity', () => {
|
|
const config = loadConfig({ bankIdPrefix: '' });
|
|
expect(deriveBankId(ctx, config)).toBe('co-123::ag-456');
|
|
});
|
|
|
|
it('throws when bank ID would be empty', () => {
|
|
const config = loadConfig({ bankIdPrefix: '', bankGranularity: [] });
|
|
expect(() => deriveBankId(ctx, config)).toThrow('Bank ID cannot be empty');
|
|
});
|
|
|
|
it('reversed granularity order', () => {
|
|
const config = loadConfig({ bankGranularity: ['agent', 'company'] });
|
|
expect(deriveBankId(ctx, config)).toBe('paperclip::ag-456::co-123');
|
|
});
|
|
});
|