firedrill-run 2.2.4 → 3.0.0

package/dist/contracts/tool-setup-proposal.js

@@ -0,0 +1,59 @@
+import { nativeMetadataCanonical } from './local-value-source-contracts.js';
+import { toolGroupMatches } from './tool-group-contracts.js';
+const uuid = (v) => typeof v === 'string' && /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/.test(v);
+const sha = (v) => typeof v === 'string' && /^[a-f0-9]{64}$/.test(v);
+const text = (v, maximum, empty = false) => typeof v === 'string'
+    && (empty || v.length > 0) && v.length <= maximum && !/[\x00-\x1f\x7f]/.test(v);
+const int = (v, minimum) => typeof v === 'number' && Number.isSafeInteger(v) && v >= minimum;
+const keys = (v, names) => Object.keys(v).sort().join(',') === names.split(',').sort().join(',');
+const object = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+function selection(v) {
+    if (!object(v))
+        return false;
+    return (v.release_id === null && uuid(v.implementation_id) || uuid(v.release_id) && v.implementation_id === null)
+        && (v.dataset_id === null || v.release_id === null && uuid(v.dataset_id));
+}
+export function toolSetupProposalId(value) {
+    return object(value) && value.schema === 'firedrill.tool-setup-proposal.v1' && uuid(value.tool_setup_proposal_id)
+        ? value.tool_setup_proposal_id : null;
+}
+export function toolSetupRequestCanonical(request) { return nativeMetadataCanonical(request); }
+export async function toolSetupRequestDigest(request) {
+    const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(toolSetupRequestCanonical(request)));
+    return Array.from(new Uint8Array(digest), n => n.toString(16).padStart(2, '0')).join('');
+}
+export function checkedToolSetupProposal(value) {
+    const invalid = () => new Error('tool_setup_proposal_invalid');
+    if (!object(value) || !keys(value, 'schema,id,actor_id,world_id,workspace_id,title,source_id,world_revision,configuration_revision,request,request_sha256,available,current,can_review,requires_user_approval,runtime_started,consent_granted,selection_choices,setup_request_key,setup')
+        || value.schema !== 'firedrill.tool-setup-proposal.v1'
+        || ![value.id, value.actor_id, value.world_id, value.workspace_id, value.source_id].every(uuid)
+        || value.setup_request_key !== value.id || !text(value.title, 160) || !int(value.world_revision, 1)
+        || !int(value.configuration_revision, 0) || !sha(value.request_sha256)
+        || value.available !== true || typeof value.current !== 'boolean' || typeof value.can_review !== 'boolean' || value.can_review && !value.current
+        || value.requires_user_approval !== true || value.runtime_started !== false || value.consent_granted !== false)
+        throw invalid();
+    const request = value.request;
+    if (!object(request) || !keys(request, 'name,duration_seconds,selections') || !text(request.name, 120)
+        || !int(request.duration_seconds, 60) || !Array.isArray(request.selections) || request.selections.length < 1
+        || request.selections.length > 10000 || !request.selections.every(v => selection(v) && keys(v, 'release_id,implementation_id,dataset_id'))
+        || new Set(request.selections.map(v => v.release_id ?? v.implementation_id)).size !== request.selections.length
+        || !Array.isArray(value.selection_choices) || value.selection_choices.length !== request.selections.length)
+        throw invalid();
+    for (let i = 0; i < value.selection_choices.length; i++) {
+        const c = value.selection_choices[i], selected = request.selections[i];
+        if (!object(c) || !keys(c, 'release_id,implementation_id,dataset_id,name,version,description,archive_sha256,bundle_digest,contract_digest,interfaces,visual_interface,dataset_name')
+            || !selection(c) || c.release_id !== selected.release_id || c.implementation_id !== selected.implementation_id || c.dataset_id !== selected.dataset_id
+            || !text(c.name, 120) || !text(c.version, 80) || !text(c.description, 500, true)
+            || !sha(c.archive_sha256) || !sha(c.contract_digest) || typeof c.bundle_digest !== 'string' || !/^sha256:[a-f0-9]{64}$/.test(c.bundle_digest)
+            || !Array.isArray(c.interfaces) || c.interfaces.length < 1 || c.interfaces.length > 2
+            || new Set(c.interfaces).size !== c.interfaces.length || !c.interfaces.every(v => v === 'http' || v === 'mcp')
+            || typeof c.visual_interface !== 'boolean' || c.dataset_name !== null && !text(c.dataset_name, 120))
+            throw invalid();
+    }
+    const row = value;
+    if (row.setup !== null && (!toolGroupMatches(row.setup, { workspace: row.workspace_id, actor: row.actor_id }, { key: row.id })
+        || row.setup.name !== row.request.name || row.setup.duration_seconds !== row.request.duration_seconds
+        || row.setup.counts.selected !== row.request.selections.length || row.can_review))
+        throw invalid();
+    return row;
+}

