@clowder-ai/plugin-contract 0.1.0-beta.1

package/dist/conformance/runner.js

@@ -0,0 +1,252 @@
+/**
+ * Conformance runner skeleton.
+ *
+ * Validates fixture files against contract JSON Schemas.  This is the
+ * mechanical verification that fixtures (maintained by sol) conform to
+ * the schema shapes (maintained by opus).
+ *
+ * Usage:
+ *   pnpm --filter @clowder-ai/plugin-contract conformance
+ *
+ * Exit codes:
+ *   0 = all fixtures valid (or no fixtures yet)
+ *   1 = validation errors found
+ *
+ * @packageDocumentation
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { join, relative } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { validateMessagingSemantics } from '../validation/messaging-semantic.js';
+// Ajv is CJS — use createRequire for clean interop with ESM + verbatimModuleSyntax
+// Use ajv/dist/2020 for JSON Schema 2020-12 ($defs, etc.)
+const require = createRequire(import.meta.url);
+const Ajv = require('ajv/dist/2020');
+const addFormats = require('ajv-formats');
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const PKG_ROOT = join(__dirname, '..', '..');
+// ---------------------------------------------------------------------------
+// Schema loading
+// ---------------------------------------------------------------------------
+async function loadSchema(schemaPath) {
+    const raw = await readFile(schemaPath, 'utf-8');
+    return JSON.parse(raw);
+}
+async function discoverFixtures(fixturesDir) {
+    const fixtures = [];
+    const domains = ['manifest', 'messaging'];
+    for (const domain of domains) {
+        for (const validity of ['valid', 'invalid']) {
+            const dir = join(fixturesDir, domain, validity);
+            let entries;
+            try {
+                entries = await readdir(dir);
+            }
+            catch {
+                // Directory may not exist yet — sol adds fixtures incrementally
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.endsWith('.json'))
+                    continue;
+                fixtures.push({
+                    path: join(dir, entry),
+                    relativePath: relative(fixturesDir, join(dir, entry)),
+                    domain,
+                    validity,
+                });
+            }
+        }
+    }
+    return fixtures;
+}
+function getDefaultSchemaId(domain) {
+    const ids = {
+        manifest: 'https://clowder-ai.dev/schemas/manifest/v0.1',
+        messaging: 'https://clowder-ai.dev/schemas/messaging/v0.1',
+    };
+    return ids[domain] ?? '';
+}
+async function validateFixture(ajv, fixture, schemas) {
+    const schema = schemas.get(fixture.domain);
+    if (!schema) {
+        return {
+            fixture,
+            passed: false,
+            errors: [`No schema found for domain: ${fixture.domain}`],
+        };
+    }
+    const raw = await readFile(fixture.path, 'utf-8');
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (e) {
+        return {
+            fixture,
+            passed: false,
+            errors: [`Invalid JSON: ${e instanceof Error ? e.message : String(e)}`],
+        };
+    }
+    // Fixture files may specify which $def they target via a _meta field
+    const meta = data?.['_meta'];
+    const schemaId = getDefaultSchemaId(fixture.domain);
+    const ref = meta?.schemaRef
+        ? `${schemaId}#/$defs/${meta.schemaRef}`
+        : schemaId;
+    // Strip _meta before validation (it's runner metadata, not contract data)
+    if (meta) {
+        delete data['_meta'];
+    }
+    const validate = ajv.getSchema(ref);
+    if (!validate) {
+        return {
+            fixture,
+            passed: false,
+            errors: [`Schema ref not found: ${ref}`],
+        };
+    }
+    const isSchemaValid = validate(data);
+    const semanticResult = fixture.domain === 'messaging' && isSchemaValid
+        ? validateMessagingSemantics(meta?.schemaRef ?? 'root', data)
+        : { valid: true, errors: [] };
+    const isValid = isSchemaValid && semanticResult.valid;
+    if (fixture.validity === 'valid') {
+        // Valid fixtures MUST pass structural and semantic validation.
+        return {
+            fixture,
+            passed: isValid,
+            errors: isValid
+                ? undefined
+                : [
+                    ...(validate.errors?.map((e) => `${e.instancePath}: ${e.message}`) ?? []),
+                    ...semanticResult.errors.map((e) => `${e.path}: ${e.message}`),
+                ],
+        };
+    }
+    else {
+        // Invalid fixtures may fail either structural or semantic validation.
+        return {
+            fixture,
+            passed: isValid === false,
+            errors: isValid
+                ? ['Expected validation to FAIL for invalid fixture, but it passed']
+                : undefined,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const fixturesDir = join(PKG_ROOT, 'fixtures');
+    const schemasDir = join(PKG_ROOT, 'src', 'schemas');
+    console.log('🔍 Conformance runner — @clowder-ai/plugin-contract');
+    console.log(`   Fixtures: ${fixturesDir}`);
+    console.log(`   Schemas:  ${schemasDir}`);
+    console.log();
+    // Load schemas
+    const schemas = new Map();
+    const manifestSchema = await loadSchema(join(schemasDir, 'manifest.schema.json'));
+    const messagingSchema = await loadSchema(join(schemasDir, 'messaging.schema.json'));
+    const behaviorSchema = await loadSchema(join(schemasDir, 'behavior-fixture.schema.json'));
+    schemas.set('manifest', manifestSchema);
+    schemas.set('messaging', messagingSchema);
+    // Set up Ajv with format validation (date-time, uri, email, etc.)
+    const ajv = new Ajv({ allErrors: true, strict: false });
+    addFormats(ajv);
+    ajv.addSchema(manifestSchema, manifestSchema['$id']);
+    ajv.addSchema(messagingSchema, messagingSchema['$id']);
+    ajv.addSchema(behaviorSchema, behaviorSchema['$id']);
+    // Discover and validate fixtures
+    const fixtures = await discoverFixtures(fixturesDir);
+    if (fixtures.length === 0) {
+        console.log('📭 No fixtures found — runner OK (empty run).');
+        console.log('   Fixtures will be added by sol per the three-tier fixture plan.');
+        process.exit(0);
+    }
+    const results = [];
+    for (const fixture of fixtures) {
+        results.push(await validateFixture(ajv, fixture, schemas));
+    }
+    // Report schema fixtures
+    let schemaFailures = 0;
+    for (const result of results) {
+        const icon = result.passed ? '✅' : '❌';
+        const expect = result.fixture.validity === 'valid' ? 'should pass' : 'should fail';
+        console.log(`${icon} ${result.fixture.relativePath} (${expect})`);
+        if (result.errors) {
+            for (const err of result.errors) {
+                console.log(`   → ${err}`);
+            }
+            schemaFailures++;
+        }
+    }
+    // Validate and report behavioral fixtures before deferring their execution.
+    const behaviorDir = join(fixturesDir, 'behavior');
+    let behaviorCount = 0;
+    let behaviorFileCount = 0;
+    let behaviorFailures = 0;
+    const validateBehavior = ajv.getSchema(behaviorSchema['$id']);
+    if (!validateBehavior) {
+        throw new Error('Behavior fixture schema was not registered');
+    }
+    try {
+        const behaviorDomains = await readdir(behaviorDir);
+        for (const domain of behaviorDomains) {
+            const domainDir = join(behaviorDir, domain);
+            let entries;
+            try {
+                entries = await readdir(domainDir);
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.endsWith('.json'))
+                    continue;
+                const path = join(domainDir, entry);
+                const fixturePath = relative(fixturesDir, path);
+                let data;
+                try {
+                    data = JSON.parse(await readFile(path, 'utf-8'));
+                }
+                catch (error) {
+                    console.log(`❌ ${fixturePath} (invalid JSON)`);
+                    console.log(`   → ${error instanceof Error ? error.message : String(error)}`);
+                    behaviorFailures++;
+                    continue;
+                }
+                if (!validateBehavior(data)) {
+                    console.log(`❌ ${fixturePath} (malformed behavior fixture)`);
+                    for (const error of validateBehavior.errors ?? []) {
+                        console.log(`   → ${error.instancePath}: ${error.message}`);
+                    }
+                    behaviorFailures++;
+                    continue;
+                }
+                const caseCount = data.cases.length;
+                behaviorCount += caseCount;
+                behaviorFileCount++;
+                console.log(`✅ ${fixturePath} (${caseCount} validated cases, executor: ${data._meta.executor}; execution skipped — requires P-2)`);
+            }
+        }
+    }
+    catch {
+        // No behavior directory yet — that's fine
+    }
+    console.log();
+    console.log(`Results: ${results.length - schemaFailures}/${results.length} contract fixtures passed`);
+    if (behaviorCount > 0) {
+        console.log(`⏭️  ${behaviorCount} validated behavioral cases across ${behaviorFileCount} file(s); loopback execution requires P-2`);
+    }
+    if (schemaFailures + behaviorFailures > 0) {
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error('Conformance runner crashed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=runner.js.map

package/dist/conformance/runner.js.map

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

package/dist/generated/contract.generated.d.ts

@@ -0,0 +1,282 @@
+/**
+ * Generated from manifest.schema.json and messaging.schema.json.
+ * Do not edit by hand. Run `pnpm generate` after changing a schema.
+ */
+export type SemVer = string;
+export type DataClass = 'cache' | 'ephemeral' | 'user-authored' | 'derived-user-visible' | 'relationship' | 'interaction-history';
+export type DataStrategy = 'lifecycle' | 'retained' | 'ask-on-uninstall';
+export type Capability = 'plugin.config.read' | 'plugin.state.get' | 'plugin.state.set' | 'messaging.send' | 'schedule.register' | 'events.publish' | 'messaging.appendElements' | 'onMessage' | 'message.event.subscribe' | 'secret.read' | 'thread.listMetadata' | 'thread.readContent' | 'memory.query' | 'memory.append' | 'memory.retrieve' | 'windows.create' | 'whisper.extend';
+export type DataDeclaration = {
+    readonly name: string;
+    readonly dataClass: 'cache';
+    readonly strategy: 'lifecycle' | 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+} | {
+    readonly name: string;
+    readonly dataClass: 'ephemeral';
+    readonly strategy: 'lifecycle' | 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+} | {
+    readonly name: string;
+    readonly dataClass: 'user-authored';
+    readonly strategy: 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+} | {
+    readonly name: string;
+    readonly dataClass: 'derived-user-visible';
+    readonly strategy: 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+} | {
+    readonly name: string;
+    readonly dataClass: 'relationship';
+    readonly strategy: 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+} | {
+    readonly name: string;
+    readonly dataClass: 'interaction-history';
+    readonly strategy: 'retained' | 'ask-on-uninstall';
+    readonly schemaVersion?: string;
+};
+export type ResourceReference = {
+    readonly type: string;
+    readonly id: string;
+};
+export type PluginFeature = {
+    readonly id: string;
+    readonly name: string;
+    readonly resources: readonly ResourceReference[];
+    readonly capabilities: readonly Capability[];
+};
+export type RuntimeTransport = 'stdio' | 'ipc' | 'builtin';
+export type ExternalRuntimeTransport = 'stdio' | 'ipc';
+export type ExternalRuntimeDeclaration = {
+    readonly transport: ExternalRuntimeTransport;
+    readonly entrypoint: string;
+};
+export type BuiltinRuntimeDeclaration = {
+    readonly transport: 'builtin';
+    readonly entrypoint?: string;
+};
+export type RuntimeDeclaration = ExternalRuntimeDeclaration | BuiltinRuntimeDeclaration;
+export type PluginManifest = {
+    readonly pluginId: string;
+    readonly version: SemVer;
+    readonly contractVersion: SemVer;
+    readonly name: string;
+    readonly description?: string;
+    readonly features: readonly PluginFeature[];
+    readonly data?: readonly DataDeclaration[];
+    readonly runtime: RuntimeDeclaration;
+};
+export type ActorKind = 'user' | 'cat' | 'plugin' | 'device' | 'system';
+export type ActorRef = {
+    readonly kind: ActorKind;
+    readonly id: string;
+};
+export type EpistemicStatus = 'observation' | 'user_intent' | 'inference';
+export type ExternalSourceAddress = {
+    readonly connectorId: string;
+    readonly chatId: string;
+    readonly messageId?: string;
+};
+export type IngressSourceAddress = ExternalSourceAddress;
+export type PluginOrigin = {
+    readonly kind: 'plugin';
+    readonly instanceId: string;
+};
+export type ExternalOrigin = {
+    readonly kind: 'external';
+    readonly connectorId: string;
+    readonly sourceAddress?: ExternalSourceAddress;
+};
+export type HostOrigin = {
+    readonly kind: 'host';
+};
+export type ProvenanceOrigin = PluginOrigin | ExternalOrigin | HostOrigin;
+export type DraftOrigin = PluginOrigin | ExternalOrigin;
+export type MessageProvenance = {
+    readonly origin: ProvenanceOrigin;
+    readonly epistemicStatus: EpistemicStatus;
+};
+export type DraftProvenance = {
+    readonly origin?: DraftOrigin;
+    readonly epistemicStatus: EpistemicStatus;
+};
+export type ElementKind = 'text' | 'media_ref' | 'rich_block';
+export type TextElementPayload = {
+    readonly text: string;
+};
+export type MediaRefElementPayload = Readonly<Record<string, unknown>>;
+export type RichBlockElementPayload = Readonly<Record<string, unknown>>;
+export type TextMessageElement = {
+    readonly elementId: string;
+    readonly kind: 'text';
+    readonly payload: TextElementPayload;
+    readonly derivedFromElementId?: string;
+    readonly epistemicStatus?: EpistemicStatus;
+};
+export type MediaRefMessageElement = {
+    readonly elementId: string;
+    readonly kind: 'media_ref';
+    readonly payload: MediaRefElementPayload;
+    readonly derivedFromElementId?: string;
+    readonly epistemicStatus?: EpistemicStatus;
+};
+export type RichBlockMessageElement = {
+    readonly elementId: string;
+    readonly kind: 'rich_block';
+    readonly payload: RichBlockElementPayload;
+    readonly derivedFromElementId?: string;
+    readonly epistemicStatus?: EpistemicStatus;
+};
+export type MessageElement = TextMessageElement | MediaRefMessageElement | RichBlockMessageElement;
+export type MessagePayload = {
+    readonly provenance: MessageProvenance;
+    readonly elements: readonly MessageElement[];
+    readonly correlationId?: string;
+    readonly causationId?: string;
+};
+export type DraftPayload = {
+    readonly provenance: DraftProvenance;
+    readonly elements: readonly MessageElement[];
+    readonly correlationId?: string;
+    readonly causationId?: string;
+};
+export type ThreadHandleAddress = {
+    readonly kind: 'thread_handle';
+    readonly handle: string;
+};
+export type ConnectorBindingAddress = {
+    readonly kind: 'connector_binding';
+    readonly handle: string;
+};
+export type MessageAddress = ThreadHandleAddress | ConnectorBindingAddress;
+export type PublicAudience = {
+    readonly kind: 'public';
+};
+export type WhisperAudience = {
+    readonly kind: 'whisper';
+    readonly targets: readonly string[];
+};
+export type SystemAudience = {
+    readonly kind: 'system';
+};
+export type DraftAudience = PublicAudience | WhisperAudience;
+export type CanonicalAudience = PublicAudience | WhisperAudience | SystemAudience;
+export type MessageDraft = {
+    readonly address: MessageAddress;
+    readonly draftAudience?: DraftAudience;
+    readonly idempotencyKey: string;
+    readonly sourceEventId?: string;
+    readonly replyTo?: string;
+    readonly payload: DraftPayload;
+};
+export type MessageEnvelope = {
+    readonly messageId: string;
+    readonly revision: number;
+    readonly threadId: string;
+    readonly replyTo?: string;
+    readonly actor: ActorRef;
+    readonly audience: CanonicalAudience;
+    readonly occurredAt: string;
+    readonly payload: MessagePayload;
+};
+export type MessagePublishEvent = {
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly type: 'message.publish';
+    readonly envelope: MessageEnvelope;
+};
+export type MessageElementsAppendEvent = {
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly type: 'message.elements.append';
+    readonly messageId: string;
+    readonly threadId: string;
+    readonly operationId: string;
+    readonly baseRevision?: number;
+    readonly revision: number;
+    readonly elements: readonly MessageElement[];
+};
+export type MessageOutputEvent = MessagePublishEvent | MessageElementsAppendEvent;
+export type SendReceipt = {
+    readonly messageId: string;
+    readonly threadId: string;
+    readonly revision: number;
+    readonly publishSequence?: number;
+};
+export type AppendReceipt = {
+    readonly messageId: string;
+    readonly revision: number;
+    readonly appendSequence?: number;
+    readonly appliedElementIds: readonly string[];
+};
+export type MessagingErrorCode = 'VALIDATION' | 'PERMISSION' | 'NOT_FOUND' | 'CONFLICT' | 'RETRYABLE_INFLIGHT' | 'STALE_CURSOR';
+export type MessageHandle = {
+    readonly kind: 'message';
+    readonly token: string;
+};
+export type AppendElementsRequest = {
+    readonly handle: MessageHandle;
+    readonly operationId: string;
+    readonly baseRevision?: number;
+    readonly elements: readonly MessageElement[];
+};
+export type SubscriptionCursor = string;
+export type SubscriptionNormalResponse = {
+    readonly events: readonly MessageOutputEvent[];
+    readonly ackToken: SubscriptionCursor;
+    readonly stale: false;
+};
+export type SubscriptionEmptyResponse = {
+    readonly events: readonly MessageOutputEvent[];
+    readonly ackToken: null;
+    readonly stale: false;
+};
+export type SubscriptionStaleResponse = {
+    readonly events: readonly MessageOutputEvent[];
+    readonly ackToken: null;
+    readonly stale: true;
+};
+export type SubscriptionReadResponse = SubscriptionNormalResponse | SubscriptionEmptyResponse | SubscriptionStaleResponse;
+export type SnapshotResponse = {
+    readonly envelopes: readonly MessageEnvelope[];
+    readonly resumeSequence: number;
+};
+export declare const L0_CAPABILITIES: readonly ["plugin.config.read", "plugin.state.get", "plugin.state.set"];
+export type L0Capability = (typeof L0_CAPABILITIES)[number];
+export declare const L1_CAPABILITIES: readonly ["messaging.send", "schedule.register", "events.publish", "messaging.appendElements"];
+export type L1Capability = (typeof L1_CAPABILITIES)[number];
+export declare const L2_CAPABILITIES: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend"];
+export type L2Capability = (typeof L2_CAPABILITIES)[number];
+export declare const CAPABILITY_TABLE: {
+    readonly L0: readonly ["plugin.config.read", "plugin.state.get", "plugin.state.set"];
+    readonly L1: readonly ["messaging.send", "schedule.register", "events.publish", "messaging.appendElements"];
+    readonly L2: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend"];
+};
+export type AuthorizationLayer = keyof typeof CAPABILITY_TABLE;
+export declare const DATA_CLASS_ALLOWED_STRATEGIES: {
+    readonly cache: readonly ["lifecycle", "retained", "ask-on-uninstall"];
+    readonly ephemeral: readonly ["lifecycle", "retained", "ask-on-uninstall"];
+    readonly 'user-authored': readonly ["retained", "ask-on-uninstall"];
+    readonly 'derived-user-visible': readonly ["retained", "ask-on-uninstall"];
+    readonly relationship: readonly ["retained", "ask-on-uninstall"];
+    readonly 'interaction-history': readonly ["retained", "ask-on-uninstall"];
+};
+export declare const MESSAGING_BOUNDS: {
+    readonly maxElementsPerOperation: 32;
+    readonly maxElementPayloadBytes: 65536;
+    readonly maxTotalPayloadBytes: 262144;
+    readonly maxWhisperTargets: 16;
+    readonly maxIdempotencyKeyLength: 200;
+    readonly maxElementIdLength: 128;
+    readonly maxElementsPerMessage: 128;
+    readonly maxAppendOpsPerMessage: 64;
+};
+/**
+ * @signed(G-0 2026-07-15)
+ * Host control plane/UI obligation: expose effective retention to users.
+ * This does not add a plugin handshake field or query API.
+ */
+export declare const MESSAGING_REPLAY_WINDOW_DEFAULT: "P7D";
+//# sourceMappingURL=contract.generated.d.ts.map

