@jinn-network/client 0.1.2-canary.d6e72dfd → 0.1.2

package/dist/intents/kinds/prediction-v0.js

@@ -0,0 +1,32 @@
+import { BASE_SEPOLIA_FEEDS } from '../../venues/chainlink/feeds.js';
+import { predictionV0TemplateNeedsReadCurrent, resolvePredictionV0Template, } from '../prediction-v0-template.js';
+import { makePredictionV0Generator } from '../prediction-v0-auto.js';
+import { PREDICTION_V0_KIND } from './constants.js';
+export const predictionV0 = {
+    kind: PREDICTION_V0_KIND,
+    async parseSpec(raw, deps) {
+        if (predictionV0TemplateNeedsReadCurrent(raw) && !deps?.readCurrent) {
+            throw new Error('prediction.v0 parseSpec requires readCurrent (Chainlink) when the template uses a current[±…] threshold sentinel');
+        }
+        const intent = await resolvePredictionV0Template(raw, {
+            readCurrent: deps?.readCurrent,
+        });
+        return { window: intent.window, spec: intent.spec, eligibility: intent.eligibility };
+    },
+    buildGenerator: (config) => makePredictionV0Generator(config),
+    getTestnetAutoConfig: (ctx) => {
+        if (ctx.network !== 'testnet')
+            return undefined;
+        return {
+            feed: BASE_SEPOLIA_FEEDS['ETH / USD'],
+            feedDescription: 'ETH / USD',
+            venue: 'chainlink-base-sepolia',
+            rpcUrl: ctx.rpcUrl,
+        };
+    },
+    ui: {
+        description: 'Price threshold prediction (Chainlink oracle)',
+        category: 'prediction',
+    },
+};
+//# sourceMappingURL=prediction-v0.js.map

package/dist/intents/kinds/prediction-v0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-v0.js","sourceRoot":"","sources":["../../../src/intents/kinds/prediction-v0.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAA+B,MAAM,0BAA0B,CAAC;AAElG,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,CAAC,MAAM,YAAY,GAAqC;IAC5D,IAAI,EAAE,kBAAkB;IACxB,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI;QACvB,IAAI,oCAAoC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YACpE,MAAM,IAAI,KAAK,CACb,kHAAkH,CACnH,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,GAAG,EAAE;YACpD,WAAW,EAAE,IAAI,EAAE,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IACvF,CAAC;IACD,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC;IAC7D,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC;YACrC,eAAe,EAAE,WAAW;YAC5B,KAAK,EAAE,wBAAwB;YAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC;IACJ,CAAC;IACD,EAAE,EAAE;QACF,WAAW,EAAE,+CAA+C;QAC5D,QAAQ,EAAE,YAAY;KACvB;CACF,CAAC"}

package/dist/intents/kinds/spec-kind.d.ts

@@ -0,0 +1,38 @@
+/**
+ * SpecKind manifest — one entry per in-repo intent kind (parse + optional auto-gen).
+ * See jinn-mono-6q1.1.
+ */
+import type { IntentGenerator } from '../sources.js';
+/** Overlay fields merged into DesiredState when posting from --spec-file. */
+export type ParsedSpecOverlay = {
+    window: unknown;
+    spec: unknown;
+    eligibility: unknown;
+};
+/** Optional deps for kinds that resolve sentinels at parse time (e.g. Chainlink). */
+export interface ParseDeps {
+    readCurrent?: (args: {
+        feed: `0x${string}`;
+        venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    }) => Promise<string>;
+}
+/** Context for optional testnet auto-intent registration (see {@link collectTestnetAutoIntentGenerators}). */
+export interface TestnetAutoContext {
+    network: 'mainnet' | 'testnet';
+    rpcUrl: string;
+    env: NodeJS.ProcessEnv;
+}
+export interface SpecKind<GenConfig = unknown> {
+    kind: string;
+    parseSpec: (raw: unknown, deps?: ParseDeps) => Promise<ParsedSpecOverlay>;
+    buildGenerator?: (config: GenConfig) => IntentGenerator;
+    /**
+     * If this returns a config object, the daemon may register `buildGenerator(config)` on testnet.
+     * Return `undefined` to skip (default for kinds without auto-gen or not enabled on testnet).
+     */
+    getTestnetAutoConfig?: (ctx: TestnetAutoContext) => GenConfig | undefined;
+    ui?: {
+        description: string;
+        category: string;
+    };
+}