package/dist/contracts/tool-state-contracts.js

@@ -0,0 +1,79 @@
+import { sessionStateCounter } from './session-state-contracts.js';
+export { toolCommandScope as toolStateScope } from './tool-command-contracts.js';
+const uuid = /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/;
+const positive = (value) => sessionStateCounter(value) !== null && value !== '0';
+const optionalId = (value) => value === null || uuid.test(value);
+const duration = (value) => value === null || Number.isSafeInteger(value) && value >= 60;
+const scopes = ['owned_postgres_rows_sequences', 'declared_sqlite_files', 'owned_postgres_and_declared_sqlite_files', 'declared_stateless'];
+export function toolStateRead(value, matches) {
+    if (!matches)
+        throw new Error('The saved-data response did not match this instance or original request. Inspect its retained history.');
+    return value;
+}
+function sameInstance(value, scope) {
+    return !!value && uuid.test(scope.workspace) && uuid.test(scope.instance)
+        && value.workspace_id === scope.workspace && value.instance_id === scope.instance;
+}
+export function toolCheckpointMatches(value, scope, id) {
+    return sameInstance(value, scope) && uuid.test(value.id) && (!id || value.id === id) && positive(value.state_epoch)
+        && sessionStateCounter(value.completed_command_sequence) !== null && ['baseline', 'closing', 'manual'].includes(value.kind)
+        && ['retained', 'unavailable'].includes(value.state) && (value.scope === null || scopes.includes(value.scope))
+        && (!value.available || value.state === 'retained' && value.scope !== null)
+        && [value.records.collection_count, value.records.record_count].every(one => one === null || Number.isSafeInteger(one) && one >= 0)
+        && (!value.records.available || value.available && value.scope !== 'declared_stateless'
+            && value.records.collection_count !== null && value.records.record_count !== null);
+}
+function requestMatches(value, scope, selected) {
+    return sameInstance(value, scope) && [value.id, value.actor_id, value.request_key].every(one => uuid.test(one))
+        && /^[a-f0-9]{64}$/.test(value.request_digest) && (!selected.id || value.id === selected.id)
+        && (!selected.digest || value.request_digest === selected.digest)
+        && (!selected.key || value.request_key === selected.key && value.actor_id === scope.actor);
+}
+export function toolCaptureMatches(value, scope, selected = {}) {
+    return requestMatches(value, scope, selected) && positive(value.state_epoch) && optionalId(value.checkpoint_id)
+        && ['queued', 'publishing', 'accepted', 'captured', 'unavailable', 'canceled'].includes(value.state)
+        && Boolean(value.finished_at) === ['captured', 'unavailable', 'canceled'].includes(value.state)
+        && (value.state !== 'captured' || value.checkpoint_id !== null)
+        && (!value.checkpoint_available || value.state === 'captured' && value.checkpoint_id !== null);
+}
+export function toolTransitionMatches(value, scope, selected = {}) {
+    const input = selected.input;
+    return requestMatches(value, scope, selected) && uuid.test(value.checkpoint_id) && optionalId(value.successor_id)
+        && ['waiting', 'starting', 'completed', 'failed'].includes(value.state) && ['reset', 'restore', 'fork', 'resume'].includes(value.action)
+        && value.request?.action === value.action && optionalId(value.request.checkpoint_id) && uuid.test(value.request.usage_quote_id) && duration(value.request.duration_seconds)
+        && (value.request.checkpoint_id === null || value.request.checkpoint_id === value.checkpoint_id)
+        && Number.isSafeInteger(value.duration_seconds) && value.duration_seconds >= 60
+        && (value.request.duration_seconds === null || value.duration_seconds === value.request.duration_seconds)
+        && Boolean(value.finished_at) === ['completed', 'failed'].includes(value.state)
+        && (value.state !== 'completed' || value.successor_id !== null)
+        && value.previous_connections_closed === (value.action !== 'fork') && value.new_connection_required === true
+        && (!input || input.action === value.request.action && input.checkpoint_id === value.request.checkpoint_id
+            && input.duration_seconds === value.request.duration_seconds && input.usage_quote_id === value.request.usage_quote_id);
+}
+async function originalDigest(value) {
+    const bytes = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(JSON.stringify(value)));
+    return Array.from(new Uint8Array(bytes), one => one.toString(16).padStart(2, '0')).join('');
+}
+export async function toolCaptureAccepted(value, scope, selected) {
+    return toolCaptureMatches(value, scope, selected) && value.request_digest === await originalDigest({ instance_id: scope.instance });
+}
+export async function toolTransitionAccepted(value, scope, selected) {
+    const input = selected.input ?? value.request;
+    return toolTransitionMatches(value, scope, selected) && value.request_digest === await originalDigest({
+        action: input.action, checkpoint_id: input.checkpoint_id, duration_seconds: input.duration_seconds, usage_quote_id: input.usage_quote_id
+    });
+}
+function pageMatches(value, scope, query, page) {
+    return sameInstance(value, scope) && value.query === query.trim() && Number.isSafeInteger(value.page) && value.page >= 1
+        && (page === undefined || page === value.page) && Number.isSafeInteger(value.page_size) && value.page_size >= 1 && value.page_size <= 100
+        && Number.isSafeInteger(value.count) && value.count >= 0 && value.results.length <= value.page_size;
+}
+export function toolCheckpointsMatch(value, scope, query = '', page) {
+    return pageMatches(value, scope, query, page) && value.results.every(row => toolCheckpointMatches(row, scope));
+}
+export function toolCapturesMatch(value, scope, query = '', page) {
+    return pageMatches(value, scope, query, page) && value.results.every(row => toolCaptureMatches(row, scope));
+}
+export function toolTransitionsMatch(value, scope, query = '', page) {
+    return pageMatches(value, scope, query, page) && value.results.every(row => toolTransitionMatches(row, scope));
+}

