@zergai/ztc 0.4.0-beta.1 → 0.5.0-beta.1

package/dist/plugin/simulation_documents.d.ts

@@ -0,0 +1,22 @@
+import type { SimulationDocumentWriteV1, SimulationDynamicHistoryEntryV1, SimulationDynamicStateV1 } from './simulation_contract.js';
+export type SimulationDocumentProvenanceV1 = {
+    readonly policyVersion: 'document-stream-1';
+    readonly documentKey: string;
+} & ({
+    readonly kind: 'scenario';
+    readonly revision: 0;
+} | {
+    readonly kind: 'accepted-action';
+    readonly revision: number;
+    readonly sourceEventId: string;
+    readonly sourceActionIds: readonly string[];
+} | {
+    readonly kind: 'player-edit';
+    readonly eligibleRevision: number;
+    readonly inputId: string;
+});
+export interface SimulationDocumentPolicyV1 {
+    readonly policyVersion: 'document-stream-1';
+    initial(state: SimulationDynamicStateV1): readonly SimulationDocumentWriteV1[];
+    accepted(state: SimulationDynamicStateV1, entry: SimulationDynamicHistoryEntryV1): readonly SimulationDocumentWriteV1[];
+}

package/dist/plugin/simulation_documents.js

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

package/dist/plugin/simulation_interventions.d.ts

@@ -0,0 +1,103 @@
+import type { SimulationJsonObjectV1, SimulationTransitionBatchV1, SimulationPersistentAgentStateV1 } from './simulation_contract.js';
+export type SimulationInputRequestV1 = {
+    inputId: string;
+    kind: 'message';
+    recipientActorIds: readonly string[];
+    body: string;
+} | {
+    inputId: string;
+    kind: 'document-edit';
+    documentId: string;
+    expectedVersion: number;
+    body: string;
+};
+export interface SimulationAddressedInputV1 {
+    inputId: string;
+    senderActorId: string;
+    recipientActorIds: readonly string[];
+    acceptedSequence: number;
+    eligibleRevision: number;
+    fingerprint: string;
+    payload: {
+        kind: 'message';
+        body: string;
+    } | {
+        kind: 'document-edit';
+        documentId: string;
+        version: number;
+        versionId: string;
+    };
+}
+export interface SimulationInputAcknowledgementV1 {
+    inputId: string;
+    recipientActorIds: readonly string[];
+    recipientNames: readonly string[];
+    eligibleRevision: number;
+    acceptedSequence: number;
+    document?: {
+        documentId: string;
+        version: number;
+        versionId: string;
+    };
+}
+export interface SimulationInputBatchV1 {
+    /** Absent only on historical V1 seals. Included in the immutable seal digest. */
+    resolutionContract?: {
+        version: 2;
+        actorsBefore: readonly SimulationPersistentAgentStateV1[];
+    };
+    revision: number;
+    basedOnRevision: number;
+    documentVersionIds: readonly string[];
+    inputIds: readonly string[];
+    worldDigest: string;
+    digest: string;
+}
+export interface SimulationInterventionResolutionV1 {
+    inputId: string;
+    actorId: string;
+    revision: number;
+    disposition: 'acted' | 'refused' | 'ignored' | 'deferred';
+    reason: string;
+    causeIds: readonly string[];
+    change: {
+        kind: 'intent' | 'belief' | 'relationship';
+        recordId: string;
+    } | null;
+}
+export interface SimulationAuthorizedDocumentV1 {
+    provenance?: import('./simulation_documents.js').SimulationDocumentProvenanceV1;
+    documentId: string;
+    versionId: string;
+    version: number;
+    ownerActorId: string;
+    recipientActorIds: readonly string[];
+    body: string;
+    label: string;
+}
+export interface ActorInterventionContext {
+    revision: number;
+    batchId: string;
+    actorId: string;
+    addressedInputs: readonly SimulationAddressedInputV1[];
+    documents: readonly SimulationAuthorizedDocumentV1[];
+    requiredResolutionInputIds: readonly string[];
+}
+export interface SimulationInputJournalV1 {
+    schemaVersion: 1;
+    materialFromRevision?: number;
+    inputs: SimulationAddressedInputV1[];
+    acknowledgements: SimulationInputAcknowledgementV1[];
+    batches: SimulationInputBatchV1[];
+    resolutions: SimulationInterventionResolutionV1[];
+}
+export interface SimulationDetachedInputCommitV1 {
+    checkpoint: SimulationJsonObjectV1;
+    sealedDigest: string;
+    batch: SimulationTransitionBatchV1;
+}
+/** Server-only privacy corpus. Never include it in an actor request. */
+export interface SimulationPrivateInputTextV1 {
+    recipientActorIds: readonly string[];
+    text: string;
+}