package/dist/intents/kinds/spec-kind.js

@@ -0,0 +1,6 @@
+/**
+ * SpecKind manifest — one entry per in-repo intent kind (parse + optional auto-gen).
+ * See jinn-mono-6q1.1.
+ */
+export {};
+//# sourceMappingURL=spec-kind.js.map

package/dist/intents/kinds/spec-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-kind.js","sourceRoot":"","sources":["../../../src/intents/kinds/spec-kind.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/intents/posting-service.d.ts

@@ -0,0 +1,26 @@
+import type { ExecutionAdapter } from '../adapters/adapter.js';
+import type { Store } from '../store/store.js';
+import { type DesiredState, type RequestId } from '../types/index.js';
+import type { IntentCandidate } from './sources.js';
+import type { Registry8004 } from '../discovery/registry.js';
+export interface IntentPostResult {
+    requestId: RequestId;
+    desiredState: DesiredState;
+    attemptNumber: number;
+    attemptId: string;
+    idempotent: boolean;
+    source: 'store' | 'legacy_config' | 'posted';
+}
+export interface PostIntentCandidateOptions {
+    creatorSafeAddress?: string;
+    legacyConfigKeys?: string[];
+}
+export declare class IntentPostingService {
+    private readonly adapter;
+    private readonly store;
+    private readonly registry?;
+    constructor(adapter: ExecutionAdapter, store: Store, registry?: Registry8004 | undefined);
+    postCandidate(candidate: IntentCandidate, opts?: PostIntentCandidateOptions): Promise<IntentPostResult>;
+    private tryImportLegacyRecord;
+    private buildIdempotentResult;
+}

package/dist/intents/posting-service.js