package/dist/contracts/trial-state-contracts.js

@@ -0,0 +1,30 @@
+export const checkpointNames = { initial: 'Initial state', target_response: 'Agent response observed',
+    voice_message: 'Spoken message observed', operation_started: 'Service request observed',
+    operation_completed: 'Service response observed', operation_committed: 'Service SQL transaction committed',
+    schedule_committed: 'Scheduled data boundary', realtime_event_committed: 'Timed world change', interaction_finished: 'Interaction finished', final: 'Final observed state' };
+export function checkpointLabel(row) {
+    return `${checkpointNames[row.kind]}${row.turn_index === null ? '' : ` · ${row.kind === 'voice_message' ? 'Message' : 'Turn'} ${row.turn_index + 1}`} · Attempt ${row.attempt_number}`;
+}
+export function stateChangeMatches(detail, original) {
+    return detail.id === original.id && detail.kind === original.kind && detail.collection === original.collection
+        && detail.changed_fields.length === original.field_count
+        && original.changed_fields.every((name, index) => detail.changed_fields[index] === name);
+}
+/** Interpret typed observations without losing decimal/integer precision or
+ * reconstructing hidden/preview-only values. Full JSON stays available. */
+export function observedCellValue(cell) {
+    if (!cell)
+        return 'Not present';
+    if (cell.type === 'null')
+        return null;
+    if (cell.type === 'redacted')
+        return 'Hidden';
+    if (cell.type === 'array')
+        return 'value' in cell ? cell.value.map(observedCellValue) : `${cell.size} items`;
+    if (cell.type === 'object')
+        return 'value' in cell
+            ? Object.fromEntries(Object.entries(cell.value).map(([key, value]) => [key, observedCellValue(value)])) : `${cell.size} fields`;
+    if (cell.type === 'binary' && !('value' in cell))
+        return 'Binary data';
+    return 'value' in cell ? cell.value : undefined;
+}