package/dist/plugin/simulation_interventions.js

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

package/dist/plugin/simulation_living.d.ts

@@ -0,0 +1 @@
+export * from '../simulation/living/index.js';

package/dist/plugin/simulation_living.js

@@ -0,0 +1,3 @@
+// Public boundary for the living-world engine: one inhabited character, a cast with
+// their own minds, a Game Master that resolves attempts, and replayable saved events.
+export * from '../simulation/living/index.js';

package/dist/plugin/simulation_meetings.d.ts

@@ -0,0 +1,121 @@
+import type { SimulationRouterModelV1 } from './simulation_contract.js';
+export interface SimulationLocationV1 {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: 'meeting-room' | 'workplace' | 'transit' | 'field';
+    readonly domainObjectId?: string;
+}
+export interface SimulationActorPositionV1 {
+    readonly actorId: string;
+    readonly locationId: string | null;
+    readonly revision: number;
+    readonly cause: {
+        readonly kind: 'initial' | 'action' | 'meeting';
+        readonly sourceId: string;
+    } | null;
+}
+export interface SimulationInteractionStateV1 {
+    readonly policyVersion: 'meetings-1' | 'meetings-2' | null;
+    readonly policy: SimulationInteractionPolicyV1 | null;
+    readonly locations: readonly SimulationLocationV1[];
+    readonly positions: readonly SimulationActorPositionV1[];
+}
+export interface SimulationInteractionPolicyV1 {
+    readonly version: 'meetings-1' | 'meetings-2';
+    readonly locations: readonly SimulationLocationV1[];
+    readonly initialActorLocations: Readonly<Record<string, string | null>>;
+    readonly meetingLocationId: string;
+    readonly issue: {
+        readonly title: string;
+        readonly domainObjectIds: readonly string[];
+    };
+    readonly actionLocations: readonly {
+        readonly mechanic: string;
+        readonly location: {
+            readonly kind: 'fixed';
+            readonly locationId: string;
+        } | {
+            readonly kind: 'object';
+            readonly intentParameter: string;
+            readonly objectLocations: Readonly<Record<string, string>>;
+        };
+    }[];
+}
+export interface SimulationMeetingChoiceV1 {
+    readonly id: 'proceed-both' | 'proceed-first' | 'proceed-second';
+    readonly proceedProposalIds: readonly string[];
+    readonly deferProposalIds: readonly string[];
+}
+export interface SimulationMeetingTurnV1 {
+    readonly meetingId: string;
+    readonly turnId: string;
+    readonly speakerActorId: string;
+    readonly predecessorTurnId: string | null;
+    readonly text: string;
+    readonly candidateChoiceId: SimulationMeetingChoiceV1['id'] | null;
+    readonly endMeeting?: boolean;
+}
+export interface SimulationMeetingTurnReceiptV1 {
+    readonly requestVersion?: 2;
+    readonly instructionVersion?: 2 | 3;
+    readonly turnId: string;
+    readonly speakerActorId: string;
+    readonly predecessorTurnId: string | null;
+    readonly requested: boolean;
+    readonly durationMs: number;
+    readonly priorTurnsDigest: string;
+    readonly turnDigest: string | null;
+    readonly provider: 'codex_legacy' | 'zergrouter';
+    readonly role: 'character';
+    readonly model: 'gpt-5.6-luna' | SimulationRouterModelV1;
+    readonly reasoningEffort: 'low';
+    readonly status: 'accepted' | 'declined' | 'rejected';
+    readonly failureCode?: string;
+    readonly inputDigest: string;
+    readonly outputDigest: string;
+    readonly outputBytes: number;
+    readonly maxTokens: 512;
+}
+export interface SimulationMeetingInvitationV1 {
+    readonly sourceProposalId: string;
+    readonly authorActorId: string;
+    readonly recipientActorId: string;
+}
+export interface SimulationMeetingV1 {
+    readonly invitation?: SimulationMeetingInvitationV1;
+    readonly meetingId: string;
+    readonly revision: number;
+    readonly issue: string;
+    readonly locationId: string;
+    readonly participantActorIds: readonly [string, string];
+    readonly audienceActorIds: readonly string[];
+    readonly sourceProposalIds: readonly [string, string];
+    readonly turns: readonly SimulationMeetingTurnV1[];
+    readonly receipts: readonly SimulationMeetingTurnReceiptV1[];
+    readonly status: 'accepted' | 'rejected';
+    readonly decision: (SimulationMeetingChoiceV1 & {
+        readonly finalTurnId: string;
+    }) | null;
+    readonly failureCode?: string;
+}
+export type SimulationMeetingActivityV1 = {
+    readonly kind: 'meeting-forming';
+    readonly invitation?: SimulationMeetingInvitationV1;
+    readonly meetingId: string;
+    readonly basedOnRevision: number;
+    readonly status: 'pending';
+    readonly validation: 'ztc-simulation-meeting-plan';
+    readonly locationId: string;
+    readonly locationName: string;
+    readonly issue: string;
+    readonly participants: readonly {
+        readonly actorId: string;
+        readonly actorName: string;
+    }[];
+} | (SimulationMeetingTurnV1 & {
+    readonly kind: 'meeting-turn';
+    readonly basedOnRevision: number;
+    readonly status: 'pending';
+    readonly validation: 'ztc-simulation-meeting-turn';
+    readonly speakerName: string;
+});

