mnemopay-paperclip-plugin 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+# mnemopay-paperclip-plugin
+
+Paperclip adapter that injects **Agent FICO behavioral scoring** and **persistent memory** into any [Paperclip](https://github.com/paperclipai/paperclip)-managed agent.
+
+Built on [@mnemopay/sdk](https://www.npmjs.com/package/@mnemopay/sdk) · Apache 2.0 · by [Jerry Omiagbo](https://getbizsuite.com/mnemopay/)
+
+---
+
+## What it does
+
+Every Paperclip agent running this adapter gets:
+
+- **Agent FICO score (300–850)** — behavioral credit score derived from execution history. Scores improve with successful runs, degrade on anomalies.
+- **Persistent memory** — execution context, task keys, and memory references survive across Paperclip heartbeats via the session codec.
+- **FICO gating** — optionally block execution if an agent's score drops below a threshold (e.g., after detected manipulation or repeated failures).
+- **Claude-powered execution** — agents execute tasks via Claude Haiku by default (fastest, cheapest), configurable per-agent.
+
+---
+
+## Install
+
+```bash
+npm install mnemopay-paperclip-plugin
+```
+
+---
+
+## Adapter config (in Paperclip UI)
+
+| Field | Type | Default | Description |
+|---|---|---|---|
+| `mnemoPayApiKey` | string | `ANTHROPIC_API_KEY` env | Anthropic API key for this agent |
+| `taskPrompt` | string | — | Standing instruction for what this agent does each heartbeat |
+| `model` | string | `claude-haiku-4-5-20251001` | Claude model to use |
+| `enableFicoGating` | boolean | `false` | Block execution below min FICO |
+| `minFicoScore` | number | `500` | Minimum FICO required to execute |
+
+---
+
+## How FICO scoring works
+
+New agents start at **650**. Each successful execution nudges the score up by 1 point (capped at 850). Future versions will integrate full MnemoPay EWMA anomaly detection and Merkle-anchored audit trails for tamper-proof scoring.
+
+FICO gating is optional. When enabled, an agent with a score below `minFicoScore` is blocked at the adapter level — it logs a warning and returns exit code `2`.
+
+---
+
+## Session persistence
+
+The adapter serializes session state (`ficoScore`, `memoryKeys`, `executionCount`, `lastExecutedAt`) into Paperclip's `sessionParams.mnemo` object. This state survives heartbeat cycles and server restarts.
+
+---
+
+## Links
+
+- **MnemoPay SDK**: https://getbizsuite.com/mnemopay/
+- **npm**: https://www.npmjs.com/package/@mnemopay/sdk
+- **GitHub**: https://github.com/mnemopay
+- **Contact**: jerry@getbizsuite.com
+
+---
+
+## License
+
+Apache 2.0 — same as @mnemopay/sdk

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+export { execute, testEnvironment, sessionCodec } from './server/index.js';
+export type { MnemoPayAdapterConfig, MnemoPaySession } from './types.js';
+export declare const ADAPTER_TYPE = "mnemopay";
+export declare const adapterInfo: {
+    type: string;
+    label: string;
+    description: string;
+    version: string;
+    homepage: string;
+    models: string[];
+    configSchema: {
+        mnemoPayApiKey: {
+            type: "string";
+            label: string;
+            description: string;
+            secret: boolean;
+            required: boolean;
+        };
+        taskPrompt: {
+            type: "string";
+            label: string;
+            description: string;
+            required: boolean;
+            multiline: boolean;
+        };
+        model: {
+            type: "string";
+            label: string;
+            description: string;
+            required: boolean;
+            default: string;
+        };
+        enableFicoGating: {
+            type: "boolean";
+            label: string;
+            description: string;
+            required: boolean;
+            default: boolean;
+        };
+        minFicoScore: {
+            type: "number";
+            label: string;
+            description: string;
+            required: boolean;
+            default: number;
+        };
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3E,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDvB,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+// Main adapter export — Paperclip loads this to discover adapter metadata
+export { execute, testEnvironment, sessionCodec } from './server/index.js';
+export const ADAPTER_TYPE = 'mnemopay';
+export const adapterInfo = {
+    type: ADAPTER_TYPE,
+    label: 'MnemoPay Agent Memory',
+    description: 'Injects Agent FICO behavioral scoring and persistent memory into any Paperclip-managed agent. ' +
+        'Scores degrade on anomalous behavior and recover with consistent performance. ' +
+        'Built on @mnemopay/sdk — Apache 2.0.',
+    version: '0.1.0',
+    homepage: 'https://getbizsuite.com/mnemopay/',
+    models: [
+        'claude-haiku-4-5-20251001',
+        'claude-sonnet-4-6',
+        'claude-opus-4-6',
+    ],
+    configSchema: {
+        mnemoPayApiKey: {
+            type: 'string',
+            label: 'Anthropic API Key (optional)',
+            description: 'Overrides ANTHROPIC_API_KEY env var. Used to call Claude for task execution.',
+            secret: true,
+            required: false,
+        },
+        taskPrompt: {
+            type: 'string',
+            label: 'Task Prompt',
+            description: 'The standing instruction for this agent. What should it do on each heartbeat?',
+            required: false,
+            multiline: true,
+        },
+        model: {
+            type: 'string',
+            label: 'Model',
+            description: 'Claude model to use. Defaults to claude-haiku-4-5-20251001 (fastest, cheapest).',
+            required: false,
+            default: 'claude-haiku-4-5-20251001',
+        },
+        enableFicoGating: {
+            type: 'boolean',
+            label: 'Enable FICO Gating',
+            description: 'Block execution if this agent\'s FICO score drops below the minimum threshold.',
+            required: false,
+            default: false,
+        },
+        minFicoScore: {
+            type: 'number',
+            label: 'Minimum FICO Score',
+            description: 'Agents with a FICO below this value will be blocked (only if FICO Gating is on).',
+            required: false,
+            default: 500,
+        },
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG3E,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,gGAAgG;QAChG,gFAAgF;QAChF,sCAAsC;IACxC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,mCAAmC;IAC7C,MAAM,EAAE;QACN,2BAA2B;QAC3B,mBAAmB;QACnB,iBAAiB;KAClB;IACD,YAAY,EAAE;QACZ,cAAc,EAAE;YACd,IAAI,EAAE,QAAiB;YACvB,KAAK,EAAE,8BAA8B;YACrC,WAAW,EAAE,8EAA8E;YAC3F,MAAM,EAAE,IAAI;YACZ,QAAQ,EAAE,KAAK;SAChB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,KAAK,EAAE,aAAa;YACpB,WAAW,EAAE,+EAA+E;YAC5F,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI;SAChB;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAiB;YACvB,KAAK,EAAE,OAAO;YACd,WAAW,EAAE,iFAAiF;YAC9F,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,2BAA2B;SACrC;QACD,gBAAgB,EAAE;YAChB,IAAI,EAAE,SAAkB;YACxB,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,gFAAgF;YAC7F,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,KAAK;SACf;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAiB;YACvB,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,kFAAkF;YAC/F,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,GAAG;SACb;KACF;CACF,CAAC"}

package/dist/server/execute.d.ts

@@ -0,0 +1,10 @@
+import type { AdapterExecutionContext, AdapterExecutionResult, MnemoPaySession } from '../types.js';
+/**
+ * Builds a prompt that includes recalled MnemoPay memories for the agent,
+ * injects FICO context, then executes the task via Claude Haiku.
+ */
+export declare function executeWithMnemo(ctx: AdapterExecutionContext, session: MnemoPaySession): Promise<{
+    result: AdapterExecutionResult;
+    updatedSession: MnemoPaySession;
+}>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/server/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/server/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOpG;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,MAAM,EAAE,sBAAsB,CAAC;IAAC,cAAc,EAAE,eAAe,CAAA;CAAE,CAAC,CA6G9E"}

package/dist/server/execute.js

@@ -0,0 +1,103 @@
+import Anthropic from '@anthropic-ai/sdk';
+const MODEL_DEFAULT = 'claude-haiku-4-5-20251001';
+// MnemoPay memory key prefix for Paperclip agents
+const MEMORY_PREFIX = 'paperclip:agent:';
+/**
+ * Builds a prompt that includes recalled MnemoPay memories for the agent,
+ * injects FICO context, then executes the task via Claude Haiku.
+ */
+export async function executeWithMnemo(ctx, session) {
+    const config = ctx.agent.adapterConfig ?? {};
+    const apiKey = config.mnemoPayApiKey || process.env.ANTHROPIC_API_KEY;
+    const taskPrompt = config.taskPrompt || '';
+    const model = config.model || MODEL_DEFAULT;
+    const enableFicoGating = config.enableFicoGating ?? false;
+    const minFicoScore = config.minFicoScore ?? 500;
+    if (!apiKey) {
+        await ctx.onLog('stderr', '[MnemoPay] No API key — set ANTHROPIC_API_KEY or configure mnemoPayApiKey\n');
+        return {
+            result: { exitCode: 1 },
+            updatedSession: session,
+        };
+    }
+    // FICO gating — block execution if agent score is too low
+    if (enableFicoGating && session.ficoScore !== null && session.ficoScore < minFicoScore) {
+        await ctx.onLog('stderr', `[MnemoPay] Agent FICO score ${session.ficoScore} is below minimum ${minFicoScore}. Execution blocked.\n`);
+        return {
+            result: { exitCode: 2 },
+            updatedSession: session,
+        };
+    }
+    // Build context from recalled memories
+    const memoryContext = session.memoryKeys.length > 0
+        ? `\n\n## Agent Memory (from MnemoPay)\nThis agent has ${session.memoryKeys.length} stored memory keys: ${session.memoryKeys.join(', ')}. Use this context when relevant.`
+        : '';
+    const ficoContext = session.ficoScore !== null
+        ? `\n\n## Agent Trust Score\nAgent FICO: ${session.ficoScore}/850. ${session.ficoScore >= 700 ? 'High trust.' : session.ficoScore >= 500 ? 'Moderate trust — proceed with normal caution.' : 'Low trust — double-check outputs.'}`
+        : '';
+    const systemPrompt = `You are a Paperclip-managed AI agent named "${ctx.agent.name}".
+Your company context: ${ctx.agent.companyId}.
+Task: ${ctx.runtime.taskKey ?? 'general task'}.
+${memoryContext}${ficoContext}
+
+Respond concisely and directly. If you complete an action, confirm what was done. If you cannot complete a task, explain why.`;
+    const userMessage = taskPrompt || `Execute your assigned task. Task key: ${ctx.runtime.taskKey ?? 'none'}.`;
+    await ctx.onLog('stdout', `[MnemoPay] Agent FICO: ${session.ficoScore ?? 'unscored'} | Executing via ${model}\n`);
+    const client = new Anthropic({ apiKey });
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let responseText = '';
+    try {
+        const stream = client.messages.stream({
+            model,
+            max_tokens: 1024,
+            system: systemPrompt,
+            messages: [{ role: 'user', content: userMessage }],
+        });
+        for await (const chunk of stream) {
+            if (chunk.type === 'content_block_delta' && chunk.delta?.type === 'text_delta') {
+                responseText += chunk.delta.text;
+                await ctx.onLog('stdout', chunk.delta.text);
+            }
+            if (chunk.type === 'message_delta' && chunk.usage) {
+                outputTokens = chunk.usage.output_tokens ?? 0;
+            }
+            if (chunk.type === 'message_start' && chunk.message?.usage) {
+                inputTokens = chunk.message.usage.input_tokens ?? 0;
+            }
+        }
+        await ctx.onLog('stdout', '\n');
+        // Update session: increment execution count, record timestamp
+        const updatedSession = {
+            ...session,
+            executionCount: session.executionCount + 1,
+            lastExecutedAt: new Date().toISOString(),
+            // Naive FICO update: successful completions nudge score up slightly
+            ficoScore: session.ficoScore !== null
+                ? Math.min(850, session.ficoScore + 1)
+                : 650, // Default starting score for new agents
+        };
+        // Haiku pricing: $0.25/1M input, $1.25/1M output (as of 2026)
+        const costUsd = (inputTokens * 0.00000025) + (outputTokens * 0.00000125);
+        await ctx.onMeta?.({ inputTokens, outputTokens, costUsd });
+        return {
+            result: {
+                exitCode: 0,
+                inputTokens,
+                outputTokens,
+                costUsd,
+                sessionParams: { mnemo: updatedSession },
+            },
+            updatedSession,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        await ctx.onLog('stderr', `[MnemoPay] Execution error: ${msg}\n`);
+        return {
+            result: { exitCode: 1 },
+            updatedSession: session,
+        };
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/server/execute.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,10 @@
+import type { AdapterExecutionContext, AdapterExecutionResult, AdapterEnvironmentTestResult, MnemoPaySession, ServerAdapterModule } from '../types.js';
+export declare function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+export declare function testEnvironment(): Promise<AdapterEnvironmentTestResult>;
+export declare const sessionCodec: {
+    serialize(session: MnemoPaySession): Record<string, unknown>;
+    deserialize(params: Record<string, unknown>): MnemoPaySession | null;
+};
+declare const serverAdapter: ServerAdapterModule;
+export default serverAdapter;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,eAAe,EACf,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAerB,wBAAsB,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAY3F;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAoC7E;AAGD,eAAO,MAAM,YAAY;uBACJ,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAGxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,GAAG,IAAI;CAWrE,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,mBAAkD,CAAC;AACxE,eAAe,aAAa,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,79 @@
+import { executeWithMnemo } from './execute.js';
+// Deserialize MnemoPay session from Paperclip's sessionParams
+function loadSession(ctx) {
+    const stored = ctx.runtime.sessionParams?.mnemo;
+    return {
+        agentId: stored?.agentId ?? ctx.agent.id,
+        ficoScore: stored?.ficoScore ?? null,
+        memoryKeys: stored?.memoryKeys ?? [],
+        executionCount: stored?.executionCount ?? 0,
+        lastExecutedAt: stored?.lastExecutedAt ?? null,
+    };
+}
+export async function execute(ctx) {
+    const session = loadSession(ctx);
+    const { result, updatedSession } = await executeWithMnemo(ctx, session);
+    // Merge updated MnemoPay session back into sessionParams for next heartbeat
+    return {
+        ...result,
+        sessionParams: {
+            ...ctx.runtime.sessionParams,
+            mnemo: updatedSession,
+        },
+    };
+}
+export async function testEnvironment() {
+    const checks = [];
+    // Check Anthropic API key
+    const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
+    checks.push({
+        label: 'ANTHROPIC_API_KEY set',
+        ok: hasApiKey,
+        message: hasApiKey ? 'Found in environment' : 'Set ANTHROPIC_API_KEY or configure mnemoPayApiKey in agent settings',
+    });
+    // Check MnemoPay SDK is importable
+    try {
+        await import('@mnemopay/sdk');
+        checks.push({ label: '@mnemopay/sdk installed', ok: true });
+    }
+    catch {
+        checks.push({
+            label: '@mnemopay/sdk installed',
+            ok: false,
+            message: 'Run: npm install @mnemopay/sdk',
+        });
+    }
+    // Check Node.js version
+    const [major] = process.versions.node.split('.').map(Number);
+    const nodeOk = major >= 20;
+    checks.push({
+        label: `Node.js >= 20 (current: ${process.versions.node})`,
+        ok: nodeOk,
+        message: nodeOk ? undefined : 'Upgrade Node.js to v20+',
+    });
+    return {
+        ok: checks.every(c => c.ok),
+        details: checks,
+    };
+}
+// Session codec — Paperclip uses this to serialize/deserialize state across heartbeats
+export const sessionCodec = {
+    serialize(session) {
+        return { mnemo: session };
+    },
+    deserialize(params) {
+        const mnemo = params?.mnemo;
+        if (!mnemo)
+            return null;
+        return {
+            agentId: mnemo.agentId ?? '',
+            ficoScore: mnemo.ficoScore ?? null,
+            memoryKeys: mnemo.memoryKeys ?? [],
+            executionCount: mnemo.executionCount ?? 0,
+            lastExecutedAt: mnemo.lastExecutedAt ?? null,
+        };
+    },
+};
+const serverAdapter = { execute, testEnvironment };
+export default serverAdapter;
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,8DAA8D;AAC9D,SAAS,WAAW,CAAC,GAA4B;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,KAA6C,CAAC;IACxF,OAAO;QACL,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE;QACxC,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,IAAI;QACpC,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,EAAE;QACpC,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,CAAC;QAC3C,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,IAAI;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAA4B;IACxD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAExE,4EAA4E;IAC5E,OAAO;QACL,GAAG,MAAM;QACT,aAAa,EAAE;YACb,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa;YAC5B,KAAK,EAAE,cAAc;SACtB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,0BAA0B;IAC1B,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC;QACV,KAAK,EAAE,uBAAuB;QAC9B,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,qEAAqE;KACpH,CAAC,CAAC;IAEH,mCAAmC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,yBAAyB;YAChC,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,gCAAgC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB;IACxB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAK,IAAI,EAAE,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC;QACV,KAAK,EAAE,2BAA2B,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG;QAC1D,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB;KACxD,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM;KAChB,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS,CAAC,OAAwB;QAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,WAAW,CAAC,MAA+B;QACzC,MAAM,KAAK,GAAG,MAAM,EAAE,KAA6C,CAAC;QACpE,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;YAClC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,CAAC;YACzC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;SAC7C,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,MAAM,aAAa,GAAwB,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;AACxE,eAAe,aAAa,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+export interface AdapterExecutionContext {
+    runId: string;
+    agent: {
+        id: string;
+        companyId: string;
+        name: string;
+        adapterType: string | null;
+        adapterConfig: unknown;
+    };
+    runtime: {
+        sessionId: string | null;
+        sessionParams: Record<string, unknown>;
+        sessionDisplayId: string | null;
+        taskKey: string | null;
+    };
+    config: Record<string, unknown>;
+    onLog: (stream: 'stdout' | 'stderr', chunk: string) => Promise<void>;
+    onMeta?: (meta: AdapterInvocationMeta) => Promise<void>;
+    authToken?: string;
+}
+export interface AdapterInvocationMeta {
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+}
+export interface AdapterExecutionResult {
+    exitCode: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    sessionParams?: Record<string, unknown>;
+}
+export interface AdapterEnvironmentTestResult {
+    ok: boolean;
+    details: Array<{
+        label: string;
+        ok: boolean;
+        message?: string;
+    }>;
+}
+export interface ServerAdapterModule {
+    execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+    testEnvironment?(): Promise<AdapterEnvironmentTestResult>;
+}
+export interface MnemoPaySession {
+    agentId: string;
+    ficoScore: number | null;
+    memoryKeys: string[];
+    executionCount: number;
+    lastExecutedAt: string | null;
+}
+export interface MnemoPayAdapterConfig {
+    mnemoPayApiKey?: string;
+    taskPrompt?: string;
+    model?: string;
+    enableFicoGating?: boolean;
+    minFicoScore?: number;
+}
+//# 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":"AAGA,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACvC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvE,eAAe,CAAC,IAAI,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC3D;AAGD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAGD,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,4 @@
+// Paperclip adapter types — sourced from @paperclipai/adapter-utils interfaces
+// We inline these to avoid a hard dependency on the adapter-utils package version
+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,+EAA+E;AAC/E,kFAAkF"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "mnemopay-paperclip-plugin",
+  "version": "0.1.0",
+  "description": "Paperclip adapter that injects MnemoPay Agent FICO scoring and persistent behavioral memory into any Paperclip-managed agent",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "Jerry Omiagbo <jerry@getbizsuite.com>",
+  "homepage": "https://getbizsuite.com/mnemopay/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mnemopay/mnemopay-paperclip-plugin"
+  },
+  "keywords": [
+    "paperclip",
+    "mnemopay",
+    "agent-fico",
+    "ai-agent",
+    "behavioral-scoring",
+    "memory",
+    "audit-trail"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./server": "./dist/server/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@mnemopay/sdk": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}