package/dist/contracts/typescript/agent-change.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/assessment-aggregate.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/assessment.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/billing-commerce.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/campaigns.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/catalog.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/ci-access.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/ci-configuration.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/ci-delivery.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/ci-result.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/ci-runs.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/clips.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/comparison.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/composite.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/connections.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/context.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/datasets.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/evidence-coverage.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/export.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/github-directory.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/insight.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/inspection.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/intake.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-claim.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-configuration.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-evidence.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-grant.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-input.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-runner.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-trial-live.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-value-source.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/local-world-native.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/mcp.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/media.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/native-check.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/native-identity.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/onboarding.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/performance.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/planning.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/preparation.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/real-operation.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/recommendation.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/reports.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/resource-lifecycle.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/saved-record.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/scenarios.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/services.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/session-command.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/session-state.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/session-voice.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/session.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-command.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-connection.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-contribution.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-groups.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-lifecycle.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-package.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/tool-state.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/trial-state.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/vault.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/workspace-team.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/typescript/world-stream.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/workspace-team-contracts.js

@@ -0,0 +1,55 @@
+const uuid = (v) => typeof v === 'string' && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(v);
+const count = (v, min = 0) => typeof v === 'number' && Number.isSafeInteger(v) && v >= min;
+const text = (v, max) => typeof v === 'string' && v.length <= max;
+export function workspaceTeamRead(value, matches) {
+    if (!matches)
+        throw new Error('These settings or team details do not match the selected workspace, account or original request. Reload before applying a change.');
+    return value;
+}
+export function workspaceSettingsMatch(v, workspace, actor) {
+    return !!v && v.workspace_id === workspace && v.actor_id === actor && uuid(workspace) && uuid(actor)
+        && text(v.name, 120) && v.name.trim().length > 0 && text(v.description, 2000) && text(v.simulation_context, 8000)
+        && count(v.simulation_context_revision, 1) && typeof v.mask_sensitive_data === 'boolean' && typeof v.can_manage === 'boolean'
+        && count(v.retention_days, 1) && Array.isArray(v.retention_options) && v.retention_options.length > 0 && v.retention_options.length <= 100
+        && v.retention_options.every(one => count(one, 1)) && new Set(v.retention_options).size === v.retention_options.length
+        && v.retention_options.includes(v.retention_days);
+}
+export function workspaceMemberMatch(v, workspace, id) {
+    return !!v && v.workspace_id === workspace && uuid(v.id) && (!id || v.id === id) && typeof v.name === 'string'
+        && text(v.email, 254) && ['owner', 'admin', 'member', 'viewer'].includes(v.role) && typeof v.is_self === 'boolean';
+}
+function authority(v, workspace, actor) {
+    return v.workspace_id === workspace && v.actor_id === actor && uuid(workspace) && uuid(actor) && [1, 3, 8, 15].includes(v.actor_role)
+        && typeof v.can_manage === 'boolean';
+}
+function paged(v, page) {
+    return count(v.count) && v.page === page && count(v.page_size, 1) && v.page_size <= 100 && Array.isArray(v.results) && v.results.length <= v.page_size;
+}
+export function workspaceTeamMatch(v, workspace, actor, query = '', page = 1) {
+    return !!v && authority(v, workspace, actor) && v.query === query.trim() && paged(v, page) && v.results.every(one => workspaceMemberMatch(one, workspace))
+        && new Set(v.results.map(one => one.id)).size === v.results.length;
+}
+export function workspaceMemberDetailMatch(v, workspace, actor, id) {
+    return workspaceMemberMatch(v, workspace, id) && authority(v, workspace, actor)
+        && ['not_requested', 'searching', 'witness', 'no_owner', 'attention_required'].includes(v.owner_check);
+}
+export function workspaceMemberChangeMatch(v, workspace, actor, member) {
+    return !!v && v.workspace_id === workspace && v.actor_id === actor && v.member_id === member && uuid(member)
+        && ['completed', 'checking_owners', 'reconciling'].includes(v.state) && (v.message === undefined || typeof v.message === 'string');
+}
+export function workspaceInvitationMatch(v, workspace, original = {}) {
+    return !!v && v.workspace_id === workspace && uuid(v.id) && uuid(v.actor_id) && text(v.email, 254)
+        && ['admin', 'member', 'viewer'].includes(v.role) && /^[a-z_]{1,24}$/.test(v.state) && text(v.request_key, 128) && !!v.request_key
+        && (v.expires_at === null || Number.isFinite(Date.parse(v.expires_at)))
+        && (!original.id || v.id === original.id) && (!original.actor || v.actor_id === original.actor) && (!original.key || v.request_key === original.key)
+        && (original.email === undefined || v.email === original.email) && (!original.role || v.role === original.role);
+}
+export function workspaceInvitationsMatch(v, workspace, actor, query = '', page = 1) {
+    return !!v && v.workspace_id === workspace && v.actor_id === actor && v.query === query.trim() && paged(v, page)
+        && v.results.every(one => workspaceInvitationMatch(one, workspace)) && new Set(v.results.map(one => one.id)).size === v.results.length;
+}
+export function workspaceInvitationRequestMatch(v, workspace, actor, key, original = {}) {
+    return !!v && v.schema === 'firedrill.invitation-request.v1' && v.workspace_id === workspace && v.actor_id === actor && v.request_key === key
+        && (v.state === 'not_received' ? v.invitation === null && !original.id : ['accepted', 'withdrawn'].includes(v.state) && v.invitation !== null
+            && workspaceInvitationMatch(v.invitation, workspace, { actor, key, ...original }) && (v.state === 'withdrawn') === (v.invitation.state === 'withdrawn'));
+}