package/dist/plugin/simulation_meetings.js

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

package/dist/plugin/simulation_story_review.d.ts

@@ -0,0 +1,111 @@
+import type { SimulationDynamicWorldStateV1, SimulationRouterModelV1 } from './simulation_contract.js';
+export interface StoryEvidenceV1 {
+    readonly eventIds: readonly string[];
+    readonly objects: readonly {
+        readonly objectId: string;
+        readonly version: number;
+    }[];
+    readonly resources: readonly {
+        readonly resourceId: string;
+        readonly value: number;
+    }[];
+}
+export type StoryReviewDecisionV1 = {
+    readonly version: 1;
+    readonly reviewId: string;
+    readonly basedOnRevision: number;
+    readonly evidenceDigest: string;
+    readonly explanation: string;
+    readonly evidence: StoryEvidenceV1;
+} & ({
+    readonly kind: 'close';
+    readonly title: string;
+    readonly narrative: string;
+    readonly outcome: 'triumph' | 'mixed' | 'collapse';
+    readonly unresolvedStakes: readonly string[];
+} | {
+    readonly kind: 'continue';
+    readonly unresolvedStake: string;
+} | {
+    readonly kind: 'stalled';
+    readonly unresolvedStake: string;
+    readonly requestPressure: boolean;
+});
+export interface StoryReviewReceiptV1 {
+    readonly version: 1;
+    readonly revision: number;
+    readonly acceptedBeat: number;
+    readonly reviewId: string;
+    readonly evidenceDigest: string;
+    readonly model: 'gpt-5.6-sol' | SimulationRouterModelV1;
+    readonly reasoningEffort: 'none';
+    readonly inputDigest: string;
+    readonly outputDigest: string;
+    readonly outputBytes: number;
+    readonly requested: boolean;
+    readonly status: 'accepted' | 'rejected';
+    readonly decision: StoryReviewDecisionV1 | null;
+    readonly failureCode?: string;
+}
+/** Code-computed standing of the current chapter. The model never writes any of it. */
+export interface StoryChapterStandingV1 {
+    readonly act: number;
+    readonly acts: number;
+    readonly decisions: number;
+    readonly workingDecisions: number;
+    readonly decisionsLeft: number;
+    readonly goals: readonly {
+        readonly id: string;
+        readonly label: string;
+        readonly met: boolean;
+        readonly share: number;
+    }[];
+    readonly score: number;
+    readonly dangers: readonly {
+        readonly resourceId: string;
+        readonly label: string;
+        readonly value: number;
+        readonly bound: number;
+        readonly room: number;
+    }[];
+    readonly result: 'open' | 'win' | 'mixed' | 'loss';
+    readonly lossCause: null | {
+        readonly kind: 'meter';
+        readonly resourceId: string;
+        readonly label: string;
+    } | {
+        readonly kind: 'out-of-decisions';
+    };
+}
+export interface StoryChapterV1 {
+    readonly startRevision: number;
+    readonly startResources: Readonly<Record<string, number>>;
+    readonly standing: StoryChapterStandingV1;
+}
+export interface StoryChapterResultV1 {
+    readonly act: number;
+    readonly result: 'win' | 'mixed' | 'loss';
+    readonly revision: number;
+    readonly title: string;
+    readonly narrative: string;
+}
+export interface StoryEpisodeV1 {
+    readonly version: 1;
+    readonly origin: {
+        readonly objective: string;
+        readonly world: SimulationDynamicWorldStateV1;
+    };
+    readonly acceptedBeats: number;
+    readonly lastReview: StoryReviewReceiptV1 | null;
+    /** Present only under chapter rules: code owns when a chapter ends and how. */
+    readonly chapter?: StoryChapterV1;
+    readonly results?: readonly StoryChapterResultV1[];
+}
+export interface StoryReviewViewV1 {
+    readonly version: 1;
+    readonly acceptedBeats: number;
+    readonly nextReviewAtAcceptedBeat: number;
+    readonly last: StoryReviewReceiptV1 | null;
+    readonly chapter?: StoryChapterStandingV1;
+    readonly results?: readonly StoryChapterResultV1[];
+}

