@plumbus/core 0.1.0

package/dist/define/__tests__/defineCapability.test.js

@@ -0,0 +1,66 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineCapability } from '../defineCapability.js';
+describe('defineCapability', () => {
+    const validConfig = () => ({
+        name: 'getUser',
+        kind: 'query',
+        domain: 'users',
+        input: z.object({ userId: z.string() }),
+        output: z.object({ id: z.string(), name: z.string() }),
+        effects: { data: ['User'], events: [], external: [], ai: false },
+        handler: async (_ctx, input) => ({
+            id: input.userId,
+            name: 'Test User',
+        }),
+    });
+    it('creates a valid capability contract', () => {
+        const cap = defineCapability(validConfig());
+        expect(cap.name).toBe('getUser');
+        expect(cap.kind).toBe('query');
+        expect(cap.domain).toBe('users');
+        expect(cap.effects.ai).toBe(false);
+        expect(typeof cap.handler).toBe('function');
+    });
+    it('freezes the returned contract', () => {
+        const cap = defineCapability(validConfig());
+        expect(Object.isFrozen(cap)).toBe(true);
+    });
+    it('accepts optional fields', () => {
+        const cap = defineCapability({
+            ...validConfig(),
+            description: 'Fetches a user by ID',
+            tags: ['user', 'read'],
+            version: '1.0.0',
+            owner: 'team-users',
+            access: { roles: ['admin'], tenantScoped: true },
+            audit: { event: 'user.fetched', includeInput: ['userId'] },
+            explanation: { enabled: true, summary: 'Fetched user data' },
+        });
+        expect(cap.description).toBe('Fetches a user by ID');
+        expect(cap.access?.roles).toEqual(['admin']);
+        expect(cap.audit?.event).toBe('user.fetched');
+    });
+    it('throws if name is missing', () => {
+        expect(() => defineCapability({ ...validConfig(), name: '' })).toThrow('name is required');
+    });
+    it('throws if kind is missing', () => {
+        expect(() => defineCapability({ ...validConfig(), kind: '' })).toThrow('kind is required');
+    });
+    it('throws if domain is missing', () => {
+        expect(() => defineCapability({ ...validConfig(), domain: '' })).toThrow('domain is required');
+    });
+    it('throws if input is not a Zod schema', () => {
+        expect(() => defineCapability({ ...validConfig(), input: {} })).toThrow('input must be a Zod schema');
+    });
+    it('throws if output is not a Zod schema', () => {
+        expect(() => defineCapability({ ...validConfig(), output: 'string' })).toThrow('output must be a Zod schema');
+    });
+    it('throws if effects is missing', () => {
+        expect(() => defineCapability({ ...validConfig(), effects: undefined })).toThrow('effects declaration is required');
+    });
+    it('throws if handler is not a function', () => {
+        expect(() => defineCapability({ ...validConfig(), handler: 'nope' })).toThrow('handler function is required');
+    });
+});
+//# sourceMappingURL=defineCapability.test.js.map

package/dist/define/__tests__/defineCapability.test.js.map

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

package/dist/define/__tests__/defineEntity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defineEntity.test.d.ts.map

package/dist/define/__tests__/defineEntity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEntity.test.d.ts","sourceRoot":"","sources":["../../../src/define/__tests__/defineEntity.test.ts"],"names":[],"mappings":""}