@@ -0,0 +1,218 @@
+import { randomUUID } from 'node:crypto';
+import { getAddress } from 'viem';
+import { emitEvent } from '../observability/emit-event.js';
+import { TransientError } from '../types/index.js';
+const GLOBAL_CREATOR_SCOPE = '__global__';
+const POST_LOCK_STALE_AFTER_MS = 60_000;
+function normalizeCreatorSafeAddress(safeAddress) {
+    return safeAddress ? getAddress(safeAddress) : GLOBAL_CREATOR_SCOPE;
+}
+function policyTypeOf(policy) {
+    return policy.kind;
+}
+function scopeKeyOf(policy) {
+    switch (policy.kind) {
+        case 'once_per_safe':
+            return '';
+        case 'once_per_bucket':
+            return policy.bucketKey;
+        case 'interval':
+            return policy.scopeKey ?? '';
+    }
+}
+function shouldSkipPost(record, policy, nowMs) {
+    if (policy.kind !== 'interval')
+        return true;
+    const lastPostedAt = Date.parse(record.lastPostedAt);
+    return Number.isFinite(lastPostedAt) && (nowMs - lastPostedAt) < policy.intervalMs;
+}
+export class IntentPostingService {
+    adapter;
+    store;
+    registry;
+    constructor(adapter, store, registry) {
+        this.adapter = adapter;
+        this.store = store;
+        this.registry = registry;
+    }
+    async postCandidate(candidate, opts = {}) {
+        const creatorSafeAddress = normalizeCreatorSafeAddress(opts.creatorSafeAddress);
+        const policyType = policyTypeOf(candidate.postingPolicy);
+        const scopeKey = scopeKeyOf(candidate.postingPolicy);
+        const now = new Date();
+        const nowIso = now.toISOString();
+        const nowMs = now.getTime();
+        const existing = this.store.getIntentPostRecord({
+            creatorSafeAddress,
+            sourceKey: candidate.sourceKey,
+            policyType,
+            scopeKey,
+        });
+        if (existing && shouldSkipPost(existing, candidate.postingPolicy, nowMs)) {
+            return this.buildIdempotentResult(candidate, existing, 'store');
+        }
+        const migrated = this.tryImportLegacyRecord(candidate, {
+            creatorSafeAddress,
+            policyType,
+            scopeKey,
+            nowIso,
+            legacyConfigKeys: opts.legacyConfigKeys ?? [],
+        });
+        if (migrated) {
+            return this.buildIdempotentResult(candidate, migrated, 'legacy_config');
+        }
+        const ownerToken = randomUUID();
+        const lockAcquired = this.store.acquireIntentPostLock({
+            creatorSafeAddress,
+            sourceKey: candidate.sourceKey,
+            policyType,
+            scopeKey,
+            ownerToken,
+            lockedAt: nowIso,
+            staleAfterMs: POST_LOCK_STALE_AFTER_MS,
+        });
+        if (!lockAcquired) {
+            throw new TransientError(`Intent post already in progress for ${candidate.sourceKey} (${candidate.desiredState.id})`);
+        }
+        try {
+            const lockedExisting = this.store.getIntentPostRecord({
+                creatorSafeAddress,
+                sourceKey: candidate.sourceKey,
+                policyType,
+                scopeKey,
+            });
+            if (lockedExisting && shouldSkipPost(lockedExisting, candidate.postingPolicy, nowMs)) {
+                return this.buildIdempotentResult(candidate, lockedExisting, 'store');
+            }
+            const lockedMigrated = this.tryImportLegacyRecord(candidate, {
+                creatorSafeAddress,
+                policyType,
+                scopeKey,
+                nowIso,
+                legacyConfigKeys: opts.legacyConfigKeys ?? [],
+            });
+            if (lockedMigrated) {
+                return this.buildIdempotentResult(candidate, lockedMigrated, 'legacy_config');
+            }
+            const previousPostCount = lockedExisting?.postCount ?? 0;
+            const attemptNumber = previousPostCount + 1;
+            const attemptId = `${candidate.desiredState.id}/${attemptNumber}`;
+            const desiredState = {
+                ...candidate.desiredState,
+                type: 'restoration',
+                attemptId,
+                attemptNumber,
+            };
+            const requestId = await this.adapter.postDesiredState(desiredState);
+            // ERC-8004 Intent registration (Plan E Task 10). Best-effort: a failure here
+            // does NOT roll back the post. Registration fires only when a registry is
+            // injected and the adapter surfaces the intent CID (IPFS-backed adapters only).
+            if (this.registry && candidate.desiredState.spec?.kind) {
+                const intentCid = this.adapter.getLastPostedIntentCid?.();
+                if (intentCid) {
+                    const creator = opts.creatorSafeAddress
+                        ? getAddress(opts.creatorSafeAddress)
+                        : creatorSafeAddress === GLOBAL_CREATOR_SCOPE
+                            ? ''
+                            : creatorSafeAddress;
+                    try {
+                        await this.registry.registerIntent({
+                            intentCid,
+                            kind: candidate.desiredState.spec.kind,
+                            creator,
+                            createdAt: nowMs,
+                            requestId: requestId,
+                        });
+                    }
+                    catch (err) {
+                        // Registration is best-effort; a failure here should not prevent the
+                        // intent from being posted. Log + emit but don't throw.
+                        console.warn(`[posting-service] registerIntent failed: ${err instanceof Error ? err.message : err}`);
+                        emitEvent(this.store, {
+                            kind: 'intent_registry_failed',
+                            requestId,
+                            specKind: candidate.desiredState.spec?.kind,
+                            outcome: 'failed',
+                            detail: err instanceof Error ? err.message : String(err),
+                        }, 'creator');
+                    }
+                }
+            }
+            this.store.recordOwnActivity(requestId, 'created');
+            emitEvent(this.store, {
+                kind: 'intent_posted',
+                requestId,
+                specKind: candidate.desiredState.spec?.kind,
+                outcome: 'ok',
+                detail: `Posted intent for desired state ${candidate.desiredState.id} via ${candidate.sourceKey}`,
+            }, 'creator');
+            this.store.upsertIntentPostRecord({
+                creatorSafeAddress,
+                sourceKey: candidate.sourceKey,
+                policyType,
+                scopeKey,
+                desiredStateId: candidate.desiredState.id,
+                requestId,
+                firstPostedAt: lockedExisting?.firstPostedAt ?? nowIso,
+                lastPostedAt: nowIso,
+                postCount: attemptNumber,
+            });
+            return {
+                requestId,
+                desiredState,
+                attemptNumber,
+                attemptId,
+                idempotent: false,
+                source: 'posted',
+            };
+        }
+        finally {
+            this.store.releaseIntentPostLock({
+                creatorSafeAddress,
+                sourceKey: candidate.sourceKey,
+                policyType,
+                scopeKey,
+                ownerToken,
+            });
+        }
+    }
+    tryImportLegacyRecord(candidate, args) {
+        for (const key of args.legacyConfigKeys) {
+            const requestId = this.store.getConfigValue(key);
+            if (!requestId)
+                continue;
+            const record = {
+                creatorSafeAddress: args.creatorSafeAddress,
+                sourceKey: candidate.sourceKey,
+                policyType: args.policyType,
+                scopeKey: args.scopeKey,
+                desiredStateId: candidate.desiredState.id,
+                requestId,
+                firstPostedAt: args.nowIso,
+                lastPostedAt: args.nowIso,
+                postCount: 1,
+            };
+            this.store.upsertIntentPostRecord(record);
+            return record;
+        }
+        return null;
+    }
+    buildIdempotentResult(candidate, record, source) {
+        const attemptNumber = Math.max(1, record.postCount);
+        const attemptId = `${candidate.desiredState.id}/${attemptNumber}`;
+        return {
+            requestId: record.requestId,
+            desiredState: {
+                ...candidate.desiredState,
+                type: 'restoration',
+                attemptId,
+                attemptNumber,
+            },
+            attemptNumber,
+            attemptId,
+            idempotent: true,
+            source,
+        };
+    }
+}
+//# sourceMappingURL=posting-service.js.map