package/dist/plugin/simulation_story_review.js

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

package/dist/plugin/simulation_storyteller.d.ts

@@ -0,0 +1,91 @@
+import type { SimulationDomainActionProposalV1 } from './simulation_contract.js';
+export type StorytellerPersonalityV1 = 'rising-tension' | 'spacious-recovery';
+export interface DynamicInitializationV1 {
+    readonly version: 1;
+    readonly storyteller: {
+        readonly policyVersion: 'storyteller-1' | 'storyteller-2';
+        readonly personality: StorytellerPersonalityV1;
+    };
+}
+export interface DynamicSelectionV1 {
+    readonly policyVersion: 'selection-1';
+    readonly gameKind: string;
+    readonly rulesVersion: string;
+    readonly scenarioId: string;
+    readonly roleId: string;
+}
+export interface DynamicInitializationV2 {
+    readonly documents?: {
+        readonly policyVersion: 'document-stream-1';
+        readonly authoredRevision?: 2;
+    };
+    readonly version: 2;
+    readonly selection: DynamicSelectionV1;
+    readonly storyteller: DynamicInitializationV1['storyteller'];
+}
+export type DynamicInitialization = DynamicInitializationV1 | DynamicInitializationV2;
+export interface StorytellerDecisionV1 {
+    readonly basedOnRevision: number;
+    readonly mode: 'quiet' | 'recovery' | 'pressure';
+    readonly strengthTier: number;
+    readonly offerRecovery: boolean;
+    readonly quietLimit: number;
+    readonly inputDigest: string;
+}
+/** Only an accepted canonical history entry gives this receipt authority. */
+export interface StorytellerReceiptV1 {
+    readonly recovery?: StorytellerRecoveryV2;
+    readonly decision: StorytellerDecisionV1;
+    readonly proposedPressure: readonly SimulationDomainActionProposalV1[];
+    readonly proposedRecovery: readonly SimulationDomainActionProposalV1[];
+    readonly acceptedPressureActionIds: readonly string[];
+    readonly majorCrisis: boolean;
+    readonly setbackResourceIds: readonly string[];
+    readonly recoveryChoiceIds: readonly string[];
+    readonly recoveryForRevisions: readonly number[];
+}
+export interface StorytellerObservationV1 {
+    /** Safe headroom and progress use integer thousandths. Private values are excluded. */
+    readonly headroom: readonly number[];
+    readonly progress: number;
+    readonly activeThreats: number;
+}
+/** References resolve against immutable accepted history, never a mutable debt ledger. */
+export interface StorytellerSetbackV2 {
+    readonly id: string;
+    readonly revision: number;
+    readonly actionIds: readonly string[];
+    readonly effectIndexes: readonly number[];
+    readonly objectIds: readonly string[];
+    readonly resourceIds: readonly string[];
+    readonly mechanic: string;
+    readonly private: boolean;
+    readonly major: boolean;
+}
+export interface StorytellerOpportunityV2 {
+    readonly causeId: string;
+    readonly revision: number;
+    readonly choiceId: string | null;
+    readonly actionId: string | null;
+    readonly relation: string;
+    readonly targets: readonly {
+        readonly id: string;
+        readonly version: number;
+    }[];
+    readonly personal: {
+        readonly resourceId: string;
+        readonly minimumRequired: number;
+        readonly cost: number;
+        readonly available: number;
+    } | null;
+    readonly worldCosts: readonly {
+        readonly resourceId: string;
+        readonly required: number;
+        readonly available: number;
+    }[];
+}
+export interface StorytellerRecoveryV2 {
+    readonly version: 2;
+    readonly setbacks: readonly StorytellerSetbackV2[];
+    readonly opportunities: readonly StorytellerOpportunityV2[];
+}