package/dist/define/__tests__/defineEntity.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { field } from '../../fields/index.js';
+import { defineEntity } from '../defineEntity.js';
+describe('defineEntity', () => {
+    const validConfig = () => ({
+        name: 'User',
+        fields: {
+            id: field.id(),
+            email: field.string({ required: true, unique: true, classification: 'personal' }),
+            name: field.string({ required: true }),
+            active: field.boolean({ default: true }),
+        },
+    });
+    it('creates a valid entity definition', () => {
+        const entity = defineEntity(validConfig());
+        expect(entity.name).toBe('User');
+        expect(Object.keys(entity.fields)).toEqual(['id', 'email', 'name', 'active']);
+    });
+    it('freezes the returned definition', () => {
+        const entity = defineEntity(validConfig());
+        expect(Object.isFrozen(entity)).toBe(true);
+    });
+    it('accepts optional fields', () => {
+        const entity = defineEntity({
+            ...validConfig(),
+            description: 'Application user',
+            domain: 'identity',
+            tags: ['core'],
+            owner: 'team-auth',
+            indexes: [['email'], ['name', 'active']],
+            retention: { duration: '365d' },
+            tenantScoped: true,
+        });
+        expect(entity.indexes).toEqual([['email'], ['name', 'active']]);
+        expect(entity.tenantScoped).toBe(true);
+    });
+    it('throws if name is missing', () => {
+        expect(() => defineEntity({ ...validConfig(), name: '' })).toThrow('name is required');
+    });
+    it('throws if fields is empty', () => {
+        expect(() => defineEntity({ ...validConfig(), fields: {} })).toThrow('at least one field is required');
+    });
+    it('throws if index references unknown field', () => {
+        expect(() => defineEntity({
+            ...validConfig(),
+            indexes: [['nonexistent']],
+        })).toThrow('index references unknown field "nonexistent"');
+    });
+});
+//# sourceMappingURL=defineEntity.test.js.map

package/dist/define/__tests__/defineEntity.test.js.map

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

package/dist/define/__tests__/defineEvent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defineEvent.test.d.ts.map

package/dist/define/__tests__/defineEvent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEvent.test.d.ts","sourceRoot":"","sources":["../../../src/define/__tests__/defineEvent.test.ts"],"names":[],"mappings":""}

package/dist/define/__tests__/defineEvent.test.js

@@ -0,0 +1,35 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineEvent } from '../defineEvent.js';
+describe('defineEvent', () => {
+    const validConfig = () => ({
+        name: 'order.placed',
+        payload: z.object({ orderId: z.string(), amount: z.number() }),
+    });
+    it('creates a valid event definition', () => {
+        const event = defineEvent(validConfig());
+        expect(event.name).toBe('order.placed');
+    });
+    it('freezes the returned definition', () => {
+        const event = defineEvent(validConfig());
+        expect(Object.isFrozen(event)).toBe(true);
+    });
+    it('accepts optional fields', () => {
+        const event = defineEvent({
+            ...validConfig(),
+            description: 'Emitted when a new order is placed',
+            domain: 'orders',
+            version: '1.0.0',
+            tags: ['billing'],
+        });
+        expect(event.version).toBe('1.0.0');
+        expect(event.domain).toBe('orders');
+    });
+    it('throws if name is missing', () => {
+        expect(() => defineEvent({ ...validConfig(), name: '' })).toThrow('name is required');
+    });
+    it('throws if payload is not a Zod schema', () => {
+        expect(() => defineEvent({ ...validConfig(), payload: {} })).toThrow('payload must be a Zod schema');
+    });
+});
+//# sourceMappingURL=defineEvent.test.js.map

package/dist/define/__tests__/defineEvent.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEvent.test.js","sourceRoot":"","sources":["../../../src/define/__tests__/defineEvent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;KAC/D,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,GAAG,WAAW,EAAE;YAChB,WAAW,EAAE,oCAAoC;YACjD,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,CAAC,SAAS,CAAC;SAClB,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,OAAO,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CACzE,8BAA8B,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/define/__tests__/defineFlow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defineFlow.test.d.ts.map

package/dist/define/__tests__/defineFlow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFlow.test.d.ts","sourceRoot":"","sources":["../../../src/define/__tests__/defineFlow.test.ts"],"names":[],"mappings":""}

