@aephia/atlas-kit 0.6.0-next.1 → 0.6.0-next.100

package/dist/fleets/warp-lane-estimate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-estimate.js","sourceRoot":"","sources":["../../src/fleets/warp-lane-estimate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAkC5E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAiC;IAEjC,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,GAAG,iBAAiB,CAC3D,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,IAAI,GAAG,EAAE,EAC1D,WAAW,CACZ,CAAC;IACF,IAAI,kBAAkB,KAAK,EAAE;QAC3B,MAAM,IAAI,2BAA2B,CACnC,wBAAwB,EACxB,kBAAkB,EAClB,yMAAyM,CAC1M,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAClB,uBAAuB,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;QACvD,WAAW;QACX,eAAe,EACb,CAAC,kBAAkB,GAAG,aAAa,GAAG,EAAE,CAAC,GAAG,aAAa;QAC3D,SAAS,EAAE,EAAW;KACvB,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/fleets/warp-lane-policy.d.ts

@@ -0,0 +1,68 @@
+import type { FactionRegionData } from '../internal/c4/factions.js';
+import type { RiskZoneAccess } from '../internal/c4/identity.js';
+import type { WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Explicit lane policy inputs; destinationRegion must contain the destination coordinates.
+ * A System's stored region id alone does not establish this spatial relationship.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLanePolicyInput;
+ * console.log(input.destinationRegion.risk, input.securityZoneAccess);
+ * ```
+ */
+export interface FleetWarpLanePolicyInput {
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly destinationLevel: WorldStarbaseLevel;
+    readonly crossFactionEconomicsEnabled: boolean;
+    readonly destinationRegion: Pick<FactionRegionData, 'owner' | 'safety' | 'risk'>;
+    readonly securityZoneAccess: RiskZoneAccess;
+}
+/** A bounded policy failure, not a simulation or transaction error.
+ * @example
+ * ```ts
+ * const reason: FleetWarpLanePolicyFailure = 'foreign-low-risk';
+ * ```
+ */
+export type FleetWarpLanePolicyFailure = 'source-level-zero' | 'destination-level-zero' | 'cross-faction-disabled' | 'foreign-low-risk' | 'security-zone-access';
+/** Policy result only: passing never proves travel eligibility or affordability.
+ * @example
+ * ```ts
+ * declare const assessment: FleetWarpLanePolicy;
+ * console.log(assessment.passesPolicy, assessment.failures);
+ * ```
+ */
+export interface FleetWarpLanePolicy {
+    readonly passesPolicy: boolean;
+    readonly failures: readonly FleetWarpLanePolicyFailure[];
+    readonly effectiveRisk: FactionRegionData['risk'];
+    toJSON(): unknown;
+}
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export declare function deriveFleetWarpLanePolicy(input: FleetWarpLanePolicyInput): FleetWarpLanePolicy;
+//# sourceMappingURL=warp-lane-policy.d.ts.map

package/dist/fleets/warp-lane-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-policy.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhF;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,kBAAkB,CAAC;IAC9C,QAAQ,CAAC,4BAA4B,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAC9B,iBAAiB,EACjB,OAAO,GAAG,QAAQ,GAAG,MAAM,CAC5B,CAAC;IACF,QAAQ,CAAC,kBAAkB,EAAE,cAAc,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,MAAM,0BAA0B,GAClC,mBAAmB,GACnB,wBAAwB,GACxB,wBAAwB,GACxB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA2ErB"}

package/dist/fleets/warp-lane-policy.js

@@ -0,0 +1,91 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+/** Assesses qualified lane policy independently of Plan validation or execution.
+ * Both endpoint owners must equal Fleet faction when cross-faction economics is
+ * disabled. Both endpoint Starbases need nonzero levels. Stored low risk keeps
+ * its embedded faction; Safe medium/high becomes low risk of the region owner,
+ * while Border retains its tier. Foreign low risk rejects; higher tiers require
+ * sufficient Character access. Relationships and combat/territory gates do not
+ * block the tested lane policy.
+ *
+ * Only playable factions and known levels/tiers are supported. Resolve the
+ * region containing the destination coordinates before calling: this pure
+ * helper does not perform spatial lookup and does not trust a System region id
+ * on your behalf. It checks no connection, Fleet state, cooldown, crew, XP,
+ * permission, toll or available balance. Deployment 54356023 is the empirical
+ * scope; requalify on relevant game changes and simulate before signing.
+ * @example
+ * ```ts
+ * const result = deriveFleetWarpLanePolicy({
+ *   fleetFaction: 'oni', sourceOwner: 'oni', destinationOwner: 'oni',
+ *   sourceLevel: 'css', destinationLevel: 'level-1',
+ *   crossFactionEconomicsEnabled: false, securityZoneAccess: 'low',
+ *   destinationRegion: { owner: 'oni', safety: 'safe',
+ *     risk: { kind: 'low', faction: 'oni' } },
+ * }); // passesPolicy: true; still simulate the actual Plan
+ * ```
+ */
+export function deriveFleetWarpLanePolicy(input) {
+    const invalid = (field, value) => {
+        throw new InvalidDerivationInputError(field, value, 'Use current playable-faction ownership, known Starbase levels and the region containing the destination coordinates, with current Character access. Unknown or NPC policy is not qualified; refresh and simulate the lane Plan.');
+    };
+    const playable = (field, faction) => {
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    };
+    playable('Fleet faction', input.fleetFaction);
+    playable('Source owner', input.sourceOwner);
+    playable('Destination owner', input.destinationOwner);
+    playable('Destination region owner', input.destinationRegion.owner);
+    const levels = [
+        'level-0',
+        'level-1',
+        'level-2',
+        'level-3',
+        'level-4',
+        'level-5',
+        'css',
+    ];
+    if (!levels.includes(input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    if (!levels.includes(input.destinationLevel))
+        invalid('Destination Starbase level', input.destinationLevel);
+    if (typeof input.crossFactionEconomicsEnabled !== 'boolean')
+        invalid('Cross-faction flag type', typeof input.crossFactionEconomicsEnabled);
+    const { risk, safety, owner } = input.destinationRegion;
+    if (safety !== 'safe' && safety !== 'border')
+        invalid('Region safety', safety);
+    const kind = risk.kind;
+    if (kind !== 'low' && kind !== 'medium' && kind !== 'high')
+        invalid('Region risk', kind);
+    if (risk.kind === 'low')
+        playable('Low-risk faction', risk.faction);
+    const tiers = { low: 0, medium: 1, high: 2 };
+    if (!Object.hasOwn(tiers, input.securityZoneAccess))
+        invalid('Character security-zone access', input.securityZoneAccess);
+    const effectiveRisk = Object.freeze(risk.kind === 'low'
+        ? { ...risk }
+        : safety === 'safe'
+            ? { kind: 'low', faction: owner }
+            : { ...risk });
+    const failures = [];
+    if (input.sourceLevel === 'level-0')
+        failures.push('source-level-zero');
+    if (input.destinationLevel === 'level-0')
+        failures.push('destination-level-zero');
+    if (!input.crossFactionEconomicsEnabled &&
+        (input.sourceOwner !== input.fleetFaction ||
+            input.destinationOwner !== input.fleetFaction))
+        failures.push('cross-faction-disabled');
+    if (effectiveRisk.kind === 'low' &&
+        effectiveRisk.faction !== input.fleetFaction)
+        failures.push('foreign-low-risk');
+    if (tiers[effectiveRisk.kind] > tiers[input.securityZoneAccess])
+        failures.push('security-zone-access');
+    return Object.freeze(attachJsonSerialization({
+        passesPolicy: failures.length === 0,
+        failures: Object.freeze(failures),
+        effectiveRisk,
+    }));
+}
+//# sourceMappingURL=warp-lane-policy.js.map

package/dist/fleets/warp-lane-policy.js.map

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

package/dist/fleets/warp-lane-toll.d.ts

@@ -0,0 +1,55 @@
+import type { FactionRelationship } from '../internal/c4/factions.js';
+import type { WorldConnectionCosts, WorldFaction, WorldStarbaseLevel } from '../internal/c4/world.js';
+/** Current source connection costs, ownership and Character fee modifier.
+ * destinationRelationship is Fleet-to-destination-owner, not endpoint-to-endpoint.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * console.log(input.sourceLevel, input.feeModifierRaw);
+ * ```
+ */
+export interface FleetWarpLaneTollInput {
+    readonly costs: Pick<WorldConnectionCosts, 'level1Raw' | 'level2Raw' | 'level3Raw' | 'level4Raw' | 'level5Raw' | 'cssRaw'>;
+    readonly sourceLevel: WorldStarbaseLevel;
+    readonly fleetFaction: WorldFaction;
+    readonly sourceOwner: WorldFaction;
+    readonly destinationOwner: WorldFaction;
+    readonly destinationRelationship: FactionRelationship;
+    readonly feeModifierRaw: bigint;
+    readonly alliedTollBps: number;
+    readonly neutralTollBps: number;
+}
+/** Character's prospective ATLAS debit, entirely in raw ATLAS units (Floyds).
+ * @example
+ * ```ts
+ * declare const toll: FleetWarpLaneToll;
+ * console.log(toll.modifiedBaseRaw, toll.surchargeRaw, toll.totalRaw);
+ * ```
+ */
+export interface FleetWarpLaneToll {
+    readonly baseRaw: bigint;
+    readonly modifiedBaseRaw: bigint;
+    readonly surchargeRaw: bigint;
+    readonly totalRaw: bigint;
+    toJSON(): unknown;
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export declare function deriveFleetWarpLaneToll(input: FleetWarpLaneTollInput): FleetWarpLaneToll;
+//# sourceMappingURL=warp-lane-toll.d.ts.map

package/dist/fleets/warp-lane-toll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warp-lane-toll.d.ts","sourceRoot":"","sources":["../../src/fleets/warp-lane-toll.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAGjC;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAClB,oBAAoB,EAClB,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,WAAW,GACX,QAAQ,CACX,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,QAAQ,CAAC,uBAAuB,EAAE,mBAAmB,CAAC;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC;CACnB;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CAyDnB"}

package/dist/fleets/warp-lane-toll.js

@@ -0,0 +1,79 @@
+import { InvalidDerivationInputError } from '../client/index.js';
+import { attachJsonSerialization } from '../internal/json.js';
+const amountMax = (1n << 64n) - 1n;
+const modifierScale = 1n << 32n;
+const remedy = 'Refresh the source connection, source Starbase level, playable Fleet/Starbase factions, Fleet-to-destination relationship, fee modifier and toll basis points. Only qualified nonnegative values and a u64 ATLAS debit are supported; simulate the lane Plan before signing.';
+function invalid(field, value) {
+    throw new InvalidDerivationInputError(field, value, remedy);
+}
+/** Estimates the Character ATLAS toll using deployment-54356023 lane rules.
+ * Selects cost by departure level. Ceils the Character-modified base, then adds
+ * a separately floored surcharge on the unmodified base if either endpoint is
+ * foreign. Allied uses allied bps; neutral/hostile/ceasefire use neutral bps.
+ * A foreign source with own destination uses neutral bps. Modifier zero waives
+ * only the modified base. Relationship expiry does not alter the measured toll.
+ *
+ * Accepts playable factions only, usable source levels, u64 raw base cost,
+ * nonnegative i64 raw I32F32 modifier, and u16 bps. Rejects a result beyond u64.
+ * No RPC, balance, connection, region, permission or execution checks occur.
+ * ATLAS is paid from Character, not wallet. Requalify after program changes.
+ * @example
+ * ```ts
+ * declare const input: FleetWarpLaneTollInput;
+ * const toll = deriveFleetWarpLaneToll(input);
+ * console.log(toll.totalRaw);
+ * ```
+ */
+export function deriveFleetWarpLaneToll(input) {
+    for (const [field, faction] of [
+        ['Fleet faction', input.fleetFaction],
+        ['Source owner', input.sourceOwner],
+        ['Destination owner', input.destinationOwner],
+    ])
+        if (faction !== 'mud' && faction !== 'oni' && faction !== 'ustur')
+            invalid(field, faction);
+    const levelKeys = {
+        'level-1': 'level1Raw',
+        'level-2': 'level2Raw',
+        'level-3': 'level3Raw',
+        'level-4': 'level4Raw',
+        'level-5': 'level5Raw',
+        css: 'cssRaw',
+    };
+    if (!Object.hasOwn(levelKeys, input.sourceLevel))
+        invalid('Source Starbase level', input.sourceLevel);
+    const baseRaw = input.costs[levelKeys[input.sourceLevel]];
+    if (baseRaw < 0n || baseRaw > amountMax)
+        invalid('Base ATLAS toll raw', baseRaw);
+    if (input.feeModifierRaw < 0n || input.feeModifierRaw > (1n << 63n) - 1n)
+        invalid('Character lane fee modifier raw', input.feeModifierRaw);
+    for (const [field, bps] of [
+        ['Allied toll bps', input.alliedTollBps],
+        ['Neutral toll bps', input.neutralTollBps],
+    ])
+        if (!Number.isInteger(bps) || bps < 0 || bps > 65535)
+            invalid(field, bps);
+    const relation = input.destinationRelationship;
+    if (relation !== 'allied' &&
+        relation !== 'neutral' &&
+        relation !== 'hostile' &&
+        relation !== 'ceasefire')
+        invalid('Destination relationship', relation);
+    const crossFaction = input.sourceOwner !== input.fleetFaction ||
+        input.destinationOwner !== input.fleetFaction;
+    const bps = input.destinationOwner !== input.fleetFaction && relation === 'allied'
+        ? input.alliedTollBps
+        : input.neutralTollBps;
+    const modifiedBaseRaw = (baseRaw * input.feeModifierRaw + modifierScale - 1n) / modifierScale;
+    const surchargeRaw = crossFaction ? (baseRaw * BigInt(bps)) / 10000n : 0n;
+    const totalRaw = modifiedBaseRaw + surchargeRaw;
+    if (totalRaw > amountMax)
+        invalid('Total ATLAS toll raw', totalRaw);
+    return Object.freeze(attachJsonSerialization({
+        baseRaw,
+        modifiedBaseRaw,
+        surchargeRaw,
+        totalRaw,
+    }));
+}
+//# sourceMappingURL=warp-lane-toll.js.map

package/dist/fleets/warp-lane-toll.js.map

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

package/dist/identity/actions/create-profile.d.ts

@@ -0,0 +1,56 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import { type Plan } from '../../planning/index.js';
+/** One explicitly scoped key and its exact unsigned 64-bit permission mask.
+ * `expiresAt` is a nonnegative Unix timestamp in seconds; omission means no expiry.
+ * Profile AUTH keys must omit expiry and must be directly signing addresses.
+ * @example
+ * ```ts
+ * declare const authority: Address;
+ * declare const playerProfileProgram: Address;
+ * const key: ProfileCreationKeyInput = {address: authority, scope: playerProfileProgram, permissionsRaw: 1n};
+ * ```
+ */
+export interface ProfileCreationKeyInput {
+    readonly address: Address;
+    readonly scope: Address;
+    readonly permissionsRaw: bigint;
+    readonly expiresAt?: bigint;
+}
+/** Explicit storage funder, ordered keys, and protected Profile update threshold.
+ * No permissions or threshold are selected automatically.
+ * @example
+ * ```ts
+ * declare const funder: Address;
+ * declare const keys: readonly ProfileCreationKeyInput[];
+ * const options: PlanCreateProfileOptions = {funder, keys, keyThreshold: 1};
+ * ```
+ */
+export interface PlanCreateProfileOptions {
+    readonly funder: Address;
+    readonly keys: readonly ProfileCreationKeyInput[];
+    readonly keyThreshold: number;
+}
+/** Plans a new signer-created Profile with explicit scoped permissions.
+ * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
+ * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
+ * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
+ * Existing target accounts and a Profile address equal to its funder are rejected.
+ * No Game load, onboarding, funding top-up, key generation or signing is implicit.
+ * Storage rent, balances and final creation remain chain-authoritative. Simulate
+ * before requesting signatures; after confirmed execution, read `getProfile` and
+ * verify the exact keys, scopes, permission masks and threshold.
+ * @example
+ * ```ts
+ * import {planCreateProfile} from '@aephia/atlas-kit/identity/actions';
+ * declare const ctx: SageContext;
+ * declare const profileAddress: Address;
+ * declare const options: PlanCreateProfileOptions;
+ * const plan = await planCreateProfile(ctx, profileAddress, options);
+ * console.log(plan.summary, plan.requiredSigners);
+ * ```
+ */
+export declare function planCreateProfile(ctx: SageContext, profileAddress: Address, input: PlanCreateProfileOptions): Promise<Plan>;
+//# sourceMappingURL=create-profile.d.ts.map

package/dist/identity/actions/create-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-profile.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/create-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAyID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/identity/actions/create-profile.js

@@ -0,0 +1,139 @@
+import { isAddress, isOffCurveAddress } from '@solana/kit';
+import { InvalidActionInputError, SageSdkError } from '../../client/errors.js';
+import { readContextRawAccounts } from '../../client/reconciliation.js';
+import { createProfileInstruction, isProfileCreationAuthority, } from '../../internal/c4/profile-creation.js';
+import { createPlan } from '../../planning/index.js';
+function invalid(field, value, remedy) {
+    throw new InvalidActionInputError(field, value, 'explicit valid Profile creation input', remedy);
+}
+function record(value, field, allowed) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        invalid(field, value, 'Pass an address-only options object for Profile creation.');
+    const result = value;
+    if (Object.keys(result).some((key) => !allowed.includes(key)))
+        invalid(field, value, 'Remove unrecognized fields and signer objects; specify only the documented Profile creation fields.');
+    return result;
+}
+function validAddress(value, field, signer) {
+    if (typeof value !== 'string' ||
+        !isAddress(value) ||
+        (signer && isOffCurveAddress(value)))
+        invalid(field, value, signer
+            ? 'Supply the address of a directly signing external z.ink/Solana account.'
+            : 'Supply a valid z.ink/Solana account address.');
+    return value;
+}
+function options(input) {
+    const raw = record(input, 'options', ['funder', 'keys', 'keyThreshold']);
+    const funder = validAddress(raw.funder, 'options.funder', true);
+    if (!Array.isArray(raw.keys) || raw.keys.length === 0)
+        invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
+    const seen = new Set();
+    const keys = [];
+    for (const [index, value] of raw.keys.entries()) {
+        const path = `options.keys[${index}]`;
+        const key = record(value, path, [
+            'address',
+            'scope',
+            'permissionsRaw',
+            'expiresAt',
+        ]);
+        const address = validAddress(key.address, `${path}.address`, false);
+        const scope = validAddress(key.scope, `${path}.scope`, false);
+        const permissionsRaw = key.permissionsRaw;
+        if (typeof permissionsRaw !== 'bigint' ||
+            permissionsRaw < 0n ||
+            permissionsRaw > 0xffffffffffffffffn)
+            invalid(`${path}.permissionsRaw`, permissionsRaw, 'Supply an explicit bigint permission mask from 0n through 18446744073709551615n.');
+        const expiresAt = key.expiresAt;
+        if (expiresAt !== undefined &&
+            (typeof expiresAt !== 'bigint' ||
+                expiresAt < 0n ||
+                expiresAt > 0x7fffffffffffffffn))
+            invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for a permanent key, or supply nonnegative bigint Unix seconds within the signed 64-bit range.');
+        const captured = {
+            address,
+            scope,
+            permissionsRaw,
+            ...(expiresAt === undefined ? {} : { expiresAt }),
+        };
+        if (isProfileCreationAuthority(captured)) {
+            validAddress(address, `${path}.address`, true);
+            if (expiresAt !== undefined)
+                invalid(`${path}.expiresAt`, expiresAt, 'Omit expiry for every Player Profile AUTH key.');
+        }
+        const identity = `${address}:${scope}`;
+        if (seen.has(identity))
+            invalid(path, address, 'Remove duplicate address/scope pairs; distinct scopes may reuse one key address.');
+        seen.add(identity);
+        keys.push(captured);
+    }
+    const authCount = keys.filter(isProfileCreationAuthority).length;
+    if (authCount === 0)
+        invalid('options.keys', raw.keys, 'Specify at least one non-expiring Player Profile AUTH key.');
+    const keyThreshold = raw.keyThreshold;
+    if (typeof keyThreshold !== 'number' ||
+        !Number.isInteger(keyThreshold) ||
+        keyThreshold < 1 ||
+        keyThreshold > 255 ||
+        keyThreshold > authCount)
+        invalid('options.keyThreshold', keyThreshold, 'Set an explicit integer threshold from 1 through the number of distinct Player Profile AUTH keys, no greater than 255.');
+    return { funder, keys, keyThreshold };
+}
+/** Plans a new signer-created Profile with explicit scoped permissions.
+ * The new Profile, storage funder, and every Player Profile AUTH key sign creation,
+ * even when the editing threshold is lower. Other keys remain readonly.
+ * The new Profile signer is needed only for creation unless explicitly listed
+ * among the initial authority keys; creating the account does not grant it AUTH.
+ * The threshold governs protected Profile updates; it is not a gameplay-wide multisig policy.
+ * Existing target accounts and a Profile address equal to its funder are rejected.
+ * No Game load, onboarding, funding top-up, key generation or signing is implicit.
+ * Storage rent, balances and final creation remain chain-authoritative. Simulate
+ * before requesting signatures; after confirmed execution, read `getProfile` and
+ * verify the exact keys, scopes, permission masks and threshold.
+ * @example
+ * ```ts
+ * import {planCreateProfile} from '@aephia/atlas-kit/identity/actions';
+ * declare const ctx: SageContext;
+ * declare const profileAddress: Address;
+ * declare const options: PlanCreateProfileOptions;
+ * const plan = await planCreateProfile(ctx, profileAddress, options);
+ * console.log(plan.summary, plan.requiredSigners);
+ * ```
+ */
+export async function planCreateProfile(ctx, profileAddress, input) {
+    const profile = validAddress(profileAddress, 'profileAddress', true);
+    // Capture every nested scalar before the first await; caller edits cannot change authority.
+    const captured = options(input);
+    if (profile === captured.funder)
+        invalid('profileAddress', profile, 'Use a fresh Profile signer address distinct from the storage funder; do not convert the funding wallet into a Profile.');
+    const [existing] = await readContextRawAccounts(ctx, [profile]);
+    if (existing)
+        throw new SageSdkError('ACTION_PRECONDITION_FAILED', `Profile target ${profile} already exists. Read an existing Profile with getProfile, or select a fresh signer address; creation is not idempotent.`, { address: profile });
+    const summary = `Create Profile ${profile} with ${captured.keys.length} explicitly scoped keys and protected Profile update threshold ${captured.keyThreshold}. ${captured.keys.map((key, index) => `Key ${index}: address ${key.address}, scope ${key.scope}, permissionsRaw ${key.permissionsRaw} (0x${key.permissionsRaw.toString(16)}), expiresAt ${key.expiresAt === undefined ? 'never' : key.expiresAt}, role ${isProfileCreationAuthority(key) ? 'Profile AUTH signer' : 'readonly key'}.`).join(' ')} Review these exact scoped permission masks; the threshold does not establish gameplay-wide multisig. Funder ${captured.funder} pays storage rent; transaction fees are separate. The Profile, funder and every Profile AUTH key sign creation. Rent, balances and final creation remain chain-authoritative: simulate before signing, then use getProfile after confirmed execution to verify keys, scopes, permissionsRaw and keyThreshold. No other onboarding or balance top-up is included.`;
+    return createPlan({
+        kind: 'identity.create-profile',
+        summary,
+        preconditions: [
+            {
+                kind: 'account-absent',
+                address: profile,
+                describes: `New Profile ${profile} remains absent; if another transaction creates it, read and inspect it before proceeding.`,
+            },
+        ],
+        steps: [
+            {
+                describes: summary,
+                signers: [
+                    captured.funder,
+                    profile,
+                    ...captured.keys
+                        .filter(isProfileCreationAuthority)
+                        .map((key) => key.address),
+                ],
+                instruction: createProfileInstruction({ profile, ...captured }),
+            },
+        ],
+    });
+}
+//# sourceMappingURL=create-profile.js.map

package/dist/identity/actions/create-profile.js.map

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

package/dist/identity/actions/index.d.ts

@@ -0,0 +1,38 @@
+import { type Address } from '@solana/kit';
+import type { SageContext } from '../../client/contracts.js';
+import { type Plan } from '../../planning/index.js';
+/** Address of the external signer that will fund Character account storage.
+ * Character registration has no Profile-authority or faction signer role.
+ * @example
+ * ```ts
+ * declare const funder: Address;
+ * const options:PlanRegisterCharacterOptions={funder};
+ * ```
+ */
+export interface PlanRegisterCharacterOptions {
+    readonly funder: Address;
+}
+/** Plans creation of an existing Profile's canonical Character in the configured Game.
+ * Only the explicit storage funder signs. The Profile's authority and faction
+ * enrollment are not prerequisites for this instruction. Planning never creates
+ * an account, signs, submits, or retains a signer. Existing Characters are rejected;
+ * reuse them through `getCharacterForProfile` or `maybeGetCharacterForProfile`.
+ * New Plans bind the current Game-2 Character and Career XP creation intent.
+ * The canonical accounts, absence, storage pricing, and funder balance are
+ * revalidated before signing. Final creation remains chain-authoritative. Simulate
+ * before signing and read the Character after confirmed execution to verify its
+ * exact Profile/Game identity. Submission alone does not prove creation.
+ * @example
+ * ```ts
+ * import {planRegisterCharacter} from '@aephia/atlas-kit/identity/actions';
+ * import type {SageContext,Address} from '@aephia/atlas-kit/client';
+ * declare const ctx:SageContext;
+ * declare const profileAddress:Address;
+ * declare const funder:Address;
+ * const plan=await planRegisterCharacter(ctx,profileAddress,{funder});
+ * console.log(plan.summary,plan.requiredSigners);
+ * ```
+ */
+export declare function planRegisterCharacter(ctx: SageContext, profileAddress: Address, input: PlanRegisterCharacterOptions): Promise<Plan>;
+export { planCreateProfile, type PlanCreateProfileOptions, type ProfileCreationKeyInput, } from './create-profile.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/identity/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/identity/actions/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAY7D,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AA+BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,OAAO,EACvB,KAAK,EAAE,4BAA4B,GAClC,OAAO,CAAC,IAAI,CAAC,CAsHf;AAED,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}