package/dist/plugin/simulation_storyteller.js

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

package/dist/plugin/simulation_structured.d.ts

@@ -0,0 +1,2 @@
+/** Structured output helpers without host, providers or dynamic engines. */
+export { compileStrictSimulationSchema, decodeStrictSimulationOutput } from '../simulation/toolkit/structured_output.js';

package/dist/plugin/simulation_structured.js

@@ -0,0 +1,2 @@
+/** Structured output helpers without host, providers or dynamic engines. */
+export { compileStrictSimulationSchema, decodeStrictSimulationOutput } from '../simulation/toolkit/structured_output.js';

package/dist/plugin/simulation_toolkit.d.ts

@@ -31,6 +31,11 @@ export { resolveTerminal, type TerminalProposal, } from '../simulation/toolkit/t
 export { ActorThreads, type ActorPriorMove, type ActorThreadMove, type ActorThreadsSnapshot, } from '../simulation/toolkit/actor_threads.js';
 export { completeAndParse, runLlmPassSerially, type LlmPassOutcome, } from '../simulation/toolkit/passes.js';
 export { setChannelLines } from '../simulation/toolkit/channel_lines.js';
+export { BoundedTurnError, assertBoundedTraversal, assertBoundedTurnAdvance, makeSeededRandom, type BoundedTurnErrorCode, type SeededRandom, } from '../simulation/toolkit/bounded_turns.js';
+export { DynamicGameContractError, validateCharacterProposal, validateGmProposal, validateSimulationInferenceRouting, type DynamicProposalValidationContextV1, } from '../simulation/toolkit/dynamic_game.js';
+export { applyDynamicAgentUpdates, DynamicAgentStateError, } from '../simulation/toolkit/dynamic_agents.js';
+export { applyDynamicWorldActions, applyDynamicWorldEffects, sceneRecordsToRetire, DynamicWorldStateError, type DynamicWorldEffectContextV1, } from '../simulation/toolkit/dynamic_world.js';
+export { DynamicMechanicContractError, dynamicMechanicParametersSchema, makeDynamicFallbackParameters, makeDynamicFallbackResolution, resolveDynamicActionParticipantIds, dynamicActionObjectGraph, dynamicObjectGraph, validateDynamicMechanicAction, validateDynamicMechanicCatalog, type DynamicMechanicContextV1, } from '../simulation/toolkit/dynamic_mechanics.js';
 export { parseBoolFlag, parseEnumFlag, parseNumberFlag, resolveFeatures, type FeatureCatalog, type FeatureKind, type FeatureSpec, type FeatureValue, type FeatureValues, type ParseWarning, type ResolvedFeatureSet, } from '../simulation/toolkit/features.js';
 export { DEFAULT_MATERIAL_MOVE, materialFieldMoves, type MaterialFieldMove, } from '../simulation/toolkit/stale_fields.js';
 export { applyCausalPropagations, computeCausalPropagations, type CausalEdge, type CausalGraph, type CausalPropagation, type FieldSnapshot, } from '../simulation/world/causal_graph.js';
@@ -43,3 +48,19 @@ export { slugify as artSlugify, trimText } from '../simulation/art/text.js';
 export { ArtService, DEFAULT_ART_BUDGET_USD, DEFAULT_ART_CONCURRENCY, DEFAULT_ART_COST_USD, DEFAULT_ART_MODEL, type ArtAssetSink, type ArtCacheHit, type ArtCostPolicy, type ArtProvider, type ArtServiceIo, type ArtServiceOptions, } from '../simulation/art/service.js';
 export { generateGeminiImage, makeGeminiImageProvider, } from '../simulation/art/gemini_image.js';
 export { defaultArtDirs, makeFsArtIo, type ArtDirs, } from '../simulation/art/fs_io.js';