package/dist/define/__tests__/defineFlow.test.js

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { defineFlow } from '../defineFlow.js';
+describe('defineFlow', () => {
+    const validConfig = () => ({
+        name: 'approveRefund',
+        domain: 'billing',
+        input: z.object({ refundId: z.string() }),
+        steps: [
+            { type: 'capability', name: 'validateRefund' },
+            { type: 'capability', name: 'processRefund' },
+        ],
+    });
+    it('creates a valid flow definition', () => {
+        const flow = defineFlow(validConfig());
+        expect(flow.name).toBe('approveRefund');
+        expect(flow.steps).toHaveLength(2);
+    });
+    it('freezes the returned definition', () => {
+        const flow = defineFlow(validConfig());
+        expect(Object.isFrozen(flow)).toBe(true);
+    });
+    it('accepts optional fields', () => {
+        const flow = defineFlow({
+            ...validConfig(),
+            description: 'Processes refund approval',
+            tags: ['billing'],
+            state: z.object({ approved: z.boolean() }),
+            trigger: { event: 'refund.requested' },
+            schedule: { cron: '0 * * * *' },
+            retry: { attempts: 3, backoff: 'exponential' },
+        });
+        expect(flow.trigger?.event).toBe('refund.requested');
+        expect(flow.retry?.attempts).toBe(3);
+    });
+    it('throws if name is missing', () => {
+        expect(() => defineFlow({ ...validConfig(), name: '' })).toThrow('name is required');
+    });
+    it('throws if domain is missing', () => {
+        expect(() => defineFlow({ ...validConfig(), domain: '' })).toThrow('domain is required');
+    });
+    it('throws if input is not a Zod schema', () => {
+        expect(() => defineFlow({ ...validConfig(), input: {} })).toThrow('input must be a Zod schema');
+    });
+    it('throws if steps is empty', () => {
+        expect(() => defineFlow({ ...validConfig(), steps: [] })).toThrow('at least one step is required');
+    });
+});
+//# sourceMappingURL=defineFlow.test.js.map

package/dist/define/__tests__/defineFlow.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFlow.test.js","sourceRoot":"","sources":["../../../src/define/__tests__/defineFlow.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QACzC,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,YAAqB,EAAE,IAAI,EAAE,gBAAgB,EAAE;YACvD,EAAE,IAAI,EAAE,YAAqB,EAAE,IAAI,EAAE,eAAe,EAAE;SACvD;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,IAAI,GAAG,UAAU,CAAC;YACtB,GAAG,WAAW,EAAE;YAChB,WAAW,EAAE,2BAA2B;YACxC,IAAI,EAAE,CAAC,SAAS,CAAC;YACjB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE;YACtC,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;YAC/B,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE;SAC/C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,KAAK,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CACtE,4BAA4B,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAC/D,+BAA+B,CAChC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/define/__tests__/definePrompt.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definePrompt.test.d.ts.map

package/dist/define/__tests__/definePrompt.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.test.d.ts","sourceRoot":"","sources":["../../../src/define/__tests__/definePrompt.test.ts"],"names":[],"mappings":""}

package/dist/define/__tests__/definePrompt.test.js

@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest';
+import { z } from 'zod';
+import { definePrompt } from '../definePrompt.js';
+describe('definePrompt', () => {
+    const validConfig = () => ({
+        name: 'summarizeTicket',
+        input: z.object({ ticketText: z.string() }),
+        output: z.object({ summary: z.string(), priority: z.enum(['low', 'medium', 'high']) }),
+    });
+    it('creates a valid prompt definition', () => {
+        const prompt = definePrompt(validConfig());
+        expect(prompt.name).toBe('summarizeTicket');
+    });
+    it('freezes the returned definition', () => {
+        const prompt = definePrompt(validConfig());
+        expect(Object.isFrozen(prompt)).toBe(true);
+    });
+    it('accepts optional fields', () => {
+        const prompt = definePrompt({
+            ...validConfig(),
+            description: 'Summarizes support tickets',
+            domain: 'support',
+            tags: ['ai'],
+            owner: 'team-support',
+            model: { provider: 'openai', name: 'gpt-4', temperature: 0.3, maxTokens: 500 },
+        });
+        expect(prompt.model?.provider).toBe('openai');
+        expect(prompt.model?.temperature).toBe(0.3);
+    });
+    it('throws if name is missing', () => {
+        expect(() => definePrompt({ ...validConfig(), name: '' })).toThrow('name is required');
+    });
+    it('throws if input is not a Zod schema', () => {
+        expect(() => definePrompt({ ...validConfig(), input: 'text' })).toThrow('input must be a Zod schema');
+    });
+    it('throws if output is not a Zod schema', () => {
+        expect(() => definePrompt({ ...validConfig(), output: 42 })).toThrow('output must be a Zod schema');
+    });
+});
+//# sourceMappingURL=definePrompt.test.js.map

