@letta-ai/letta-agent-sdk 0.8.19 → 0.8.20
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.
- package/README.md +5 -0
- package/dist/client-base.d.ts +1 -1
- package/dist/client-base.d.ts.map +1 -1
- package/dist/client-entry.js +16 -10
- package/dist/client-entry.js.map +3 -3
- package/dist/client.d.ts.map +1 -1
- package/dist/index.js +26 -18
- package/dist/index.js.map +4 -4
- package/dist/query-types.d.ts +3 -1
- package/dist/query-types.d.ts.map +1 -1
- package/package.json +1 -1
- package/src/client-base.ts +53 -40
- package/src/client.ts +21 -17
- package/src/query-types.ts +3 -1
package/README.md
CHANGED
|
@@ -70,6 +70,11 @@ for await (const message of client.query({
|
|
|
70
70
|
`appServer.harnessBackend: "api"`; the default local harness backend does not
|
|
71
71
|
store agent-free conversations.
|
|
72
72
|
|
|
73
|
+
Pass the returned `query.conversationId` as `options.conversationId` on a later
|
|
74
|
+
`query()` to continue that conversation with its history. On resume, `model`,
|
|
75
|
+
`system`, and other creation settings are ignored; the conversation keeps its
|
|
76
|
+
stored configuration.
|
|
77
|
+
|
|
73
78
|
Cloud queries require an explicit connected computer. Local and remote clients
|
|
74
79
|
run the ephemeral conversation through their App Server.
|
|
75
80
|
|
package/dist/client-base.d.ts
CHANGED
|
@@ -60,7 +60,7 @@ export declare class LettaAgentClientBase implements AsyncDisposable {
|
|
|
60
60
|
* Applications should use a session when they need interactive turn state.
|
|
61
61
|
*/
|
|
62
62
|
prompt(message: SendMessage, agentId: string, options?: LettaCodeClientSessionOptions): Promise<SDKResultMessage>;
|
|
63
|
-
/** Run one prompt in a new agent-free ephemeral conversation. */
|
|
63
|
+
/** Run one prompt in a new or resumed agent-free ephemeral conversation. */
|
|
64
64
|
query(params: QueryParams): Query;
|
|
65
65
|
private createAgentFreeSession;
|
|
66
66
|
private assertSessionBackend;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../src/client-base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAS9E,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAEV,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EACV,qBAAqB,EACrB,KAAK,EACL,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,kBAAkB,EAElB,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EAIpB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACZ,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"client-base.d.ts","sourceRoot":"","sources":["../src/client-base.ts"],"names":[],"mappings":"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"}
|
package/dist/client-entry.js
CHANGED
|
@@ -16872,11 +16872,15 @@ function agentFreeSessionOptions(options) {
|
|
|
16872
16872
|
isSubagent: _isSubagent,
|
|
16873
16873
|
modelSettings: _modelSettings,
|
|
16874
16874
|
contextWindowLimit: _contextWindowLimit,
|
|
16875
|
+
conversationId: _conversationId,
|
|
16875
16876
|
...sessionOptions
|
|
16876
16877
|
} = options;
|
|
16877
16878
|
return sessionOptions;
|
|
16878
16879
|
}
|
|
16879
16880
|
function validateAgentFreeQueryOptions(options) {
|
|
16881
|
+
if (options.conversationId !== undefined && (typeof options.conversationId !== "string" || !options.conversationId.trim())) {
|
|
16882
|
+
throw new Error("query() conversationId must be a non-empty string.");
|
|
16883
|
+
}
|
|
16880
16884
|
if (typeof options.model !== "string" || options.model.length === 0) {
|
|
16881
16885
|
throw new Error("query() requires a non-empty model.");
|
|
16882
16886
|
}
|
|
@@ -17071,14 +17075,16 @@ class LettaAgentClientBase {
|
|
|
17071
17075
|
if (this.backend === "remote") {
|
|
17072
17076
|
return new AppServerSession(this.appServerSessionOptions(), {
|
|
17073
17077
|
kind: "agent-free",
|
|
17074
|
-
|
|
17075
|
-
|
|
17076
|
-
|
|
17077
|
-
|
|
17078
|
-
|
|
17079
|
-
|
|
17080
|
-
|
|
17081
|
-
|
|
17078
|
+
...options.conversationId ? { conversationId: options.conversationId } : {
|
|
17079
|
+
createConversation: {
|
|
17080
|
+
model: options.model,
|
|
17081
|
+
system: options.system,
|
|
17082
|
+
...options.parentAgentId !== undefined ? { parentAgentId: options.parentAgentId } : {},
|
|
17083
|
+
...options.name !== undefined ? { name: options.name } : {},
|
|
17084
|
+
...options.isSubagent !== undefined ? { isSubagent: options.isSubagent } : {},
|
|
17085
|
+
...options.modelSettings !== undefined ? { modelSettings: options.modelSettings } : {},
|
|
17086
|
+
...options.contextWindowLimit !== undefined ? { contextWindowLimit: options.contextWindowLimit } : {}
|
|
17087
|
+
}
|
|
17082
17088
|
},
|
|
17083
17089
|
options: sessionOptions
|
|
17084
17090
|
});
|
|
@@ -17088,7 +17094,7 @@ class LettaAgentClientBase {
|
|
|
17088
17094
|
if (computer === undefined) {
|
|
17089
17095
|
throw new Error("Cloud query() requires an explicit computer; managed sandboxes are agent-scoped.");
|
|
17090
17096
|
}
|
|
17091
|
-
const conversation = await this.getCloudClient().post("/v1/conversations/ephemeral", {
|
|
17097
|
+
const conversation = options.conversationId ? { id: options.conversationId } : await this.getCloudClient().post("/v1/conversations/ephemeral", {
|
|
17092
17098
|
body: {
|
|
17093
17099
|
model: options.model,
|
|
17094
17100
|
system: options.system,
|
|
@@ -17797,4 +17803,4 @@ export {
|
|
|
17797
17803
|
CloudManagedSandboxExpiredError
|
|
17798
17804
|
};
|
|
17799
17805
|
|
|
17800
|
-
//# debugId=
|
|
17806
|
+
//# debugId=8D68B3C7B271B2C064756E2164756E21
|