package/dist/contracts/world-command.js

@@ -0,0 +1,65 @@
+const uuid = (value) => typeof value === 'string'
+    && /^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(value);
+const record = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const keys = (value, expected) => Object.keys(value).sort().join(',') === expected.sort().join(',');
+const positive = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value > 0;
+/** Metadata admission before retaining a local intent. The server still owns
+ * current access, configuration, capacity, grants and execution decisions.
+ * Never include supplied text/values in an exception or a journal here.
+ */
+export function parseWorldCommand(value) {
+    if (!record(value) || !keys(value, ['schema', 'kind', 'basis', 'payload']) || value.schema !== 'firedrill.world-command.v1'
+        || !record(value.basis) || !keys(value.basis, ['source_id', 'world_revision', 'config_revision'])
+        || !uuid(value.basis.source_id) || !positive(value.basis.world_revision) || !positive(value.basis.config_revision)
+        || !record(value.payload))
+        return null;
+    const basis = { source_id: value.basis.source_id, world_revision: value.basis.world_revision, config_revision: value.basis.config_revision };
+    const schema = 'firedrill.world-command.v1', payload = value.payload;
+    switch (value.kind) {
+        case 'build': {
+            if (Object.keys(payload).some(key => !['instruction', 'simulation_purpose', 'scenario_count', 'usage_quote_id', 'retry_job_id'].includes(key)))
+                return null;
+            const normalized = { instruction: '', simulation_purpose: 'explore', scenario_count: null, ...payload };
+            return parseNormalizedBuild(normalized, basis);
+        }
+        case 'message':
+            if (!keys(payload, ['content', 'conversation_id', 'reply_to']) || typeof payload.content !== 'string'
+                || !payload.content.trim() || payload.content.length > 32000 || !uuid(payload.conversation_id)
+                || payload.reply_to !== null && !uuid(payload.reply_to))
+                return null;
+            return { schema, kind: 'message', basis, payload: { content: payload.content, conversation_id: payload.conversation_id, reply_to: payload.reply_to } };
+        case 'stop_response':
+            if (!keys(payload, ['conversation_id', 'response_id']) || !uuid(payload.conversation_id) || !uuid(payload.response_id))
+                return null;
+            return { schema, kind: 'stop_response', basis, payload: { conversation_id: payload.conversation_id, response_id: payload.response_id } };
+        case 'cancel_build':
+            if (!keys(payload, ['job_id']) || !uuid(payload.job_id))
+                return null;
+            return { schema, kind: 'cancel_build', basis, payload: { job_id: payload.job_id } };
+        case 'proposal': {
+            const quote = Object.hasOwn(payload, 'usage_quote_id');
+            if (!keys(payload, ['proposal_id', 'action', ...(quote ? ['usage_quote_id'] : [])]) || !uuid(payload.proposal_id)
+                || quote && (!uuid(payload.usage_quote_id) || payload.action !== 'apply'))
+                return null;
+            const action = payload.action;
+            if (action !== 'apply' && action !== 'dismiss')
+                return null;
+            return { schema, kind: 'proposal', basis, payload: { proposal_id: payload.proposal_id, action,
+                    ...(quote ? { usage_quote_id: payload.usage_quote_id } : {}) } };
+        }
+        default: return null;
+    }
+}
+function parseNormalizedBuild(payload, basis) {
+    const schema = 'firedrill.world-command.v1', retry = Object.hasOwn(payload, 'retry_job_id');
+    if (!keys(payload, ['instruction', 'simulation_purpose', 'scenario_count', 'usage_quote_id', ...(retry ? ['retry_job_id'] : [])]) || !uuid(payload.usage_quote_id) || typeof payload.instruction !== 'string'
+        || payload.instruction.length > 32000 || payload.scenario_count !== null && !positive(payload.scenario_count))
+        return null;
+    if (retry && (!uuid(payload.retry_job_id) || payload.instruction !== ''))
+        return null;
+    const purpose = payload.simulation_purpose;
+    if (purpose !== 'explore' && purpose !== 'evaluate' && purpose !== 'adversarial' && purpose !== 'demonstrate')
+        return null;
+    return { schema, kind: 'build', basis, payload: { instruction: payload.instruction, simulation_purpose: purpose, scenario_count: payload.scenario_count, usage_quote_id: payload.usage_quote_id,
+            ...(retry ? { retry_job_id: payload.retry_job_id } : {}) } };
+}