package/dist/define/__tests__/definePrompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.test.js","sourceRoot":"","sources":["../../../src/define/__tests__/definePrompt.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;KACvF,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,GAAG,WAAW,EAAE;YAChB,WAAW,EAAE,4BAA4B;YACzC,MAAM,EAAE,SAAS;YACjB,IAAI,EAAE,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,cAAc;YACrB,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE;SAC/E,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,KAAK,EAAE,MAAa,EAAE,CAAC,CAAC,CAAC,OAAO,CAC5E,4BAA4B,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,GAAG,WAAW,EAAE,EAAE,MAAM,EAAE,EAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CACzE,6BAA6B,CAC9B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/define/defineCapability.d.ts

@@ -0,0 +1,38 @@
+import type { z } from 'zod';
+import type { CapabilityContract } from '../types/capability.js';
+import type { ExecutionContext } from '../types/context.js';
+import type { CapabilityKind } from '../types/enums.js';
+import type { AccessPolicy } from '../types/security.js';
+interface DefineCapabilityInput<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny> {
+    name: string;
+    kind: CapabilityKind;
+    domain: string;
+    description?: string;
+    tags?: string[];
+    version?: string;
+    owner?: string;
+    input: TInput;
+    output: TOutput;
+    access?: AccessPolicy;
+    effects: {
+        data: string[];
+        events: string[];
+        external: string[];
+        flows?: string[];
+        ai: boolean;
+    };
+    audit?: {
+        enabled?: boolean;
+        event: string;
+        includeInput?: string[];
+        includeOutput?: string[];
+    };
+    explanation?: {
+        enabled?: boolean;
+        summary?: string;
+    };
+    handler: (ctx: ExecutionContext, input: z.infer<TInput>) => Promise<z.infer<TOutput>>;
+}
+export declare function defineCapability<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny>(config: DefineCapabilityInput<TInput, TOutput>): CapabilityContract<TInput, TOutput>;
+export {};
+//# sourceMappingURL=defineCapability.d.ts.map

package/dist/define/defineCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineCapability.d.ts","sourceRoot":"","sources":["../../src/define/defineCapability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAazD,UAAU,qBAAqB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAEhB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,EAAE,EAAE,OAAO,CAAC;KACb,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,OAAO,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;CACvF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,EACxF,MAAM,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7C,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBrC"}

package/dist/define/defineCapability.js

@@ -0,0 +1,33 @@
+/** Duck-type check for Zod schemas (works across different Zod instances) */
+function isZodSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+export function defineCapability(config) {
+    if (!config.name) {
+        throw new Error('Capability name is required');
+    }
+    if (!config.kind) {
+        throw new Error('Capability kind is required');
+    }
+    if (!config.domain) {
+        throw new Error('Capability domain is required');
+    }
+    if (!isZodSchema(config.input)) {
+        throw new Error(`Capability "${config.name}": input must be a Zod schema`);
+    }
+    if (!isZodSchema(config.output)) {
+        throw new Error(`Capability "${config.name}": output must be a Zod schema`);
+    }
+    if (!config.effects) {
+        throw new Error(`Capability "${config.name}": effects declaration is required`);
+    }
+    if (typeof config.handler !== 'function') {
+        throw new Error(`Capability "${config.name}": handler function is required`);
+    }
+    return Object.freeze({ ...config });
+}
+//# sourceMappingURL=defineCapability.js.map

package/dist/define/defineCapability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineCapability.js","sourceRoot":"","sources":["../../src/define/defineCapability.ts"],"names":[],"mappings":"AAMA,6EAA6E;AAC7E,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAiC,CAAC,SAAS,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC;AAoCD,MAAM,UAAU,gBAAgB,CAC9B,MAA8C;IAE9C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,gCAAgC,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,oCAAoC,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,iCAAiC,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/define/defineEntity.d.ts

@@ -0,0 +1,16 @@
+import type { EntityDefinition, EntityRetention } from '../types/entity.js';
+import type { FieldDescriptor } from '../types/fields.js';
+interface DefineEntityInput {
+    name: string;
+    description?: string;
+    domain?: string;
+    tags?: string[];
+    owner?: string;
+    fields: Record<string, FieldDescriptor>;
+    indexes?: string[][];
+    retention?: EntityRetention;
+    tenantScoped?: boolean;
+}
+export declare function defineEntity(config: DefineEntityInput): EntityDefinition;
+export {};
+//# sourceMappingURL=defineEntity.d.ts.map

