@letta-ai/letta-agent-sdk 0.8.19 → 0.8.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/README.md +5 -0
  2. package/dist/app-server-session.d.ts.map +1 -1
  3. package/dist/client-base.d.ts +1 -1
  4. package/dist/client-base.d.ts.map +1 -1
  5. package/dist/client-entry.js +29 -11
  6. package/dist/client-entry.js.map +5 -5
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/index.js +41 -20
  9. package/dist/index.js.map +6 -6
  10. package/dist/query-types.d.ts +5 -1
  11. package/dist/query-types.d.ts.map +1 -1
  12. package/dist/remote-session-protocol.d.ts +1 -0
  13. package/dist/remote-session-protocol.d.ts.map +1 -1
  14. package/package.json +1 -1
  15. package/src/app-server-session.ts +10 -0
  16. package/src/client-base.ts +62 -40
  17. package/src/client.ts +24 -17
  18. package/src/query-types.ts +5 -1
  19. package/src/remote-session-protocol.ts +1 -0
package/dist/query-types.d.ts CHANGED
@@ -5,6 +5,8 @@ export interface AgentFreeQueryOptions extends Omit<LettaCodeClientSessionOption
5
5
  model: string;
6
6
  /** Complete system prompt for the ephemeral conversation. */
7
7
  system: string;
8
+ /** Resume an existing agent-free conversation instead of creating one. Creation settings are ignored on resume. */
9
+ conversationId?: string;
8
10
  /** Provider model settings persisted on the ephemeral conversation. */
9
11
  modelSettings?: Record<string, unknown>;
10
12
  /** Invoking parent agent, persisted when the conversation is created. */
@@ -13,6 +15,8 @@ export interface AgentFreeQueryOptions extends Omit<LettaCodeClientSessionOption
13
15
  name?: string;
14
16
  /** Whether the ephemeral conversation represents a subagent. */
15
17
  isSubagent?: boolean;
18
+ /** Disable the runtime's memory guard for this query (app-server backends only). */
19
+ disableMemoryGuard?: boolean;
16
20
  /** Optional context-window limit persisted on the ephemeral conversation. */
17
21
  contextWindowLimit?: number | null;
18
22
  }
@@ -23,7 +27,7 @@ export interface QueryParams {
23
27
  }
24
28
  /** Stream returned by query(), with controls for long-running execution. */