+export { digestDynamicText } from '../simulation/toolkit/dynamic_digest.js';
+export { dynamicMeetingSystemPrompt } from '../simulation/toolkit/dynamic_meetings.js';
+export { compileStrictSimulationSchema, decodeStrictSimulationOutput } from '../simulation/toolkit/structured_output.js';
+export { evaluateChapterStanding, CHAPTER_MIN_DECISIONS, CHAPTER_MAX_DECISIONS, type ChapterStanding, type ChapterResult, withPublicChoiceLinks, type MilestoneRelation, type MilestoneRelationCondition, type MilestoneRelationKind, type ChoiceMilestoneLink, evaluateMilestones, evaluatePublicProgress, groupActs, summarizeMilestones, type ActStatus, type ActView, type MilestoneRule, type MilestoneState, type SimulationCatalogEntry, type DynamicPublicProgress } from '../simulation/toolkit/dynamic_progress.js';
+export { dynamicInitializationSchema, DEFAULT_DYNAMIC_INITIALIZATION, STORYTELLER_OPTIONS, parseDynamicInitialization, planStoryteller, storytellerMemory, pendingStorytellerSetbacks } from '../simulation/toolkit/dynamic_storyteller.js';
+export type { DynamicStorytellerAdapter } from '../simulation/toolkit/dynamic_storyteller_runtime.js';
+export { asDynamicStateJson, DynamicStateContractError, MAX_DYNAMIC_STATE_BYTES, parseDynamicSimulationState, parseDynamicCharacterProposal, retainedParsedDynamicStates, validateDynamicStateTransition, isRulesGeneration, } from '../simulation/toolkit/dynamic_state.js';
+export { advanceDynamicSimulation, compactCharacterProposalForHistory, findDynamicCharacterPrivacyRejection, makeDynamicCharacterRequest, makeDynamicMeetingSpeakerContext, makeCharacterFallback, makeDynamicPlayerChoices, containSameBeatIdentifierCollisions, makeDynamicCharacterCorrectionSystem, makeDynamicCharacterCorrectionRequest, assertDynamicCharacterRequestPrivacy, validateDynamicCharacterCorrectionChoices, validateDynamicCharacterProposalForActor, dynamicSimulationFailureCode, projectDynamicProgress, createDynamicSimulationState, DynamicDomainPolicyError, DynamicSimulationError, replayDynamicSimulation, validateDynamicDomainActionFeasibility, validateDynamicSimulationStateForPolicy, retainedDynamicPolicyStates, makeDynamicActorCorrectionRequest, validateDynamicActorCorrectionChoices, hasDynamicActorCorrectionPrivacyRejection, applyDynamicPublicCorrection, makeDynamicPublicCorrectionRequest, validateDynamicPublicCorrectionChoices, findDynamicPublicPrivacyRejection, replayDynamicMainConsequences, replayDynamicPublicConsequences, makeDynamicActorUpdateSystem, applyDynamicStoryReview, makeDynamicStoryReviewCandidate, type DynamicDomainPolicy, type DynamicDomainPolicyState, type DynamicPersonalResourceActionV1, quoteDynamicPlayerChoices, type DynamicPlayerChoiceQuoteV1, type DynamicPersonalResourceQuoteV1, type DynamicActorCreditV1, } from '../simulation/toolkit/dynamic_runtime.js';
+export { actorSeedsForPolicy, createDynamicSimulationRegistration, } from '../simulation/toolkit/dynamic_driver.js';
+export { assertDynamicInferenceKnowledge, dynamicPrivateKnowledge, dynamicPublishedKnowledge, DynamicKnowledgeContaminationError } from '../simulation/toolkit/dynamic_knowledge.js';
+export { normalizeDynamicActorResponse, type ActorReceiptCauseBinding, type DynamicActorInstructionVersion } from '../simulation/intervention_generation.js';
+export { StoryReviewError, makeDynamicStoryReviewRequest, replayDynamicStoryReview, STORY_REVIEW_INTERVAL, STORY_REVIEW_INPUT_BYTES, STORY_REVIEW_TIMEOUT_MS, STORY_REVIEW_MAX_TOKENS } from '../simulation/toolkit/dynamic_story_review.js';
+export { registerSimulationCheckpointValidators } from '../simulation/plugin_host.js';
+export { checkpointInterventionContext, prepareSessionInput, sealSessionInputs, commitSessionInputBatch, projectSessionInputs, getSessionTransition, SimulationInputError, actorInterventionContext, checkpointInputJournal } from '../simulation/session_inputs.js';
+export { withDynamicHistoryStorage, dynamicHistoryReference, dynamicHistory, readDynamicHistory, DynamicHistoryError, type DynamicHistoryStorage, type DynamicHistoryReference, type DynamicHistoryRecord } from '../simulation/dynamic_history.js';
+export { freePlayerAction } from '../simulation/toolkit/dynamic_runtime.js';

