@aephia/atlas-kit 0.6.0-next.13 → 0.6.0-next.130

package/dist/internal/planning/own-starbase-facts.js

@@ -0,0 +1,49 @@
+import { SageSdkError } from '../../client/errors.js';
+import { characterAccountDefinition } from '../c4/character.js';
+import { profileAccountDefinition } from '../c4/identity.js';
+import { profileFactionAccountDefinition } from '../c4/profile-faction.js';
+import { starbasePlayerAccountDefinition } from '../c4/starbase.js';
+import { deriveStarSystemAddress, starSystemAccountDefinition, } from '../c4/world.js';
+function fail(address, message) {
+    throw new SageSdkError('ACTION_PRECONDITION_FAILED', message, { address });
+}
+/** Decodes and relates the Profile, Character, faction membership, Star System
+ * and StarbasePlayer that Fleet creation and ship assembly both require: one
+ * canonical Character and membership for the Profile, a canonical Starbase
+ * System owned by that faction, and the StarbasePlayer joining them.
+ * `required` reads each account with the planner's own wording. */
+export async function readOwnStarbaseFacts(intent, resolved, required, action) {
+    const profileRaw = required(resolved.profile, 'Profile');
+    const profile = profileAccountDefinition.decode(profileRaw);
+    const character = characterAccountDefinition.decode(required(resolved.character, 'Character'));
+    const faction = profileFactionAccountDefinition.decode(required(resolved.profileFaction, 'ProfileFaction'));
+    const system = starSystemAccountDefinition.decode(required(resolved.system, 'Star System'));
+    const player = starbasePlayerAccountDefinition.decode(required(resolved.starbasePlayer, 'StarbasePlayer'));
+    if (character.game !== intent.game ||
+        character.playerProfile !== intent.profile)
+        fail(resolved.character, `The Character belongs to a different Game or Profile. Refresh the canonical Character and ${action.replan}.`);
+    if (faction.profile !== intent.profile)
+        fail(resolved.profileFaction, `The faction membership belongs to a different Profile. Refresh the canonical membership ${action.before}.`);
+    if (system.game !== intent.game ||
+        (await deriveStarSystemAddress(system.game, system.systemId)) !==
+            intent.system ||
+        !system.starbase)
+        fail(resolved.system, 'The selected System is not canonical for this Game or has no Starbase. Choose a valid Starbase System and replan.');
+    if (player.playerProfile !== intent.profile ||
+        player.character !== resolved.character ||
+        player.system !== intent.system ||
+        player.faction !== faction.faction)
+        fail(resolved.starbasePlayer, 'The StarbasePlayer has a different Profile, Character, System or faction relationship. Refresh the canonical StarbasePlayer and replan.');
+    if (faction.faction === 'unaligned' ||
+        system.starbase.owner !== faction.faction)
+        fail(resolved.system, 'This planner supports an existing own-faction StarbasePlayer only. Select an own-faction Starbase; other diplomacy or access routes require separate supported planning.');
+    return {
+        profileRaw,
+        profile,
+        character,
+        faction,
+        starbase: system.starbase,
+        player,
+    };
+}
+//# sourceMappingURL=own-starbase-facts.js.map