package/dist/contracts/world-lifetime-contracts.js

@@ -0,0 +1,74 @@
+export function worldTimelineCanonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(worldTimelineCanonical).join(',')}]`;
+    if (value !== null && typeof value === 'object')
+        return `{${Object.keys(value).sort().map(key => `${JSON.stringify(key)}:${worldTimelineCanonical(value[key])}`).join(',')}}`;
+    const encoded = JSON.stringify(value);
+    if (encoded === undefined || typeof value === 'number' && !Number.isSafeInteger(value))
+        throw new Error('Use supported JSON values in a schedule request.');
+    return encoded;
+}
+const id = /^[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}$/, digest = /^[a-f0-9]{64}$/;
+export function worldQuoteMatches(value, workspace) {
+    return !!value && id.test(value.id) && value.workspace_id === workspace && value.activity === 'simulation' && value.execution_location === 'managed'
+        && digest.test(value.scope_digest) && digest.test(value.tariff_digest) && !!value.scope && Number.isSafeInteger(value.credit_scale) && value.credit_scale > 0
+        && Number.isSafeInteger(value.maximum_units) && Number.isSafeInteger(value.estimated_units) && value.estimated_units >= 0
+        && value.maximum_units >= value.estimated_units && Date.parse(value.expires_at) > Date.now();
+}
+export function worldAllocationMatches(value, workspace, world, selected) {
+    const scope = value?.scope;
+    return worldQuoteMatches(value, workspace) && scope.schema === 'firedrill.world-runtime-budget.v1' && scope.world_id === world
+        && scope.world_revision === selected.world_revision && scope.launch_request_key === selected.launch_request_key
+        && scope.configuration_revision === selected.configuration_revision && scope.dataset_id === selected.dataset_id
+        && scope.checkpoint_id === selected.checkpoint_id && scope.application_checkpoint_id === (selected.application_checkpoint_id ?? null)
+        && scope.duration_seconds === selected.duration_seconds && digest.test(String(scope.input_digest));
+}
+const date = (value) => typeof value === 'string' && Number.isFinite(Date.parse(value));
+export function worldExtensionMatches(value, selected, original) {
+    return !!value && id.test(value.id) && value.workspace_id === selected.workspace_id && value.world_id === selected.world_id && value.session_id === selected.id
+        && id.test(value.actor_id) && id.test(value.request_key) && (value.usage_quote_id === null || id.test(value.usage_quote_id))
+        && ['queued', 'publishing', 'accepted', 'confirmed', 'failed'].includes(value.state) && /^[1-9][0-9]{0,18}$/.test(value.revision)
+        && /^(0|[1-9][0-9]{0,18})$/.test(value.reset_count) && date(value.created_at) && (value.finished_at === null || date(value.finished_at))
+        && date(value.expected_expires_at) && date(value.requested_expires_at) && Date.parse(value.requested_expires_at) > Date.parse(value.expected_expires_at)
+        && (selected.lease_revision === undefined || /^(0|[1-9][0-9]{0,18})$/.test(selected.lease_revision) && BigInt(value.revision) <= BigInt(selected.lease_revision) + 1n)
+        && (!original || value.request_key === original.key && (!original.actor || value.actor_id === original.actor)
+            && (!original.input || value.expected_expires_at === original.input.expected_expires_at && value.reset_count === original.input.reset_count
+                && value.usage_quote_id === original.input.usage_quote_id
+                && Date.parse(value.requested_expires_at) === Date.parse(original.input.expected_expires_at) + original.input.additional_seconds * 1000));
+}
+export function resourcePageMatches(value, page, matches) {
+    return !!value && value.page === page && Number.isSafeInteger(value.count) && value.count >= 0 && Number.isSafeInteger(value.page_size)
+        && value.page_size > 0 && value.page_size <= 100 && Array.isArray(value.results) && value.results.length <= value.page_size
+        && value.results.length <= value.count && value.results.every(matches);
+}
+export function worldTimelineMatches(value, scope) {
+    return !!value && id.test(value.id) && value.world_id === scope.world_id && value.workspace_id === scope.workspace_id && value.session_id === scope.id
+        && id.test(value.actor_id) && id.test(value.request_key) && Number.isSafeInteger(value.revision) && value.revision > 0
+        && Number.isSafeInteger(value.control_revision) && value.control_revision >= 0
+        && /^(0|[1-9][0-9]{0,18})$/.test(value.reset_count) && ['active', 'paused', 'completed', 'canceled', 'ended', 'superseded'].includes(value.state)
+        && date(value.created_at) && (value.finished_at === null || date(value.finished_at)) && typeof value.timezone === 'string'
+        && (value.next_event === null || !!value.next_event && id.test(value.next_event.id) && typeof value.next_event.name === 'string' && date(value.next_event.due_at));
+}
+export function worldTimelineIntentMatches(value, scope, key, selected) {
+    return !!value && value.schema === 'firedrill.world-timeline-intent.v1' && value.workspace_id === scope.workspace_id
+        && value.world_id === scope.world_id && value.session_id === scope.id && value.actor_id === scope.actor && value.request_key === key
+        && id.test(key) && ['not_received', 'prepared', 'applied', 'withdrawn'].includes(value.state)
+        && (value.prepared_until === null || date(value.prepared_until))
+        && (value.action === null || ['schedule', 'control'].includes(value.action))
+        && (value.request_digest === null || digest.test(value.request_digest))
+        && (value.state === 'not_received' ? value.request_digest === null && value.action === null && value.timeline === null
+            : value.request_digest !== null && (!selected?.digest || value.request_digest === selected.digest)
+                && (value.state === 'withdrawn' || value.action !== null && (!selected?.action || value.action === selected.action))
+                && (value.state === 'applied' ? value.timeline !== null && worldTimelineMatches(value.timeline, scope)
+                    && (value.action === 'schedule' ? value.timeline.request_key === key && value.timeline.actor_id === scope.actor
+                        : !selected?.timeline || value.timeline.id === selected.timeline) : value.timeline === null));
+}
+export function worldScheduledEventMatches(value, timeline) {
+    return !!value && id.test(value.id) && value.timeline_id === timeline && typeof value.name === 'string' && value.name.length <= 120
+        && Number.isSafeInteger(value.position) && value.position >= 0 && date(value.due_at)
+        && ['scheduled', 'dispatched', 'observed', 'not_dispatched', 'unknown', 'canceled'].includes(value.state)
+        && [value.after_event_id, value.after_command_id, value.command_id].every(one => one === null || typeof one === 'string' && id.test(one))
+        && (value.command_sequence === null || /^[1-9][0-9]{0,18}$/.test(value.command_sequence))
+        && [value.requested_at, value.finished_at].every(one => one === null || date(one));
+}
+export const worldCredits = (value, kind = 'maximum') => new Intl.NumberFormat(undefined, { maximumFractionDigits: 6 }).format((kind === 'estimated' ? value.estimated_units : value.maximum_units) / value.credit_scale);