package/dist/intents/posting-service.js.map

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

package/dist/intents/prediction-apy-v0-auto.js

@@ -34,7 +34,7 @@ export function makePredictionApyV0Generator(config = {}) {
                     },
                     question: { resolveTs },
                 },
-                eligibility: { maxSubmissionDelayMs: 60_000 },
+                eligibility: { maxSubmissionDelayMs: windowDurationMs },
             });
             return intent;
         }

package/dist/intents/prediction-apy-v0-auto.js.map

@@ -1 +1 @@
-{"version":3,"file":"prediction-apy-v0-auto.js","sourceRoot":"","sources":["../../src/intents/prediction-apy-v0-auto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAa9D,MAAM,UAAU,4BAA4B,CAAC,SAAoC,EAAE;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,sBAAsB,CAAC;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC;IACpD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAE/C,OAAO,KAAK,IAAkC,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,GAAG,gBAAgB,CAAC;QACzC,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC;gBAClD,EAAE,EAAE,oBAAoB,OAAO,EAAE;gBACjC,WAAW,EAAE,+CAA+C,KAAK,CAAC,MAAM,OAAO,KAAK,EAAE;gBACtF,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1B,IAAI,EAAE;oBACJ,IAAI,EAAE,mBAAmB;oBACzB,MAAM,EAAE;wBACN,KAAK;wBACL,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,aAAa,EAAE,KAAK,CAAC,MAAM;qBAC5B;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,oBAAoB;wBAC1B,gBAAgB;wBAChB,WAAW;wBACX,YAAY;qBACb;oBACD,QAAQ,EAAE,EAAE,SAAS,EAAE;iBACxB;gBACD,WAAW,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE;aAC9C,CAAC,CAAC;YACH,OAAO,MAAiC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"prediction-apy-v0-auto.js","sourceRoot":"","sources":["../../src/intents/prediction-apy-v0-auto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAa9D,MAAM,UAAU,4BAA4B,CAAC,SAAoC,EAAE;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,sBAAsB,CAAC;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC;IAC5D,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,OAAO,CAAC;IACpD,MAAM,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,KAAK,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC;IAE/C,OAAO,KAAK,IAAkC,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,GAAG,gBAAgB,CAAC;QACzC,MAAM,SAAS,GAAG,KAAK,GAAG,YAAY,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,8BAA8B,CAAC;gBAClD,EAAE,EAAE,oBAAoB,OAAO,EAAE;gBACjC,WAAW,EAAE,+CAA+C,KAAK,CAAC,MAAM,OAAO,KAAK,EAAE;gBACtF,MAAM,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1B,IAAI,EAAE;oBACJ,IAAI,EAAE,mBAAmB;oBACzB,MAAM,EAAE;wBACN,KAAK;wBACL,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,aAAa,EAAE,KAAK,CAAC,MAAM;qBAC5B;oBACD,MAAM,EAAE;wBACN,IAAI,EAAE,oBAAoB;wBAC1B,gBAAgB;wBAChB,WAAW;wBACX,YAAY;qBACb;oBACD,QAAQ,EAAE,EAAE,SAAS,EAAE;iBACxB;gBACD,WAAW,EAAE,EAAE,oBAAoB,EAAE,gBAAgB,EAAE;aACxD,CAAC,CAAC;YACH,OAAO,MAAiC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/intents/prediction-v0-template.d.ts

@@ -30,10 +30,10 @@ export declare function isCurrentSentinel(value: unknown): boolean;
 export interface TemplateReaderDeps {
     /**
      * Read the current price of the Chainlink feed referenced in the template.
-     * The helper passes `{feed, venue}` so the reader can build the right client.
-     * Returns a decimal string (scaled from int256 via scaleToDecimal).
+     * Required only when the template uses a `current[±…]` threshold sentinel
+     * (see {@link predictionV0TemplateNeedsReadCurrent}).
      */
-    readCurrent: (args: {
+    readCurrent?: (args: {
         feed: `0x${string}`;
         venue: 'chainlink-base' | 'chainlink-base-sepolia';
     }) => Promise<string>;
@@ -53,6 +53,11 @@ export interface TemplateReaderDeps {
 export declare const DEFAULT_WINDOW_DURATION_MS = 600000;
 /** Default resolve gap for the startTs-sentinel fill. Tuned for fast-test. */
 export declare const DEFAULT_RESOLVE_GAP_MS = 300000;
+/**
+ * True if {@link resolvePredictionV0Template} will call `readCurrent` for this
+ * template (Chainlink). `window.startTs === 0` does not need `readCurrent`.
+ */
+export declare function predictionV0TemplateNeedsReadCurrent(template: unknown): boolean;
 /**
  * Resolve all supported sentinels in a raw prediction.v0 template + return a
  * parsed, validated PredictionV0Intent.

package/dist/intents/prediction-v0-template.js

@@ -25,6 +25,7 @@
  * future auto-generator (jinn-mono-9ew) call through this helper.
  */
 import { PredictionV0IntentSchema, } from '../types/prediction.js';
+import { PREDICTION_V0_KIND } from './kinds/constants.js';
 // ── Sentinel parsers ──────────────────────────────────────────────────────────
 /**
  * Parse a `current[±N[%]]` sentinel. Returns a function that takes the current
@@ -66,6 +67,22 @@ export function isCurrentSentinel(value) {
 export const DEFAULT_WINDOW_DURATION_MS = 600_000;
 /** Default resolve gap for the startTs-sentinel fill. Tuned for fast-test. */
 export const DEFAULT_RESOLVE_GAP_MS = 300_000;
+/**
+ * True if {@link resolvePredictionV0Template} will call `readCurrent` for this
+ * template (Chainlink). `window.startTs === 0` does not need `readCurrent`.
+ */
+export function predictionV0TemplateNeedsReadCurrent(template) {
+    if (typeof template !== 'object' || template === null)
+        return false;
+    const t = template;
+    const spec = t['spec'];
+    if (spec?.kind !== PREDICTION_V0_KIND)
+        return false;
+    if (spec.question?.kind === 'threshold' && typeof spec.question.threshold === 'string') {
+        return isCurrentSentinel(spec.question.threshold);
+    }
+    return false;
+}
 /**
  * Resolve all supported sentinels in a raw prediction.v0 template + return a
  * parsed, validated PredictionV0Intent.
@@ -96,11 +113,14 @@ export async function resolvePredictionV0Template(template, deps) {
     }
     // ── (2) spec.question.threshold sentinel → absolute price ──────────────────
     const spec = stub['spec'];
-    if (spec?.kind === 'prediction.v0' &&
+    if (spec?.kind === PREDICTION_V0_KIND &&
         spec.question?.kind === 'threshold' &&
         typeof spec.question.threshold === 'string') {
         const t = spec.question.threshold;
         if (isCurrentSentinel(t)) {
+            if (!deps.readCurrent) {
+                throw new Error('resolvePredictionV0Template: readCurrent is required when spec.question.threshold uses a current[±…] sentinel');
+            }
             if (!spec.oracle?.feed || !spec.oracle.venue) {
                 throw new Error('cannot resolve threshold sentinel: spec.oracle.feed and spec.oracle.venue are required');
             }

package/dist/intents/prediction-v0-template.js.map

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

package/dist/intents/sources.d.ts

@@ -0,0 +1,39 @@
+import type { DesiredState } from '../types/desired-state.js';
+/** Returns a freshly-built DesiredState for this tick, or null to skip. */
+export type IntentGenerator = () => Promise<DesiredState | null>;
+export type IntentPostingPolicy = {
+    kind: 'once_per_safe';
+} | {
+    kind: 'once_per_bucket';
+    bucketKey: string;
+} | {
+    kind: 'interval';
+    intervalMs: number;
+    scopeKey?: string;
+};
+export interface IntentCandidate {
+    desiredState: DesiredState;
+    sourceKey: string;
+    postingPolicy: IntentPostingPolicy;
+    sourceMeta?: {
+        kind?: string;
+        bucketKey?: string;
+        note?: string;
+    };
+}
+export interface IntentSource {
+    sourceKey: string;
+    collect(now: Date): Promise<IntentCandidate[]>;
+}
+export declare class StaticConfiguredIntentSource implements IntentSource {
+    private readonly desiredStates;
+    readonly sourceKey = "configured";
+    constructor(desiredStates: DesiredState[]);
+    collect(_now: Date): Promise<IntentCandidate[]>;
+}
+export declare class GeneratedIntentSource implements IntentSource {
+    readonly sourceKey: string;
+    private readonly generator;
+    constructor(sourceKey: string, generator: IntentGenerator);
+    collect(_now: Date): Promise<IntentCandidate[]>;
+}

package/dist/intents/sources.js

@@ -0,0 +1,42 @@
+export class StaticConfiguredIntentSource {
+    desiredStates;
+    sourceKey = 'configured';
+    constructor(desiredStates) {
+        this.desiredStates = desiredStates;
+    }
+    async collect(_now) {
+        return this.desiredStates.map((desiredState) => ({
+            desiredState,
+            sourceKey: `${this.sourceKey}:${desiredState.id}`,
+            postingPolicy: { kind: 'once_per_safe' },
+            sourceMeta: { kind: desiredState.spec?.kind, note: 'configured' },
+        }));
+    }
+}
+export class GeneratedIntentSource {
+    sourceKey;
+    generator;
+    constructor(sourceKey, generator) {
+        this.sourceKey = sourceKey;
+        this.generator = generator;
+    }
+    async collect(_now) {
+        const desiredState = await this.generator();
+        if (!desiredState)
+            return [];
+        const bucketKey = desiredState.window
+            ? `${desiredState.window.startTs}:${desiredState.window.endTs}`
+            : desiredState.id;
+        return [{
+                desiredState,
+                sourceKey: this.sourceKey,
+                postingPolicy: { kind: 'once_per_bucket', bucketKey },
+                sourceMeta: {
+                    kind: desiredState.spec?.kind,
+                    bucketKey,
+                    note: 'generated',
+                },
+            }];
+    }
+}
+//# sourceMappingURL=sources.js.map

package/dist/intents/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../../src/intents/sources.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,4BAA4B;IAGV;IAFpB,SAAS,GAAG,YAAY,CAAC;IAElC,YAA6B,aAA6B;QAA7B,kBAAa,GAAb,aAAa,CAAgB;IAAG,CAAC;IAE9D,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YAC/C,YAAY;YACZ,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,EAAE,EAAE;YACjD,aAAa,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;YACxC,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE;SAClE,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,MAAM,OAAO,qBAAqB;IAErB;IACQ;IAFnB,YACW,SAAiB,EACT,SAA0B;QADlC,cAAS,GAAT,SAAS,CAAQ;QACT,cAAS,GAAT,SAAS,CAAiB;IAC1C,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,IAAU;QACtB,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5C,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM;YACnC,CAAC,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE;YAC/D,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;QACpB,OAAO,CAAC;gBACN,YAAY;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,aAAa,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE;gBACrD,UAAU,EAAE;oBACV,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI;oBAC7B,SAAS;oBACT,IAAI,EAAE,WAAW;iBAClB;aACF,CAAC,CAAC;IACL,CAAC;CACF"}