package/dist/define/defineEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEntity.d.ts","sourceRoot":"","sources":["../../src/define/defineEntity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAqBxE"}

package/dist/define/defineEntity.js

@@ -0,0 +1,21 @@
+export function defineEntity(config) {
+    if (!config.name) {
+        throw new Error('Entity name is required');
+    }
+    if (!config.fields || Object.keys(config.fields).length === 0) {
+        throw new Error(`Entity "${config.name}": at least one field is required`);
+    }
+    // Validate indexes reference existing fields
+    if (config.indexes) {
+        const fieldNames = new Set(Object.keys(config.fields));
+        for (const idx of config.indexes) {
+            for (const col of idx) {
+                if (!fieldNames.has(col)) {
+                    throw new Error(`Entity "${config.name}": index references unknown field "${col}"`);
+                }
+            }
+        }
+    }
+    return Object.freeze({ ...config });
+}
+//# sourceMappingURL=defineEntity.js.map

package/dist/define/defineEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEntity.js","sourceRoot":"","sources":["../../src/define/defineEntity.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,mCAAmC,CAAC,CAAC;IAC7E,CAAC;IAED,6CAA6C;IAC7C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,sCAAsC,GAAG,GAAG,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/define/defineEvent.d.ts

@@ -0,0 +1,13 @@
+import type { z } from 'zod';
+import type { EventDefinition } from '../types/event.js';
+interface DefineEventInput<TPayload extends z.ZodTypeAny> {
+    name: string;
+    description?: string;
+    domain?: string;
+    version?: string;
+    tags?: string[];
+    payload: TPayload;
+}
+export declare function defineEvent<TPayload extends z.ZodTypeAny>(config: DefineEventInput<TPayload>): EventDefinition<TPayload>;
+export {};
+//# sourceMappingURL=defineEvent.d.ts.map

package/dist/define/defineEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEvent.d.ts","sourceRoot":"","sources":["../../src/define/defineEvent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAYzD,UAAU,gBAAgB,CAAC,QAAQ,SAAS,CAAC,CAAC,UAAU;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,OAAO,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,CAAC,CAAC,UAAU,EACvD,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC,CAS3B"}

package/dist/define/defineEvent.js

@@ -0,0 +1,17 @@
+function isZodSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+export function defineEvent(config) {
+    if (!config.name) {
+        throw new Error('Event name is required');
+    }
+    if (!isZodSchema(config.payload)) {
+        throw new Error(`Event "${config.name}": payload must be a Zod schema`);
+    }
+    return Object.freeze({ ...config });
+}
+//# sourceMappingURL=defineEvent.js.map

package/dist/define/defineEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineEvent.js","sourceRoot":"","sources":["../../src/define/defineEvent.ts"],"names":[],"mappings":"AAGA,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAiC,CAAC,SAAS,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,WAAW,CACzB,MAAkC;IAElC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,iCAAiC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/define/defineFlow.d.ts

@@ -0,0 +1,17 @@
+import type { z } from 'zod';
+import type { FlowDefinition, FlowRetryPolicy, FlowSchedule, FlowStep, FlowTrigger } from '../types/flow.js';
+interface DefineFlowInput<TInput extends z.ZodTypeAny, TState extends z.ZodTypeAny> {
+    name: string;
+    domain: string;
+    description?: string;
+    tags?: string[];
+    input: TInput;
+    state?: TState;
+    steps: FlowStep[];
+    trigger?: FlowTrigger;
+    schedule?: FlowSchedule;
+    retry?: FlowRetryPolicy;
+}
+export declare function defineFlow<TInput extends z.ZodTypeAny, TState extends z.ZodTypeAny = z.ZodTypeAny>(config: DefineFlowInput<TInput, TState>): FlowDefinition<TInput, TState>;
+export {};
+//# sourceMappingURL=defineFlow.d.ts.map

package/dist/define/defineFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFlow.d.ts","sourceRoot":"","sources":["../../src/define/defineFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAY1B,UAAU,eAAe,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,UAAU;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;IAElB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,wBAAgB,UAAU,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAChG,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAehC"}

