@jinn-network/client 0.1.1 → 0.1.2-canary.6237288d

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.d.ts

@@ -0,0 +1,11 @@
+import type { DesiredState } from '../types/desired-state.js';
+export interface PredictionApyV0AutoConfig {
+    venue?: 'aave-v3-base-sepolia' | 'aave-v3-base' | 'aave-v3-mainnet';
+    windowDurationMs?: number;
+    resolveGapMs?: number;
+    twaWindowSeconds?: number;
+    sampleCount?: number;
+    toleranceBps?: number;
+}
+export type PredictionApyV0Generator = () => Promise<DesiredState | null>;
+export declare function makePredictionApyV0Generator(config?: PredictionApyV0AutoConfig): PredictionApyV0Generator;

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

@@ -0,0 +1,46 @@
+import { resolvePredictionApyV0Template } from './prediction-apy-v0-template.js';
+import { AAVE_V3_USDC } from '../venues/aave-v3/addresses.js';
+export function makePredictionApyV0Generator(config = {}) {
+    const venue = config.venue ?? 'aave-v3-base-sepolia';
+    const addrs = AAVE_V3_USDC[venue];
+    const windowDurationMs = config.windowDurationMs ?? 600_000;
+    const resolveGapMs = config.resolveGapMs ?? 300_000;
+    const twaWindowSeconds = config.twaWindowSeconds ?? 3_600;
+    const sampleCount = config.sampleCount ?? 12;
+    const toleranceBps = config.toleranceBps ?? 50;
+    return async () => {
+        const now = Date.now();
+        const startTs = Math.floor(now / windowDurationMs) * windowDurationMs;
+        const endTs = startTs + windowDurationMs;
+        const resolveTs = endTs + resolveGapMs;
+        try {
+            const intent = await resolvePredictionApyV0Template({
+                id: `pred-apy-v0-auto-${startTs}`,
+                description: `Auto-generated prediction.apy.v0 intent for ${addrs.symbol} on ${venue}`,
+                window: { startTs, endTs },
+                spec: {
+                    kind: 'prediction.apy.v0',
+                    oracle: {
+                        venue,
+                        pool: addrs.pool,
+                        reserve: addrs.reserve,
+                        reserveSymbol: addrs.symbol,
+                    },
+                    metric: {
+                        type: 'supply-apy-twa-bps',
+                        twaWindowSeconds,
+                        sampleCount,
+                        toleranceBps,
+                    },
+                    question: { resolveTs },
+                },
+                eligibility: { maxSubmissionDelayMs: windowDurationMs },
+            });
+            return intent;
+        }
+        catch {
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=prediction-apy-v0-auto.js.map

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

@@ -0,0 +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,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-apy-v0-template.d.ts

@@ -0,0 +1,8 @@
+import { type PredictionApyV0Intent } from '../types/prediction-apy.js';
+export interface PredictionApyTemplateDeps {
+    windowDurationMs?: number;
+    resolveGapMs?: number;
+}
+export declare const DEFAULT_WINDOW_DURATION_MS = 600000;
+export declare const DEFAULT_RESOLVE_GAP_MS = 300000;
+export declare function resolvePredictionApyV0Template(template: unknown, deps?: PredictionApyTemplateDeps): Promise<PredictionApyV0Intent>;

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

@@ -0,0 +1,22 @@
+import { PredictionApyV0IntentSchema, } from '../types/prediction-apy.js';
+export const DEFAULT_WINDOW_DURATION_MS = 600_000;
+export const DEFAULT_RESOLVE_GAP_MS = 300_000;
+export async function resolvePredictionApyV0Template(template, deps = {}) {
+    if (typeof template !== 'object' || template === null) {
+        throw new Error('resolvePredictionApyV0Template: template must be an object');
+    }
+    const stub = JSON.parse(JSON.stringify(template));
+    const windowMs = deps.windowDurationMs ?? DEFAULT_WINDOW_DURATION_MS;
+    const resolveMs = deps.resolveGapMs ?? DEFAULT_RESOLVE_GAP_MS;
+    const win = stub['window'];
+    if (win && win.startTs === 0) {
+        const now = Date.now();
+        win.startTs = now;
+        win.endTs = now + windowMs;
+        const spec = stub['spec'];
+        if (spec?.question)
+            spec.question.resolveTs = now + windowMs + resolveMs;
+    }
+    return PredictionApyV0IntentSchema.parse(stub);
+}
+//# sourceMappingURL=prediction-apy-v0-template.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-apy-v0-template.js","sourceRoot":"","sources":["../../src/intents/prediction-apy-v0-template.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,GAE5B,MAAM,4BAA4B,CAAC;AAOpC,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,QAAiB,EACjB,OAAkC,EAAE;IAEpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAA4B,CAAC;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IACrE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,sBAAsB,CAAC;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAqD,CAAC;IAC/E,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC;QAClB,GAAG,CAAC,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAsD,CAAC;QAC/E,IAAI,IAAI,EAAE,QAAQ;YAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,GAAG,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3E,CAAC;IACD,OAAO,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * Auto-generator for prediction.v0 intents.
+ *
+ * Produces a fresh DesiredState per hour bucket: reads current Chainlink
+ * price, builds a template with the configured threshold sentinel
+ * (default "current+0.5%" — coin-flip-ish, slightly biased NO), and resolves
+ * it via the shared template helper. Stable ID per hour prevents duplicate
+ * posts within a window; the CreatorLoop's SQLite cache guards against
+ * restart-replay.
+ *
+ * Wired in main.ts for testnet-only (jinn-mono-9ew). Operators can opt out
+ * with JINN_DISABLE_AUTO_INTENTS=1.
+ */
+import { type PublicClient } from 'viem';
+import type { DesiredState } from '../types/desired-state.js';
+export interface PredictionV0AutoConfig {
+    /** Chainlink AggregatorV3 proxy address. Defaults to Base Sepolia ETH/USD. */
+    feed: `0x${string}`;
+    /** Human-readable feed description embedded in the generated intent. */
+    feedDescription: string;
+    /** Which chain the feed lives on. */
+    venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    /**
+     * Threshold sentinel to resolve each cycle. Defaults to "current+0.5%" —
+     * biases slightly NO, Brier scores land meaningfully around 0.75. Use
+     * "current" for a strict coin-flip direction question.
+     */
+    thresholdSentinel?: string;
+    /** Comparator operator. Default 'GT'. */
+    operator?: 'GT' | 'GTE' | 'LT' | 'LTE';
+    /**
+     * Submission window duration in ms. Default: 600_000 (10 min) to sync with
+     * the 15-min fast-test epoch on Base Sepolia. Set to 3_600_000 for 1h
+     * mainnet-style windows. Bucket size also uses this value.
+     */
+    windowDurationMs?: number;
+    /**
+     * Gap between window.endTs and resolveTs in ms. Default: 300_000 (5 min).
+     * Bounded by schema to ≤ 1h.
+     */
+    resolveGapMs?: number;
+    /** RPC URL for the publicClient used to read Chainlink. */
+    rpcUrl?: string;
+    /** Injected publicClient — tests pass a mock; production leaves unset. */
+    _publicClient?: PublicClient;
+}
+export type PredictionV0Generator = () => Promise<DesiredState | null>;
+/**
+ * Build a generator closure. Calling the closure returns a freshly-resolved
+ * DesiredState for the current hour bucket, or null if Chainlink is
+ * unreachable (caller skips this tick).
+ */
+export declare function makePredictionV0Generator(config: PredictionV0AutoConfig): PredictionV0Generator;

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

@@ -0,0 +1,84 @@
+/**
+ * Auto-generator for prediction.v0 intents.
+ *
+ * Produces a fresh DesiredState per hour bucket: reads current Chainlink
+ * price, builds a template with the configured threshold sentinel
+ * (default "current+0.5%" — coin-flip-ish, slightly biased NO), and resolves
+ * it via the shared template helper. Stable ID per hour prevents duplicate
+ * posts within a window; the CreatorLoop's SQLite cache guards against
+ * restart-replay.
+ *
+ * Wired in main.ts for testnet-only (jinn-mono-9ew). Operators can opt out
+ * with JINN_DISABLE_AUTO_INTENTS=1.
+ */
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+import { readChainlinkLatest, scaleToDecimal } from '../venues/chainlink/client.js';
+import { resolvePredictionV0Template } from './prediction-v0-template.js';
+// ── Generator factory ──────────────────────────────────────────────────────────
+/**
+ * Build a generator closure. Calling the closure returns a freshly-resolved
+ * DesiredState for the current hour bucket, or null if Chainlink is
+ * unreachable (caller skips this tick).
+ */
+export function makePredictionV0Generator(config) {
+    const threshold = config.thresholdSentinel ?? 'current+0.5%';
+    const operator = config.operator ?? 'GT';
+    const windowDurationMs = config.windowDurationMs ?? 600_000; // 10 min default (fast-test)
+    const resolveGapMs = config.resolveGapMs ?? 300_000; // 5 min default
+    // Lazy publicClient construction — reused across calls.
+    let publicClient = config._publicClient ?? null;
+    const getPublicClient = () => {
+        if (publicClient)
+            return publicClient;
+        const chain = config.venue === 'chainlink-base' ? base : baseSepolia;
+        const rpcUrl = config.rpcUrl ?? (config.venue === 'chainlink-base'
+            ? 'https://mainnet.base.org'
+            : 'https://sepolia.base.org');
+        publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+        return publicClient;
+    };
+    return async () => {
+        // Bucket start = windowDurationMs boundary ≤ now. Stable ID per bucket
+        // prevents duplicate posts within the same window.
+        const now = Date.now();
+        const startTs = Math.floor(now / windowDurationMs) * windowDurationMs;
+        const endTs = startTs + windowDurationMs;
+        const resolveTs = endTs + resolveGapMs;
+        const template = {
+            id: `pred-v0-auto-${startTs}`,
+            description: `Auto-generated prediction.v0 intent — ${config.feedDescription} ${operator} ${threshold} at ${new Date(resolveTs).toISOString()}`,
+            window: { startTs, endTs },
+            spec: {
+                kind: 'prediction.v0',
+                oracle: {
+                    venue: config.venue,
+                    feed: config.feed,
+                    feedDescription: config.feedDescription,
+                },
+                question: {
+                    kind: 'threshold',
+                    operator,
+                    threshold,
+                    resolveTs,
+                },
+            },
+            eligibility: { maxSubmissionDelayMs: 60_000 },
+        };
+        try {
+            const intent = await resolvePredictionV0Template(template, {
+                readCurrent: async ({ feed }) => {
+                    const reading = await readChainlinkLatest(feed, getPublicClient());
+                    return scaleToDecimal(reading.answer, reading.decimals);
+                },
+            });
+            // Return the resolved DesiredState shape (intent is already valid).
+            return intent;
+        }
+        catch {
+            // Chainlink read failure or schema mismatch — skip this tick, try next.
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=prediction-v0-auto.js.map

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

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

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

@@ -0,0 +1,70 @@
+/**
+ * Sentinel resolution for prediction.v0 intent templates.
+ *
+ * Two sentinels are supported in template JSON (e.g.,
+ * `client/fixtures/prediction-v0-intent.example.json`):
+ *
+ *   1. window.startTs = 0 → rewritten as Date.now() at call time; the rest of
+ *      the window (endTs) and resolveTs are computed relative to that.
+ *
+ *   2. spec.question.threshold = "current[±N[%]]" → read the Chainlink feed
+ *      named in spec.oracle and substitute an absolute price:
+ *
+ *        "current"         → current price exactly
+ *        "current+0.5%"    → current × 1.005
+ *        "current-2%"      → current × 0.98
+ *        "current+100"     → current + 100
+ *        "current-50"      → current - 50
+ *
+ *      The on-chain intent always carries an absolute decimal string; the
+ *      sentinel is ONLY resolved at post time. Evaluator + restorer impls
+ *      never see the sentinel form.
+ *
+ * Exported as a pure function with a `readCurrent` dep so it's trivially
+ * unit-testable. Both the `jinn submit-intent --spec-file` path and the
+ * future auto-generator (jinn-mono-9ew) call through this helper.
+ */
+import { type PredictionV0Intent } from '../types/prediction.js';
+/** Returns true iff the given value looks like a "current[±N[%]]" sentinel. */
+export declare function isCurrentSentinel(value: unknown): boolean;
+export interface TemplateReaderDeps {
+    /**
+     * Read the current price of the Chainlink feed referenced in the template.
+     * Required only when the template uses a `current[±…]` threshold sentinel
+     * (see {@link predictionV0TemplateNeedsReadCurrent}).
+     */
+    readCurrent?: (args: {
+        feed: `0x${string}`;
+        venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    }) => Promise<string>;
+    /**
+     * Window duration when the template uses `window.startTs = 0` (now-relative
+     * sentinel). Default: 10 min — syncs with the 15-min fast-test epoch cadence
+     * on testnet. Set to 3_600_000 for a 1h window (mainnet-style dogfood).
+     */
+    windowDurationMs?: number;
+    /**
+     * Resolve gap when the template uses `window.startTs = 0`. Default: 5 min.
+     * `resolveTs = endTs + resolveGapMs`. Bounded by schema to ≤ 1h.
+     */
+    resolveGapMs?: number;
+}
+/** Default window duration for the startTs-sentinel fill. Tuned for fast-test. */
+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.
+ *
+ * The template must be the JSON shape of a PredictionV0Intent with optional
+ * sentinel values. Callers that build the template from multiple sources
+ * (CLI --spec-file + --id + --description) should merge their bits BEFORE
+ * calling this helper.
+ */
+export declare function resolvePredictionV0Template(template: unknown, deps: TemplateReaderDeps): Promise<PredictionV0Intent>;