package/dist/generated/contract.generated.d.ts.map

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

package/dist/generated/contract.generated.js

@@ -0,0 +1,37 @@
+/**
+ * Generated from manifest.schema.json and messaging.schema.json.
+ * Do not edit by hand. Run `pnpm generate` after changing a schema.
+ */
+export const L0_CAPABILITIES = ['plugin.config.read', 'plugin.state.get', 'plugin.state.set'];
+export const L1_CAPABILITIES = ['messaging.send', 'schedule.register', 'events.publish', 'messaging.appendElements'];
+export const L2_CAPABILITIES = ['onMessage', 'message.event.subscribe', 'secret.read', 'thread.listMetadata', 'thread.readContent', 'memory.query', 'memory.append', 'memory.retrieve', 'windows.create', 'whisper.extend'];
+export const CAPABILITY_TABLE = {
+    L0: L0_CAPABILITIES,
+    L1: L1_CAPABILITIES,
+    L2: L2_CAPABILITIES,
+};
+export const DATA_CLASS_ALLOWED_STRATEGIES = {
+    'cache': ['lifecycle', 'retained', 'ask-on-uninstall'],
+    'ephemeral': ['lifecycle', 'retained', 'ask-on-uninstall'],
+    'user-authored': ['retained', 'ask-on-uninstall'],
+    'derived-user-visible': ['retained', 'ask-on-uninstall'],
+    'relationship': ['retained', 'ask-on-uninstall'],
+    'interaction-history': ['retained', 'ask-on-uninstall'],
+};
+export const MESSAGING_BOUNDS = {
+    maxElementsPerOperation: 32,
+    maxElementPayloadBytes: 65536,
+    maxTotalPayloadBytes: 262144,
+    maxWhisperTargets: 16,
+    maxIdempotencyKeyLength: 200,
+    maxElementIdLength: 128,
+    maxElementsPerMessage: 128,
+    maxAppendOpsPerMessage: 64,
+};
+/**
+ * @signed(G-0 2026-07-15)
+ * Host control plane/UI obligation: expose effective retention to users.
+ * This does not add a plugin handshake field or query API.
+ */
+export const MESSAGING_REPLAY_WINDOW_DEFAULT = 'P7D';
+//# sourceMappingURL=contract.generated.js.map

