[jhomra21]

Problem

The Welcome Wizard imports existing sessions from other agents, but not from Factory Droid. A Droid user has to start every conversation over in T3 Code.

Change

• AgentSessionScanner reads the .jsonl transcripts under ~/.factory/sessions/<session-slug>. It skips Droid child sessions, which are marked with callingSessionId or callingToolUseId, and it skips malformed transcripts and transcripts with no user message. When the transcript names no model, it reads the model from the session's .settings.json file.
• AgentSessionImporter saves the Droid session id as the provider thread's native id and as the runtime's resume cursor. When the imported thread starts, the Droid adapter loads that session with droid.load_session.
• WelcomeWizard lists Factory Droid as an import source and in its scan description, and the session-source contract includes it.
• The Droid and Welcome Wizard user guides say Droid sessions can be imported.

Scope and approval

This depends on the native Factory Droid provider PR and falls under the same Ideas discussion. (Ideas discussion: pingdotgg#27369) Against the provider branch, the diff is 9 files: the scanner and importer with their tests, the Welcome Wizard and its browser test, the session-source contract, and the two user guides.

Verification

• vp env exec --node 26.12.1 -- vp run --filter t3 --filter @t3tools/web --filter @t3tools/contracts typecheck: passed.
• vp env exec --node 26.12.1 -- vp test run apps/server/src/project/AgentSessionScanner.test.ts apps/server/src/project/AgentSessionImporter.test.ts: all passed except 2 scanner tests that create symlinks, which Windows refused without symlink permission (EPERM). The same 2 tests fail on the provider branch.
• Mutation checks on the pre-merge branch, where each removal failed its test:
  • removing the child-session exclusion;
  • replacing the saved Droid session id;
  • accepting a transcript with no user message.
• Not checked: WelcomeWizard.import.browser.test.tsx, because Playwright Chromium isn't installed on this machine, and the import flow in a real client after the merge.

Built with Claude Opus 5.5 orchestrating GPT-6 Luna and Claude Haiku 5.5 workers through Factory Droid in T3 Code. Upstream preparation by GPT-6.1 Terra, orchestrated by Claude Opus 5.5, through Factory Droid in T3 Code.

[github-actions]

Thread transfer impact

⚠️ The latest CI run did not produce a thread transfer result for c7321de.

This comment will update automatically after the next completed run.