package/dist/internal/planning/own-starbase-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"own-starbase-facts.js","sourceRoot":"","sources":["../../../src/internal/planning/own-starbase-facts.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAUxB,SAAS,IAAI,CAAC,OAAgB,EAAE,OAAe;IAC7C,MAAM,IAAI,YAAY,CAAC,4BAA4B,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;;mEAImE;AACnE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAIC,EACD,QAMC,EACD,QAAwD,EACxD,MAAyB;IAEzB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,0BAA0B,CAAC,MAAM,CACjD,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAC1C,CAAC;IACF,MAAM,OAAO,GAAG,+BAA+B,CAAC,MAAM,CACpD,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACpD,CAAC;IACF,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAC/C,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,CACzC,CAAC;IACF,MAAM,MAAM,GAAG,+BAA+B,CAAC,MAAM,CACnD,QAAQ,CAAC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC,CACpD,CAAC;IACF,IACE,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC9B,SAAS,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QAE1C,IAAI,CACF,QAAQ,CAAC,SAAS,EAClB,6FAA6F,MAAM,CAAC,MAAM,GAAG,CAC9G,CAAC;IACJ,IAAI,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;QACpC,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,2FAA2F,MAAM,CAAC,MAAM,GAAG,CAC5G,CAAC;IACJ,IACE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAC3B,CAAC,MAAM,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3D,MAAM,CAAC,MAAM;QACf,CAAC,MAAM,CAAC,QAAQ;QAEhB,IAAI,CACF,QAAQ,CAAC,MAAM,EACf,mHAAmH,CACpH,CAAC;IACJ,IACE,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO;QACvC,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS;QACvC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAC/B,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;QAElC,IAAI,CACF,QAAQ,CAAC,cAAc,EACvB,yIAAyI,CAC1I,CAAC;IACJ,IACE,OAAO,CAAC,OAAO,KAAK,WAAW;QAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,OAAO;QAEzC,IAAI,CACF,QAAQ,CAAC,MAAM,EACf,0KAA0K,CAC3K,CAAC;IACJ,OAAO;QACL,UAAU;QACV,OAAO;QACP,SAAS;QACT,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/internal/planning/plan-fields.d.ts

@@ -0,0 +1,60 @@
+import { type Address } from '@solana/kit';
+export type UnknownRecord = Record<string, unknown>;
+export declare const MAX_U64 = 18446744073709551615n;
+/** Rejects one Plan field with the shared recreate-or-hydrate remedy. */
+export declare function invalid(field: string, value: unknown, acceptedRange: string): never;
+export declare function readRecord(value: unknown, field: string): UnknownRecord;
+export declare function assertKeys(value: UnknownRecord, field: string, required: readonly string[], optional?: readonly string[]): void;
+export declare function readString(value: unknown, field: string): string;
+export declare function readAddress(value: unknown, field: string): Address;
+/** An integer, or with `finite` any finite number, in an inclusive range. */
+export interface NumberField {
+    readonly min: number;
+    readonly max: number;
+    readonly accepted: string;
+    readonly finite?: true;
+}
+/** A bigint in an inclusive range; Plan JSON carries a canonical decimal string. */
+export interface BigIntField {
+    readonly min: bigint;
+    readonly max: bigint;
+    readonly accepted: string;
+}
+/** One of a fixed set of values. */
+export interface TokenField {
+    readonly values: readonly unknown[];
+    readonly accepted: string;
+}
+/** How one Plan guard field is validated in memory and decoded from Plan JSON. */
+export type GuardFieldType = 'address' | 'hash' | 'string' | 'text' | 'label' | NumberField | BigIntField | TokenField;
+/** A guard field: key, type and whether it may be omitted. */
+export type GuardFieldEntry = readonly [
+    key: string,
+    type: GuardFieldType,
+    optional?: true
+];
+/** One flat guard kind; field order is the normalized and serialized order. */
+export interface GuardSchema {
+    readonly fields: readonly GuardFieldEntry[];
+    /** Extra fields for the guard's validated `status`, keyed by status value.
+     * Requires a `status` field; a status without an entry adds no fields.
+     */
+    readonly byStatus?: Readonly<Record<string, readonly GuardFieldEntry[]>>;
+    /** Cross-field invariants, evaluated after every field is valid. */
+    readonly check?: (guard: UnknownRecord) => boolean;
+    /** Replaces every field-level error with one safeguard-level error. */
+    readonly error?: {
+        readonly accepted: string;
+        readonly remedy: string;
+    };
+}
+/** Validates one flat guard against its schema; `wire` decodes Plan JSON values.
+ * The result is frozen, with `kind` first, fields in schema order and
+ * `describes` last.
+ */
+export declare function normalizeSchemaGuard(guard: UnknownRecord, field: string, schema: GuardSchema, wire: boolean): UnknownRecord;
+/** Converts a guard to Plan JSON: bigint values become decimal strings and
+ * undefined members are omitted, at every depth, preserving key order.
+ */
+export declare function guardToWire(value: unknown): unknown;
+//# sourceMappingURL=plan-fields.d.ts.map

package/dist/internal/planning/plan-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-fields.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/plan-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAItD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,eAAO,MAAM,OAAO,wBAAsB,CAAC;AAK3C,yEAAyE;AACzE,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,aAAa,EAAE,MAAM,GACpB,KAAK,CAOP;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAKvE;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC/B,IAAI,CAWN;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAIlE;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;CACxB;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,kFAAkF;AAClF,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAEf,8DAA8D;AAC9D,MAAM,MAAM,eAAe,GAAG,SAAS;IACrC,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,cAAc;IACpB,QAAQ,CAAC,EAAE,IAAI;CAChB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC,CAAC,CAAC;IACzE,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC;IACnD,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAoGD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,OAAO,GACZ,aAAa,CA2Cf;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASnD"}

package/dist/internal/planning/plan-fields.js

@@ -0,0 +1,159 @@
+import { isAddress } from '@solana/kit';
+import { InvalidActionInputError } from '../../client/errors.js';
+export const MAX_U64 = 0xffffffffffffffffn;
+const DATA_HASH_PATTERN = /^[\da-f]{64}$/u;
+const UNSIGNED_DECIMAL = /^(0|[1-9][0-9]*)$/u;
+const SIGNED_DECIMAL = /^(0|-?[1-9][0-9]*)$/u;
+/** Rejects one Plan field with the shared recreate-or-hydrate remedy. */
+export function invalid(field, value, acceptedRange) {
+    throw new InvalidActionInputError(field, value, acceptedRange, 'Correct this Plan field and recreate or hydrate the Plan before retrying.');
+}
+export function readRecord(value, field) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return invalid(field, value, 'a plain object');
+    }
+    return value;
+}
+export function assertKeys(value, field, required, optional = []) {
+    const accepted = new Set([...required, ...optional]);
+    const missing = required.find((key) => !Object.hasOwn(value, key));
+    const unexpected = Object.keys(value).find((key) => !accepted.has(key));
+    if (missing !== undefined || unexpected !== undefined) {
+        invalid(field, missing === undefined ? unexpected : `missing ${missing}`, `exactly the fields ${[...required, ...optional].join(', ')}`);
+    }
+}
+export function readString(value, field) {
+    return typeof value === 'string' ? value : invalid(field, value, 'a string');
+}
+export function readAddress(value, field) {
+    return typeof value === 'string' && isAddress(value)
+        ? value
+        : invalid(field, value, 'a valid base58 Solana address');
+}
+const LABEL_ACCEPTED = 'a nonblank, NUL-free Unicode label of at most 64 UTF-8 bytes';
+function readLabel(value, field, fail) {
+    if (typeof value !== 'string')
+        return fail(field, value, 'a string');
+    const bytes = new TextEncoder().encode(value);
+    if (value.trim().length === 0 ||
+        value.includes('\0') ||
+        bytes.length > 64 ||
+        new TextDecoder('utf-8', { ignoreBOM: true }).decode(bytes) !== value)
+        fail(field, value, LABEL_ACCEPTED);
+    return value;
+}
+function readField(type, value, field, wire, fail) {
+    if (type === 'address')
+        return typeof value === 'string' && isAddress(value)
+            ? value
+            : fail(field, value, 'a valid base58 Solana address');
+    if (type === 'hash')
+        return typeof value === 'string' && DATA_HASH_PATTERN.test(value)
+            ? value
+            : fail(field, value, 'a lowercase 64-character SHA-256 hex digest');
+    if (type === 'string')
+        return typeof value === 'string' ? value : fail(field, value, 'a string');
+    if (type === 'text')
+        return typeof value === 'string' && value.trim().length > 0
+            ? value
+            : fail(field, value, 'a nonblank string');
+    if (type === 'label')
+        return readLabel(value, field, fail);
+    if ('values' in type)
+        return type.values.includes(value)
+            ? value
+            : fail(field, value, type.accepted);
+    if (typeof type.min === 'bigint') {
+        let parsed = value;
+        if (wire) {
+            const signed = type.min < 0n;
+            if (typeof value !== 'string' ||
+                !(signed ? SIGNED_DECIMAL : UNSIGNED_DECIMAL).test(value))
+                fail(field, value, signed
+                    ? 'a canonical decimal string'
+                    : 'a canonical unsigned decimal string');
+            parsed = BigInt(value);
+        }
+        return typeof parsed === 'bigint' &&
+            parsed >= type.min &&
+            parsed <= type.max
+            ? parsed
+            : fail(field, parsed, type.accepted);
+    }
+    const range = type;
+    return typeof value === 'number' &&
+        (range.finite ? Number.isFinite(value) : Number.isInteger(value)) &&
+        value >= range.min &&
+        value <= range.max
+        ? value
+        : fail(field, value, range.accepted);
+}
+/** Fields for the guard's `status` variant. The status is validated against
+ * its `status` field type before the exact-key check, and only own `byStatus`
+ * entries are used, so an inherited name such as `__proto__` is a typed status
+ * error, never a prototype lookup. A missing status is left to the exact-key
+ * check.
+ */
+function variantFields(guard, field, schema, wire, fail) {
+    const variants = schema.byStatus;
+    if (variants === undefined || !Object.hasOwn(guard, 'status'))
+        return [];
+    const [, type] = schema.fields.find(([key]) => key === 'status');
+    const status = readField(type, guard.status, `${field}.status`, wire, fail);
+    return typeof status === 'string' && Object.hasOwn(variants, status)
+        ? variants[status]
+        : [];
+}
+/** Validates one flat guard against its schema; `wire` decodes Plan JSON values.
+ * The result is frozen, with `kind` first, fields in schema order and
+ * `describes` last.
+ */
+export function normalizeSchemaGuard(guard, field, schema, wire) {
+    const fail = schema.error === undefined
+        ? invalid
+        : () => {
+            throw new InvalidActionInputError(String(guard.kind), guard, schema.error.accepted, schema.error.remedy);
+        };
+    const fields = [
+        ...schema.fields,
+        ...variantFields(guard, field, schema, wire, fail),
+    ];
+    // `describes` closes every guard, after any status-specific fields.
+    const entries = [
+        ...fields.filter(([key]) => key !== 'describes'),
+        ...fields.filter(([key]) => key === 'describes'),
+    ];
+    const keys = (optional) => entries.filter((entry) => (entry[2] === true) === optional).map(([k]) => k);
+    try {
+        assertKeys(guard, field, ['kind', ...keys(false)], keys(true));
+    }
+    catch (error) {
+        if (schema.error === undefined)
+            throw error;
+        fail(field, guard, 'exact guard fields');
+    }
+    const normalized = { kind: guard.kind };
+    for (const [key, type, optional] of entries) {
+        if (optional === true && guard[key] === undefined)
+            continue;
+        normalized[key] = readField(type, guard[key], `${field}.${key}`, wire, fail);
+    }
+    if (schema.check !== undefined && !schema.check(normalized))
+        fail(field, guard, 'internally consistent guard fields');
+    return Object.freeze(normalized);
+}
+/** Converts a guard to Plan JSON: bigint values become decimal strings and
+ * undefined members are omitted, at every depth, preserving key order.
+ */
+export function guardToWire(value) {
+    if (typeof value === 'bigint')
+        return String(value);
+    if (Array.isArray(value))
+        return value.map(guardToWire);
+    if (value === null || typeof value !== 'object')
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .filter(([, member]) => member !== undefined)
+        .map(([key, member]) => [key, guardToWire(member)]));
+}
+//# sourceMappingURL=plan-fields.js.map