package/dist/plugin/simulation_toolkit.js

@@ -34,6 +34,11 @@ export { resolveTerminal, } from '../simulation/toolkit/terminal.js';
 export { ActorThreads, } from '../simulation/toolkit/actor_threads.js';
 export { completeAndParse, runLlmPassSerially, } from '../simulation/toolkit/passes.js';
 export { setChannelLines } from '../simulation/toolkit/channel_lines.js';
+export { BoundedTurnError, assertBoundedTraversal, assertBoundedTurnAdvance, makeSeededRandom, } from '../simulation/toolkit/bounded_turns.js';
+export { DynamicGameContractError, validateCharacterProposal, validateGmProposal, validateSimulationInferenceRouting, } from '../simulation/toolkit/dynamic_game.js';
+export { applyDynamicAgentUpdates, DynamicAgentStateError, } from '../simulation/toolkit/dynamic_agents.js';
+export { applyDynamicWorldActions, applyDynamicWorldEffects, sceneRecordsToRetire, DynamicWorldStateError, } from '../simulation/toolkit/dynamic_world.js';
+export { DynamicMechanicContractError, dynamicMechanicParametersSchema, makeDynamicFallbackParameters, makeDynamicFallbackResolution, resolveDynamicActionParticipantIds, dynamicActionObjectGraph, dynamicObjectGraph, validateDynamicMechanicAction, validateDynamicMechanicCatalog, } from '../simulation/toolkit/dynamic_mechanics.js';
 // `resolveFeatures` REQUIRES the environment to be passed in — the resolver
 // never reads `process.env` itself, so feature resolution stays a pure
 // function of (catalog, env, overrides).