package/dist/generated/contract.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.generated.js","sourceRoot":"","sources":["../../src/generated/contract.generated.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsPH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,CAAU,CAAC;AAEvG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,0BAA0B,CAAU,CAAC;AAE9H,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAW,EAAE,yBAAyB,EAAE,aAAa,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,CAAU,CAAC;AAErO,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,eAAe;CACX,CAAC;AAGX,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,OAAO,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,kBAAkB,CAAC;IACtD,WAAW,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,kBAAkB,CAAC;IAC1D,eAAe,EAAE,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACjD,sBAAsB,EAAE,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxD,cAAc,EAAE,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAChD,qBAAqB,EAAE,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACgB,CAAC;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,uBAAuB,EAAE,EAAE;IAC3B,sBAAsB,EAAE,KAAK;IAC7B,oBAAoB,EAAE,MAAM;IAC5B,iBAAiB,EAAE,EAAE;IACrB,uBAAuB,EAAE,GAAG;IAC5B,kBAAkB,EAAE,GAAG;IACvB,qBAAqB,EAAE,GAAG;IAC1B,sBAAsB,EAAE,EAAE;CAClB,CAAC;AAEX;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAc,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @clowder-ai/plugin-contract
+ *
+ * The single machine-readable truth source for the Clowder AI plugin
+ * ecosystem (P15).  Schema, types, capability table, and conformance
+ * utilities all ship from this package — the host (clowder-ai) and
+ * plugin SDK both consume it; neither redefines structures.
+ *
+ * ## Version strategy (pre-1.0)
+ *
+ * - `0.x.0-candidate.N`: work-in-progress, NOT published to registry,
+ *   no implementation may consume.
+ * - `0.x.0`: published after dual-sign merge (CODEOWNERS) + CI publish.
+ *   Registry must show exact version + digest before any gate proceeds.
+ * - Breaking changes are expected before 1.0 (P3).
+ * - v1.0.0 = public compatibility commitment; breaking window closes.
+ *
+ * ## Domains (v0.1 candidate)
+ *
+ * - **messaging**: MessagePayload, MessageDraft, MessageEnvelope,
+ *   MessageOutputEvent, AppendElementsRequest, SendReceipt
+ * - **manifest**: PluginManifest, PluginFeature, DataDeclaration,
+ *   RuntimeDeclaration (v0.1 scope — signals/tasks/windows deferred)
+ * - **capability**: L0/L1/L2 capability table (`@signed(G-0 2026-07-15)`)
+ * - **data-class**: DataClass × DataStrategy validation
+ * - **generated projection**: all public structural types and contract tables
+ *   are deterministically generated from the JSON Schemas
+ * - **validation**: shared semantic checks for constraints JSON Schema cannot
+ *   express, including UTF-8 payload byte budgets
+ *
+ * @packageDocumentation
+ */
+export * from './types/index.js';
+export * from './validation/index.js';
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC"}