package/dist/internal/planning/plan-fields.js.map

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

package/dist/internal/planning/plan-guards.d.ts

@@ -0,0 +1,4 @@
+import type { PlanPrecondition } from '../../planning/index.js';
+/** Validates one Plan guard; `wire` decodes its Plan JSON form. */
+export declare function normalizePrecondition(value: unknown, field: string, wire?: boolean): PlanPrecondition;
+//# sourceMappingURL=plan-guards.d.ts.map

package/dist/internal/planning/plan-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/plan-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAiVhE,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,UAAQ,GACX,gBAAgB,CAkBlB"}

package/dist/internal/planning/plan-guards.js

@@ -0,0 +1,175 @@
+import { normalizeArrivalGuard } from './arrival-guards.js';
+import { FLEET_DOCK_FUNDING_SCHEMA } from './fleet-dock-funding-guard.js';
+import { LOCAL_MARKET_ORDER_SCHEMA } from './local-market-order.js';
+import { MAX_U64, invalid, normalizeSchemaGuard, readRecord, } from './plan-fields.js';
+import { isRuntimeGuard, normalizeRuntimeGuard } from './runtime-guards.js';
+import { scanCompletionDiscriminators } from './scan-completion-guard.js';
+const U8 = {
+    min: 0,
+    max: 255,
+    accepted: 'an unsigned u8 integer',
+};
+const U16 = {
+    min: 0,
+    max: 65535,
+    accepted: 'an unsigned u16 integer',
+};
+const U32 = {
+    min: 0,
+    max: 4294967295,
+    accepted: 'an unsigned u32 integer',
+};
+const KEY_INDEX = { ...U16, accepted: 'a u16 Profile key index' };
+const SHIP_ID = {
+    ...U16,
+    accepted: 'a u16 ship configuration ID',
+};
+const CARGO_ID = { ...U16, accepted: 'a u16 cargo ID' };
+const U64 = {
+    min: 0n,
+    max: MAX_U64,
+    accepted: 'an unsigned u64 bigint',
+};
+const SEQUENCE = { ...U64, accepted: 'an unsigned u64 sequence' };
+const STARBASE_SEQUENCE = {
+    ...U64,
+    accepted: 'an unsigned u64 Starbase sequence',
+};
+const SYSTEM_GENERATION = {
+    ...U64,
+    accepted: 'an unsigned u64 System generation',
+};
+const CEILING = {
+    ...U64,
+    accepted: 'a nonnegative u64 funding ceiling',
+};
+const LAMPORTS = {
+    ...U64,
+    accepted: 'a nonnegative u64 lamport amount',
+};
+const address = (key) => [key, 'address'];
+const DESCRIBES = ['describes', 'string'];
+const AUTHORIZED = [
+    address('address'),
+    address('game'),
+    address('profile'),
+    address('authority'),
+    address('system'),
+    ['keyIndex', KEY_INDEX],
+];
+const FACTION_TRADE = [
+    address('address'),
+    address('game'),
+    ['factionId', U16],
+    ['schemaVersion', U8],
+    DESCRIBES,
+];
+const schema = (...fields) => ({
+    fields,
+});
+/** Every flat Plan guard kind; nested arrival and runtime guards keep their own readers. */
+const GUARD_SCHEMAS = {
+    'character-registration': schema(address('address'), address('game'), address('profile'), ['profileDataHash', 'hash'], address('funder'), address('xpBudget'), address('xpBudgetConfig'), ['maximumFunderDebit', CEILING], ['characterLamports', LAMPORTS], ['budgetLamports', LAMPORTS], [
+        'characterSize',
+        {
+            min: 423,
+            max: Number.MAX_SAFE_INTEGER,
+            accepted: 'a qualified Character allocation of at least 423 bytes',
+        },
+    ], ['initializationHash', 'hash'], DESCRIBES),
+    'ship-import-funding': schema(address('address'), address('game'), address('profile'), address('system'), ['shipId', SHIP_ID], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-attack': schema(address('address'), address('defender'), address('game'), address('profile'), address('defenderProfile'), ['instructionKey', 'string'], DESCRIBES),
+    'currency-cache': schema(address('address'), address('game'), DESCRIBES),
+    'movement-character': schema(address('address'), address('game'), address('profile'), ['stateHash', 'hash'], DESCRIBES),
+    'fleet-docking-policy': schema(address('address'), address('game'), address('system'), address('ownership'), DESCRIBES),
+    'starbase-system': schema(address('address'), address('game'), ['starbaseSequenceId', STARBASE_SEQUENCE], [
+        'requireCss',
+        {
+            values: [true],
+            accepted: 'true when CSS access is required, otherwise omitted',
+        },
+        true,
+    ], DESCRIBES),
+    'fleet-mining': schema(address('address'), address('game'), address('profile'), address('asteroid'), DESCRIBES),
+    'faction-treasury-buy-versioned': schema(...FACTION_TRADE, ['cargoId', CARGO_ID], ['floorRaw', U64]),
+    'faction-treasury-sell-versioned': schema(...FACTION_TRADE, ['atlasOutCapPerEpochRaw', U64], [
+        'epochLengthSeconds',
+        { min: -(1n << 63n), max: (1n << 63n) - 1n, accepted: 'an i64 bigint' },
+    ]),
+    'faction-epoch-meter-versioned': schema(...FACTION_TRADE),
+    'fleet-add-ship': schema(...AUTHORIZED, ['shipId', SHIP_ID], [
+        'amount',
+        {
+            min: 1n,
+            max: 255n,
+            accepted: 'a whole ship quantity from 1n through 255n',
+        },
+    ], ['maximumProfileDebit', CEILING], ['configHash', 'hash'], DESCRIBES),
+    'research-unlock': schema(...AUTHORIZED, address('starbasePlayer'), address('currencyCache'), ['nodeId', { ...U16, accepted: 'a u16 research node ID' }], [
+        'level',
+        { ...U32, min: 1, accepted: 'a u32 research node level of at least 1' },
+    ], [
+        'researchSequenceId',
+        { ...U32, accepted: 'a u32 research definition sequence' },
+    ], ['xpSequenceId', { ...U32, accepted: 'a u32 XP definition sequence' }], ['maximumAtlasDebit', CEILING], DESCRIBES),
+    'scan-completion': schema([
+        'operation',
+        {
+            values: Object.keys(scanCompletionDiscriminators),
+            accepted: 'a supported scan lifecycle operation',
+        },
+    ], ...[
+        'address',
+        'game',
+        'signal',
+        'profile',
+        'character',
+        'authority',
+        'policy',
+        'loot',
+        'xpBudget',
+        'xpConfig',
+    ].map(address), ['keyIndex', KEY_INDEX], ['status', { min: 1, max: 6, accepted: 'a current nonempty signal state' }], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'scan-detect': schema(...[
+        'address',
+        'game',
+        'profile',
+        'authority',
+        'character',
+        'signal',
+        'pattern',
+        'policy',
+        'loot',
+        'tracker',
+    ].map(address), ['keyIndex', KEY_INDEX], ['patternId', U16], ['focus', { min: 0, max: 4, accepted: 'a scan focus from 0 through 4' }], ['policyRevision', U32], ['profileRevision', U32], ['expectedSequence', SEQUENCE], ['configHash', 'hash'], DESCRIBES),
+    'fleet-crew-transfer': schema(['direction', { values: ['load', 'unload'], accepted: 'load or unload' }], ...AUTHORIZED.slice(0, 5), address('starbasePlayer'), ['count', { min: 1, max: 65535, accepted: 'a positive u16 crew count' }], ['keyIndex', KEY_INDEX], ['systemSequenceId', SYSTEM_GENERATION], DESCRIBES),
+    'fleet-respawn': schema(...AUTHORIZED, ['phase', { values: ['start', 'complete'], accepted: 'start or complete' }], ['fleetHash', 'hash'], ['maximumRecoveryFee', CEILING], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'scan-signal-open': schema(['authorityHash', 'hash'], ...['address', 'game', 'fleet', 'profile', 'authority', 'character'].map(address), ['keyIndex', KEY_INDEX], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'fleet-create': schema(...AUTHORIZED, ['label', 'label'], ['maximumProfileDebit', CEILING], DESCRIBES),
+    'system-account-or-absent': schema(address('address'), DESCRIBES),
+    'recipe-state': schema(address('address'), ['configHash', 'hash'], ['requiredUses', U64], DESCRIBES),
+    'token-mint': schema(address('address'), ['decimals', { ...U8, accepted: 'an unsigned u8 mint decimals value' }], DESCRIBES),
+    'game-ship-config': schema(address('address'), ['shipId', SHIP_ID], ['configHash', 'hash'], DESCRIBES),
+    'game-account': schema(address('address'), DESCRIBES),
+    'token-account': schema(address('address'), address('mint'), address('owner'), ['minimumBalance', U64], DESCRIBES),
+    'game-cargo-bytes-config': schema(address('address'), ['cargoId', CARGO_ID], ['configHash', 'hash'], DESCRIBES),
+    'cargo-cache': schema(address('address'), address('game'), ['bump', { ...U8, accepted: 'a u8 PDA bump' }], DESCRIBES),
+    'token-account-or-absent': schema(address('address'), address('mint'), address('owner'), DESCRIBES),
+    'account-absent': schema(address('address'), DESCRIBES),
+    'account-state': schema(address('address'), ['dataHash', 'hash'], DESCRIBES),
+    'fleet-dock-funding': FLEET_DOCK_FUNDING_SCHEMA,
+    'local-market-order': LOCAL_MARKET_ORDER_SCHEMA,
+};
+/** Validates one Plan guard; `wire` decodes its Plan JSON form. */
+export function normalizePrecondition(value, field, wire = false) {
+    const guard = readRecord(value, field);
+    if (guard.kind === 'fleet-arrival')
+        return normalizeArrivalGuard(guard, field, wire);
+    if (isRuntimeGuard(guard))
+        return normalizeRuntimeGuard(guard, field, wire);
+    const kind = guard.kind;
+    if (typeof kind !== 'string' || !Object.hasOwn(GUARD_SCHEMAS, kind))
+        return invalid(`${field}.kind`, kind, 'a supported current Plan guard; recreate the Plan using the current capability planner');
+    return normalizeSchemaGuard(guard, field, GUARD_SCHEMAS[kind], wire);
+}
+//# sourceMappingURL=plan-guards.js.map

package/dist/internal/planning/plan-guards.js.map

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

package/dist/internal/planning/profile-key.d.ts

@@ -0,0 +1,13 @@
+import type { Address } from '@solana/kit';
+import type { ProfileKeyData } from '../c4/identity.js';
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export declare function directProfileKey(keys: readonly ProfileKeyData[], keyIndex: number, authority: Address): ProfileKeyData | undefined;
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export declare function profileKeyExpired(key: ProfileKeyData, now: bigint): boolean;
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export declare function hasPermissionBit(key: ProfileKeyData, bit: bigint): boolean;
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export declare function grantsPermission(key: ProfileKeyData, scope: Address, bit: bigint): boolean;
+//# sourceMappingURL=profile-key.d.ts.map

package/dist/internal/planning/profile-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;+CAE+C;AAC/C,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,SAAS,cAAc,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,GACjB,cAAc,GAAG,SAAS,CAG5B;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAET"}

package/dist/internal/planning/profile-key.js

@@ -0,0 +1,20 @@
+/** The Profile key at `keyIndex` when it belongs to `authority`. Each planner
+ * keeps its own permission predicate and remedy; these helpers share only the
+ * key identity, expiry and scope mechanics. */
+export function directProfileKey(keys, keyIndex, authority) {
+    const key = keys[keyIndex];
+    return key?.address === authority ? key : undefined;
+}
+/** Whether the key expired before `now`; a negative expiry never expires. */
+export function profileKeyExpired(key, now) {
+    return key.expiresAtRaw >= 0n && key.expiresAtRaw < now;
+}
+/** Whether the key's permission mask holds `bit`, whatever its scope. */
+export function hasPermissionBit(key, bit) {
+    return (key.permissionsRaw & (1n << bit)) !== 0n;
+}
+/** Whether the key is scoped to `scope` and holds permission `bit` there. */
+export function grantsPermission(key, scope, bit) {
+    return key.scope === scope && hasPermissionBit(key, bit);
+}
+//# sourceMappingURL=profile-key.js.map

package/dist/internal/planning/profile-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-key.js","sourceRoot":"","sources":["../../../src/internal/planning/profile-key.ts"],"names":[],"mappings":"AAIA;;+CAE+C;AAC/C,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,QAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,OAAO,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,iBAAiB,CAAC,GAAmB,EAAE,GAAW;IAChE,OAAO,GAAG,CAAC,YAAY,IAAI,EAAE,IAAI,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;AAC1D,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,GAAmB,EAAE,GAAW;IAC/D,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,GAAmB,EACnB,KAAc,EACd,GAAW;IAEX,OAAO,GAAG,CAAC,KAAK,KAAK,KAAK,IAAI,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC"}

package/dist/internal/planning/recipe-state.d.ts

@@ -0,0 +1,9 @@
+import type { RawAccount } from '../../client/contracts.js';
+/** Preserve the complete pinned Recipe encoding except its shared usage counter. */
+export declare function hashRecipeConfiguration(account: RawAccount): Promise<string>;
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
+export declare function validateRecipeUsage(account: RawAccount, requiredUses: bigint): void;
+//# sourceMappingURL=recipe-state.d.ts.map

package/dist/internal/planning/recipe-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-state.d.ts","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAS5D,oFAAoF;AACpF,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,CAAC,CAKjB;AAED;;;0BAG0B;AAC1B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,MAAM,GACnB,IAAI,CAWN"}

package/dist/internal/planning/recipe-state.js

@@ -0,0 +1,23 @@
+import { SageSdkError } from '../../client/errors.js';
+import { readRecipeName, readRecipeUsage, RECIPE_USAGE_COUNT_OFFSET, } from '../c4/crafting.js';
+import { hashAccountState } from './account-state.js';
+/** Preserve the complete pinned Recipe encoding except its shared usage counter. */
+export async function hashRecipeConfiguration(account) {
+    readRecipeUsage(account);
+    const data = new Uint8Array(account.data);
+    data.fill(0, RECIPE_USAGE_COUNT_OFFSET, RECIPE_USAGE_COUNT_OFFSET + 8);
+    return hashAccountState(account.owner, data);
+}
+/** Each Crafting Process start consumes exactly one Recipe use, whatever its
+ * quantity; completing or cancelling an existing job reserves none. A Recipe is
+ * usable only while its usage count is below its limit, so a stored limit of
+ * `0` is never usable. */
+export function validateRecipeUsage(account, requiredUses) {
+    if (requiredUses === 0n)
+        return;
+    const recipe = readRecipeUsage(account);
+    const remaining = recipe.limit > recipe.count ? recipe.limit - recipe.count : 0n;
+    if (requiredUses > remaining)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Recipe ${readRecipeName(account) || account.address} usage limit has remaining ${remaining}, but a Crafting Process start requested ${requiredUses}. The Recipe's uses are exhausted; choose another active Recipe, then recreate the Plan before retrying.`, { address: account.address });
+}
+//# sourceMappingURL=recipe-state.js.map

package/dist/internal/planning/recipe-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipe-state.js","sourceRoot":"","sources":["../../../src/internal/planning/recipe-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,eAAe,EACf,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB;IAEnB,eAAe,CAAC,OAAO,CAAC,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,yBAAyB,EAAE,yBAAyB,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;0BAG0B;AAC1B,MAAM,UAAU,mBAAmB,CACjC,OAAmB,EACnB,YAAoB;IAEpB,IAAI,YAAY,KAAK,EAAE;QAAE,OAAO;IAChC,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,IAAI,YAAY,GAAG,SAAS;QAC1B,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,UAAU,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,8BAA8B,SAAS,4CAA4C,YAAY,0GAA0G,EAC7P,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAC7B,CAAC;AACN,CAAC"}

package/dist/internal/planning/rent-catalog.d.ts

@@ -0,0 +1,37 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import type { PlanPrecondition, PlanStep } from '../../planning/index.js';
+/** Baseline-record hints; the program reads them only under an Active catalog. */
+export declare const DISABLED_RENT_HINTS: readonly number[];
+export interface DisabledStakeRent {
+    readonly rentCatalog: Address;
+    readonly rentAuthority: Address;
+}
+export interface DisabledLevelRent {
+    readonly rentCatalog: Address;
+    readonly rentHead: Address;
+}
+/** Requires Disabled rent for an existing Claim Stake: neither the Game's rent
+ * catalog nor the stake's settlement authority exists. */
+export declare function requireDisabledStakeRent(ctx: SageContext, game: Address, stake: Address, action: string): Promise<{
+    readonly accounts: DisabledStakeRent;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Requires that a new Claim Stake address has no rent settlement authority. */
+export declare function requireNewStakeRent(ctx: SageContext, stake: Address): Promise<{
+    readonly rentAuthority: Address;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Requires Disabled rent for a Starbase-level change in `system`: neither the
+ * Game's rent catalog nor the System's level history head exists. */
+export declare function requireDisabledLevelRent(ctx: SageContext, game: Address, system: {
+    readonly address: Address;
+    readonly systemId: number;
+}, action: string): Promise<{
+    readonly accounts: DisabledLevelRent;
+    readonly guards: readonly PlanPrecondition[];
+}>;
+/** Binds every rent account of a recognized instruction to an absence guard
+ * and rejects rent pages, supplied optional rent accounts and nonzero hints. */
+export declare function validateRentInstructions(steps: readonly PlanStep[], guards: readonly PlanPrecondition[]): void;
+//# sourceMappingURL=rent-catalog.d.ts.map