@pushchain/core 6.0.27-alpha.2 → 6.0.27-alpha.4

package/src/lib/agentic/presets/types.d.ts

@@ -1,4 +1,5 @@
 import type { Address } from 'viem';
+import type { PUSH_NETWORK } from '../../constants/enums';
 import type { Rule, RuleAsset, RuleCall, ForeignChainNamespace } from '../agentic.types';
 export type PresetCategory = 'DEXES' | 'LENDING' | 'STAKING' | 'PREDICTION';
 export interface Preset {
@@ -7,7 +8,7 @@ export interface Preset {
     name: string;
     chains: ForeignChainNamespace[];
 }
-/** An editable review-screen template; both identity and expiry are required by create. */
+/** Presets generate expiry; optional fields retain editable-template compatibility. */
 export type PresetRuleTemplate = Omit<Rule, 'agent' | 'validUntil'> & {
     agent?: Address;
     validUntil?: number;
@@ -22,23 +23,29 @@ export interface PresetAsset {
     maxTotal?: bigint;
 }
 export interface PresetOptions {
-    /** Explicit Push-PC gas budget per outbound; omitted = zero. */
+    /** Offline route/deployment checks; defaults to TESTNET_DONUT. */
+    network?: PUSH_NETWORK;
+    /** Push-PC budget ceiling per outbound; omitted uses the catalog policy (20 PC).
+     * Explicit zero is preserved. This is not the fee charged. */
     maxGasPerCall?: bigint;
     chainNamespace?: ForeignChainNamespace;
     agent?: Address;
+    /** Omitted: seven days from generation time. Explicit expiry is preserved. */
     validUntil?: number;
-    /** DEX swaps with fewer than two tokens are zero-input-cap review templates.
-     * Call get again with a complete pair to generate token pins and amount limits. */
+    /** Omitted: include the catalog's curated tokens and explicit spending policy.
+     * An explicit array replaces all defaults (including [] to select no tokens).
+     * Supplied assets retain zero for omitted caps; no policy is guessed for them.
+     * DEX swaps with fewer than two tokens remain zero-input-cap review templates. */
     assets?: PresetAsset[];
 }
 export interface ReadyPresetOptions extends PresetOptions {
     agent: Address;
-    validUntil: number;
 }
-/** Offline configuration only: does not check deployment, reserves, balances or liquidity. */
+/** Offline configuration/registry checks; chain state and balances are not checked. */
 export interface PresetConfigurationIssue {
-    code: 'AGENT_REQUIRED' | 'EXPIRY_REQUIRED' | 'GAS_BUDGET_REQUIRED' | 'ASSETS_REQUIRED' | 'TOKEN_PAIR_REQUIRED' | 'NO_ENABLED_OPERATION';
+    code: 'AGENT_REQUIRED' | 'EXPIRY_REQUIRED' | 'GAS_BUDGET_REQUIRED' | 'ASSETS_REQUIRED' | 'TOKEN_PAIR_REQUIRED' | 'NO_ENABLED_OPERATION' | 'AGW_NETWORK_UNAVAILABLE' | 'DESTINATION_UNAVAILABLE' | 'BRIDGE_ASSET_UNAVAILABLE';
     message: string;
+    token?: string;
 }
 export interface PresetCallIssue {
     target: string;
@@ -51,12 +58,21 @@ export interface PresetCallIssue {
 export interface PresetChainReadiness {
     chainNamespace: ForeignChainNamespace;
     ready: boolean;
+    configurationReady: boolean;
+    /** Selected assets and caps, matching the returned rule assets. */
+    selectedAssets: RuleAsset[];
+    /** Registry presence only; grant preparation verifies exact on-chain identity. */
+    bridgeAssets: {
+        token: string;
+        status: 'registered' | 'unavailable';
+        prc20?: Address;
+    }[];
     issues: PresetConfigurationIssue[];
     /** Calls present in the rule but disabled by a zero amount/value maximum. */
     disabledCalls: PresetCallIssue[];
     /** Calls deliberately omitted, including operations with incompatible amount units. */
     excludedCalls: PresetCallIssue[];
-    /** Known fixed-token/reserve addresses in this catalog, not selected defaults. */
+    /** Known catalog token addresses, including the curated default subset. */
     knownTokens: string[];
     /** Selected tokens with a zero Push-outbound budget; destination-held assets are separate. */
     zeroBridgeLimits: string[];

package/src/lib/agentic/public-rule.js

@@ -36,6 +36,7 @@ const selectors_1 = require("./codec/selectors");
 const abi_layout_1 = require("./codec/abi-layout");
 const defaults_1 = require("./codec/defaults");
 const svm_accounts_1 = require("./codec/svm-accounts");
+const destination_1 = require("./management/destination");
 exports.WALLET = 'agentic:wallet';
 const PUBLIC_INPUT = Symbol('AGW public rule');
 /** Mark authored inputs for normalization after the wallet address is fixed. */
@@ -94,6 +95,11 @@ async function normalizePublicRule(input, wallet, runtime) {
     if ('format' in rule && rule.format === 'decoded')
         return input;
     const r = rule;
+    if (!(0, viem_1.isAddress)(r.agent, { strict: false }) || /^0x0{40}$/i.test(r.agent))
+        throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'Enter a valid agent wallet address.', {
+            userMessage: 'Enter a valid agent wallet address.',
+            details: { field: 'agent' },
+        });
     rejectFields(r, [
         'target',
         'selector',
@@ -158,10 +164,15 @@ async function normalizePublicRule(input, wallet, runtime) {
         throw invalid('native rules do not carry assets or maxGasPerCall');
     const own = native
         ? wallet
-        : (0, viem_1.getAddress)((await runtime.resolveCEA(wallet, r.chainNamespace)).cea);
+        : await (0, destination_1.resolveRuleDestination)(runtime, wallet, r.chainNamespace);
     const nativeActions = [];
     const calls = [];
-    for (const call of r.allowedCalls) {
+    for (const [callIndex, call] of r.allowedCalls.entries()) {
+        if (!(0, viem_1.isAddress)(call.target, { strict: false }))
+            throw new errors_1.AgenticError(errors_1.AGENTIC_ERROR_CODE.INVALID_RULE, 'An allowed function has an invalid app address.', {
+                userMessage: 'An allowed function has an invalid app address. Select the app again.',
+                details: { field: `allowedCalls[${callIndex}].target`, callIndex },
+            });
         const pins = call.pins ?? [];
         const wirePins = [];
         const occupied = new Set();

package/src/lib/constants/index.d.ts

@@ -111,6 +111,41 @@ export declare const CONSTANTS: {
     /** Checked v5 agentic wallet deployments by Push network (Donut only). */
     AGENTIC: Readonly<{
         WALLET: "agentic:wallet";
+        PRINCIPAL: "agentic:principal";
+        JOB: Readonly<{
+            ADDRESS: Readonly<{
+                'eip155:42101': Readonly<{
+                    KERNEL: "0x977cf1AC973E9eC4332791d531507575006157Ed";
+                    HOOK: "0xDe7A94e510b6C571DE7880d441349689F73A32b3";
+                    EVALUATOR: "0x1afC81396f1bb36F91f74506284952b81e4bd47c";
+                }>;
+            }>;
+            EVALUATION: Readonly<{
+                readonly BOOLEAN: "BOOLEAN";
+                readonly COMPARE: "COMPARE";
+                readonly NUMBER: "NUMBER";
+                readonly PERCENTAGE: "PERCENTAGE";
+            }>;
+            OPERATION: Readonly<{
+                readonly EQUAL: "EQUAL";
+                readonly NOT_EQUAL: "NOT_EQUAL";
+                readonly GREATER_THAN: "GREATER_THAN";
+                readonly GREATER_OR_EQUAL: "GREATER_OR_EQUAL";
+                readonly LESS_THAN: "LESS_THAN";
+                readonly LESS_OR_EQUAL: "LESS_OR_EQUAL";
+            }>;
+            LOGIC: Readonly<{
+                readonly ALL: "ALL";
+                readonly ANY: "ANY";
+                readonly AT_LEAST: "AT_LEAST";
+            }>;
+            ALLOWED_MUTABILITY: Readonly<{
+                readonly NONE: "NONE";
+                readonly CLIENT: "CLIENT";
+                readonly PROVIDER: "PROVIDER";
+                readonly BOTH: "BOTH";
+            }>;
+        }>;
         PRESETS: Readonly<{
             CATEGORY: Readonly<{
                 DEXES: "DEXES";

package/src/lib/index.d.ts

@@ -1,4 +1,8 @@
 import { PushChain } from './push-chain/push-chain';
+export { MarketError, JobError, JobSpecError } from './market';
+export type { AgentCardRules, MarketAssetToken, MarketPin, AgentCard, AgentCardInput, AgentCardSummary, MarketNamespace, MarketPreviewOptions, MarketWriteOptions, MarketOpenOptions, MarketDepositOptions, MarketDepositResult, MarketDepositStep, JobPlan, OwnerIntent, } from './market';
+export type { JobNamespace, Job, JobStatus, JobEvent, JobWatchCursor, JobWatchOptions, CreateJobOptions, FundJobOptions, } from './job/types';
+export type { JobSpec, JobSpecTemplate, JobRead, PreparedJobRead, JobReadInput, JobCheck, JobCheckTemplate, LogicTree, Evaluation, Operation, LogicKind, AllowedMutability, PrincipalMarker, PrepareJobReadOptions, ExecuteJobReadOptions, BuildJobSpecOptions, BuildJobSpecTemplateOptions, JobSpecPreview, PreviewJobSpecOptions, } from './job-spec';
 export { CHAIN } from './constants/enums';
 export type { ConversionQuote } from './constants/tokens';
 export type { UniversalSigner, UniversalAccount, UniversalSignerSkeleton, SignAuthorizationParams, SignedAuthorization, DerivedExecutorAccount, ResolvedAccount, ResolvedControllerAccounts, AccountType, AccountRole, } from './universal/universal.types';

package/src/lib/index.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReadTimeoutError = exports.ReadDecodeError = exports.UnsupportedReadDestinationError = exports.ReadHeightUnavailableError = exports.InvalidReadSpecError = exports.InvalidReadQueryError = exports.ReadStateError = exports.TERMINAL_READ_STATUSES = exports.CONTRACT_REQUEST_STATUS = exports.READ_OUTCOME = exports.READ_ERROR_CODE = exports.READ_STATUS = exports.UNIVERSAL_READ_STATUS = exports.buildErc20WithdrawalMulticall = exports.buildMigrationPayload = exports.isValidSolanaHexAddress = exports.isSvmChain = exports.encodeSvmExecutePayload = exports.getAllCEAAddresses = exports.getCEAFactoryAddress = exports.chainSupportsOutbound = exports.chainSupportsCEA = exports.isCEA = exports.getPushAccountForCEA = exports.getCEAAddress = exports.quoteMaxPCForGasCapFromNativeValue = exports.quoteMaxPCForGasCap = exports.MAX_PC_FOR_GAS_BUFFER_BPS_LIMIT = exports.DEFAULT_MAX_PC_FOR_GAS_BUFFER_BPS = exports.isChainTarget = exports.detectRoute = exports.TransactionRoute = exports.parseUEAVersion = exports.PC20UnsafeEmptyPayloadError = exports.PC20ExportRevertedError = exports.PC20WrapperPredictionUnavailableError = exports.PC20UnknownChainNamespaceError = exports.InsufficientPC20BalanceError = exports.UnsupportedPC20DestinationError = exports.PC20AmbiguousAddressError = exports.PC20ExpectedButPRC20Error = exports.InvalidPC20MetadataError = exports.PC20FactoryMismatchError = exports.PC20RegistryMismatchError = exports.PC20WrapperNotRegisteredError = exports.PC20TokenChainMismatchError = exports.InvalidPC20AddressError = exports.PC20Error = exports.isPC20Reference = exports.CHAIN = void 0;
-exports.PushChain = exports.AgenticRevertError = exports.AgenticError = exports.AGENTIC_ERROR_CODE = exports.PushChainBatchExecutionError = exports.PushChainExecutionError = exports.UNIVERSAL_READ_REGISTRY_EVM = exports.UNIVERSAL_CALLBACK_EVM = exports.toReadQuery = exports.toRequestIdHex = exports.inferResultShape = exports.sizeCallbackBudget = exports.toCallData = exports.validateReadSpec = exports.buildReadSpecFromPreflight = exports.parseFulfilOutcome = exports.parseReadRequestsFromReceipt = exports.decodeReadResult = exports.encodeReadQuery = exports.resolveDestination = exports.ReadRegistryUnavailableError = exports.ReadNotFoundError = void 0;
+exports.ReadHeightUnavailableError = exports.InvalidReadSpecError = exports.InvalidReadQueryError = exports.ReadStateError = exports.TERMINAL_READ_STATUSES = exports.CONTRACT_REQUEST_STATUS = exports.READ_OUTCOME = exports.READ_ERROR_CODE = exports.READ_STATUS = exports.UNIVERSAL_READ_STATUS = exports.buildErc20WithdrawalMulticall = exports.buildMigrationPayload = exports.isValidSolanaHexAddress = exports.isSvmChain = exports.encodeSvmExecutePayload = exports.getAllCEAAddresses = exports.getCEAFactoryAddress = exports.chainSupportsOutbound = exports.chainSupportsCEA = exports.isCEA = exports.getPushAccountForCEA = exports.getCEAAddress = exports.quoteMaxPCForGasCapFromNativeValue = exports.quoteMaxPCForGasCap = exports.MAX_PC_FOR_GAS_BUFFER_BPS_LIMIT = exports.DEFAULT_MAX_PC_FOR_GAS_BUFFER_BPS = exports.isChainTarget = exports.detectRoute = exports.TransactionRoute = exports.parseUEAVersion = exports.PC20UnsafeEmptyPayloadError = exports.PC20ExportRevertedError = exports.PC20WrapperPredictionUnavailableError = exports.PC20UnknownChainNamespaceError = exports.InsufficientPC20BalanceError = exports.UnsupportedPC20DestinationError = exports.PC20AmbiguousAddressError = exports.PC20ExpectedButPRC20Error = exports.InvalidPC20MetadataError = exports.PC20FactoryMismatchError = exports.PC20RegistryMismatchError = exports.PC20WrapperNotRegisteredError = exports.PC20TokenChainMismatchError = exports.InvalidPC20AddressError = exports.PC20Error = exports.isPC20Reference = exports.CHAIN = exports.JobSpecError = exports.JobError = exports.MarketError = void 0;
+exports.PushChain = exports.AgenticRevertError = exports.AgenticError = exports.AGENTIC_ERROR_CODE = exports.PushChainBatchExecutionError = exports.PushChainExecutionError = exports.UNIVERSAL_READ_REGISTRY_EVM = exports.UNIVERSAL_CALLBACK_EVM = exports.toReadQuery = exports.toRequestIdHex = exports.inferResultShape = exports.sizeCallbackBudget = exports.toCallData = exports.validateReadSpec = exports.buildReadSpecFromPreflight = exports.parseFulfilOutcome = exports.parseReadRequestsFromReceipt = exports.decodeReadResult = exports.encodeReadQuery = exports.resolveDestination = exports.ReadRegistryUnavailableError = exports.ReadNotFoundError = exports.ReadTimeoutError = exports.ReadDecodeError = exports.UnsupportedReadDestinationError = void 0;
 const push_chain_1 = require("./push-chain/push-chain");
 Object.defineProperty(exports, "PushChain", { enumerable: true, get: function () { return push_chain_1.PushChain; } });
+var market_1 = require("./market");
+Object.defineProperty(exports, "MarketError", { enumerable: true, get: function () { return market_1.MarketError; } });
+Object.defineProperty(exports, "JobError", { enumerable: true, get: function () { return market_1.JobError; } });
+Object.defineProperty(exports, "JobSpecError", { enumerable: true, get: function () { return market_1.JobSpecError; } });
 var enums_1 = require("./constants/enums");
 Object.defineProperty(exports, "CHAIN", { enumerable: true, get: function () { return enums_1.CHAIN; } });
 var orchestrator_types_1 = require("./orchestrator/orchestrator.types");

package/src/lib/job/job.d.ts

@@ -0,0 +1,35 @@
+import { type Address, type Hex } from 'viem';
+import { type StackRuntime } from '../market/runtime';
+import type { CreateJobOptions, FundJobOptions, Job, JobEvent, JobNamespace, JobStatus, JobWriteOptions, JobWatchOptions } from './types';
+export declare class JobNamespaceImpl implements JobNamespace {
+    private readonly rt;
+    constructor(rt: StackRuntime);
+    private raw;
+    private jobAt;
+    status(jobId: bigint): Promise<Job>;
+    list(options?: {
+        client?: Address;
+        provider?: Address;
+        status?: JobStatus;
+        fromJobId?: bigint;
+    }): Promise<{
+        jobs: Job[];
+    }>;
+    create(options: CreateJobOptions): Promise<{
+        jobId: bigint;
+        tx: import("../orchestrator/orchestrator.types").UniversalTxResponse;
+    }>;
+    private provider;
+    private open;
+    setBudget(jobId: bigint, budget: bigint, options?: JobWriteOptions & {
+        jobSpec?: Hex;
+    }): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    fund(jobId: bigint, options?: FundJobOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    submit(jobId: bigint, options: JobWriteOptions & {
+        deliverable: Hex | string;
+    }): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    cancel(jobId: bigint, options?: JobWriteOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    claimRefund(jobId: bigint, options?: JobWriteOptions): Promise<import("../orchestrator/orchestrator.types").UniversalTxResponse>;
+    verify(_jobId: bigint, _options?: JobWriteOptions): Promise<never>;
+    watch(jobId: bigint, callback: (event: JobEvent) => void, options?: JobWatchOptions): () => void;
+}

package/src/lib/job/job.js

@@ -0,0 +1,382 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobNamespaceImpl = void 0;
+const viem_1 = require("viem");
+const AgenticCommerce_1 = require("../market/contracts/AgenticCommerce");
+const RulesBindingHook_1 = require("../market/contracts/RulesBindingHook");
+const UniversalMarketplace_1 = require("../market/contracts/UniversalMarketplace");
+const kernel_wire_1 = require("../market/kernel-wire");
+const runtime_1 = require("../market/runtime");
+const errors_1 = require("../market/errors");
+const deployments_1 = require("../agentic/deployments");
+const rules_1 = require("../agentic/reads/rules");
+const snapshot_1 = require("../agentic/reads/snapshot");
+const codec_1 = require("../job-spec/codec");
+const watch_1 = require("./watch");
+const STATES = [
+    'Open',
+    'Funded',
+    'Submitted',
+    'Completed',
+    'Rejected',
+    'Expired',
+];
+function validId(jobId) {
+    if (typeof jobId !== 'bigint' || jobId < BigInt(1))
+        throw new errors_1.JobError('INVALID_JOB_ID', 'Job IDs are positive bigint values.');
+}
+function amount(n) {
+    if (typeof n !== 'bigint' || n < BigInt(0) || n >= BigInt(1) << BigInt(256))
+        throw new errors_1.JobError('INVALID_AMOUNT', 'The amount must fit uint256.');
+}
+class JobNamespaceImpl {
+    rt;
+    constructor(rt) {
+        this.rt = rt;
+    }
+    async raw(jobId, s) {
+        validId(jobId);
+        const j = await s.read((0, runtime_1.deployment)(this.rt).kernel, kernel_wire_1.KERNEL_READ_ABI, 'getJob', [jobId]);
+        if ((0, viem_1.getAddress)(j.client) === viem_1.zeroAddress || !STATES[j.status])
+            throw new errors_1.JobError('JOB_NOT_FOUND', 'This job does not exist.');
+        return j;
+    }
+    async jobAt(jobId, s) {
+        const d = (0, runtime_1.deployment)(this.rt);
+        const j = await this.raw(jobId, s);
+        const paymentToken = await s.read(d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'paymentToken');
+        let spec;
+        let decodeError;
+        if (j.description !== '0x') {
+            try {
+                spec = (0, codec_1.decodeJobSpec)(j.description, { format: 'spec' });
+            }
+            catch (e) {
+                decodeError = e.message;
+            }
+        }
+        const rulesId = (0, viem_1.getAddress)(j.hook) === (0, viem_1.getAddress)(d.hook)
+            ? await s.read(d.hook, RulesBindingHook_1.RULES_HOOK_ABI, 'rulesOfJob', [jobId])
+            : undefined;
+        let deliverable;
+        if (j.status >= 2) {
+            const logs = await (0, snapshot_1.scanLogs)(this.rt.agw.reader, {
+                address: d.kernel,
+                event: (0, viem_1.getAbiItem)({ abi: AgenticCommerce_1.JOB_KERNEL_ABI, name: 'JobSubmitted' }),
+                args: { jobId },
+            }, this.rt.jobBlocks?.get(jobId) ?? d.startBlock, s.blockNumber);
+            if (logs.length > 1)
+                throw new errors_1.JobError('INCONSISTENT_READ', 'The job has multiple submission events.');
+            if (logs.length === 1) {
+                const event = (0, viem_1.decodeEventLog)({
+                    abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                    eventName: 'JobSubmitted',
+                    data: logs[0].data,
+                    topics: logs[0].topics,
+                });
+                deliverable = event.args.deliverable;
+            }
+        }
+        return {
+            ...j,
+            jobId,
+            status: STATES[j.status],
+            paymentToken,
+            ...(deliverable ? { deliverable } : {}),
+            ...(rulesId && rulesId !== viem_1.zeroHash ? { rulesId } : {}),
+            ...(spec ? { jobSpec: { spec, bytes: j.description } } : {}),
+            ...(decodeError ? { jobSpecDecodeError: decodeError } : {}),
+            evaluation: {
+                available: false,
+                reason: (0, viem_1.getAddress)(j.evaluator) === (0, viem_1.getAddress)(d.evaluator)
+                    ? 'MANUAL_EVALUATOR'
+                    : 'UNVERIFIED_EVALUATOR',
+            },
+        };
+    }
+    async status(jobId) {
+        return this.jobAt(jobId, await (0, runtime_1.snapshot)(this.rt));
+    }
+    async list(options = {}) {
+        const s = await (0, runtime_1.snapshot)(this.rt);
+        const count = await s.read((0, runtime_1.deployment)(this.rt).kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'jobCounter');
+        const from = options.fromJobId ?? BigInt(1);
+        validId(from);
+        const jobs = [];
+        for (let i = from; i <= count; i += BigInt(8)) {
+            const rows = await Promise.all(Array.from({
+                length: Number(count - i + BigInt(1) > BigInt(8)
+                    ? BigInt(8)
+                    : count - i + BigInt(1)),
+            }, (_, n) => this.jobAt(i + BigInt(n), s)));
+            jobs.push(...rows.filter((j) => (!options.client ||
+                (0, viem_1.getAddress)(options.client) === (0, viem_1.getAddress)(j.client)) &&
+                (!options.provider ||
+                    (0, viem_1.getAddress)(options.provider) === (0, viem_1.getAddress)(j.provider)) &&
+                (!options.status || options.status === j.status)));
+        }
+        return { jobs };
+    }
+    async create(options) {
+        options = { ...options };
+        const d = (0, runtime_1.deployment)(this.rt);
+        const s = await (0, runtime_1.snapshot)(this.rt);
+        const token = await s.read(d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'paymentToken');
+        if ((0, viem_1.getAddress)(options.paymentToken) !== (0, viem_1.getAddress)(token))
+            throw new errors_1.JobError('TOKEN_MISMATCH', 'The job token must equal this kernel’s payment token.');
+        if (options.jobSpec) {
+            const spec = (0, codec_1.decodeJobSpec)(options.jobSpec, {
+                format: 'spec',
+            });
+            if (spec.allowedMutability !== 'NONE')
+                (0, errors_1.unavailable)('Mutable job criteria');
+            if (spec.origin !== viem_1.zeroHash)
+                throw new errors_1.JobError('INVALID_JOB_SPEC', 'A plain job must have a zero marketplace origin.');
+            if (spec.failFinalAt >= options.expiredAt)
+                throw new errors_1.JobError('INVALID_JOB_SPEC', 'The failure deadline must precede expiry.');
+        }
+        const min = await s.read(d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'MIN_EXPIRY_WINDOW');
+        if (!Number.isSafeInteger(options.expiredAt) ||
+            options.expiredAt <= s.timestamp + Number(min) ||
+            options.expiredAt >= 2 ** 48)
+            throw new errors_1.JobError('EXPIRY_TOO_SHORT', 'Choose a future expiry beyond the kernel minimum window.');
+        const call = {
+            target: d.kernel,
+            value: BigInt(0),
+            data: (0, kernel_wire_1.encodeCreateJob)((0, viem_1.getAddress)(options.provider), (0, viem_1.getAddress)(options.evaluator), options.expiredAt, options, (0, viem_1.getAddress)(options.hook)),
+        };
+        const wallet = this.rt.wallet();
+        const tx = wallet
+            ? await (0, runtime_1.ownerBatch)(this.rt, wallet, [call], options.progressHook)
+            : await (0, runtime_1.write)(this.rt, call, options.progressHook, 'JOB', true);
+        const e = await (0, runtime_1.eventArgs)(this.rt, tx, d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'JobCreated');
+        if ((0, viem_1.getAddress)(e['client']) !== (0, viem_1.getAddress)(this.rt.account()))
+            throw new errors_1.JobError('RECEIPT_MISMATCH', 'The created job has a different client.', { txHash: tx.hash });
+        return { jobId: e['jobId'], tx };
+    }
+    provider(j) {
+        if ((0, viem_1.getAddress)(j.provider) !== (0, viem_1.getAddress)(this.rt.agw.signerPushAccount()))
+            throw new errors_1.JobError('NOT_PROVIDER', 'Connect this job’s provider.');
+    }
+    open(j, now) {
+        if (j.status !== 0 || j.expiredAt <= now)
+            throw new errors_1.JobError('WRONG_STATUS', 'The job must be Open and unexpired.');
+    }
+    async setBudget(jobId, budget, options = {}) {
+        if (options.jobSpec !== undefined)
+            (0, errors_1.unavailable)('Replacement JobSpec proposals');
+        amount(budget);
+        const s = await (0, runtime_1.snapshot)(this.rt);
+        const j = await this.raw(jobId, s);
+        this.provider(j);
+        this.open(j, s.timestamp);
+        const d = (0, runtime_1.deployment)(this.rt);
+        return (0, runtime_1.write)(this.rt, {
+            target: d.kernel,
+            value: BigInt(0),
+            data: (0, viem_1.encodeFunctionData)({
+                abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                functionName: 'setBudget',
+                args: [jobId, budget, '0x'],
+            }),
+        }, options.progressHook, 'JOB', true);
+    }
+    async fund(jobId, options = {}) {
+        options = { ...options };
+        const rt = this.rt;
+        const d = (0, runtime_1.deployment)(rt);
+        const s = await (0, runtime_1.snapshot)(rt);
+        const j = await this.raw(jobId, s);
+        this.open(j, s.timestamp);
+        const gen = (0, deployments_1.currentGeneration)(rt.agw.network);
+        const isWallet = await s.read(gen.addresses.factory, gen.contracts.abis.factory, 'isWallet', [j.client]);
+        if (isWallet) {
+            const owner = await s.read(j.client, gen.contracts.abis.wallet, 'owner');
+            if ((0, viem_1.getAddress)(owner) !== (0, viem_1.getAddress)(rt.agw.signerPushAccount()))
+                throw new errors_1.JobError('NOT_CLIENT', 'Connect the job wallet’s owner.');
+        }
+        else if ((0, viem_1.getAddress)(j.client) !== (0, viem_1.getAddress)(rt.agw.signerPushAccount()))
+            throw new errors_1.JobError('NOT_CLIENT', 'Connect this job’s client.');
+        let expected = options.expectedBudget;
+        const cardId = await s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'cardOfJob', [jobId]);
+        let rulesId = options.rulesId;
+        if (cardId) {
+            const [version, view, recordedRules] = await Promise.all([
+                s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'cardVersionOfJob', [
+                    jobId,
+                ]),
+                s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'getAgentCard', [cardId]),
+                s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'rulesOfJob', [jobId]),
+            ]);
+            if (rulesId && rulesId !== recordedRules)
+                throw new errors_1.JobError('RULES_MISMATCH', 'Use the permission recorded when this job was opened.');
+            rulesId = recordedRules;
+            if (expected === undefined && version === view.version)
+                expected = view.card.providerFee;
+        }
+        if (expected === undefined)
+            throw new errors_1.JobError('EXPECTED_BUDGET_REQUIRED', 'Pass the exact budget you reviewed; this SDK does not silently accept the latest provider quote.');
+        amount(expected);
+        if (expected !== j.budget)
+            throw new errors_1.JobError('BUDGET_MISMATCH', 'The provider’s current price differs from the budget you reviewed.', { expectedBudget: expected, currentBudget: j.budget });
+        let optParams = '0x';
+        if ((0, viem_1.getAddress)(j.hook) === (0, viem_1.getAddress)(d.hook)) {
+            if (!isWallet || !rulesId || !/^0x[\da-f]{64}$/i.test(rulesId))
+                throw new errors_1.JobError('RULES_REQUIRED', 'This rules hook needs an AGW client and its rulesId.');
+            const record = await (0, rules_1.getRule)(new snapshot_1.Snapshot(rt.agw.reader, s.blockNumber), gen, j.client, rulesId, rt.agw.pushChainNamespace);
+            if ((0, viem_1.getAddress)(record.agent) !== (0, viem_1.getAddress)(j.provider) ||
+                record.validUntil < j.expiredAt)
+                throw new errors_1.JobError('RULES_MISMATCH', 'The live rule must authorize this provider through the job expiry.');
+            if (await s.read(d.hook, RulesBindingHook_1.RULES_HOOK_ABI, 'activeJobOf', [j.client]))
+                throw new errors_1.JobError('WALLET_HAS_ACTIVE_JOB', 'This wallet already has a funded job under the rules hook.');
+            optParams = (0, viem_1.encodeAbiParameters)([{ type: 'bytes32' }], [rulesId]);
+        }
+        else if (rulesId)
+            throw new errors_1.JobError('HOOK_MISMATCH', 'A rulesId payload is supported only for the verified rules hook.');
+        const token = await s.read(d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'paymentToken');
+        const calls = [];
+        if (expected > BigInt(0)) {
+            const [balance, allowance] = await Promise.all([
+                s.read(token, viem_1.erc20Abi, 'balanceOf', [j.client]),
+                s.read(token, viem_1.erc20Abi, 'allowance', [j.client, d.kernel]),
+            ]);
+            if (balance < expected)
+                throw new errors_1.JobError('INSUFFICIENT_FUNDS', 'The job client lacks the payment tokens required for escrow.');
+            if (allowance < expected) {
+                if (allowance > BigInt(0))
+                    calls.push({
+                        target: token,
+                        value: BigInt(0),
+                        data: (0, viem_1.encodeFunctionData)({
+                            abi: viem_1.erc20Abi,
+                            functionName: 'approve',
+                            args: [d.kernel, BigInt(0)],
+                        }),
+                    });
+                calls.push({
+                    target: token,
+                    value: BigInt(0),
+                    data: (0, viem_1.encodeFunctionData)({
+                        abi: viem_1.erc20Abi,
+                        functionName: 'approve',
+                        args: [d.kernel, expected],
+                    }),
+                });
+            }
+        }
+        calls.push({
+            target: d.kernel,
+            value: BigInt(0),
+            data: (0, viem_1.encodeFunctionData)({
+                abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                functionName: 'fund',
+                args: [jobId, expected, optParams],
+            }),
+        });
+        if (isWallet)
+            return (0, runtime_1.ownerBatch)(rt, j.client, calls, options.progressHook);
+        if (calls.length === 1)
+            return (0, runtime_1.write)(rt, calls[0], options.progressHook, 'JOB', true);
+        if (rt.agw.isReadOnly)
+            throw new errors_1.JobError('READ_ONLY', 'Connect a signer to fund escrow.');
+        // No sequential fallback: allowance and acceptance must belong to one atomic batch.
+        return rt.agw.executeAtomicBatch({
+            to: d.kernel,
+            value: BigInt(0),
+            data: calls.map((c) => ({
+                to: c.target,
+                value: c.value,
+                data: c.data,
+            })),
+        }, { progressHook: options.progressHook });
+    }
+    async submit(jobId, options) {
+        options = { ...options };
+        const s = await (0, runtime_1.snapshot)(this.rt);
+        const j = await this.raw(jobId, s);
+        this.provider(j);
+        if (j.status !== 1 || j.expiredAt <= s.timestamp)
+            throw new errors_1.JobError('WRONG_STATUS', 'Only an unexpired Funded job can be submitted.');
+        const deliverable = /^0x[\da-f]{64}$/i.test(options.deliverable)
+            ? options.deliverable
+            : (0, viem_1.keccak256)((0, viem_1.stringToHex)(options.deliverable));
+        return (0, runtime_1.write)(this.rt, {
+            target: (0, runtime_1.deployment)(this.rt).kernel,
+            value: BigInt(0),
+            data: (0, viem_1.encodeFunctionData)({
+                abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                functionName: 'submit',
+                args: [jobId, deliverable, '0x'],
+            }),
+        }, options.progressHook, 'JOB', true);
+    }
+    async cancel(jobId, options = {}) {
+        const rt = this.rt;
+        const d = (0, runtime_1.deployment)(rt);
+        const s = await (0, runtime_1.snapshot)(rt);
+        const j = await this.raw(jobId, s);
+        if (j.status !== 0)
+            throw new errors_1.JobError('WRONG_STATUS', 'Only an Open job can be cancelled by its client.');
+        const gen = (0, deployments_1.currentGeneration)(rt.agw.network);
+        const isWallet = await s.read(gen.addresses.factory, gen.contracts.abis.factory, 'isWallet', [j.client]);
+        const calls = [
+            {
+                target: d.kernel,
+                value: BigInt(0),
+                data: (0, viem_1.encodeFunctionData)({
+                    abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                    functionName: 'reject',
+                    args: [jobId, viem_1.zeroHash, '0x'],
+                }),
+            },
+        ];
+        if (isWallet) {
+            const wallet = await s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'agwOfJob', [jobId]);
+            const rulesId = await s.read(d.marketplace, UniversalMarketplace_1.MARKETPLACE_ABI, 'rulesOfJob', [jobId]);
+            if ((0, viem_1.getAddress)(wallet) === (0, viem_1.getAddress)(j.client) &&
+                rulesId !== viem_1.zeroHash &&
+                (await s.read(gen.addresses.sessionEngine, gen.contracts.abis.engine, 'isPermissionEnabled', [rulesId, j.client])))
+                calls.push({
+                    target: j.client,
+                    value: BigInt(0),
+                    data: gen.contracts.encodeRevokeRules(rulesId),
+                });
+            return (0, runtime_1.ownerBatch)(rt, j.client, calls, options.progressHook);
+        }
+        if ((0, viem_1.getAddress)(j.client) !== (0, viem_1.getAddress)(rt.agw.signerPushAccount()))
+            throw new errors_1.JobError('NOT_CLIENT', 'Only the client can use this cancellation method.');
+        return (0, runtime_1.write)(rt, calls[0], options.progressHook, 'JOB', true);
+    }
+    async claimRefund(jobId, options = {}) {
+        const s = await (0, runtime_1.snapshot)(this.rt);
+        const j = await this.raw(jobId, s);
+        const d = (0, runtime_1.deployment)(this.rt);
+        if (![0, 1, 2].includes(j.status))
+            throw new errors_1.JobError('WRONG_STATUS', 'This job is already terminal.');
+        const grace = j.status === 2
+            ? Number(await s.read(d.kernel, AgenticCommerce_1.JOB_KERNEL_ABI, 'EVALUATOR_GRACE_PERIOD'))
+            : 0;
+        if (s.timestamp < j.expiredAt + grace)
+            throw new errors_1.JobError('REFUND_NOT_READY', 'The expiry or evaluator grace window has not elapsed.');
+        return (0, runtime_1.write)(this.rt, {
+            target: d.kernel,
+            value: BigInt(0),
+            data: (0, viem_1.encodeFunctionData)({
+                abi: AgenticCommerce_1.JOB_KERNEL_ABI,
+                functionName: 'claimRefund',
+                args: [jobId],
+            }),
+        }, options.progressHook, 'JOB', true);
+    }
+    async verify(_jobId, _options) {
+        void _jobId;
+        void _options;
+        return (0, errors_1.unavailable)('Automatic job verification; the configured evaluator is manual');
+    }
+    watch(jobId, callback, options = {}) {
+        validId(jobId);
+        return (0, watch_1.watchJob)(this.rt, jobId, callback, { ...options });
+    }
+}
+exports.JobNamespaceImpl = JobNamespaceImpl;
+//# sourceMappingURL=job.js.map