golem-multi-instance-agent-ts

You create multiple stateful TypeScript agent instances by using phantom UUIDs to spawn agents that share constructor parameters but maintain independent identities and separated state for multi-session workflows.

To reconnect to a previously persisted agent instance, call the getPhantom method with the saved phantom UUID and the original shared parameters to restore that specific independent agent identity.

Yes, you can automatically create a fresh phantom agent instance for each incoming HTTP request by using optional HTTP-mounted phantom behavior and decorator options to handle parallel requests independently.

The get method provides non-phantom idempotent reuse of an agent instance, whereas newPhantom creates a completely fresh instance with a unique phantom UUID to ensure strict identity and state separation.

You scope agent identities by both constructor parameters and config fields by using WithConfig variants, which generate corresponding phantom and non-phantom methods when @config fields exist in the agent definition.

You need phantom agent instances for parallel request handling when multiple distinct sessions require shared constructor logic but must remain identity-separated by UUIDs to prevent state collision across concurrent operations.