package/dist/define/defineFlow.js

@@ -0,0 +1,23 @@
+function isZodSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+export function defineFlow(config) {
+    if (!config.name) {
+        throw new Error('Flow name is required');
+    }
+    if (!config.domain) {
+        throw new Error('Flow domain is required');
+    }
+    if (!isZodSchema(config.input)) {
+        throw new Error(`Flow "${config.name}": input must be a Zod schema`);
+    }
+    if (!Array.isArray(config.steps) || config.steps.length === 0) {
+        throw new Error(`Flow "${config.name}": at least one step is required`);
+    }
+    return Object.freeze({ ...config });
+}
+//# sourceMappingURL=defineFlow.js.map

package/dist/define/defineFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineFlow.js","sourceRoot":"","sources":["../../src/define/defineFlow.ts"],"names":[],"mappings":"AASA,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAiC,CAAC,SAAS,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC;AAiBD,MAAM,UAAU,UAAU,CACxB,MAAuC;IAEvC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,CAAC,IAAI,kCAAkC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/define/definePrompt.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+import type { ModelConfig, PromptDefinition } from '../types/prompt.js';
+interface DefinePromptInput<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny> {
+    name: string;
+    description?: string;
+    domain?: string;
+    tags?: string[];
+    owner?: string;
+    input: TInput;
+    output: TOutput;
+    model?: ModelConfig;
+}
+export declare function definePrompt<TInput extends z.ZodTypeAny, TOutput extends z.ZodTypeAny>(config: DefinePromptInput<TInput, TOutput>): PromptDefinition<TInput, TOutput>;
+export {};
+//# sourceMappingURL=definePrompt.d.ts.map

package/dist/define/definePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.d.ts","sourceRoot":"","sources":["../../src/define/definePrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAYxE,UAAU,iBAAiB,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,EAAE,OAAO,SAAS,CAAC,CAAC,UAAU,EACpF,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAYnC"}

package/dist/define/definePrompt.js

@@ -0,0 +1,20 @@
+function isZodSchema(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        '_def' in value &&
+        'safeParse' in value &&
+        typeof value.safeParse === 'function');
+}
+export function definePrompt(config) {
+    if (!config.name) {
+        throw new Error('Prompt name is required');
+    }
+    if (!isZodSchema(config.input)) {
+        throw new Error(`Prompt "${config.name}": input must be a Zod schema`);
+    }
+    if (!isZodSchema(config.output)) {
+        throw new Error(`Prompt "${config.name}": output must be a Zod schema`);
+    }
+    return Object.freeze({ ...config });
+}
+//# sourceMappingURL=definePrompt.js.map

package/dist/define/definePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePrompt.js","sourceRoot":"","sources":["../../src/define/definePrompt.ts"],"names":[],"mappings":"AAGA,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,WAAW,IAAI,KAAK;QACpB,OAAQ,KAAiC,CAAC,SAAS,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC;AAcD,MAAM,UAAU,YAAY,CAC1B,MAA0C;IAE1C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,gCAAgC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/define/index.d.ts

@@ -0,0 +1,6 @@
+export { defineCapability } from './defineCapability.js';
+export { defineEntity } from './defineEntity.js';
+export { defineEvent } from './defineEvent.js';
+export { defineFlow } from './defineFlow.js';
+export { definePrompt } from './definePrompt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/define/index.js

@@ -0,0 +1,10 @@
+// ── Define Functions Module ──
+// The five define*() functions that create frozen contract objects for each
+// Plumbus primitive: capabilities, entities, events, flows, and prompts.
+// These are the primary SDK surface for application developers.
+export { defineCapability } from './defineCapability.js';
+export { defineEntity } from './defineEntity.js';
+export { defineEvent } from './defineEvent.js';
+export { defineFlow } from './defineFlow.js';
+export { definePrompt } from './definePrompt.js';
+//# sourceMappingURL=index.js.map

package/dist/define/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/define/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,4EAA4E;AAC5E,yEAAyE;AACzE,gEAAgE;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/errors/__tests__/errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.test.d.ts.map

package/dist/errors/__tests__/errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../../src/errors/__tests__/errors.test.ts"],"names":[],"mappings":""}