@@ -62,3 +67,22 @@ export { ArtService, DEFAULT_ART_BUDGET_USD, DEFAULT_ART_CONCURRENCY, DEFAULT_AR
 export { generateGeminiImage, makeGeminiImageProvider, } from '../simulation/art/gemini_image.js';
 // Filesystem persistence seam for the art service (`~/.ztc` cache/run dirs).
 export { defaultArtDirs, makeFsArtIo, } from '../simulation/art/fs_io.js';
+export { digestDynamicText } from '../simulation/toolkit/dynamic_digest.js';
+export { dynamicMeetingSystemPrompt } from '../simulation/toolkit/dynamic_meetings.js';
+export { compileStrictSimulationSchema, decodeStrictSimulationOutput } from '../simulation/toolkit/structured_output.js';
+export { evaluateChapterStanding, CHAPTER_MIN_DECISIONS, CHAPTER_MAX_DECISIONS, withPublicChoiceLinks, evaluateMilestones, evaluatePublicProgress, groupActs, summarizeMilestones } from '../simulation/toolkit/dynamic_progress.js';
+export { dynamicInitializationSchema, DEFAULT_DYNAMIC_INITIALIZATION, STORYTELLER_OPTIONS, parseDynamicInitialization, planStoryteller, storytellerMemory, pendingStorytellerSetbacks } from '../simulation/toolkit/dynamic_storyteller.js';
+// Dynamic state and replay can read host-injected archival storage.
+export { asDynamicStateJson, DynamicStateContractError, MAX_DYNAMIC_STATE_BYTES, parseDynamicSimulationState, parseDynamicCharacterProposal, retainedParsedDynamicStates, validateDynamicStateTransition, isRulesGeneration, } from '../simulation/toolkit/dynamic_state.js';
+export { advanceDynamicSimulation, compactCharacterProposalForHistory, findDynamicCharacterPrivacyRejection, makeDynamicCharacterRequest, makeDynamicMeetingSpeakerContext, makeCharacterFallback, makeDynamicPlayerChoices, containSameBeatIdentifierCollisions, makeDynamicCharacterCorrectionSystem, makeDynamicCharacterCorrectionRequest, assertDynamicCharacterRequestPrivacy, validateDynamicCharacterCorrectionChoices, validateDynamicCharacterProposalForActor, dynamicSimulationFailureCode, projectDynamicProgress, createDynamicSimulationState, DynamicDomainPolicyError, DynamicSimulationError, replayDynamicSimulation, validateDynamicDomainActionFeasibility, validateDynamicSimulationStateForPolicy, retainedDynamicPolicyStates, makeDynamicActorCorrectionRequest, validateDynamicActorCorrectionChoices, hasDynamicActorCorrectionPrivacyRejection, applyDynamicPublicCorrection, makeDynamicPublicCorrectionRequest, validateDynamicPublicCorrectionChoices, findDynamicPublicPrivacyRejection, replayDynamicMainConsequences, replayDynamicPublicConsequences, makeDynamicActorUpdateSystem, applyDynamicStoryReview, makeDynamicStoryReviewCandidate, quoteDynamicPlayerChoices, } from '../simulation/toolkit/dynamic_runtime.js';
+export { actorSeedsForPolicy, createDynamicSimulationRegistration, } from '../simulation/toolkit/dynamic_driver.js';
+export { assertDynamicInferenceKnowledge, dynamicPrivateKnowledge, dynamicPublishedKnowledge, DynamicKnowledgeContaminationError } from '../simulation/toolkit/dynamic_knowledge.js';
+export { normalizeDynamicActorResponse } from '../simulation/intervention_generation.js';
+export { StoryReviewError, makeDynamicStoryReviewRequest, replayDynamicStoryReview, STORY_REVIEW_INTERVAL, STORY_REVIEW_INPUT_BYTES, STORY_REVIEW_TIMEOUT_MS, STORY_REVIEW_MAX_TOKENS } from '../simulation/toolkit/dynamic_story_review.js';
+// Host-owned session inputs and checkpoint validation. These bind the
+// detached plugin host, so they live on this boundary side, not in the contract.
+export { registerSimulationCheckpointValidators } from '../simulation/plugin_host.js';
+export { checkpointInterventionContext, prepareSessionInput, sealSessionInputs, commitSessionInputBatch, projectSessionInputs, getSessionTransition, SimulationInputError, actorInterventionContext, checkpointInputJournal } from '../simulation/session_inputs.js';
+// Canonical dynamic history over host-injected archival storage.
+export { withDynamicHistoryStorage, dynamicHistoryReference, dynamicHistory, readDynamicHistory, DynamicHistoryError } from '../simulation/dynamic_history.js';
+export { freePlayerAction } from '../simulation/toolkit/dynamic_runtime.js';

package/dist/prompts/tool_delegate_task.j2

@@ -8,7 +8,7 @@ Good for:
 - Reading multiple files to gather information
 - Running shell commands to investigate system state
 
-The sub-agent runs independently and returns a summary. Its full trace (file reads, searches) does NOT consume your context — only the summary comes back.
+The sub-agent runs independently and returns an unverified summary plus a bounded source-linked evidence handoff. Omission counts are explicit. Child observations stay in the child's session; they never grant parent authority. Resume an owned child using child_session_id from its handoff to list session_evidence or recall_tool_response with the original tool-call handle. Missing sources remain unknown. A handoff from another parent or workspace cannot be resumed here.
 
 IMPORTANT: If the user says "in the background", "while you do X", "independently", or the result is NOT needed immediately, use spawn_background_agent instead — it returns instantly so you can keep talking.
 

package/dist/remote-broker/Dockerfile

@@ -0,0 +1,10 @@
+FROM python:3.12-slim@sha256:f77ac9e44ae96ef2c90b8053ea08c31f8be030f824196b0ae4db6d462c84e51f
+COPY requirements.txt /opt/ztc-broker/requirements.txt
+RUN /usr/local/bin/python3 -I -m pip install --no-cache-dir -r /opt/ztc-broker/requirements.txt \
+    && mkdir -p /data /state \
+    && chown 65532:65532 /data /state
+COPY server.py worker.py archive.py resources.json /opt/ztc-broker/
+WORKDIR /opt/ztc-broker
+USER 65532:65532
+EXPOSE 8787
+ENTRYPOINT ["/usr/local/bin/python3", "-I", "-B", "/opt/ztc-broker/server.py"]