25
29
  export interface Query extends AsyncGenerator<SDKMessage, void, unknown> {
26
- /** Created conversation ID; null until initialized, retained after close. */
30
+ /** Created or resumed conversation ID; null until initialized, retained after close. */
27
31
  readonly conversationId: string | null;
28
32
  /** Underlying session agent ID; null for agent-free conversations. */
29
33
  readonly agentId: string | null;
package/dist/query-types.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"query-types.d.ts","sourceRoot":"","sources":["../src/query-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,MAAM,WAAW,qBACf,SAAQ,IAAI,CACV,6BAA6B,EAC3B,OAAO,GACP,iBAAiB,GACjB,WAAW,GACX,UAAU,GACV,WAAW,GACX,uBAAuB,CAC1B;IACD,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,KAAM,SAAQ,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC;IACtE,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mEAAmE;IACnE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,IAAI,IAAI,CAAC;CACf"}
1
+ {"version":3,"file":"query-types.d.ts","sourceRoot":"","sources":["../src/query-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,UAAU,EACV,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,2EAA2E;AAC3E,MAAM,WAAW,qBACf,SAAQ,IAAI,CACV,6BAA6B,EAC3B,OAAO,GACP,iBAAiB,GACjB,WAAW,GACX,UAAU,GACV,WAAW,GACX,uBAAuB,CAC1B;IACD,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,mHAAmH;IACnH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,WAAW,KAAM,SAAQ,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC;IACtE,wFAAwF;IACxF,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mEAAmE;IACnE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,IAAI,IAAI,CAAC;CACf"}
package/dist/remote-session-protocol.d.ts CHANGED
@@ -23,6 +23,7 @@ export type RuntimeSessionMode = {
23
23
  isSubagent?: boolean;
24
24
  contextWindowLimit?: number | null;
25
25
  };
26
+ disableMemoryGuard?: boolean;
26
27
  options: LettaCodeClientSessionOptions;
27
28
  } | {
28
29
  kind: "session";
package/dist/remote-session-protocol.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"remote-session-protocol.d.ts","sourceRoot":"","sources":["../src/remote-session-protocol.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"remote-session-protocol.d.ts","sourceRoot":"","sources":["../src/remote-session-protocol.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@letta-ai/letta-agent-sdk",
3
- "version": "0.8.19",
3
+ "version": "0.8.21",
4
4
  "packageManager": "bun@1.3.14",
5
5
  "description": "SDK for programmatic control of Letta agents",
6
6
  "type": "module",
package/src/app-server-session.ts CHANGED
@@ -754,6 +754,16 @@ export class AppServerSession extends RemoteClientSessionCore {
754
754
 
755
755
  const mode = mapPermissionMode(options.permissionMode);
756
756
  if (mode) command.mode = mode;
757
+ if (
758
+ this.mode.kind === "agent-free" &&
759
+ this.mode.disableMemoryGuard === true
760
+ ) {
761
+ command.execution_settings = {
762
+ allowed_tools: [],
763
+ disallowed_tools: [],
764
+ disable_memory_guard: true,
765
+ };
766
+ }
757
767
  if (options.cwd !== undefined) command.cwd = options.cwd;
758
768
  if (
759
769
  this.mode.kind === "session" &&
package/src/client-base.ts CHANGED
@@ -110,12 +110,20 @@ function agentFreeSessionOptions(
110
110
  isSubagent: _isSubagent,
111
111
  modelSettings: _modelSettings,
112
112
  contextWindowLimit: _contextWindowLimit,
113
+ conversationId: _conversationId,
114
+ disableMemoryGuard: _disableMemoryGuard,
113
115
  ...sessionOptions
114
116
  } = options;
115
117
  return sessionOptions;
116
118
  }
117
119
 
118
120
  function validateAgentFreeQueryOptions(options: AgentFreeQueryOptions): void {
121
+ if (
122
+ options.conversationId !== undefined &&
123
+ (typeof options.conversationId !== "string" || !options.conversationId.trim())
124
+ ) {
125
+ throw new Error("query() conversationId must be a non-empty string.");
126
+ }
119
127
  if (typeof options.model !== "string" || options.model.length === 0) {
120
128
  throw new Error("query() requires a non-empty model.");
121
129
  }
@@ -413,7 +421,7 @@ export class LettaAgentClientBase implements AsyncDisposable {
413
421
  }
414
422
  }
415
423
 
416
- /** Run one prompt in a new agent-free ephemeral conversation. */
424
+ /** Run one prompt in a new or resumed agent-free ephemeral conversation. */
417
425
  query(params: QueryParams): Query {
418
426
  this.assertOpen();
419
427
  validateAgentFreeQueryOptions(params.options);
@@ -427,28 +435,40 @@ export class LettaAgentClientBase implements AsyncDisposable {
427
435
  validateAgentFreeQueryOptions(options);
428
436
  const sessionOptions = agentFreeSessionOptions(options);
429
437
  this.assertSessionBackend("query", sessionOptions);
438
+ if (options.disableMemoryGuard === true && this.backend === "cloud") {
439
+ throw new Error(
440
+ 'query() disableMemoryGuard is only supported with backend: "local" or "remote".',
441
+ );
442
+ }
430
443
 
431
444
  if (this.backend === "remote") {
432
445
  return new AppServerSession(this.appServerSessionOptions(), {
433
446
  kind: "agent-free",
434
- createConversation: {
435
- model: options.model,
436
- system: options.system,
437
- ...(options.parentAgentId !== undefined
438
- ? { parentAgentId: options.parentAgentId }
439
- : {}),
440
- ...(options.name !== undefined ? { name: options.name } : {}),
441
- ...(options.isSubagent !== undefined
442
- ? { isSubagent: options.isSubagent }
443
- : {}),
444
- ...(options.modelSettings !== undefined
445
- ? { modelSettings: options.modelSettings }
446
- : {}),
447
- ...(options.contextWindowLimit !== undefined
448
- ? { contextWindowLimit: options.contextWindowLimit }
449
- : {}),
450
- },
447
+ ...(options.conversationId
448
+ ? { conversationId: options.conversationId }
449
+ : {
450
+ createConversation: {
451
+ model: options.model,
452
+ system: options.system,
453
+ ...(options.parentAgentId !== undefined
454
+ ? { parentAgentId: options.parentAgentId }
455
+ : {}),
456
+ ...(options.name !== undefined ? { name: options.name } : {}),
457
+ ...(options.isSubagent !== undefined
458
+ ? { isSubagent: options.isSubagent }
459
+ : {}),
460
+ ...(options.modelSettings !== undefined
461
+ ? { modelSettings: options.modelSettings }
462
+ : {}),
463
+ ...(options.contextWindowLimit !== undefined
464
+ ? { contextWindowLimit: options.contextWindowLimit }
465
+ : {}),
466
+ },
467
+ }),
451
468
  options: sessionOptions,
469
+ ...(options.disableMemoryGuard === true
470
+ ? { disableMemoryGuard: true }
471
+ : {}),
452
472
  });
453
473
  }
454
474
  if (this.backend === "cloud") {
@@ -458,28 +478,30 @@ export class LettaAgentClientBase implements AsyncDisposable {
458
478
  "Cloud query() requires an explicit computer; managed sandboxes are agent-scoped.",
459
479
  );
460
480
  }
461
- const conversation = await this.getCloudClient().post<unknown>(
462
- "/v1/conversations/ephemeral",
463
- {
464
- body: {
465
- model: options.model,
466
- system: options.system,
467
- ...(options.parentAgentId !== undefined
468
- ? { parent_agent_id: options.parentAgentId }
469
- : {}),
470
- ...(options.name !== undefined ? { name: options.name } : {}),
471
- ...(options.isSubagent !== undefined
472
- ? { is_subagent: options.isSubagent }
473
- : {}),
474
- ...(options.modelSettings !== undefined
475
- ? { model_settings: options.modelSettings }
476
- : {}),
477
- ...(options.contextWindowLimit !== undefined
478
- ? { context_window_limit: options.contextWindowLimit }
479
- : {}),
480
- },
481
- },
482
- );
481
+ const conversation = options.conversationId
482
+ ? { id: options.conversationId }
483
+ : await this.getCloudClient().post<unknown>(
484
+ "/v1/conversations/ephemeral",
485
+ {
486
+ body: {
487
+ model: options.model,
488
+ system: options.system,
489
+ ...(options.parentAgentId !== undefined
490
+ ? { parent_agent_id: options.parentAgentId }
491
+ : {}),
492
+ ...(options.name !== undefined ? { name: options.name } : {}),
493
+ ...(options.isSubagent !== undefined
494
+ ? { is_subagent: options.isSubagent }
495
+ : {}),
496
+ ...(options.modelSettings !== undefined
497
+ ? { model_settings: options.modelSettings }
498
+ : {}),
499
+ ...(options.contextWindowLimit !== undefined
500
+ ? { context_window_limit: options.contextWindowLimit }
501
+ : {}),
502
+ },
503
+ },
504
+ );
483
505
  if (
484
506
  !conversation ||
485
507
  typeof conversation !== "object" ||
package/src/client.ts CHANGED
@@ -92,24 +92,31 @@ export class LettaAgentClient extends LettaAgentClientBase {
92
92
  }
93
93
  return createLocalAppServerSession(localOptions.appServer, {
94
94
  kind: "agent-free",
95
- createConversation: {
96
- model: queryOptions.model,
97
- system: queryOptions.system,
98
- ...(queryOptions.parentAgentId !== undefined
99
- ? { parentAgentId: queryOptions.parentAgentId }
100
- : {}),
101
- ...(queryOptions.name !== undefined ? { name: queryOptions.name } : {}),
102
- ...(queryOptions.isSubagent !== undefined
103
- ? { isSubagent: queryOptions.isSubagent }
104
- : {}),
105
- ...(queryOptions.modelSettings !== undefined
106
- ? { modelSettings: queryOptions.modelSettings }
107
- : {}),
108
- ...(queryOptions.contextWindowLimit !== undefined
109
- ? { contextWindowLimit: queryOptions.contextWindowLimit }
110
- : {}),
111
- },
95
+ ...(queryOptions.conversationId
96
+ ? { conversationId: queryOptions.conversationId }
97
+ : {
98
+ createConversation: {
99
+ model: queryOptions.model,
100
+ system: queryOptions.system,
101
+ ...(queryOptions.parentAgentId !== undefined
102
+ ? { parentAgentId: queryOptions.parentAgentId }
103
+ : {}),
104
+ ...(queryOptions.name !== undefined ? { name: queryOptions.name } : {}),
105
+ ...(queryOptions.isSubagent !== undefined
106
+ ? { isSubagent: queryOptions.isSubagent }
107
+ : {}),
108
+ ...(queryOptions.modelSettings !== undefined
109
+ ? { modelSettings: queryOptions.modelSettings }
110
+ : {}),
111
+ ...(queryOptions.contextWindowLimit !== undefined
112
+ ? { contextWindowLimit: queryOptions.contextWindowLimit }
113
+ : {}),
114
+ },
115
+ }),
112
116
  options: sessionOptions,
117
+ ...(queryOptions.disableMemoryGuard === true
118
+ ? { disableMemoryGuard: true }
119
+ : {}),
113
120
  });
114
121
  }
115
122
 
package/src/query-types.ts CHANGED
@@ -19,6 +19,8 @@ export interface AgentFreeQueryOptions
19
19
  model: string;
20
20
  /** Complete system prompt for the ephemeral conversation. */
21
21
  system: string;
22
+ /** Resume an existing agent-free conversation instead of creating one. Creation settings are ignored on resume. */
23
+ conversationId?: string;
22
24
  /** Provider model settings persisted on the ephemeral conversation. */
23
25
  modelSettings?: Record<string, unknown>;
24
26
  /** Invoking parent agent, persisted when the conversation is created. */
@@ -27,6 +29,8 @@ export interface AgentFreeQueryOptions
27
29
  name?: string;
28
30
  /** Whether the ephemeral conversation represents a subagent. */
29
31
  isSubagent?: boolean;
32
+ /** Disable the runtime's memory guard for this query (app-server backends only). */
33
+ disableMemoryGuard?: boolean;
30
34
  /** Optional context-window limit persisted on the ephemeral conversation. */
31
35
  contextWindowLimit?: number | null;
32
36
  }
@@ -39,7 +43,7 @@ export interface QueryParams {
39
43
 
40
44
  /** Stream returned by query(), with controls for long-running execution. */
41
45
  export interface Query extends AsyncGenerator<SDKMessage, void, unknown> {
42
- /** Created conversation ID; null until initialized, retained after close. */
46
+ /** Created or resumed conversation ID; null until initialized, retained after close. */
43
47
  readonly conversationId: string | null;
44
48
  /** Underlying session agent ID; null for agent-free conversations. */
45
49
  readonly agentId: string | null;
package/src/remote-session-protocol.ts CHANGED
@@ -48,6 +48,7 @@ export type RuntimeSessionMode =
48
48
  isSubagent?: boolean;
49
49
  contextWindowLimit?: number | null;
50
50
  };
51
+ disableMemoryGuard?: boolean;
51
52
  options: LettaCodeClientSessionOptions;
52
53
  }
53
54
  | {