@truefoundry/trueforge-core 0.2.0-rc.1 → 0.2.0-rc.3

package/dist/agent-session/Sessions.d.ts

@@ -1,8 +1,12 @@
 import { SessionHandle } from './SessionHandle';
 import type { CreateSessionInput, GetSessionByExternalIdInput, GetSessionInput, ISessionStore } from './store/ISessionStore';
-export type SessionsCreateInput<TSessionCustom extends object> = Omit<CreateSessionInput<TSessionCustom>, 'custom' | 'metadata'> & {
-    custom?: TSessionCustom | undefined;
-    metadata?: CreateSessionInput<TSessionCustom>['metadata'] | undefined;
+/**
+ * Domain create input: same as {@link CreateSessionInput}, but `custom`,
+ * `metadata`, and `source` are optional — {@link Sessions.create} defaults them
+ * (`null` / `{}` / `null`). The store contract requires those fields explicitly.
+ */
+export type SessionsCreateInput<TSessionCustom extends object> = Omit<CreateSessionInput<TSessionCustom>, 'custom' | 'metadata' | 'source'> & {
+    [K in 'custom' | 'metadata' | 'source']?: CreateSessionInput<TSessionCustom>[K] | undefined;
 };
 export declare class Sessions<TSessionCustom extends object = Record<string, never>, TTurnCustom extends object = Record<string, never>> {
     private readonly store;

package/dist/agent-session/Sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../src/agent-session/Sessions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAG/B,MAAM,MAAM,mBAAmB,CAAC,cAAc,SAAS,MAAM,IAAI,IAAI,CACnE,kBAAkB,CAAC,cAAc,CAAC,EAClC,QAAQ,GAAG,UAAU,CACtB,GAAG;IACF,MAAM,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;CACvE,CAAC;AAEF,qBAAa,QAAQ,CACnB,cAAc,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAElD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE,YAAY,IAAI,EAAE;QAAE,YAAY,EAAE,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;KAAE,EAE7E;IAED;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAiB5G;IAED;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,CASjG;IAED;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,CASjE;IAED;;OAEG;IACG,uBAAuB,CAC3B,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GACvG,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAyBpF;CACF"}
+{"version":3,"file":"Sessions.d.ts","sourceRoot":"","sources":["../../src/agent-session/Sessions.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAG/B;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,cAAc,SAAS,MAAM,IAAI,IAAI,CACnE,kBAAkB,CAAC,cAAc,CAAC,EAClC,QAAQ,GAAG,UAAU,GAAG,QAAQ,CACjC,GAAG;KACD,CAAC,IAAI,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAC5F,CAAC;AAEF,qBAAa,QAAQ,CACnB,cAAc,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrD,WAAW,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAElD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE,YAAY,IAAI,EAAE;QAAE,YAAY,EAAE,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;KAAE,EAE7E;IAED;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAkB5G;IAED;;;OAGG;IACG,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,CASjG;IAED;;;OAGG;IACG,eAAe,CACnB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,GAAG,SAAS,CAAC,CASjE;IAED;;OAEG;IACG,uBAAuB,CAC3B,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,EAAE,YAAY,GAAG,aAAa,CAAC,GAAG;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GACvG,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAyBpF;CACF"}

package/dist/agent-session/Sessions.js

@@ -38,7 +38,8 @@ var Sessions = class {
     await this.store.createSession({
       ...input,
       custom: input.custom ?? null,
-      metadata: input.metadata ?? {}
+      metadata: input.metadata ?? {},
+      source: input.source ?? null
     });
     const record = await this.store.getSession({
       tenant_id: input.tenant_id,

package/dist/agent-session/Sessions.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/Sessions.ts"],"sourcesContent":["/**\n * Storage-only session collection: create / get. Behavior arrives per run via\n * the resolver on {@link SessionHandle.createTurn}.\n */\nimport { ulid } from 'ulid';\nimport { SessionHandle } from './SessionHandle';\nimport type {\n  CreateSessionInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  ISessionStore,\n} from './store/ISessionStore';\nimport { SessionExternalIdConflictError } from './store/SessionStoreErrors';\n\nexport type SessionsCreateInput<TSessionCustom extends object> = Omit<\n  CreateSessionInput<TSessionCustom>,\n  'custom' | 'metadata'\n> & {\n  custom?: TSessionCustom | undefined;\n  metadata?: CreateSessionInput<TSessionCustom>['metadata'] | undefined;\n};\n\nexport class Sessions<\n  TSessionCustom extends object = Record<string, never>,\n  TTurnCustom extends object = Record<string, never>,\n> {\n  private readonly store: ISessionStore<TSessionCustom, TTurnCustom>;\n\n  constructor(deps: { sessionStore: ISessionStore<TSessionCustom, TTurnCustom> }) {\n    this.store = deps.sessionStore;\n  }\n\n  /**\n   * Creates and persists a new session with a reference or inline agent binding.\n   */\n  async create(input: SessionsCreateInput<TSessionCustom>): Promise<SessionHandle<TSessionCustom, TTurnCustom>> {\n    await this.store.createSession({\n      ...input,\n      custom: input.custom ?? null,\n      metadata: input.metadata ?? {},\n    });\n    const record = await this.store.getSession({\n      tenant_id: input.tenant_id,\n      session_id: input.session_id,\n    });\n    if (!record) {\n      throw new Error(`Session create succeeded but getSession returned undefined: ${input.session_id}`);\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session as stored (ref agents are not hydrated to a value), or\n   * undefined if not found. Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async get(input: GetSessionInput): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSession(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session bound to this tenant-scoped external id, or undefined.\n   * Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async getByExternalId(\n    input: GetSessionByExternalIdInput,\n  ): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSessionByExternalId(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Get-or-create the session bound to a tenant-scoped `external_id`.\n   */\n  async getOrCreateByExternalId(\n    input: Omit<SessionsCreateInput<TSessionCustom>, 'session_id' | 'external_id'> & { external_id: string },\n  ): Promise<{ session: SessionHandle<TSessionCustom, TTurnCustom>; created: boolean }> {\n    const { tenant_id, external_id } = input;\n\n    const existing = await this.getByExternalId({ tenant_id, external_id });\n    if (existing !== undefined) {\n      return { session: existing, created: false };\n    }\n\n    try {\n      const session = await this.create({\n        ...input,\n        session_id: ulid().toLowerCase(),\n        external_id,\n      });\n      return { session, created: true };\n    } catch (error) {\n      if (!(error instanceof SessionExternalIdConflictError)) {\n        throw error;\n      }\n      const winner = await this.getByExternalId({ tenant_id, external_id });\n      if (winner === undefined) {\n        throw error;\n      }\n      return { session: winner, created: false };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,kBAAqB;AACrB,2BAA8B;AAO9B,gCAA+C;AAUxC,IAAM,WAAN,MAGL;AAAA,EACiB;AAAA,EAEjB,YAAY,MAAoE;AAC9E,SAAK,QAAQ,KAAK;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAiG;AAC5G,UAAM,KAAK,MAAM,cAAc;AAAA,MAC7B,GAAG;AAAA,MACH,QAAQ,MAAM,UAAU;AAAA,MACxB,UAAU,MAAM,YAAY,CAAC;AAAA,IAC/B,CAAC;AACD,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW;AAAA,MACzC,WAAW,MAAM;AAAA,MACjB,YAAY,MAAM;AAAA,IACpB,CAAC;AACD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,+DAA+D,MAAM,UAAU,EAAE;AAAA,IACnG;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,OAAyF;AACjG,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW,KAAK;AAChD,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBACJ,OACiE;AACjE,UAAM,SAAS,MAAM,KAAK,MAAM,uBAAuB,KAAK;AAC5D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,OACoF;AACpF,UAAM,EAAE,WAAW,YAAY,IAAI;AAEnC,UAAM,WAAW,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACtE,QAAI,aAAa,QAAW;AAC1B,aAAO,EAAE,SAAS,UAAU,SAAS,MAAM;AAAA,IAC7C;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO;AAAA,QAChC,GAAG;AAAA,QACH,gBAAY,kBAAK,EAAE,YAAY;AAAA,QAC/B;AAAA,MACF,CAAC;AACD,aAAO,EAAE,SAAS,SAAS,KAAK;AAAA,IAClC,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,2DAAiC;AACtD,cAAM;AAAA,MACR;AACA,YAAM,SAAS,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACpE,UAAI,WAAW,QAAW;AACxB,cAAM;AAAA,MACR;AACA,aAAO,EAAE,SAAS,QAAQ,SAAS,MAAM;AAAA,IAC3C;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/agent-session/Sessions.ts"],"sourcesContent":["/**\n * Storage-only session collection: create / get. Behavior arrives per run via\n * the resolver on {@link SessionHandle.createTurn}.\n */\nimport { ulid } from 'ulid';\nimport { SessionHandle } from './SessionHandle';\nimport type {\n  CreateSessionInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  ISessionStore,\n} from './store/ISessionStore';\nimport { SessionExternalIdConflictError } from './store/SessionStoreErrors';\n\n/**\n * Domain create input: same as {@link CreateSessionInput}, but `custom`,\n * `metadata`, and `source` are optional — {@link Sessions.create} defaults them\n * (`null` / `{}` / `null`). The store contract requires those fields explicitly.\n */\nexport type SessionsCreateInput<TSessionCustom extends object> = Omit<\n  CreateSessionInput<TSessionCustom>,\n  'custom' | 'metadata' | 'source'\n> & {\n  [K in 'custom' | 'metadata' | 'source']?: CreateSessionInput<TSessionCustom>[K] | undefined;\n};\n\nexport class Sessions<\n  TSessionCustom extends object = Record<string, never>,\n  TTurnCustom extends object = Record<string, never>,\n> {\n  private readonly store: ISessionStore<TSessionCustom, TTurnCustom>;\n\n  constructor(deps: { sessionStore: ISessionStore<TSessionCustom, TTurnCustom> }) {\n    this.store = deps.sessionStore;\n  }\n\n  /**\n   * Creates and persists a new session with a reference or inline agent binding.\n   */\n  async create(input: SessionsCreateInput<TSessionCustom>): Promise<SessionHandle<TSessionCustom, TTurnCustom>> {\n    await this.store.createSession({\n      ...input,\n      custom: input.custom ?? null,\n      metadata: input.metadata ?? {},\n      source: input.source ?? null,\n    });\n    const record = await this.store.getSession({\n      tenant_id: input.tenant_id,\n      session_id: input.session_id,\n    });\n    if (!record) {\n      throw new Error(`Session create succeeded but getSession returned undefined: ${input.session_id}`);\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session as stored (ref agents are not hydrated to a value), or\n   * undefined if not found. Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async get(input: GetSessionInput): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSession(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session bound to this tenant-scoped external id, or undefined.\n   * Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async getByExternalId(\n    input: GetSessionByExternalIdInput,\n  ): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSessionByExternalId(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Get-or-create the session bound to a tenant-scoped `external_id`.\n   */\n  async getOrCreateByExternalId(\n    input: Omit<SessionsCreateInput<TSessionCustom>, 'session_id' | 'external_id'> & { external_id: string },\n  ): Promise<{ session: SessionHandle<TSessionCustom, TTurnCustom>; created: boolean }> {\n    const { tenant_id, external_id } = input;\n\n    const existing = await this.getByExternalId({ tenant_id, external_id });\n    if (existing !== undefined) {\n      return { session: existing, created: false };\n    }\n\n    try {\n      const session = await this.create({\n        ...input,\n        session_id: ulid().toLowerCase(),\n        external_id,\n      });\n      return { session, created: true };\n    } catch (error) {\n      if (!(error instanceof SessionExternalIdConflictError)) {\n        throw error;\n      }\n      const winner = await this.getByExternalId({ tenant_id, external_id });\n      if (winner === undefined) {\n        throw error;\n      }\n      return { session: winner, created: false };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAIA,kBAAqB;AACrB,2BAA8B;AAO9B,gCAA+C;AAcxC,IAAM,WAAN,MAGL;AAAA,EACiB;AAAA,EAEjB,YAAY,MAAoE;AAC9E,SAAK,QAAQ,KAAK;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAiG;AAC5G,UAAM,KAAK,MAAM,cAAc;AAAA,MAC7B,GAAG;AAAA,MACH,QAAQ,MAAM,UAAU;AAAA,MACxB,UAAU,MAAM,YAAY,CAAC;AAAA,MAC7B,QAAQ,MAAM,UAAU;AAAA,IAC1B,CAAC;AACD,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW;AAAA,MACzC,WAAW,MAAM;AAAA,MACjB,YAAY,MAAM;AAAA,IACpB,CAAC;AACD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,+DAA+D,MAAM,UAAU,EAAE;AAAA,IACnG;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,OAAyF;AACjG,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW,KAAK;AAChD,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBACJ,OACiE;AACjE,UAAM,SAAS,MAAM,KAAK,MAAM,uBAAuB,KAAK;AAC5D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,mCAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,OACoF;AACpF,UAAM,EAAE,WAAW,YAAY,IAAI;AAEnC,UAAM,WAAW,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACtE,QAAI,aAAa,QAAW;AAC1B,aAAO,EAAE,SAAS,UAAU,SAAS,MAAM;AAAA,IAC7C;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO;AAAA,QAChC,GAAG;AAAA,QACH,gBAAY,kBAAK,EAAE,YAAY;AAAA,QAC/B;AAAA,MACF,CAAC;AACD,aAAO,EAAE,SAAS,SAAS,KAAK;AAAA,IAClC,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,2DAAiC;AACtD,cAAM;AAAA,MACR;AACA,YAAM,SAAS,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACpE,UAAI,WAAW,QAAW;AACxB,cAAM;AAAA,MACR;AACA,aAAO,EAAE,SAAS,QAAQ,SAAS,MAAM;AAAA,IAC3C;AAAA,EACF;AACF;","names":[]}

package/dist/agent-session/Sessions.mjs

@@ -14,7 +14,8 @@ var Sessions = class {
     await this.store.createSession({
       ...input,
       custom: input.custom ?? null,
-      metadata: input.metadata ?? {}
+      metadata: input.metadata ?? {},
+      source: input.source ?? null
     });
     const record = await this.store.getSession({
       tenant_id: input.tenant_id,

package/dist/agent-session/Sessions.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/Sessions.ts"],"sourcesContent":["/**\n * Storage-only session collection: create / get. Behavior arrives per run via\n * the resolver on {@link SessionHandle.createTurn}.\n */\nimport { ulid } from 'ulid';\nimport { SessionHandle } from './SessionHandle';\nimport type {\n  CreateSessionInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  ISessionStore,\n} from './store/ISessionStore';\nimport { SessionExternalIdConflictError } from './store/SessionStoreErrors';\n\nexport type SessionsCreateInput<TSessionCustom extends object> = Omit<\n  CreateSessionInput<TSessionCustom>,\n  'custom' | 'metadata'\n> & {\n  custom?: TSessionCustom | undefined;\n  metadata?: CreateSessionInput<TSessionCustom>['metadata'] | undefined;\n};\n\nexport class Sessions<\n  TSessionCustom extends object = Record<string, never>,\n  TTurnCustom extends object = Record<string, never>,\n> {\n  private readonly store: ISessionStore<TSessionCustom, TTurnCustom>;\n\n  constructor(deps: { sessionStore: ISessionStore<TSessionCustom, TTurnCustom> }) {\n    this.store = deps.sessionStore;\n  }\n\n  /**\n   * Creates and persists a new session with a reference or inline agent binding.\n   */\n  async create(input: SessionsCreateInput<TSessionCustom>): Promise<SessionHandle<TSessionCustom, TTurnCustom>> {\n    await this.store.createSession({\n      ...input,\n      custom: input.custom ?? null,\n      metadata: input.metadata ?? {},\n    });\n    const record = await this.store.getSession({\n      tenant_id: input.tenant_id,\n      session_id: input.session_id,\n    });\n    if (!record) {\n      throw new Error(`Session create succeeded but getSession returned undefined: ${input.session_id}`);\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session as stored (ref agents are not hydrated to a value), or\n   * undefined if not found. Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async get(input: GetSessionInput): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSession(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session bound to this tenant-scoped external id, or undefined.\n   * Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async getByExternalId(\n    input: GetSessionByExternalIdInput,\n  ): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSessionByExternalId(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Get-or-create the session bound to a tenant-scoped `external_id`.\n   */\n  async getOrCreateByExternalId(\n    input: Omit<SessionsCreateInput<TSessionCustom>, 'session_id' | 'external_id'> & { external_id: string },\n  ): Promise<{ session: SessionHandle<TSessionCustom, TTurnCustom>; created: boolean }> {\n    const { tenant_id, external_id } = input;\n\n    const existing = await this.getByExternalId({ tenant_id, external_id });\n    if (existing !== undefined) {\n      return { session: existing, created: false };\n    }\n\n    try {\n      const session = await this.create({\n        ...input,\n        session_id: ulid().toLowerCase(),\n        external_id,\n      });\n      return { session, created: true };\n    } catch (error) {\n      if (!(error instanceof SessionExternalIdConflictError)) {\n        throw error;\n      }\n      const winner = await this.getByExternalId({ tenant_id, external_id });\n      if (winner === undefined) {\n        throw error;\n      }\n      return { session: winner, created: false };\n    }\n  }\n}\n"],"mappings":";AAIA,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAO9B,SAAS,sCAAsC;AAUxC,IAAM,WAAN,MAGL;AAAA,EACiB;AAAA,EAEjB,YAAY,MAAoE;AAC9E,SAAK,QAAQ,KAAK;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAiG;AAC5G,UAAM,KAAK,MAAM,cAAc;AAAA,MAC7B,GAAG;AAAA,MACH,QAAQ,MAAM,UAAU;AAAA,MACxB,UAAU,MAAM,YAAY,CAAC;AAAA,IAC/B,CAAC;AACD,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW;AAAA,MACzC,WAAW,MAAM;AAAA,MACjB,YAAY,MAAM;AAAA,IACpB,CAAC;AACD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,+DAA+D,MAAM,UAAU,EAAE;AAAA,IACnG;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,OAAyF;AACjG,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW,KAAK;AAChD,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBACJ,OACiE;AACjE,UAAM,SAAS,MAAM,KAAK,MAAM,uBAAuB,KAAK;AAC5D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,OACoF;AACpF,UAAM,EAAE,WAAW,YAAY,IAAI;AAEnC,UAAM,WAAW,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACtE,QAAI,aAAa,QAAW;AAC1B,aAAO,EAAE,SAAS,UAAU,SAAS,MAAM;AAAA,IAC7C;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO;AAAA,QAChC,GAAG;AAAA,QACH,YAAY,KAAK,EAAE,YAAY;AAAA,QAC/B;AAAA,MACF,CAAC;AACD,aAAO,EAAE,SAAS,SAAS,KAAK;AAAA,IAClC,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,iCAAiC;AACtD,cAAM;AAAA,MACR;AACA,YAAM,SAAS,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACpE,UAAI,WAAW,QAAW;AACxB,cAAM;AAAA,MACR;AACA,aAAO,EAAE,SAAS,QAAQ,SAAS,MAAM;AAAA,IAC3C;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/agent-session/Sessions.ts"],"sourcesContent":["/**\n * Storage-only session collection: create / get. Behavior arrives per run via\n * the resolver on {@link SessionHandle.createTurn}.\n */\nimport { ulid } from 'ulid';\nimport { SessionHandle } from './SessionHandle';\nimport type {\n  CreateSessionInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  ISessionStore,\n} from './store/ISessionStore';\nimport { SessionExternalIdConflictError } from './store/SessionStoreErrors';\n\n/**\n * Domain create input: same as {@link CreateSessionInput}, but `custom`,\n * `metadata`, and `source` are optional — {@link Sessions.create} defaults them\n * (`null` / `{}` / `null`). The store contract requires those fields explicitly.\n */\nexport type SessionsCreateInput<TSessionCustom extends object> = Omit<\n  CreateSessionInput<TSessionCustom>,\n  'custom' | 'metadata' | 'source'\n> & {\n  [K in 'custom' | 'metadata' | 'source']?: CreateSessionInput<TSessionCustom>[K] | undefined;\n};\n\nexport class Sessions<\n  TSessionCustom extends object = Record<string, never>,\n  TTurnCustom extends object = Record<string, never>,\n> {\n  private readonly store: ISessionStore<TSessionCustom, TTurnCustom>;\n\n  constructor(deps: { sessionStore: ISessionStore<TSessionCustom, TTurnCustom> }) {\n    this.store = deps.sessionStore;\n  }\n\n  /**\n   * Creates and persists a new session with a reference or inline agent binding.\n   */\n  async create(input: SessionsCreateInput<TSessionCustom>): Promise<SessionHandle<TSessionCustom, TTurnCustom>> {\n    await this.store.createSession({\n      ...input,\n      custom: input.custom ?? null,\n      metadata: input.metadata ?? {},\n      source: input.source ?? null,\n    });\n    const record = await this.store.getSession({\n      tenant_id: input.tenant_id,\n      session_id: input.session_id,\n    });\n    if (!record) {\n      throw new Error(`Session create succeeded but getSession returned undefined: ${input.session_id}`);\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session as stored (ref agents are not hydrated to a value), or\n   * undefined if not found. Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async get(input: GetSessionInput): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSession(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Returns the session bound to this tenant-scoped external id, or undefined.\n   * Read-only: does not bump last_activity_timestamp_ms.\n   */\n  async getByExternalId(\n    input: GetSessionByExternalIdInput,\n  ): Promise<SessionHandle<TSessionCustom, TTurnCustom> | undefined> {\n    const record = await this.store.getSessionByExternalId(input);\n    if (!record) {\n      return undefined;\n    }\n    return new SessionHandle({\n      store: this.store,\n      session: record,\n    });\n  }\n\n  /**\n   * Get-or-create the session bound to a tenant-scoped `external_id`.\n   */\n  async getOrCreateByExternalId(\n    input: Omit<SessionsCreateInput<TSessionCustom>, 'session_id' | 'external_id'> & { external_id: string },\n  ): Promise<{ session: SessionHandle<TSessionCustom, TTurnCustom>; created: boolean }> {\n    const { tenant_id, external_id } = input;\n\n    const existing = await this.getByExternalId({ tenant_id, external_id });\n    if (existing !== undefined) {\n      return { session: existing, created: false };\n    }\n\n    try {\n      const session = await this.create({\n        ...input,\n        session_id: ulid().toLowerCase(),\n        external_id,\n      });\n      return { session, created: true };\n    } catch (error) {\n      if (!(error instanceof SessionExternalIdConflictError)) {\n        throw error;\n      }\n      const winner = await this.getByExternalId({ tenant_id, external_id });\n      if (winner === undefined) {\n        throw error;\n      }\n      return { session: winner, created: false };\n    }\n  }\n}\n"],"mappings":";AAIA,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAO9B,SAAS,sCAAsC;AAcxC,IAAM,WAAN,MAGL;AAAA,EACiB;AAAA,EAEjB,YAAY,MAAoE;AAC9E,SAAK,QAAQ,KAAK;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,OAAiG;AAC5G,UAAM,KAAK,MAAM,cAAc;AAAA,MAC7B,GAAG;AAAA,MACH,QAAQ,MAAM,UAAU;AAAA,MACxB,UAAU,MAAM,YAAY,CAAC;AAAA,MAC7B,QAAQ,MAAM,UAAU;AAAA,IAC1B,CAAC;AACD,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW;AAAA,MACzC,WAAW,MAAM;AAAA,MACjB,YAAY,MAAM;AAAA,IACpB,CAAC;AACD,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,+DAA+D,MAAM,UAAU,EAAE;AAAA,IACnG;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,OAAyF;AACjG,UAAM,SAAS,MAAM,KAAK,MAAM,WAAW,KAAK;AAChD,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,gBACJ,OACiE;AACjE,UAAM,SAAS,MAAM,KAAK,MAAM,uBAAuB,KAAK;AAC5D,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AACA,WAAO,IAAI,cAAc;AAAA,MACvB,OAAO,KAAK;AAAA,MACZ,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,wBACJ,OACoF;AACpF,UAAM,EAAE,WAAW,YAAY,IAAI;AAEnC,UAAM,WAAW,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACtE,QAAI,aAAa,QAAW;AAC1B,aAAO,EAAE,SAAS,UAAU,SAAS,MAAM;AAAA,IAC7C;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,KAAK,OAAO;AAAA,QAChC,GAAG;AAAA,QACH,YAAY,KAAK,EAAE,YAAY;AAAA,QAC/B;AAAA,MACF,CAAC;AACD,aAAO,EAAE,SAAS,SAAS,KAAK;AAAA,IAClC,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,iCAAiC;AACtD,cAAM;AAAA,MACR;AACA,YAAM,SAAS,MAAM,KAAK,gBAAgB,EAAE,WAAW,YAAY,CAAC;AACpE,UAAI,WAAW,QAAW;AACxB,cAAM;AAAA,MACR;AACA,aAAO,EAAE,SAAS,QAAQ,SAAS,MAAM;AAAA,IAC3C;AAAA,EACF;AACF;","names":[]}

package/dist/agent-session/TurnResourceResolver.d.ts

@@ -26,15 +26,16 @@ export type TurnSandboxFactory = (input: {
  * behavior; subclass and override to customize (tool sources, sandbox,
  * tracing).
  */
+interface ResolvedModel {
+    modelClient: ILLM;
+    defaultModelParams: ModelParams;
+    modelProperties?: AgentDefinition['modelProperties'];
+}
 export declare class TurnResourceResolver<TTurnCustom extends object = Record<string, never>> implements ITurnResourceResolver<TTurnCustom> {
     #private;
     protected readonly deps: {
         /** Model name → client and defaults. Called once per resolved definition; may load provider config. */
-        llm: (model: string) => Promise<{
-            modelClient: ILLM;
-            defaultModelParams: ModelParams;
-            modelProperties?: AgentDefinition['modelProperties'];
-        }>;
+        llm: (model: string) => Promise<ResolvedModel>;
         /**
          * MCP server name → connection details. Required to use spec.mcp_servers:
          * the AgentSpec carries names only (no url/headers on the wire) — the
@@ -59,11 +60,7 @@ export declare class TurnResourceResolver<TTurnCustom extends object = Record<st
     };
     constructor(deps: {
         /** Model name → client and defaults. Called once per resolved definition; may load provider config. */
-        llm: (model: string) => Promise<{
-            modelClient: ILLM;
-            defaultModelParams: ModelParams;
-            modelProperties?: AgentDefinition['modelProperties'];
-        }>;
+        llm: (model: string) => Promise<ResolvedModel>;
         /**
          * MCP server name → connection details. Required to use spec.mcp_servers:
          * the AgentSpec carries names only (no url/headers on the wire) — the
@@ -147,5 +144,11 @@ export declare class TurnResourceResolver<TTurnCustom extends object = Record<st
         id: string;
         create: () => Promise<ToolSource>;
     }): Promise<ToolSource>;
+    /**
+     * Resolves `deps.llm` once per distinct model name for this turn — parent and
+     * sub-agents with the same catalog model share one promise.
+     */
+    protected getModel(modelName: string): Promise<ResolvedModel>;
 }
+export {};
 //# sourceMappingURL=TurnResourceResolver.d.ts.map

package/dist/agent-session/TurnResourceResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TurnResourceResolver.d.ts","sourceRoot":"","sources":["../../src/agent-session/TurnResourceResolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TurnResourceResolver.d.ts","sourceRoot":"","sources":["../../src/agent-session/TurnResourceResolver.ts"],"names":[],"mappings":"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"}

package/dist/agent-session/TurnResourceResolver.js

@@ -43,6 +43,7 @@ var TurnResourceResolver = class {
   }
   deps;
   #sources = /* @__PURE__ */ new Map();
+  #models = /* @__PURE__ */ new Map();
   #sandbox;
   get logger() {
     return this.deps.logger;
@@ -135,7 +136,7 @@ var TurnResourceResolver = class {
       })
     );
     const modelName = agentInfo?.model ?? spec.model.name;
-    const resolvedModel = await this.deps.llm(modelName);
+    const resolvedModel = await this.getModel(modelName);
     return {
       definition: {
         modelClient: resolvedModel.modelClient,
@@ -172,6 +173,19 @@ var TurnResourceResolver = class {
     this.#sources.set(input.id, made);
     return made;
   }
+  /**
+   * Resolves `deps.llm` once per distinct model name for this turn — parent and
+   * sub-agents with the same catalog model share one promise.
+   */
+  getModel(modelName) {
+    const cached = this.#models.get(modelName);
+    if (cached) {
+      return cached;
+    }
+    const made = this.deps.llm(modelName);
+    this.#models.set(modelName, made);
+    return made;
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/agent-session/TurnResourceResolver.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/TurnResourceResolver.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport type { ILLM } from '../core/llm/ILLM';\nimport type { ToolSource } from '../core/mcp/IMCPServer';\nimport { RemoteMCP, type RemoteMcpHeaders } from '../core/mcp/RemoteMCP';\nimport type { ToolSelectorConfig } from '../core/mcp/ToolSelectorPolicy';\nimport { ToolSet } from '../core/mcp/ToolSet';\nimport type { AgentDefinition, ModelParams } from '../core/runtime/AgentDefinition';\nimport type { AgentInfo } from '../core/runtime/AgentThread.types';\nimport type { Sandbox, SandboxInfo } from '../core/sandbox/Sandbox';\nimport type { AgentTracing } from '../core/tracing/AgentTracing';\nimport { NOOP_AGENT_TRACING } from '../core/tracing/NoopAgentTracing';\nimport type { ITurnResourceResolver, ResolvedAgentDefinition } from './ITurnResourceResolver';\nimport type { TurnRecord } from './models/TurnRecord';\nimport type { AgentSpec } from './schemas/agentSpec';\n\n/**\n * Factory that creates a Sandbox handle for a run (reattach via\n * existingSandboxId). `spec` carries the sandbox-relevant agent settings\n * (e.g. config.sandbox.file_downloads) so implementations can shape the\n * Sandbox per run without the factory type growing a field per option.\n */\nexport type TurnSandboxFactory = (input: {\n  spec: AgentSpec;\n  existingSandboxId?: string | undefined;\n  signal: AbortSignal;\n  tracing: AgentTracing;\n}) => Promise<Sandbox>;\n\nfunction specWantsSandbox(spec: AgentSpec): boolean {\n  return spec.config.sandbox.enabled;\n}\n\nfunction toSelectors(entry: {\n  enable_tools: string[];\n  disable_tools: string[];\n  preload_tools: string[];\n  require_approval_for_tools: string[];\n}): ToolSelectorConfig {\n  return {\n    enableTools: entry.enable_tools,\n    disableTools: entry.disable_tools,\n    preloadTools: entry.preload_tools,\n    requireApprovalForTools: entry.require_approval_for_tools,\n  };\n}\n\n/**\n * Batteries-included base implementation. Construct-and-go for the default\n * behavior; subclass and override to customize (tool sources, sandbox,\n * tracing).\n */\nexport class TurnResourceResolver<\n  TTurnCustom extends object = Record<string, never>,\n> implements ITurnResourceResolver<TTurnCustom> {\n  readonly #sources = new Map<string, Promise<ToolSource>>();\n  #sandbox?: Sandbox | undefined;\n\n  constructor(\n    protected readonly deps: {\n      /** Model name → client and defaults. Called once per resolved definition; may load provider config. */\n      llm: (model: string) => Promise<{\n        modelClient: ILLM;\n        defaultModelParams: ModelParams;\n        modelProperties?: AgentDefinition['modelProperties'];\n      }>;\n      /**\n       * MCP server name → connection details. Required to use spec.mcp_servers:\n       * the AgentSpec carries names only (no url/headers on the wire) — the\n       * runtime supplies the catalog. Called once per distinct server name per\n       * turn. Throw for unknown names. `headers` supports the async resolver form.\n       */\n      mcp: (name: string) => Promise<{ url: string; headers?: RemoteMcpHeaders }>;\n      mcpRequestTimeoutMs: number;\n      mcpConnectTimeoutMs: number;\n      /** One sandbox type per runtime. Omit = no sandbox support. */\n      sandboxProvider?: TurnSandboxFactory | undefined;\n      /**\n       * Named-agent lookup (registry id → live AgentSpec). Required when a\n       * session is bound by reference; omit only if all sessions use inline agents.\n       */\n      agent?: ((agentId: string) => Promise<AgentSpec>) | undefined;\n      /** Forwarded to RemoteMCP / AgentThread (required by their constructors). */\n      logger: Logger;\n    },\n  ) {}\n\n  get logger(): Logger {\n    return this.deps.logger;\n  }\n\n  /** Default: no-op tracing. Override to plug in a real tracer. */\n  createTracing(): AgentTracing {\n    return NOOP_AGENT_TRACING;\n  }\n\n  /** Named (ref) session agent → live registry lookup via deps.agent. */\n  async resolveAgentSpec(input: { agent_id: string }): Promise<AgentSpec> {\n    if (this.deps.agent === undefined) {\n      // Host forgot to wire deps.agent — not \"agent id missing from the registry\"\n      // (that failure belongs in the lookup callback, e.g. HTTP 422 on the server).\n      throw new Error(\n        `Named agent '${input.agent_id}' cannot be resolved: no agent lookup configured on the turn resolver`,\n      );\n    }\n    return await this.deps.agent(input.agent_id);\n  }\n\n  /**\n   * Default: creates a sandbox iff a provider is configured AND the spec wants\n   * one; reattaches to the previous turn's VM via `existing.sandbox_id` when\n   * present. Overrides that resolve their own sandbox must assign it so\n   * close() can release it (or override close() too).\n   */\n  async resolveSandbox(input: {\n    spec: AgentSpec;\n    existing?: SandboxInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<Sandbox | undefined> {\n    if (!this.deps.sandboxProvider || !specWantsSandbox(input.spec)) {\n      return undefined;\n    }\n    this.#sandbox = await this.deps.sandboxProvider({\n      spec: input.spec,\n      existingSandboxId: input.existing?.sandbox_id,\n      signal: input.signal,\n      tracing: input.tracing,\n    });\n    return this.#sandbox;\n  }\n\n  /**\n   * Closes the sandbox HANDLE if one was resolved. This releases only this\n   * process's connection (local bridge); the sandbox VM keeps running and the\n   * next turn reattaches via `existing.sandbox_id`.\n   *\n   * Tool sources (MCP connections) are intentionally NOT closed: the run's\n   * AbortSignal already aborts their in-flight calls, and connections are\n   * per-run objects that are simply dropped. If deterministic MCP socket\n   * release is ever needed, add it here — no contract change required.\n   *\n   * Subclasses that acquire additional resources MUST override, release\n   * their own resources best-effort, and call `await super.close()`.\n   * Idempotent; never throws.\n   */\n  async close(): Promise<void> {\n    const sandbox = this.#sandbox;\n    this.#sandbox = undefined;\n    await sandbox?.close().catch(() => {\n      /* no-op */\n    });\n  }\n\n  /**\n   * Default: maps the spec directly to a definition — spec.mcp_servers carry\n   * names only; deps.mcp resolves each name to url/headers, and the result\n   * becomes a RemoteMCP source (deduped per turn via getOrCreateToolSource)\n   * wrapped in a per-agent ToolSet view. Passes the previous turn's persisted\n   * MCP session_id into RemoteMCP for cross-turn stateful resume.\n   */\n  async resolveAgentDefinition(input: {\n    spec: AgentSpec;\n    agent_info?: AgentInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<ResolvedAgentDefinition> {\n    const { spec, agent_info: agentInfo, previousTurn, signal, tracing } = input;\n    const toolSets = await Promise.all(\n      (spec.mcp_servers ?? []).map(async entry => {\n        const source = await this.getOrCreateToolSource({\n          id: entry.name,\n          create: async () => {\n            const { url, headers } = await this.deps.mcp(entry.name);\n            return new RemoteMCP({\n              id: entry.name,\n              name: entry.name,\n              url,\n              headers: headers ?? {},\n              sessionId: previousTurn?.snapshot.mcp_servers?.[entry.name]?.session_id,\n              requestTimeoutMs: this.deps.mcpRequestTimeoutMs,\n              connectTimeoutMs: this.deps.mcpConnectTimeoutMs,\n              logger: this.deps.logger,\n              tracing,\n              signal,\n            });\n          },\n        });\n        return new ToolSet({\n          source,\n          selectors: toSelectors(entry),\n          preload: entry.preload,\n        });\n      }),\n    );\n    // Sub-agents may request a different catalog model via agent_info.model;\n    // resolve that name so modelClient matches the override (not just a label).\n    const modelName = agentInfo?.model ?? spec.model.name;\n    const resolvedModel = await this.deps.llm(modelName);\n    return {\n      definition: {\n        modelClient: resolvedModel.modelClient,\n        modelProperties: resolvedModel.modelProperties,\n        // Sub-agents receive the delegated task as a user message; their system\n        // prompt is SUB_AGENT_IDENTITY (added by AgentThread), not user instructions.\n        instruction: agentInfo ? undefined : spec.instructions,\n        messages: agentInfo\n          ? [{ role: 'user' as const, content: agentInfo.input }]\n          : spec.messages?.map(m => ({ role: 'user' as const, content: m.content })),\n        modelParams: {\n          ...resolvedModel.defaultModelParams,\n          ...spec.model.params,\n        },\n        // Sub-agents should return free-form summaries to the parent, not the user-facing structured response.\n        responseFormat: agentInfo ? undefined : spec.response_format,\n        iterationLimit: spec.config.iteration_limit,\n        toolSets,\n      },\n    };\n  }\n\n  /**\n   * Returns the tool source for `id`, creating it on first call — use from\n   * resolveAgentDefinition overrides so agents sharing a server share one\n   * connection. Single-flight by id: the promise is stored synchronously (no\n   * await between get and set), so overlapping resolveAgentDefinition calls\n   * can never double-create. Rejections stay cached: one attempt per turn.\n   * Do not override.\n   */\n  protected getOrCreateToolSource(input: { id: string; create: () => Promise<ToolSource> }): Promise<ToolSource> {\n    const cached = this.#sources.get(input.id);\n    if (cached) {\n      return cached;\n    }\n    const made = input.create();\n    this.#sources.set(input.id, made);\n    return made;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/agent-session/TurnResourceResolver.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport type { ILLM } from '../core/llm/ILLM';\nimport type { ToolSource } from '../core/mcp/IMCPServer';\nimport { RemoteMCP, type RemoteMcpHeaders } from '../core/mcp/RemoteMCP';\nimport type { ToolSelectorConfig } from '../core/mcp/ToolSelectorPolicy';\nimport { ToolSet } from '../core/mcp/ToolSet';\nimport type { AgentDefinition, ModelParams } from '../core/runtime/AgentDefinition';\nimport type { AgentInfo } from '../core/runtime/AgentThread.types';\nimport type { Sandbox, SandboxInfo } from '../core/sandbox/Sandbox';\nimport type { AgentTracing } from '../core/tracing/AgentTracing';\nimport { NOOP_AGENT_TRACING } from '../core/tracing/NoopAgentTracing';\nimport type { ITurnResourceResolver, ResolvedAgentDefinition } from './ITurnResourceResolver';\nimport type { TurnRecord } from './models/TurnRecord';\nimport type { AgentSpec } from './schemas/agentSpec';\n\n/**\n * Factory that creates a Sandbox handle for a run (reattach via\n * existingSandboxId). `spec` carries the sandbox-relevant agent settings\n * (e.g. config.sandbox.file_downloads) so implementations can shape the\n * Sandbox per run without the factory type growing a field per option.\n */\nexport type TurnSandboxFactory = (input: {\n  spec: AgentSpec;\n  existingSandboxId?: string | undefined;\n  signal: AbortSignal;\n  tracing: AgentTracing;\n}) => Promise<Sandbox>;\n\nfunction specWantsSandbox(spec: AgentSpec): boolean {\n  return spec.config.sandbox.enabled;\n}\n\nfunction toSelectors(entry: {\n  enable_tools: string[];\n  disable_tools: string[];\n  preload_tools: string[];\n  require_approval_for_tools: string[];\n}): ToolSelectorConfig {\n  return {\n    enableTools: entry.enable_tools,\n    disableTools: entry.disable_tools,\n    preloadTools: entry.preload_tools,\n    requireApprovalForTools: entry.require_approval_for_tools,\n  };\n}\n\n/**\n * Batteries-included base implementation. Construct-and-go for the default\n * behavior; subclass and override to customize (tool sources, sandbox,\n * tracing).\n */\ninterface ResolvedModel {\n  modelClient: ILLM;\n  defaultModelParams: ModelParams;\n  modelProperties?: AgentDefinition['modelProperties'];\n}\n\nexport class TurnResourceResolver<\n  TTurnCustom extends object = Record<string, never>,\n> implements ITurnResourceResolver<TTurnCustom> {\n  readonly #sources = new Map<string, Promise<ToolSource>>();\n  readonly #models = new Map<string, Promise<ResolvedModel>>();\n  #sandbox?: Sandbox | undefined;\n\n  constructor(\n    protected readonly deps: {\n      /** Model name → client and defaults. Called once per resolved definition; may load provider config. */\n      llm: (model: string) => Promise<ResolvedModel>;\n      /**\n       * MCP server name → connection details. Required to use spec.mcp_servers:\n       * the AgentSpec carries names only (no url/headers on the wire) — the\n       * runtime supplies the catalog. Called once per distinct server name per\n       * turn. Throw for unknown names. `headers` supports the async resolver form.\n       */\n      mcp: (name: string) => Promise<{ url: string; headers?: RemoteMcpHeaders }>;\n      mcpRequestTimeoutMs: number;\n      mcpConnectTimeoutMs: number;\n      /** One sandbox type per runtime. Omit = no sandbox support. */\n      sandboxProvider?: TurnSandboxFactory | undefined;\n      /**\n       * Named-agent lookup (registry id → live AgentSpec). Required when a\n       * session is bound by reference; omit only if all sessions use inline agents.\n       */\n      agent?: ((agentId: string) => Promise<AgentSpec>) | undefined;\n      /** Forwarded to RemoteMCP / AgentThread (required by their constructors). */\n      logger: Logger;\n    },\n  ) {}\n\n  get logger(): Logger {\n    return this.deps.logger;\n  }\n\n  /** Default: no-op tracing. Override to plug in a real tracer. */\n  createTracing(): AgentTracing {\n    return NOOP_AGENT_TRACING;\n  }\n\n  /** Named (ref) session agent → live registry lookup via deps.agent. */\n  async resolveAgentSpec(input: { agent_id: string }): Promise<AgentSpec> {\n    if (this.deps.agent === undefined) {\n      // Host forgot to wire deps.agent — not \"agent id missing from the registry\"\n      // (that failure belongs in the lookup callback, e.g. HTTP 422 on the server).\n      throw new Error(\n        `Named agent '${input.agent_id}' cannot be resolved: no agent lookup configured on the turn resolver`,\n      );\n    }\n    return await this.deps.agent(input.agent_id);\n  }\n\n  /**\n   * Default: creates a sandbox iff a provider is configured AND the spec wants\n   * one; reattaches to the previous turn's VM via `existing.sandbox_id` when\n   * present. Overrides that resolve their own sandbox must assign it so\n   * close() can release it (or override close() too).\n   */\n  async resolveSandbox(input: {\n    spec: AgentSpec;\n    existing?: SandboxInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<Sandbox | undefined> {\n    if (!this.deps.sandboxProvider || !specWantsSandbox(input.spec)) {\n      return undefined;\n    }\n    this.#sandbox = await this.deps.sandboxProvider({\n      spec: input.spec,\n      existingSandboxId: input.existing?.sandbox_id,\n      signal: input.signal,\n      tracing: input.tracing,\n    });\n    return this.#sandbox;\n  }\n\n  /**\n   * Closes the sandbox HANDLE if one was resolved. This releases only this\n   * process's connection (local bridge); the sandbox VM keeps running and the\n   * next turn reattaches via `existing.sandbox_id`.\n   *\n   * Tool sources (MCP connections) are intentionally NOT closed: the run's\n   * AbortSignal already aborts their in-flight calls, and connections are\n   * per-run objects that are simply dropped. If deterministic MCP socket\n   * release is ever needed, add it here — no contract change required.\n   *\n   * Subclasses that acquire additional resources MUST override, release\n   * their own resources best-effort, and call `await super.close()`.\n   * Idempotent; never throws.\n   */\n  async close(): Promise<void> {\n    const sandbox = this.#sandbox;\n    this.#sandbox = undefined;\n    await sandbox?.close().catch(() => {\n      /* no-op */\n    });\n  }\n\n  /**\n   * Default: maps the spec directly to a definition — spec.mcp_servers carry\n   * names only; deps.mcp resolves each name to url/headers, and the result\n   * becomes a RemoteMCP source (deduped per turn via getOrCreateToolSource)\n   * wrapped in a per-agent ToolSet view. Passes the previous turn's persisted\n   * MCP session_id into RemoteMCP for cross-turn stateful resume.\n   */\n  async resolveAgentDefinition(input: {\n    spec: AgentSpec;\n    agent_info?: AgentInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<ResolvedAgentDefinition> {\n    const { spec, agent_info: agentInfo, previousTurn, signal, tracing } = input;\n    const toolSets = await Promise.all(\n      (spec.mcp_servers ?? []).map(async entry => {\n        const source = await this.getOrCreateToolSource({\n          id: entry.name,\n          create: async () => {\n            const { url, headers } = await this.deps.mcp(entry.name);\n            return new RemoteMCP({\n              id: entry.name,\n              name: entry.name,\n              url,\n              headers: headers ?? {},\n              sessionId: previousTurn?.snapshot.mcp_servers?.[entry.name]?.session_id,\n              requestTimeoutMs: this.deps.mcpRequestTimeoutMs,\n              connectTimeoutMs: this.deps.mcpConnectTimeoutMs,\n              logger: this.deps.logger,\n              tracing,\n              signal,\n            });\n          },\n        });\n        return new ToolSet({\n          source,\n          selectors: toSelectors(entry),\n          preload: entry.preload,\n        });\n      }),\n    );\n    // Sub-agents may request a different catalog model via agent_info.model;\n    // resolve that name so modelClient matches the override (not just a label).\n    const modelName = agentInfo?.model ?? spec.model.name;\n    const resolvedModel = await this.getModel(modelName);\n    return {\n      definition: {\n        modelClient: resolvedModel.modelClient,\n        modelProperties: resolvedModel.modelProperties,\n        // Sub-agents receive the delegated task as a user message; their system\n        // prompt is SUB_AGENT_IDENTITY (added by AgentThread), not user instructions.\n        instruction: agentInfo ? undefined : spec.instructions,\n        messages: agentInfo\n          ? [{ role: 'user' as const, content: agentInfo.input }]\n          : spec.messages?.map(m => ({ role: 'user' as const, content: m.content })),\n        modelParams: {\n          ...resolvedModel.defaultModelParams,\n          ...spec.model.params,\n        },\n        // Sub-agents should return free-form summaries to the parent, not the user-facing structured response.\n        responseFormat: agentInfo ? undefined : spec.response_format,\n        iterationLimit: spec.config.iteration_limit,\n        toolSets,\n      },\n    };\n  }\n\n  /**\n   * Returns the tool source for `id`, creating it on first call — use from\n   * resolveAgentDefinition overrides so agents sharing a server share one\n   * connection. Single-flight by id: the promise is stored synchronously (no\n   * await between get and set), so overlapping resolveAgentDefinition calls\n   * can never double-create. Rejections stay cached: one attempt per turn.\n   * Do not override.\n   */\n  protected getOrCreateToolSource(input: { id: string; create: () => Promise<ToolSource> }): Promise<ToolSource> {\n    const cached = this.#sources.get(input.id);\n    if (cached) {\n      return cached;\n    }\n    const made = input.create();\n    this.#sources.set(input.id, made);\n    return made;\n  }\n\n  /**\n   * Resolves `deps.llm` once per distinct model name for this turn — parent and\n   * sub-agents with the same catalog model share one promise.\n   */\n  protected getModel(modelName: string): Promise<ResolvedModel> {\n    const cached = this.#models.get(modelName);\n    if (cached) {\n      return cached;\n    }\n    const made = this.deps.llm(modelName);\n    this.#models.set(modelName, made);\n    return made;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/agent-session/TurnResourceResolver.mjs

@@ -19,6 +19,7 @@ var TurnResourceResolver = class {
   }
   deps;
   #sources = /* @__PURE__ */ new Map();
+  #models = /* @__PURE__ */ new Map();
   #sandbox;
   get logger() {
     return this.deps.logger;
@@ -111,7 +112,7 @@ var TurnResourceResolver = class {
       })
     );
     const modelName = agentInfo?.model ?? spec.model.name;
-    const resolvedModel = await this.deps.llm(modelName);
+    const resolvedModel = await this.getModel(modelName);
     return {
       definition: {
         modelClient: resolvedModel.modelClient,
@@ -148,6 +149,19 @@ var TurnResourceResolver = class {
     this.#sources.set(input.id, made);
     return made;
   }
+  /**
+   * Resolves `deps.llm` once per distinct model name for this turn — parent and
+   * sub-agents with the same catalog model share one promise.
+   */
+  getModel(modelName) {
+    const cached = this.#models.get(modelName);
+    if (cached) {
+      return cached;
+    }
+    const made = this.deps.llm(modelName);
+    this.#models.set(modelName, made);
+    return made;
+  }
 };
 export {
   TurnResourceResolver

package/dist/agent-session/TurnResourceResolver.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/TurnResourceResolver.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport type { ILLM } from '../core/llm/ILLM';\nimport type { ToolSource } from '../core/mcp/IMCPServer';\nimport { RemoteMCP, type RemoteMcpHeaders } from '../core/mcp/RemoteMCP';\nimport type { ToolSelectorConfig } from '../core/mcp/ToolSelectorPolicy';\nimport { ToolSet } from '../core/mcp/ToolSet';\nimport type { AgentDefinition, ModelParams } from '../core/runtime/AgentDefinition';\nimport type { AgentInfo } from '../core/runtime/AgentThread.types';\nimport type { Sandbox, SandboxInfo } from '../core/sandbox/Sandbox';\nimport type { AgentTracing } from '../core/tracing/AgentTracing';\nimport { NOOP_AGENT_TRACING } from '../core/tracing/NoopAgentTracing';\nimport type { ITurnResourceResolver, ResolvedAgentDefinition } from './ITurnResourceResolver';\nimport type { TurnRecord } from './models/TurnRecord';\nimport type { AgentSpec } from './schemas/agentSpec';\n\n/**\n * Factory that creates a Sandbox handle for a run (reattach via\n * existingSandboxId). `spec` carries the sandbox-relevant agent settings\n * (e.g. config.sandbox.file_downloads) so implementations can shape the\n * Sandbox per run without the factory type growing a field per option.\n */\nexport type TurnSandboxFactory = (input: {\n  spec: AgentSpec;\n  existingSandboxId?: string | undefined;\n  signal: AbortSignal;\n  tracing: AgentTracing;\n}) => Promise<Sandbox>;\n\nfunction specWantsSandbox(spec: AgentSpec): boolean {\n  return spec.config.sandbox.enabled;\n}\n\nfunction toSelectors(entry: {\n  enable_tools: string[];\n  disable_tools: string[];\n  preload_tools: string[];\n  require_approval_for_tools: string[];\n}): ToolSelectorConfig {\n  return {\n    enableTools: entry.enable_tools,\n    disableTools: entry.disable_tools,\n    preloadTools: entry.preload_tools,\n    requireApprovalForTools: entry.require_approval_for_tools,\n  };\n}\n\n/**\n * Batteries-included base implementation. Construct-and-go for the default\n * behavior; subclass and override to customize (tool sources, sandbox,\n * tracing).\n */\nexport class TurnResourceResolver<\n  TTurnCustom extends object = Record<string, never>,\n> implements ITurnResourceResolver<TTurnCustom> {\n  readonly #sources = new Map<string, Promise<ToolSource>>();\n  #sandbox?: Sandbox | undefined;\n\n  constructor(\n    protected readonly deps: {\n      /** Model name → client and defaults. Called once per resolved definition; may load provider config. */\n      llm: (model: string) => Promise<{\n        modelClient: ILLM;\n        defaultModelParams: ModelParams;\n        modelProperties?: AgentDefinition['modelProperties'];\n      }>;\n      /**\n       * MCP server name → connection details. Required to use spec.mcp_servers:\n       * the AgentSpec carries names only (no url/headers on the wire) — the\n       * runtime supplies the catalog. Called once per distinct server name per\n       * turn. Throw for unknown names. `headers` supports the async resolver form.\n       */\n      mcp: (name: string) => Promise<{ url: string; headers?: RemoteMcpHeaders }>;\n      mcpRequestTimeoutMs: number;\n      mcpConnectTimeoutMs: number;\n      /** One sandbox type per runtime. Omit = no sandbox support. */\n      sandboxProvider?: TurnSandboxFactory | undefined;\n      /**\n       * Named-agent lookup (registry id → live AgentSpec). Required when a\n       * session is bound by reference; omit only if all sessions use inline agents.\n       */\n      agent?: ((agentId: string) => Promise<AgentSpec>) | undefined;\n      /** Forwarded to RemoteMCP / AgentThread (required by their constructors). */\n      logger: Logger;\n    },\n  ) {}\n\n  get logger(): Logger {\n    return this.deps.logger;\n  }\n\n  /** Default: no-op tracing. Override to plug in a real tracer. */\n  createTracing(): AgentTracing {\n    return NOOP_AGENT_TRACING;\n  }\n\n  /** Named (ref) session agent → live registry lookup via deps.agent. */\n  async resolveAgentSpec(input: { agent_id: string }): Promise<AgentSpec> {\n    if (this.deps.agent === undefined) {\n      // Host forgot to wire deps.agent — not \"agent id missing from the registry\"\n      // (that failure belongs in the lookup callback, e.g. HTTP 422 on the server).\n      throw new Error(\n        `Named agent '${input.agent_id}' cannot be resolved: no agent lookup configured on the turn resolver`,\n      );\n    }\n    return await this.deps.agent(input.agent_id);\n  }\n\n  /**\n   * Default: creates a sandbox iff a provider is configured AND the spec wants\n   * one; reattaches to the previous turn's VM via `existing.sandbox_id` when\n   * present. Overrides that resolve their own sandbox must assign it so\n   * close() can release it (or override close() too).\n   */\n  async resolveSandbox(input: {\n    spec: AgentSpec;\n    existing?: SandboxInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<Sandbox | undefined> {\n    if (!this.deps.sandboxProvider || !specWantsSandbox(input.spec)) {\n      return undefined;\n    }\n    this.#sandbox = await this.deps.sandboxProvider({\n      spec: input.spec,\n      existingSandboxId: input.existing?.sandbox_id,\n      signal: input.signal,\n      tracing: input.tracing,\n    });\n    return this.#sandbox;\n  }\n\n  /**\n   * Closes the sandbox HANDLE if one was resolved. This releases only this\n   * process's connection (local bridge); the sandbox VM keeps running and the\n   * next turn reattaches via `existing.sandbox_id`.\n   *\n   * Tool sources (MCP connections) are intentionally NOT closed: the run's\n   * AbortSignal already aborts their in-flight calls, and connections are\n   * per-run objects that are simply dropped. If deterministic MCP socket\n   * release is ever needed, add it here — no contract change required.\n   *\n   * Subclasses that acquire additional resources MUST override, release\n   * their own resources best-effort, and call `await super.close()`.\n   * Idempotent; never throws.\n   */\n  async close(): Promise<void> {\n    const sandbox = this.#sandbox;\n    this.#sandbox = undefined;\n    await sandbox?.close().catch(() => {\n      /* no-op */\n    });\n  }\n\n  /**\n   * Default: maps the spec directly to a definition — spec.mcp_servers carry\n   * names only; deps.mcp resolves each name to url/headers, and the result\n   * becomes a RemoteMCP source (deduped per turn via getOrCreateToolSource)\n   * wrapped in a per-agent ToolSet view. Passes the previous turn's persisted\n   * MCP session_id into RemoteMCP for cross-turn stateful resume.\n   */\n  async resolveAgentDefinition(input: {\n    spec: AgentSpec;\n    agent_info?: AgentInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<ResolvedAgentDefinition> {\n    const { spec, agent_info: agentInfo, previousTurn, signal, tracing } = input;\n    const toolSets = await Promise.all(\n      (spec.mcp_servers ?? []).map(async entry => {\n        const source = await this.getOrCreateToolSource({\n          id: entry.name,\n          create: async () => {\n            const { url, headers } = await this.deps.mcp(entry.name);\n            return new RemoteMCP({\n              id: entry.name,\n              name: entry.name,\n              url,\n              headers: headers ?? {},\n              sessionId: previousTurn?.snapshot.mcp_servers?.[entry.name]?.session_id,\n              requestTimeoutMs: this.deps.mcpRequestTimeoutMs,\n              connectTimeoutMs: this.deps.mcpConnectTimeoutMs,\n              logger: this.deps.logger,\n              tracing,\n              signal,\n            });\n          },\n        });\n        return new ToolSet({\n          source,\n          selectors: toSelectors(entry),\n          preload: entry.preload,\n        });\n      }),\n    );\n    // Sub-agents may request a different catalog model via agent_info.model;\n    // resolve that name so modelClient matches the override (not just a label).\n    const modelName = agentInfo?.model ?? spec.model.name;\n    const resolvedModel = await this.deps.llm(modelName);\n    return {\n      definition: {\n        modelClient: resolvedModel.modelClient,\n        modelProperties: resolvedModel.modelProperties,\n        // Sub-agents receive the delegated task as a user message; their system\n        // prompt is SUB_AGENT_IDENTITY (added by AgentThread), not user instructions.\n        instruction: agentInfo ? undefined : spec.instructions,\n        messages: agentInfo\n          ? [{ role: 'user' as const, content: agentInfo.input }]\n          : spec.messages?.map(m => ({ role: 'user' as const, content: m.content })),\n        modelParams: {\n          ...resolvedModel.defaultModelParams,\n          ...spec.model.params,\n        },\n        // Sub-agents should return free-form summaries to the parent, not the user-facing structured response.\n        responseFormat: agentInfo ? undefined : spec.response_format,\n        iterationLimit: spec.config.iteration_limit,\n        toolSets,\n      },\n    };\n  }\n\n  /**\n   * Returns the tool source for `id`, creating it on first call — use from\n   * resolveAgentDefinition overrides so agents sharing a server share one\n   * connection. Single-flight by id: the promise is stored synchronously (no\n   * await between get and set), so overlapping resolveAgentDefinition calls\n   * can never double-create. Rejections stay cached: one attempt per turn.\n   * Do not override.\n   */\n  protected getOrCreateToolSource(input: { id: string; create: () => Promise<ToolSource> }): Promise<ToolSource> {\n    const cached = this.#sources.get(input.id);\n    if (cached) {\n      return cached;\n    }\n    const made = input.create();\n    this.#sources.set(input.id, made);\n    return made;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/agent-session/TurnResourceResolver.ts"],"sourcesContent":["import type { Logger } from 'winston';\nimport type { ILLM } from '../core/llm/ILLM';\nimport type { ToolSource } from '../core/mcp/IMCPServer';\nimport { RemoteMCP, type RemoteMcpHeaders } from '../core/mcp/RemoteMCP';\nimport type { ToolSelectorConfig } from '../core/mcp/ToolSelectorPolicy';\nimport { ToolSet } from '../core/mcp/ToolSet';\nimport type { AgentDefinition, ModelParams } from '../core/runtime/AgentDefinition';\nimport type { AgentInfo } from '../core/runtime/AgentThread.types';\nimport type { Sandbox, SandboxInfo } from '../core/sandbox/Sandbox';\nimport type { AgentTracing } from '../core/tracing/AgentTracing';\nimport { NOOP_AGENT_TRACING } from '../core/tracing/NoopAgentTracing';\nimport type { ITurnResourceResolver, ResolvedAgentDefinition } from './ITurnResourceResolver';\nimport type { TurnRecord } from './models/TurnRecord';\nimport type { AgentSpec } from './schemas/agentSpec';\n\n/**\n * Factory that creates a Sandbox handle for a run (reattach via\n * existingSandboxId). `spec` carries the sandbox-relevant agent settings\n * (e.g. config.sandbox.file_downloads) so implementations can shape the\n * Sandbox per run without the factory type growing a field per option.\n */\nexport type TurnSandboxFactory = (input: {\n  spec: AgentSpec;\n  existingSandboxId?: string | undefined;\n  signal: AbortSignal;\n  tracing: AgentTracing;\n}) => Promise<Sandbox>;\n\nfunction specWantsSandbox(spec: AgentSpec): boolean {\n  return spec.config.sandbox.enabled;\n}\n\nfunction toSelectors(entry: {\n  enable_tools: string[];\n  disable_tools: string[];\n  preload_tools: string[];\n  require_approval_for_tools: string[];\n}): ToolSelectorConfig {\n  return {\n    enableTools: entry.enable_tools,\n    disableTools: entry.disable_tools,\n    preloadTools: entry.preload_tools,\n    requireApprovalForTools: entry.require_approval_for_tools,\n  };\n}\n\n/**\n * Batteries-included base implementation. Construct-and-go for the default\n * behavior; subclass and override to customize (tool sources, sandbox,\n * tracing).\n */\ninterface ResolvedModel {\n  modelClient: ILLM;\n  defaultModelParams: ModelParams;\n  modelProperties?: AgentDefinition['modelProperties'];\n}\n\nexport class TurnResourceResolver<\n  TTurnCustom extends object = Record<string, never>,\n> implements ITurnResourceResolver<TTurnCustom> {\n  readonly #sources = new Map<string, Promise<ToolSource>>();\n  readonly #models = new Map<string, Promise<ResolvedModel>>();\n  #sandbox?: Sandbox | undefined;\n\n  constructor(\n    protected readonly deps: {\n      /** Model name → client and defaults. Called once per resolved definition; may load provider config. */\n      llm: (model: string) => Promise<ResolvedModel>;\n      /**\n       * MCP server name → connection details. Required to use spec.mcp_servers:\n       * the AgentSpec carries names only (no url/headers on the wire) — the\n       * runtime supplies the catalog. Called once per distinct server name per\n       * turn. Throw for unknown names. `headers` supports the async resolver form.\n       */\n      mcp: (name: string) => Promise<{ url: string; headers?: RemoteMcpHeaders }>;\n      mcpRequestTimeoutMs: number;\n      mcpConnectTimeoutMs: number;\n      /** One sandbox type per runtime. Omit = no sandbox support. */\n      sandboxProvider?: TurnSandboxFactory | undefined;\n      /**\n       * Named-agent lookup (registry id → live AgentSpec). Required when a\n       * session is bound by reference; omit only if all sessions use inline agents.\n       */\n      agent?: ((agentId: string) => Promise<AgentSpec>) | undefined;\n      /** Forwarded to RemoteMCP / AgentThread (required by their constructors). */\n      logger: Logger;\n    },\n  ) {}\n\n  get logger(): Logger {\n    return this.deps.logger;\n  }\n\n  /** Default: no-op tracing. Override to plug in a real tracer. */\n  createTracing(): AgentTracing {\n    return NOOP_AGENT_TRACING;\n  }\n\n  /** Named (ref) session agent → live registry lookup via deps.agent. */\n  async resolveAgentSpec(input: { agent_id: string }): Promise<AgentSpec> {\n    if (this.deps.agent === undefined) {\n      // Host forgot to wire deps.agent — not \"agent id missing from the registry\"\n      // (that failure belongs in the lookup callback, e.g. HTTP 422 on the server).\n      throw new Error(\n        `Named agent '${input.agent_id}' cannot be resolved: no agent lookup configured on the turn resolver`,\n      );\n    }\n    return await this.deps.agent(input.agent_id);\n  }\n\n  /**\n   * Default: creates a sandbox iff a provider is configured AND the spec wants\n   * one; reattaches to the previous turn's VM via `existing.sandbox_id` when\n   * present. Overrides that resolve their own sandbox must assign it so\n   * close() can release it (or override close() too).\n   */\n  async resolveSandbox(input: {\n    spec: AgentSpec;\n    existing?: SandboxInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<Sandbox | undefined> {\n    if (!this.deps.sandboxProvider || !specWantsSandbox(input.spec)) {\n      return undefined;\n    }\n    this.#sandbox = await this.deps.sandboxProvider({\n      spec: input.spec,\n      existingSandboxId: input.existing?.sandbox_id,\n      signal: input.signal,\n      tracing: input.tracing,\n    });\n    return this.#sandbox;\n  }\n\n  /**\n   * Closes the sandbox HANDLE if one was resolved. This releases only this\n   * process's connection (local bridge); the sandbox VM keeps running and the\n   * next turn reattaches via `existing.sandbox_id`.\n   *\n   * Tool sources (MCP connections) are intentionally NOT closed: the run's\n   * AbortSignal already aborts their in-flight calls, and connections are\n   * per-run objects that are simply dropped. If deterministic MCP socket\n   * release is ever needed, add it here — no contract change required.\n   *\n   * Subclasses that acquire additional resources MUST override, release\n   * their own resources best-effort, and call `await super.close()`.\n   * Idempotent; never throws.\n   */\n  async close(): Promise<void> {\n    const sandbox = this.#sandbox;\n    this.#sandbox = undefined;\n    await sandbox?.close().catch(() => {\n      /* no-op */\n    });\n  }\n\n  /**\n   * Default: maps the spec directly to a definition — spec.mcp_servers carry\n   * names only; deps.mcp resolves each name to url/headers, and the result\n   * becomes a RemoteMCP source (deduped per turn via getOrCreateToolSource)\n   * wrapped in a per-agent ToolSet view. Passes the previous turn's persisted\n   * MCP session_id into RemoteMCP for cross-turn stateful resume.\n   */\n  async resolveAgentDefinition(input: {\n    spec: AgentSpec;\n    agent_info?: AgentInfo | undefined;\n    previousTurn?: TurnRecord<TTurnCustom> | undefined;\n    signal: AbortSignal;\n    tracing: AgentTracing;\n  }): Promise<ResolvedAgentDefinition> {\n    const { spec, agent_info: agentInfo, previousTurn, signal, tracing } = input;\n    const toolSets = await Promise.all(\n      (spec.mcp_servers ?? []).map(async entry => {\n        const source = await this.getOrCreateToolSource({\n          id: entry.name,\n          create: async () => {\n            const { url, headers } = await this.deps.mcp(entry.name);\n            return new RemoteMCP({\n              id: entry.name,\n              name: entry.name,\n              url,\n              headers: headers ?? {},\n              sessionId: previousTurn?.snapshot.mcp_servers?.[entry.name]?.session_id,\n              requestTimeoutMs: this.deps.mcpRequestTimeoutMs,\n              connectTimeoutMs: this.deps.mcpConnectTimeoutMs,\n              logger: this.deps.logger,\n              tracing,\n              signal,\n            });\n          },\n        });\n        return new ToolSet({\n          source,\n          selectors: toSelectors(entry),\n          preload: entry.preload,\n        });\n      }),\n    );\n    // Sub-agents may request a different catalog model via agent_info.model;\n    // resolve that name so modelClient matches the override (not just a label).\n    const modelName = agentInfo?.model ?? spec.model.name;\n    const resolvedModel = await this.getModel(modelName);\n    return {\n      definition: {\n        modelClient: resolvedModel.modelClient,\n        modelProperties: resolvedModel.modelProperties,\n        // Sub-agents receive the delegated task as a user message; their system\n        // prompt is SUB_AGENT_IDENTITY (added by AgentThread), not user instructions.\n        instruction: agentInfo ? undefined : spec.instructions,\n        messages: agentInfo\n          ? [{ role: 'user' as const, content: agentInfo.input }]\n          : spec.messages?.map(m => ({ role: 'user' as const, content: m.content })),\n        modelParams: {\n          ...resolvedModel.defaultModelParams,\n          ...spec.model.params,\n        },\n        // Sub-agents should return free-form summaries to the parent, not the user-facing structured response.\n        responseFormat: agentInfo ? undefined : spec.response_format,\n        iterationLimit: spec.config.iteration_limit,\n        toolSets,\n      },\n    };\n  }\n\n  /**\n   * Returns the tool source for `id`, creating it on first call — use from\n   * resolveAgentDefinition overrides so agents sharing a server share one\n   * connection. Single-flight by id: the promise is stored synchronously (no\n   * await between get and set), so overlapping resolveAgentDefinition calls\n   * can never double-create. Rejections stay cached: one attempt per turn.\n   * Do not override.\n   */\n  protected getOrCreateToolSource(input: { id: string; create: () => Promise<ToolSource> }): Promise<ToolSource> {\n    const cached = this.#sources.get(input.id);\n    if (cached) {\n      return cached;\n    }\n    const made = input.create();\n    this.#sources.set(input.id, made);\n    return made;\n  }\n\n  /**\n   * Resolves `deps.llm` once per distinct model name for this turn — parent and\n   * sub-agents with the same catalog model share one promise.\n   */\n  protected getModel(modelName: string): Promise<ResolvedModel> {\n    const cached = this.#models.get(modelName);\n    if (cached) {\n      return cached;\n    }\n    const made = this.deps.llm(modelName);\n    this.#models.set(modelName, made);\n    return made;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/agent-session/index.d.ts

@@ -6,8 +6,8 @@ export { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSch
 export type { AgentSpec, Skill } from './schemas/agentSpec';
 export { CancellationReason, CreateTurnRequestSchema, TurnInputItemSchema, TurnMetricsSchema, TurnSchema, TurnStateCancelledReasonSchema, TurnStateCancelledSchema, TurnStateDoneSchema, TurnStateErrorSchema, TurnStateRunningSchema, TurnStateSchema, } from './schemas/turn';
 export type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } from './schemas/turn';
-export { SessionMetadataSchema, SessionMetricsSchema, SessionSchema } from './schemas/session';
-export type { Session, SessionAgent, SessionMetadata, SessionMetrics } from './schemas/session';
+export { SessionMetadataSchema, SessionMetricsSchema, SessionSchema, SessionSourceScheduleSchema, SessionSourceSchema, SessionSourceTypeSchema, } from './schemas/session';
+export type { Session, SessionAgent, SessionMetadata, SessionMetrics, SessionSource, SessionSourceType, } from './schemas/session';
 export { CreatedBySubjectSchema } from './schemas/subject';
 export type { CreatedBySubject } from './schemas/subject';
 export { EventType, SessionEventItemSchema, SessionEventSchema, TurnCreatedEventSchema, TurnDoneEventSchema, } from './schemas/events';
@@ -19,7 +19,7 @@ export { MAIN_THREAD_ID } from './models/TurnRecord';
 export type { TurnRecord, TurnSnapshot } from './models/TurnRecord';
 export { assertCreateTurnThreadDelta } from './store/assertCreateTurnThreadDelta';
 export { InMemorySessionStore } from './store/InMemorySessionStore';
-export type { AddThreadsInput, AppendToEventsInput, AppendToThreadContextInput, CreateSessionInput, CreateTurnInput, DeleteSessionInput, FreezeAndGetTurnInput, GetSessionByExternalIdInput, GetSessionInput, GetTurnInput, ISessionStore, ListSessionEventsInput, ListSessionsInput, ListTurnEventsInput, ListTurnsInput, NewThreadInit, OverwriteThreadContextInput, PatchMCPServersInput, PatchSandboxInfoInput, PatchThreadCapabilityStateInput, RemoveThreadsInput, TurnContextAppend, TurnRecordWithoutSnapshot, UpdateSessionInput, UpdateTurnStateInput, } from './store/ISessionStore';
+export type { AddThreadsInput, AppendToEventsInput, AppendToThreadContextInput, CreateSessionInput, CreateTurnInput, DeleteSessionInput, FreezeAndGetTurnInput, GetOwnedIdsInput, GetSessionByExternalIdInput, GetSessionInput, GetTurnInput, ISessionStore, ListSessionEventsInput, ListSessionsInput, ListTurnEventsInput, ListTurnsInput, NewThreadInit, OverwriteThreadContextInput, PatchMCPServersInput, PatchSandboxInfoInput, PatchThreadCapabilityStateInput, RemoveThreadsInput, TurnContextAppend, TurnRecordWithoutSnapshot, UpdateSessionInput, UpdateTurnStateInput, } from './store/ISessionStore';
 export { InvalidPageTokenError, PreviousTurnRunningError, SessionAlreadyExistsError, SessionExternalIdConflictError, SessionNotFoundError, SessionStoreConflictError, SessionStoreInvariantError, SessionStoreNotFoundError, TurnAlreadyExistsError, TurnNotFoundError, TurnNotRunningError, } from './store/SessionStoreErrors';
 export type { ITurnResourceResolver } from './ITurnResourceResolver';
 export { TurnResourceResolver } from './TurnResourceResolver';

package/dist/agent-session/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,oCAAoC,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACjH,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErG,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/F,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,2BAA2B,EAC3B,eAAe,EACf,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent-session/index.ts"],"names":[],"mappings":"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"}

package/dist/agent-session/index.js

@@ -40,6 +40,9 @@ __export(agent_session_exports, {
   SessionMetricsSchema: () => import_session.SessionMetricsSchema,
   SessionNotFoundError: () => import_SessionStoreErrors.SessionNotFoundError,
   SessionSchema: () => import_session.SessionSchema,
+  SessionSourceScheduleSchema: () => import_session.SessionSourceScheduleSchema,
+  SessionSourceSchema: () => import_session.SessionSourceSchema,
+  SessionSourceTypeSchema: () => import_session.SessionSourceTypeSchema,
   SessionStoreConflictError: () => import_SessionStoreErrors.SessionStoreConflictError,
   SessionStoreInvariantError: () => import_SessionStoreErrors.SessionStoreInvariantError,
   SessionStoreNotFoundError: () => import_SessionStoreErrors.SessionStoreNotFoundError,
@@ -100,6 +103,9 @@ var import_TurnHandle = require("./TurnHandle.js");
   SessionMetricsSchema,
   SessionNotFoundError,
   SessionSchema,
+  SessionSourceScheduleSchema,
+  SessionSourceSchema,
+  SessionSourceTypeSchema,
   SessionStoreConflictError,
   SessionStoreInvariantError,
   SessionStoreNotFoundError,

package/dist/agent-session/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/index.ts"],"sourcesContent":["/**\n * Public agent session middle library.\n * Zod product contracts and session/turn runtime.\n */\n\nexport { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';\nexport type { AgentSpec, Skill } from './schemas/agentSpec';\n\nexport {\n  CancellationReason,\n  CreateTurnRequestSchema,\n  TurnInputItemSchema,\n  TurnMetricsSchema,\n  TurnSchema,\n  TurnStateCancelledReasonSchema,\n  TurnStateCancelledSchema,\n  TurnStateDoneSchema,\n  TurnStateErrorSchema,\n  TurnStateRunningSchema,\n  TurnStateSchema,\n} from './schemas/turn';\nexport type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } from './schemas/turn';\n\nexport { SessionMetadataSchema, SessionMetricsSchema, SessionSchema } from './schemas/session';\nexport type { Session, SessionAgent, SessionMetadata, SessionMetrics } from './schemas/session';\n\nexport { CreatedBySubjectSchema } from './schemas/subject';\nexport type { CreatedBySubject } from './schemas/subject';\n\nexport {\n  EventType,\n  SessionEventItemSchema,\n  SessionEventSchema,\n  TurnCreatedEventSchema,\n  TurnDoneEventSchema,\n} from './schemas/events';\nexport type {\n  PersistedTurnEvent,\n  SessionEvent,\n  SessionEventItem,\n  TurnCreatedEvent,\n  TurnDoneEvent,\n} from './schemas/events';\n\nexport { TokenPaginationSchema } from './schemas/pagination';\nexport type { TokenPagination } from './schemas/pagination';\n\nexport type { SessionRecord } from './models/SessionRecord';\nexport { MAIN_THREAD_ID } from './models/TurnRecord';\nexport type { TurnRecord, TurnSnapshot } from './models/TurnRecord';\n\nexport { assertCreateTurnThreadDelta } from './store/assertCreateTurnThreadDelta';\nexport { InMemorySessionStore } from './store/InMemorySessionStore';\nexport type {\n  AddThreadsInput,\n  AppendToEventsInput,\n  AppendToThreadContextInput,\n  CreateSessionInput,\n  CreateTurnInput,\n  DeleteSessionInput,\n  FreezeAndGetTurnInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  GetTurnInput,\n  ISessionStore,\n  ListSessionEventsInput,\n  ListSessionsInput,\n  ListTurnEventsInput,\n  ListTurnsInput,\n  NewThreadInit,\n  OverwriteThreadContextInput,\n  PatchMCPServersInput,\n  PatchSandboxInfoInput,\n  PatchThreadCapabilityStateInput,\n  RemoveThreadsInput,\n  TurnContextAppend,\n  TurnRecordWithoutSnapshot,\n  UpdateSessionInput,\n  UpdateTurnStateInput,\n} from './store/ISessionStore';\nexport {\n  InvalidPageTokenError,\n  PreviousTurnRunningError,\n  SessionAlreadyExistsError,\n  SessionExternalIdConflictError,\n  SessionNotFoundError,\n  SessionStoreConflictError,\n  SessionStoreInvariantError,\n  SessionStoreNotFoundError,\n  TurnAlreadyExistsError,\n  TurnNotFoundError,\n  TurnNotRunningError,\n} from './store/SessionStoreErrors';\n\nexport type { ITurnResourceResolver } from './ITurnResourceResolver';\nexport { TurnResourceResolver } from './TurnResourceResolver';\nexport type { TurnSandboxFactory } from './TurnResourceResolver';\n\nexport { SessionHandle } from './SessionHandle';\nexport { Sessions } from './Sessions';\nexport { TurnHandle } from './TurnHandle';\nexport type { TurnStreamingEvent } from './TurnHandle';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,uBAA2F;AAG3F,kBAYO;AAGP,qBAA2E;AAG3E,qBAAuC;AAGvC,oBAMO;AASP,wBAAsC;AAItC,wBAA+B;AAG/B,yCAA4C;AAC5C,kCAAqC;AA4BrC,gCAYO;AAGP,kCAAqC;AAGrC,2BAA8B;AAC9B,sBAAyB;AACzB,wBAA2B;","names":[]}
+{"version":3,"sources":["../../src/agent-session/index.ts"],"sourcesContent":["/**\n * Public agent session middle library.\n * Zod product contracts and session/turn runtime.\n */\n\nexport { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';\nexport type { AgentSpec, Skill } from './schemas/agentSpec';\n\nexport {\n  CancellationReason,\n  CreateTurnRequestSchema,\n  TurnInputItemSchema,\n  TurnMetricsSchema,\n  TurnSchema,\n  TurnStateCancelledReasonSchema,\n  TurnStateCancelledSchema,\n  TurnStateDoneSchema,\n  TurnStateErrorSchema,\n  TurnStateRunningSchema,\n  TurnStateSchema,\n} from './schemas/turn';\nexport type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } from './schemas/turn';\n\nexport {\n  SessionMetadataSchema,\n  SessionMetricsSchema,\n  SessionSchema,\n  SessionSourceScheduleSchema,\n  SessionSourceSchema,\n  SessionSourceTypeSchema,\n} from './schemas/session';\nexport type {\n  Session,\n  SessionAgent,\n  SessionMetadata,\n  SessionMetrics,\n  SessionSource,\n  SessionSourceType,\n} from './schemas/session';\n\nexport { CreatedBySubjectSchema } from './schemas/subject';\nexport type { CreatedBySubject } from './schemas/subject';\n\nexport {\n  EventType,\n  SessionEventItemSchema,\n  SessionEventSchema,\n  TurnCreatedEventSchema,\n  TurnDoneEventSchema,\n} from './schemas/events';\nexport type {\n  PersistedTurnEvent,\n  SessionEvent,\n  SessionEventItem,\n  TurnCreatedEvent,\n  TurnDoneEvent,\n} from './schemas/events';\n\nexport { TokenPaginationSchema } from './schemas/pagination';\nexport type { TokenPagination } from './schemas/pagination';\n\nexport type { SessionRecord } from './models/SessionRecord';\nexport { MAIN_THREAD_ID } from './models/TurnRecord';\nexport type { TurnRecord, TurnSnapshot } from './models/TurnRecord';\n\nexport { assertCreateTurnThreadDelta } from './store/assertCreateTurnThreadDelta';\nexport { InMemorySessionStore } from './store/InMemorySessionStore';\nexport type {\n  AddThreadsInput,\n  AppendToEventsInput,\n  AppendToThreadContextInput,\n  CreateSessionInput,\n  CreateTurnInput,\n  DeleteSessionInput,\n  FreezeAndGetTurnInput,\n  GetOwnedIdsInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  GetTurnInput,\n  ISessionStore,\n  ListSessionEventsInput,\n  ListSessionsInput,\n  ListTurnEventsInput,\n  ListTurnsInput,\n  NewThreadInit,\n  OverwriteThreadContextInput,\n  PatchMCPServersInput,\n  PatchSandboxInfoInput,\n  PatchThreadCapabilityStateInput,\n  RemoveThreadsInput,\n  TurnContextAppend,\n  TurnRecordWithoutSnapshot,\n  UpdateSessionInput,\n  UpdateTurnStateInput,\n} from './store/ISessionStore';\nexport {\n  InvalidPageTokenError,\n  PreviousTurnRunningError,\n  SessionAlreadyExistsError,\n  SessionExternalIdConflictError,\n  SessionNotFoundError,\n  SessionStoreConflictError,\n  SessionStoreInvariantError,\n  SessionStoreNotFoundError,\n  TurnAlreadyExistsError,\n  TurnNotFoundError,\n  TurnNotRunningError,\n} from './store/SessionStoreErrors';\n\nexport type { ITurnResourceResolver } from './ITurnResourceResolver';\nexport { TurnResourceResolver } from './TurnResourceResolver';\nexport type { TurnSandboxFactory } from './TurnResourceResolver';\n\nexport { SessionHandle } from './SessionHandle';\nexport { Sessions } from './Sessions';\nexport { TurnHandle } from './TurnHandle';\nexport type { TurnStreamingEvent } from './TurnHandle';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,uBAA2F;AAG3F,kBAYO;AAGP,qBAOO;AAUP,qBAAuC;AAGvC,oBAMO;AASP,wBAAsC;AAItC,wBAA+B;AAG/B,yCAA4C;AAC5C,kCAAqC;AA6BrC,gCAYO;AAGP,kCAAqC;AAGrC,2BAA8B;AAC9B,sBAAyB;AACzB,wBAA2B;","names":[]}

package/dist/agent-session/index.mjs

@@ -13,7 +13,14 @@ import {
   TurnStateRunningSchema,
   TurnStateSchema
 } from "./schemas/turn.mjs";
-import { SessionMetadataSchema, SessionMetricsSchema, SessionSchema } from "./schemas/session.mjs";
+import {
+  SessionMetadataSchema,
+  SessionMetricsSchema,
+  SessionSchema,
+  SessionSourceScheduleSchema,
+  SessionSourceSchema,
+  SessionSourceTypeSchema
+} from "./schemas/session.mjs";
 import { CreatedBySubjectSchema } from "./schemas/subject.mjs";
 import {
   EventType,
@@ -64,6 +71,9 @@ export {
   SessionMetricsSchema,
   SessionNotFoundError,
   SessionSchema,
+  SessionSourceScheduleSchema,
+  SessionSourceSchema,
+  SessionSourceTypeSchema,
   SessionStoreConflictError,
   SessionStoreInvariantError,
   SessionStoreNotFoundError,

package/dist/agent-session/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent-session/index.ts"],"sourcesContent":["/**\n * Public agent session middle library.\n * Zod product contracts and session/turn runtime.\n */\n\nexport { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';\nexport type { AgentSpec, Skill } from './schemas/agentSpec';\n\nexport {\n  CancellationReason,\n  CreateTurnRequestSchema,\n  TurnInputItemSchema,\n  TurnMetricsSchema,\n  TurnSchema,\n  TurnStateCancelledReasonSchema,\n  TurnStateCancelledSchema,\n  TurnStateDoneSchema,\n  TurnStateErrorSchema,\n  TurnStateRunningSchema,\n  TurnStateSchema,\n} from './schemas/turn';\nexport type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } from './schemas/turn';\n\nexport { SessionMetadataSchema, SessionMetricsSchema, SessionSchema } from './schemas/session';\nexport type { Session, SessionAgent, SessionMetadata, SessionMetrics } from './schemas/session';\n\nexport { CreatedBySubjectSchema } from './schemas/subject';\nexport type { CreatedBySubject } from './schemas/subject';\n\nexport {\n  EventType,\n  SessionEventItemSchema,\n  SessionEventSchema,\n  TurnCreatedEventSchema,\n  TurnDoneEventSchema,\n} from './schemas/events';\nexport type {\n  PersistedTurnEvent,\n  SessionEvent,\n  SessionEventItem,\n  TurnCreatedEvent,\n  TurnDoneEvent,\n} from './schemas/events';\n\nexport { TokenPaginationSchema } from './schemas/pagination';\nexport type { TokenPagination } from './schemas/pagination';\n\nexport type { SessionRecord } from './models/SessionRecord';\nexport { MAIN_THREAD_ID } from './models/TurnRecord';\nexport type { TurnRecord, TurnSnapshot } from './models/TurnRecord';\n\nexport { assertCreateTurnThreadDelta } from './store/assertCreateTurnThreadDelta';\nexport { InMemorySessionStore } from './store/InMemorySessionStore';\nexport type {\n  AddThreadsInput,\n  AppendToEventsInput,\n  AppendToThreadContextInput,\n  CreateSessionInput,\n  CreateTurnInput,\n  DeleteSessionInput,\n  FreezeAndGetTurnInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  GetTurnInput,\n  ISessionStore,\n  ListSessionEventsInput,\n  ListSessionsInput,\n  ListTurnEventsInput,\n  ListTurnsInput,\n  NewThreadInit,\n  OverwriteThreadContextInput,\n  PatchMCPServersInput,\n  PatchSandboxInfoInput,\n  PatchThreadCapabilityStateInput,\n  RemoveThreadsInput,\n  TurnContextAppend,\n  TurnRecordWithoutSnapshot,\n  UpdateSessionInput,\n  UpdateTurnStateInput,\n} from './store/ISessionStore';\nexport {\n  InvalidPageTokenError,\n  PreviousTurnRunningError,\n  SessionAlreadyExistsError,\n  SessionExternalIdConflictError,\n  SessionNotFoundError,\n  SessionStoreConflictError,\n  SessionStoreInvariantError,\n  SessionStoreNotFoundError,\n  TurnAlreadyExistsError,\n  TurnNotFoundError,\n  TurnNotRunningError,\n} from './store/SessionStoreErrors';\n\nexport type { ITurnResourceResolver } from './ITurnResourceResolver';\nexport { TurnResourceResolver } from './TurnResourceResolver';\nexport type { TurnSandboxFactory } from './TurnResourceResolver';\n\nexport { SessionHandle } from './SessionHandle';\nexport { Sessions } from './Sessions';\nexport { TurnHandle } from './TurnHandle';\nexport type { TurnStreamingEvent } from './TurnHandle';\n"],"mappings":";AAKA,SAAS,iBAAiB,sCAAsC,2BAA2B;AAG3F;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,uBAAuB,sBAAsB,qBAAqB;AAG3E,SAAS,8BAA8B;AAGvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,6BAA6B;AAItC,SAAS,sBAAsB;AAG/B,SAAS,mCAAmC;AAC5C,SAAS,4BAA4B;AA4BrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,4BAA4B;AAGrC,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;","names":[]}
+{"version":3,"sources":["../../src/agent-session/index.ts"],"sourcesContent":["/**\n * Public agent session middle library.\n * Zod product contracts and session/turn runtime.\n */\n\nexport { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';\nexport type { AgentSpec, Skill } from './schemas/agentSpec';\n\nexport {\n  CancellationReason,\n  CreateTurnRequestSchema,\n  TurnInputItemSchema,\n  TurnMetricsSchema,\n  TurnSchema,\n  TurnStateCancelledReasonSchema,\n  TurnStateCancelledSchema,\n  TurnStateDoneSchema,\n  TurnStateErrorSchema,\n  TurnStateRunningSchema,\n  TurnStateSchema,\n} from './schemas/turn';\nexport type { TerminalTurnState, Turn, TurnInputItem, TurnMetrics, TurnState } from './schemas/turn';\n\nexport {\n  SessionMetadataSchema,\n  SessionMetricsSchema,\n  SessionSchema,\n  SessionSourceScheduleSchema,\n  SessionSourceSchema,\n  SessionSourceTypeSchema,\n} from './schemas/session';\nexport type {\n  Session,\n  SessionAgent,\n  SessionMetadata,\n  SessionMetrics,\n  SessionSource,\n  SessionSourceType,\n} from './schemas/session';\n\nexport { CreatedBySubjectSchema } from './schemas/subject';\nexport type { CreatedBySubject } from './schemas/subject';\n\nexport {\n  EventType,\n  SessionEventItemSchema,\n  SessionEventSchema,\n  TurnCreatedEventSchema,\n  TurnDoneEventSchema,\n} from './schemas/events';\nexport type {\n  PersistedTurnEvent,\n  SessionEvent,\n  SessionEventItem,\n  TurnCreatedEvent,\n  TurnDoneEvent,\n} from './schemas/events';\n\nexport { TokenPaginationSchema } from './schemas/pagination';\nexport type { TokenPagination } from './schemas/pagination';\n\nexport type { SessionRecord } from './models/SessionRecord';\nexport { MAIN_THREAD_ID } from './models/TurnRecord';\nexport type { TurnRecord, TurnSnapshot } from './models/TurnRecord';\n\nexport { assertCreateTurnThreadDelta } from './store/assertCreateTurnThreadDelta';\nexport { InMemorySessionStore } from './store/InMemorySessionStore';\nexport type {\n  AddThreadsInput,\n  AppendToEventsInput,\n  AppendToThreadContextInput,\n  CreateSessionInput,\n  CreateTurnInput,\n  DeleteSessionInput,\n  FreezeAndGetTurnInput,\n  GetOwnedIdsInput,\n  GetSessionByExternalIdInput,\n  GetSessionInput,\n  GetTurnInput,\n  ISessionStore,\n  ListSessionEventsInput,\n  ListSessionsInput,\n  ListTurnEventsInput,\n  ListTurnsInput,\n  NewThreadInit,\n  OverwriteThreadContextInput,\n  PatchMCPServersInput,\n  PatchSandboxInfoInput,\n  PatchThreadCapabilityStateInput,\n  RemoveThreadsInput,\n  TurnContextAppend,\n  TurnRecordWithoutSnapshot,\n  UpdateSessionInput,\n  UpdateTurnStateInput,\n} from './store/ISessionStore';\nexport {\n  InvalidPageTokenError,\n  PreviousTurnRunningError,\n  SessionAlreadyExistsError,\n  SessionExternalIdConflictError,\n  SessionNotFoundError,\n  SessionStoreConflictError,\n  SessionStoreInvariantError,\n  SessionStoreNotFoundError,\n  TurnAlreadyExistsError,\n  TurnNotFoundError,\n  TurnNotRunningError,\n} from './store/SessionStoreErrors';\n\nexport type { ITurnResourceResolver } from './ITurnResourceResolver';\nexport { TurnResourceResolver } from './TurnResourceResolver';\nexport type { TurnSandboxFactory } from './TurnResourceResolver';\n\nexport { SessionHandle } from './SessionHandle';\nexport { Sessions } from './Sessions';\nexport { TurnHandle } from './TurnHandle';\nexport type { TurnStreamingEvent } from './TurnHandle';\n"],"mappings":";AAKA,SAAS,iBAAiB,sCAAsC,2BAA2B;AAG3F;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAUP,SAAS,8BAA8B;AAGvC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AASP,SAAS,6BAA6B;AAItC,SAAS,sBAAsB;AAG/B,SAAS,mCAAmC;AAC5C,SAAS,4BAA4B;AA6BrC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,4BAA4B;AAGrC,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,kBAAkB;","names":[]}

package/dist/agent-session/models/SessionRecord.d.ts

@@ -1,4 +1,4 @@
-import type { SessionAgent, SessionMetadata, SessionMetrics } from '../schemas/session';
+import type { SessionAgent, SessionMetadata, SessionMetrics, SessionSource } from '../schemas/session';
 import type { CreatedBySubject } from '../schemas/subject';
 /**
  * Session persistence record. Agent binding is a single discriminated `agent`
@@ -21,6 +21,10 @@ export interface SessionRecord<TCustom extends object = Record<string, never>> {
      * Null means the session has no external id.
      */
     external_id: string | null;
+    /**
+     * How the session was created. Null for interactive sessions.
+     */
+    source: SessionSource | null;
     /**
      * Session tip — used for `previous_turn_id: 'auto'` resolution and turn
      * listing anchors. Advanced only by `createTurn` (atomic link).

package/dist/agent-session/models/SessionRecord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionRecord.d.ts","sourceRoot":"","sources":["../../../src/agent-session/models/SessionRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sFAAsF;IACtF,UAAU,EAAE,IAAI,CAAC;IACjB,2FAA2F;IAC3F,UAAU,EAAE,IAAI,CAAC;IACjB;;;OAGG;IACH,0BAA0B,EAAE,MAAM,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB"}
+{"version":3,"file":"SessionRecord.d.ts","sourceRoot":"","sources":["../../../src/agent-session/models/SessionRecord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sFAAsF;IACtF,UAAU,EAAE,IAAI,CAAC;IACjB,2FAA2F;IAC3F,UAAU,EAAE,IAAI,CAAC;IACjB;;;OAGG;IACH,0BAA0B,EAAE,MAAM,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB"}

package/dist/agent-session/models/SessionRecord.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/agent-session/models/SessionRecord.ts"],"sourcesContent":["import type { SessionAgent, SessionMetadata, SessionMetrics } from '../schemas/session';\nimport type { CreatedBySubject } from '../schemas/subject';\n\n/**\n * Session persistence record. Agent binding is a single discriminated `agent`\n * (`reference` | `inline`). Reference rows carry create-time `name` snapshot\n * (nullable for legacy/orphan). Named agents are not hydrated to inline on read.\n */\nexport interface SessionRecord<TCustom extends object = Record<string, never>> {\n  tenant_id: string;\n  session_id: string;\n  /** Caller identity that created the session (immutable after create). */\n  created_by_subject: CreatedBySubject;\n  agent: SessionAgent;\n  /**\n   * Public session title (nullable). Written via updateSession patch or createTurn's\n   * update_session_title_if_not_exist (first write wins; caller derives).\n   */\n  title: string | null;\n  /**\n   * Optional caller-supplied key, unique within a tenant when set.\n   * Null means the session has no external id.\n   */\n  external_id: string | null;\n  /**\n   * Session tip — used for `previous_turn_id: 'auto'` resolution and turn\n   * listing anchors. Advanced only by `createTurn` (atomic link).\n   */\n  last_turn_id: string | null;\n  /** Instant the session was created (store domain). Wire/API serialize as ISO-8601. */\n  created_at: Date;\n  /** Instant the session was last updated (store domain). Wire/API serialize as ISO-8601. */\n  updated_at: Date;\n  /**\n   * Liveness clock (ms since epoch). The store bumps it on createSession,\n   * updateSession, and createTurn — never on reads.\n   */\n  last_activity_timestamp_ms: number;\n  metrics: SessionMetrics;\n  metadata: SessionMetadata;\n  custom: TCustom | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../../src/agent-session/models/SessionRecord.ts"],"sourcesContent":["import type { SessionAgent, SessionMetadata, SessionMetrics, SessionSource } from '../schemas/session';\nimport type { CreatedBySubject } from '../schemas/subject';\n\n/**\n * Session persistence record. Agent binding is a single discriminated `agent`\n * (`reference` | `inline`). Reference rows carry create-time `name` snapshot\n * (nullable for legacy/orphan). Named agents are not hydrated to inline on read.\n */\nexport interface SessionRecord<TCustom extends object = Record<string, never>> {\n  tenant_id: string;\n  session_id: string;\n  /** Caller identity that created the session (immutable after create). */\n  created_by_subject: CreatedBySubject;\n  agent: SessionAgent;\n  /**\n   * Public session title (nullable). Written via updateSession patch or createTurn's\n   * update_session_title_if_not_exist (first write wins; caller derives).\n   */\n  title: string | null;\n  /**\n   * Optional caller-supplied key, unique within a tenant when set.\n   * Null means the session has no external id.\n   */\n  external_id: string | null;\n  /**\n   * How the session was created. Null for interactive sessions.\n   */\n  source: SessionSource | null;\n  /**\n   * Session tip — used for `previous_turn_id: 'auto'` resolution and turn\n   * listing anchors. Advanced only by `createTurn` (atomic link).\n   */\n  last_turn_id: string | null;\n  /** Instant the session was created (store domain). Wire/API serialize as ISO-8601. */\n  created_at: Date;\n  /** Instant the session was last updated (store domain). Wire/API serialize as ISO-8601. */\n  updated_at: Date;\n  /**\n   * Liveness clock (ms since epoch). The store bumps it on createSession,\n   * updateSession, and createTurn — never on reads.\n   */\n  last_activity_timestamp_ms: number;\n  metrics: SessionMetrics;\n  metadata: SessionMetadata;\n  custom: TCustom | null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/agent-session/schemas/agentSpec.d.ts

@@ -1,4 +1,4 @@
-/** DB AgentSpec wire schema — FQN model names and name-only skill refs. */
+/** DB AgentSpec wire schema — FQN model names and skill refs (name + optional preload). */
 import { z } from '@hono/zod-openapi';
 export declare const DEFAULT_AGENT_CONFIG_ITERATION_LIMIT = 100;
 export declare const RuntimeConfigSchema: z.ZodObject<{
@@ -29,9 +29,10 @@ export declare const RuntimeConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-/** Name-only skill selection; mount fields come from the skill store. */
+/** Skill selection; mount fields come from the skill store. */
 declare const SkillSchema: z.ZodObject<{
     name: z.ZodString;
+    preload: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strict>;
 declare const InitialUserMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"user.message">;
@@ -90,6 +91,7 @@ export declare const AgentSpecSchema: z.ZodObject<{
     }, z.core.$loose>], "type">>;
     skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
+        preload: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, z.core.$strict>>>;
     config: z.ZodDefault<z.ZodObject<{
         iteration_limit: z.ZodDefault<z.ZodNumber>;

package/dist/agent-session/schemas/agentSpec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentSpec.d.ts","sourceRoot":"","sources":["../../../src/agent-session/schemas/agentSpec.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAgBtC,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAuLxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBL,CAAC;AAO5B,yEAAyE;AACzE,QAAA,MAAM,WAAW;;kBAaE,CAAC;AAIpB,QAAA,MAAM,wBAAwB;;;iBASE,CAAC;AAIjC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBL,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"agentSpec.d.ts","sourceRoot":"","sources":["../../../src/agent-session/schemas/agentSpec.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAgBtC,eAAO,MAAM,oCAAoC,MAAM,CAAC;AAuLxD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBL,CAAC;AAS5B,+DAA+D;AAC/D,QAAA,MAAM,WAAW;;;kBAaE,CAAC;AAIpB,QAAA,MAAM,wBAAwB;;;iBASE,CAAC;AAIjC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBL,CAAC;AAExB,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}