@deepagents/context 0.11.0 → 0.12.0
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/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +479 -134
- package/dist/index.js.map +4 -4
- package/dist/lib/agent.d.ts +7 -6
- package/dist/lib/agent.d.ts.map +1 -1
- package/dist/lib/engine.d.ts +7 -5
- package/dist/lib/engine.d.ts.map +1 -1
- package/dist/lib/fragments/domain.d.ts +98 -1
- package/dist/lib/fragments/domain.d.ts.map +1 -1
- package/dist/lib/fragments/user.d.ts +8 -8
- package/dist/lib/fragments/user.d.ts.map +1 -1
- package/dist/lib/fragments.d.ts +2 -6
- package/dist/lib/fragments.d.ts.map +1 -1
- package/dist/lib/guardrails/error-recovery.guardrail.d.ts +3 -0
- package/dist/lib/guardrails/error-recovery.guardrail.d.ts.map +1 -0
- package/dist/lib/render.d.ts +21 -0
- package/dist/lib/render.d.ts.map +1 -0
- package/dist/lib/renderers/abstract.renderer.d.ts +10 -2
- package/dist/lib/renderers/abstract.renderer.d.ts.map +1 -1
- package/dist/lib/sandbox/binary-bridges.d.ts.map +1 -1
- package/dist/lib/skills/fragments.d.ts +1 -1
- package/dist/lib/skills/index.d.ts +1 -1
- package/dist/lib/skills/loader.d.ts.map +1 -1
- package/dist/lib/store/sqlite.store.d.ts +4 -2
- package/dist/lib/store/sqlite.store.d.ts.map +1 -1
- package/dist/lib/store/store.d.ts +36 -2
- package/dist/lib/store/store.d.ts.map +1 -1
- package/package.json +4 -4
package/dist/lib/agent.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type StreamTextResult, type StreamTextTransform, type ToolChoice, type ToolSet, generateText } from 'ai';
|
|
1
|
+
import { type GenerateTextResult, Output, type StreamTextResult, type StreamTextTransform, type ToolChoice, type ToolSet, generateText } from 'ai';
|
|
2
2
|
import z from 'zod';
|
|
3
3
|
import { type AgentModel } from '@deepagents/agent';
|
|
4
4
|
import { type ContextEngine } from '../index.ts';
|
|
@@ -27,7 +27,7 @@ declare class Agent<CIn, COut = CIn> {
|
|
|
27
27
|
constructor(options: CreateAgent<CIn, COut>);
|
|
28
28
|
generate<COut, CIn = COut>(contextVariables: CIn, config?: {
|
|
29
29
|
abortSignal?: AbortSignal;
|
|
30
|
-
}): Promise<
|
|
30
|
+
}): Promise<GenerateTextResult<ToolSet, Output.Output<string, string, any>>>;
|
|
31
31
|
/**
|
|
32
32
|
* Stream a response from the agent.
|
|
33
33
|
*
|
|
@@ -57,11 +57,11 @@ export declare function agent<CIn, COut = CIn>(options: CreateAgent<CIn, COut>):
|
|
|
57
57
|
* Options for creating a structured output handler.
|
|
58
58
|
*/
|
|
59
59
|
export interface StructuredOutputOptions<TSchema extends z.ZodType> {
|
|
60
|
-
name: string;
|
|
61
60
|
context?: ContextEngine;
|
|
62
61
|
model?: AgentModel;
|
|
63
62
|
schema: TSchema;
|
|
64
63
|
providerOptions?: Parameters<typeof generateText>[0]['providerOptions'];
|
|
64
|
+
tools?: ToolSet;
|
|
65
65
|
}
|
|
66
66
|
/**
|
|
67
67
|
* Create a structured output handler that provides simplified access to structured output.
|
|
@@ -89,14 +89,15 @@ export interface StructuredOutputOptions<TSchema extends z.ZodType> {
|
|
|
89
89
|
* const stream = await output.stream({});
|
|
90
90
|
* ```
|
|
91
91
|
*/
|
|
92
|
-
export
|
|
92
|
+
export interface StructuredOutputResult<TSchema extends z.ZodType> {
|
|
93
93
|
generate<CIn>(contextVariables?: CIn, config?: {
|
|
94
94
|
abortSignal?: AbortSignal;
|
|
95
95
|
}): Promise<z.infer<TSchema>>;
|
|
96
96
|
stream<CIn>(contextVariables?: CIn, config?: {
|
|
97
97
|
abortSignal?: AbortSignal;
|
|
98
98
|
transform?: StreamTextTransform<ToolSet> | StreamTextTransform<ToolSet>[];
|
|
99
|
-
}): Promise<StreamTextResult<ToolSet,
|
|
100
|
-
}
|
|
99
|
+
}): Promise<StreamTextResult<ToolSet, any>>;
|
|
100
|
+
}
|
|
101
|
+
export declare function structuredOutput<TSchema extends z.ZodType>(options: StructuredOutputOptions<TSchema>): StructuredOutputResult<TSchema>;
|
|
101
102
|
export {};
|
|
102
103
|
//# sourceMappingURL=agent.d.ts.map
|
package/dist/lib/agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAEvB,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAExB,KAAK,UAAU,EACf,KAAK,OAAO,EAIZ,YAAY,EAIb,MAAM,IAAI,CAAC;AAEZ,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,aAAa,CAAC;AAE9D,OAAO,EACL,KAAK,SAAS,EAIf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,WAAW,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,cAAM,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG;;IAGzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;gBACZ,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC;IAM9B,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EACpC,gBAAgB,EAAE,GAAG,EACrB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B,GACA,OAAO,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAgC3E;;;;;;;;;;;;;;;;OAgBG;IACU,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAClC,gBAAgB,EAAE,GAAG,EACrB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAgM5C,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC;CAMrE;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,IAAI,GAAG,GAAG,EACnC,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,GAC9B,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAElB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO;IAChE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,sBAAsB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO;IAC/D,QAAQ,CAAC,GAAG,EACV,gBAAgB,CAAC,EAAE,GAAG,EACtB,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE,GACrC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7B,MAAM,CAAC,GAAG,EACR,gBAAgB,CAAC,EAAE,GAAG,EACtB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;KAC3E,GACA,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;CAC5C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EACxD,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,GACxC,sBAAsB,CAAC,OAAO,CAAC,CAoEjC"}
|
package/dist/lib/engine.d.ts
CHANGED
|
@@ -27,8 +27,8 @@ export interface ContextEngineOptions {
|
|
|
27
27
|
store: ContextStore;
|
|
28
28
|
/** Unique identifier for this chat (required) */
|
|
29
29
|
chatId: string;
|
|
30
|
-
/**
|
|
31
|
-
|
|
30
|
+
/** User who owns this chat (required) */
|
|
31
|
+
userId: string;
|
|
32
32
|
}
|
|
33
33
|
/**
|
|
34
34
|
* Metadata about a chat.
|
|
@@ -36,6 +36,8 @@ export interface ContextEngineOptions {
|
|
|
36
36
|
export interface ChatMeta {
|
|
37
37
|
/** Unique chat identifier */
|
|
38
38
|
id: string;
|
|
39
|
+
/** User who owns this chat */
|
|
40
|
+
userId: string;
|
|
39
41
|
/** When the chat was created */
|
|
40
42
|
createdAt: number;
|
|
41
43
|
/** When the chat was last updated */
|
|
@@ -56,7 +58,7 @@ export interface InspectOptions {
|
|
|
56
58
|
}
|
|
57
59
|
/**
|
|
58
60
|
* Result of inspecting context state.
|
|
59
|
-
*
|
|
61
|
+
* JSON-serializable snapshot for debugging.
|
|
60
62
|
*/
|
|
61
63
|
export interface InspectResult {
|
|
62
64
|
/** Token usage and cost estimation */
|
|
@@ -129,7 +131,7 @@ export declare class ContextEngine {
|
|
|
129
131
|
*
|
|
130
132
|
* @example
|
|
131
133
|
* ```ts
|
|
132
|
-
* const context = new ContextEngine({ store, chatId: 'chat-1' })
|
|
134
|
+
* const context = new ContextEngine({ store, chatId: 'chat-1', userId: 'user-1' })
|
|
133
135
|
* .set(role('You are helpful'), user('Hello'));
|
|
134
136
|
*
|
|
135
137
|
* const { systemPrompt, messages } = await context.resolve();
|
|
@@ -301,7 +303,7 @@ export declare class ContextEngine {
|
|
|
301
303
|
consolidate(): void;
|
|
302
304
|
/**
|
|
303
305
|
* Inspect the full context state for debugging.
|
|
304
|
-
* Returns a
|
|
306
|
+
* Returns a JSON-serializable object with context information.
|
|
305
307
|
*
|
|
306
308
|
* @param options - Inspection options (modelId and renderer required)
|
|
307
309
|
* @returns Complete inspection data including estimates, rendered output, fragments, and graph
|
package/dist/lib/engine.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lib/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAEL,KAAK,UAAU,EAGf,KAAK,cAAc,EACnB,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,KAAK,EAAE,YAAY,CAAC;IACpB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,
|
|
1
|
+
{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/lib/engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ContextFragment } from '../fragments.ts';
|
|
1
|
+
import type { ContextFragment, FragmentData } from '../fragments.ts';
|
|
2
2
|
/**
|
|
3
3
|
* Domain knowledge fragment builders.
|
|
4
4
|
*
|
|
@@ -437,4 +437,101 @@ export declare function analogy(input: {
|
|
|
437
437
|
* })
|
|
438
438
|
*/
|
|
439
439
|
export declare function glossary(entries: Record<string, string>): ContextFragment;
|
|
440
|
+
/**
|
|
441
|
+
* Create a role fragment for system prompt instructions.
|
|
442
|
+
*/
|
|
443
|
+
export declare function role(content: string): ContextFragment;
|
|
444
|
+
/**
|
|
445
|
+
* Define a guiding principle that shapes agent behavior.
|
|
446
|
+
*
|
|
447
|
+
* Use this to establish high-level rules for decision-making, reasoning, or domain behavior.
|
|
448
|
+
* Principles can contain policies (specific rules that implement the principle).
|
|
449
|
+
*
|
|
450
|
+
* @param input.title - Name/title of the principle
|
|
451
|
+
* @param input.description - What this principle means and why it matters
|
|
452
|
+
* @param input.policies - Optional specific rules that implement this principle
|
|
453
|
+
*
|
|
454
|
+
* @example
|
|
455
|
+
* // Logical dependencies principle
|
|
456
|
+
* principle({
|
|
457
|
+
* title: "Logical dependencies and constraints",
|
|
458
|
+
* description: "Analyze intended actions against factors in order of importance",
|
|
459
|
+
* policies: [
|
|
460
|
+
* "Policy-based rules, mandatory prerequisites, and constraints",
|
|
461
|
+
* "Order of operations: Ensure actions don't prevent subsequent necessary actions",
|
|
462
|
+
* "Other prerequisites (information and/or actions needed)",
|
|
463
|
+
* "Explicit user constraints or preferences"
|
|
464
|
+
* ]
|
|
465
|
+
* })
|
|
466
|
+
*
|
|
467
|
+
* @example
|
|
468
|
+
* // Risk assessment principle
|
|
469
|
+
* principle({
|
|
470
|
+
* title: "Risk assessment",
|
|
471
|
+
* description: "Evaluate consequences before taking action",
|
|
472
|
+
* policies: [
|
|
473
|
+
* "For exploratory tasks, missing optional parameters is LOW risk",
|
|
474
|
+
* "Prefer calling tools with available information over asking the user"
|
|
475
|
+
* ]
|
|
476
|
+
* })
|
|
477
|
+
*
|
|
478
|
+
* @example
|
|
479
|
+
* // Design principle
|
|
480
|
+
* principle({
|
|
481
|
+
* title: "Separation of concerns",
|
|
482
|
+
* description: "Each module should have a single, well-defined responsibility",
|
|
483
|
+
* policies: [
|
|
484
|
+
* "Data access logic stays in repository layer",
|
|
485
|
+
* "Business rules stay in service layer",
|
|
486
|
+
* "Presentation logic stays in controller/view layer"
|
|
487
|
+
* ]
|
|
488
|
+
* })
|
|
489
|
+
*/
|
|
490
|
+
export declare function principle(input: {
|
|
491
|
+
title: string;
|
|
492
|
+
description: string;
|
|
493
|
+
policies?: FragmentData[];
|
|
494
|
+
}): ContextFragment;
|
|
495
|
+
/**
|
|
496
|
+
* Define a policy rule, optionally with prerequisites or nested sub-policies.
|
|
497
|
+
*
|
|
498
|
+
* Policies can be used in two ways:
|
|
499
|
+
* 1. Prerequisite rules: "must do X before Y" using the `before` parameter
|
|
500
|
+
* 2. Sub-policies: nested rules within a principle using the `policies` parameter
|
|
501
|
+
*
|
|
502
|
+
* Policies differ from guardrails: policies are prerequisites (do this first),
|
|
503
|
+
* guardrails are prohibitions (never do this).
|
|
504
|
+
*
|
|
505
|
+
* @param input.rule - The policy rule to enforce
|
|
506
|
+
* @param input.before - What action this is a prerequisite for (optional for sub-policies)
|
|
507
|
+
* @param input.reason - Why this rule matters
|
|
508
|
+
* @param input.policies - Nested sub-policies for hierarchical structure
|
|
509
|
+
*
|
|
510
|
+
* @example
|
|
511
|
+
* // Prerequisite rule with "before"
|
|
512
|
+
* policy({
|
|
513
|
+
* rule: "Validate SQL syntax",
|
|
514
|
+
* before: "executing any query against the database",
|
|
515
|
+
* reason: "Catches errors early and allows correction before execution"
|
|
516
|
+
* })
|
|
517
|
+
*
|
|
518
|
+
* @example
|
|
519
|
+
* // Sub-policy within a principle (no "before" needed)
|
|
520
|
+
* policy({ rule: "Policy-based rules, mandatory prerequisites, and constraints." })
|
|
521
|
+
*
|
|
522
|
+
* @example
|
|
523
|
+
* // Nested sub-policies (hierarchical structure like 1.2 → 1.2.1)
|
|
524
|
+
* policy({
|
|
525
|
+
* rule: "Order of operations: Ensure taking an action does not prevent a subsequent necessary action.",
|
|
526
|
+
* policies: [
|
|
527
|
+
* "The user may request actions in a random order, but you may need to reorder operations.",
|
|
528
|
+
* ],
|
|
529
|
+
* })
|
|
530
|
+
*/
|
|
531
|
+
export declare function policy(input: {
|
|
532
|
+
rule: string;
|
|
533
|
+
before?: string;
|
|
534
|
+
reason?: string;
|
|
535
|
+
policies?: FragmentData[];
|
|
536
|
+
}): ContextFragment;
|
|
440
537
|
//# sourceMappingURL=domain.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAKtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAKlD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,eAAe,CAUlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,CAQlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,eAAe,CAWlB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,CAQzE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAKrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B,GAAG,eAAe,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B,GAAG,eAAe,CAUlB"}
|
|
@@ -36,23 +36,23 @@ export declare function identity(input: {
|
|
|
36
36
|
role?: string;
|
|
37
37
|
}): ContextFragment;
|
|
38
38
|
/**
|
|
39
|
-
* Define an AI persona with a name, role, and communication tone.
|
|
39
|
+
* Define an AI persona with a name, role, objective, and communication tone.
|
|
40
40
|
*
|
|
41
|
-
* Use this to customize the assistant's
|
|
42
|
-
* The persona influences the style and approach of responses.
|
|
41
|
+
* Use this to customize the assistant's identity and what it should accomplish.
|
|
43
42
|
*
|
|
44
43
|
* @param input.name - The persona's name
|
|
45
|
-
* @param input.role - The persona's
|
|
44
|
+
* @param input.role - The persona's expertise/identity (what they are)
|
|
45
|
+
* @param input.objective - What the persona should accomplish (the goal)
|
|
46
46
|
* @param input.tone - The communication style (e.g., friendly, professional, concise)
|
|
47
47
|
*
|
|
48
48
|
* @example
|
|
49
|
-
* persona({ name: "DataBot", role: "SQL Expert",
|
|
50
|
-
* persona({ name: "QueryMaster", role: "Database Analyst",
|
|
51
|
-
* persona({ name: "SQLHelper", role: "Data Assistant", tone: "casual and approachable" })
|
|
49
|
+
* persona({ name: "DataBot", role: "SQL Expert", objective: "Generate accurate SQL queries from natural language" })
|
|
50
|
+
* persona({ name: "QueryMaster", role: "Database Analyst", objective: "Help users explore database schemas" })
|
|
52
51
|
*/
|
|
53
52
|
export declare function persona(input: {
|
|
54
53
|
name: string;
|
|
55
|
-
role
|
|
54
|
+
role?: string;
|
|
55
|
+
objective?: string;
|
|
56
56
|
tone?: string;
|
|
57
57
|
}): ContextFragment;
|
|
58
58
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,eAAe,CAQlB;AAED
|
|
1
|
+
{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,eAAe,CAQlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,eAAe,CAUlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAKpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAKzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAKhE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,eAAe,CAKjB"}
|
package/dist/lib/fragments.d.ts
CHANGED
|
@@ -35,7 +35,7 @@ export interface ContextFragment<T extends FragmentData = FragmentData> {
|
|
|
35
35
|
/**
|
|
36
36
|
* Fragment data can be a primitive, array, object, or nested fragment.
|
|
37
37
|
*/
|
|
38
|
-
export type FragmentData = string | number | boolean | ContextFragment | FragmentData[] | {
|
|
38
|
+
export type FragmentData = string | number | null | undefined | boolean | ContextFragment | FragmentData[] | {
|
|
39
39
|
[key: string]: FragmentData;
|
|
40
40
|
};
|
|
41
41
|
/**
|
|
@@ -54,11 +54,7 @@ export declare function isFragmentObject(data: unknown): data is FragmentObject;
|
|
|
54
54
|
* Type guard to check if a fragment is a message fragment.
|
|
55
55
|
*/
|
|
56
56
|
export declare function isMessageFragment(fragment: ContextFragment): boolean;
|
|
57
|
-
export declare function fragment(name: string, ...children:
|
|
58
|
-
/**
|
|
59
|
-
* Create a role fragment for system prompt instructions.
|
|
60
|
-
*/
|
|
61
|
-
export declare function role(content: string): ContextFragment;
|
|
57
|
+
export declare function fragment(name: string, ...children: FragmentData[]): ContextFragment;
|
|
62
58
|
/**
|
|
63
59
|
* Create a user message fragment.
|
|
64
60
|
* Message fragments are separated from regular fragments during resolve().
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../src/lib/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,IAAI,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACpE;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,eAAe,GACf,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,eAAe,CAQjE;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAOtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,GAAG,QAAQ,EAAE,
|
|
1
|
+
{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../../src/lib/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,IAAI,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACpE;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,IAAI,GACJ,SAAS,GACT,OAAO,GACP,eAAe,GACf,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,eAAe,CAQjE;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE1D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAOtE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,GAAG,QAAQ,EAAE,YAAY,EAAE,GAC1B,eAAe,CAKjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAwBjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,eAAe,CAgB7D;AACD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAwBpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,eAAe,CAOjB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"error-recovery.guardrail.d.ts","sourceRoot":"","sources":["../../../src/lib/guardrails/error-recovery.guardrail.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,eAAO,MAAM,sBAAsB,EAAE,SAsFpC,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { type ContextFragment } from './fragments.ts';
|
|
2
|
+
/**
|
|
3
|
+
* Render fragments to XML.
|
|
4
|
+
*
|
|
5
|
+
* Wraps fragments in a parent tag and renders using XmlRenderer.
|
|
6
|
+
*
|
|
7
|
+
* @param tag - Parent tag name (e.g., 'instructions')
|
|
8
|
+
* @param fragments - Fragments to render
|
|
9
|
+
* @returns XML string
|
|
10
|
+
*
|
|
11
|
+
* @example
|
|
12
|
+
* ```ts
|
|
13
|
+
* const xml = render(
|
|
14
|
+
* 'instructions',
|
|
15
|
+
* persona({ name: 'Freya', role: 'Data Assistant' }),
|
|
16
|
+
* guardrail({ rule: 'Never expose PII' }),
|
|
17
|
+
* );
|
|
18
|
+
* ```
|
|
19
|
+
*/
|
|
20
|
+
export declare function render(tag: string, ...fragments: ContextFragment[]): string;
|
|
21
|
+
//# sourceMappingURL=render.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/lib/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAY,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,CAQ3E"}
|
|
@@ -32,6 +32,14 @@ export declare abstract class ContextRenderer {
|
|
|
32
32
|
* Group fragments by name for groupFragments option.
|
|
33
33
|
*/
|
|
34
34
|
protected groupByName(fragments: ContextFragment[]): Map<string, ContextFragment[]>;
|
|
35
|
+
/**
|
|
36
|
+
* Remove null/undefined from fragments and fragment data recursively.
|
|
37
|
+
* This protects renderers from nullish values and ensures they are ignored
|
|
38
|
+
* consistently across all output formats.
|
|
39
|
+
*/
|
|
40
|
+
protected sanitizeFragments(fragments: ContextFragment[]): ContextFragment[];
|
|
41
|
+
protected sanitizeFragment(fragment: ContextFragment, seen: WeakSet<object>): ContextFragment | null;
|
|
42
|
+
protected sanitizeData(data: FragmentData, seen: WeakSet<object>): FragmentData | undefined;
|
|
35
43
|
/**
|
|
36
44
|
* Template method - dispatches value to appropriate handler.
|
|
37
45
|
*/
|
|
@@ -80,8 +88,8 @@ export declare class TomlRenderer extends ContextRenderer {
|
|
|
80
88
|
* Override renderValue to preserve type information for TOML formatting.
|
|
81
89
|
*/
|
|
82
90
|
protected renderValue(key: string, value: unknown, ctx: RenderContext): string;
|
|
83
|
-
protected renderPrimitive(key: string, value: string,
|
|
84
|
-
protected renderArray(key: string, items: FragmentData[],
|
|
91
|
+
protected renderPrimitive(key: string, value: string, ctx: RenderContext): string;
|
|
92
|
+
protected renderArray(key: string, items: FragmentData[], ctx: RenderContext): string;
|
|
85
93
|
protected renderObject(key: string, obj: FragmentObject, ctx: RenderContext): string;
|
|
86
94
|
protected renderFragment(fragment: ContextFragment, ctx: RenderContext): string;
|
|
87
95
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"abstract.renderer.d.ts","sourceRoot":"","sources":["../../../src/lib/renderers/abstract.renderer.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EAGpB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,8BAAsB,eAAe;IACnC,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC;gBAEvB,OAAO,GAAE,eAAoB;IAIzC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM;IAErD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,IAAI,MAAM,GAAG,MAAM,GAAG,OAAO;IAQ5E;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,SAAS,EAAE,eAAe,EAAE,GAC3B,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAUjC;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,aAAa,GACjB,MAAM;IAgBT;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAC/B,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,aAAa,GACjB,MAAM;IAET;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,EAAE;IAO3E,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,aAAa,GACjB,MAAM;IACT,SAAS,CAAC,QAAQ,CAAC,WAAW,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,aAAa,GACjB,MAAM;IACT,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,aAAa,GACjB,MAAM;CACV;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,eAAe;;IAC9C,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM;
|
|
1
|
+
{"version":3,"file":"abstract.renderer.d.ts","sourceRoot":"","sources":["../../../src/lib/renderers/abstract.renderer.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"binary-bridges.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/binary-bridges.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"binary-bridges.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/binary-bridges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,WAAW,CAAC;AAI9D,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,QAAQ,EAAE,iBAAiB,EAAE,GAC/B,aAAa,EAAE,CA2GjB"}
|
|
@@ -11,7 +11,7 @@ import type { SkillsFragmentOptions } from './types.ts';
|
|
|
11
11
|
*
|
|
12
12
|
* @example
|
|
13
13
|
* ```ts
|
|
14
|
-
* const context = new ContextEngine({ store, chatId: 'demo' })
|
|
14
|
+
* const context = new ContextEngine({ userId: 'demo-user', store, chatId: 'demo' })
|
|
15
15
|
* .set(
|
|
16
16
|
* role('You are a helpful assistant.'),
|
|
17
17
|
* skills({ paths: ['./skills'] }), // Injects skill metadata into system prompt
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
* import { skills } from '@deepagents/context';
|
|
15
15
|
*
|
|
16
16
|
* // Add skills metadata to context
|
|
17
|
-
* const context = new ContextEngine({ store, chatId: 'demo' })
|
|
17
|
+
* const context = new ContextEngine({ userId: 'demo-user', store, chatId: 'demo' })
|
|
18
18
|
* .set(
|
|
19
19
|
* role('You are a helpful assistant.'),
|
|
20
20
|
* skills({ paths: ['./skills', '~/.deepagents/skills'] }),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/loader.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/lib/skills/loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAyB/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAWpE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CA6B5E"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { BranchData, BranchInfo, ChatData, ChatInfo, CheckpointData, CheckpointInfo, GraphData, MessageData, SearchOptions, SearchResult, StoredChatData } from './store.ts';
|
|
1
|
+
import type { BranchData, BranchInfo, ChatData, ChatInfo, CheckpointData, CheckpointInfo, DeleteChatOptions, GraphData, ListChatsOptions, MessageData, SearchOptions, SearchResult, StoredChatData } from './store.ts';
|
|
2
2
|
import { ContextStore } from './store.ts';
|
|
3
3
|
/**
|
|
4
4
|
* SQLite-based context store using graph model.
|
|
@@ -13,11 +13,13 @@ export declare class SqliteContextStore extends ContextStore {
|
|
|
13
13
|
upsertChat(chat: ChatData): Promise<StoredChatData>;
|
|
14
14
|
getChat(chatId: string): Promise<StoredChatData | undefined>;
|
|
15
15
|
updateChat(chatId: string, updates: Partial<Pick<ChatData, 'title' | 'metadata'>>): Promise<StoredChatData>;
|
|
16
|
-
listChats(): Promise<ChatInfo[]>;
|
|
16
|
+
listChats(options?: ListChatsOptions): Promise<ChatInfo[]>;
|
|
17
|
+
deleteChat(chatId: string, options?: DeleteChatOptions): Promise<boolean>;
|
|
17
18
|
addMessage(message: MessageData): Promise<void>;
|
|
18
19
|
getMessage(messageId: string): Promise<MessageData | undefined>;
|
|
19
20
|
getMessageChain(headId: string): Promise<MessageData[]>;
|
|
20
21
|
hasChildren(messageId: string): Promise<boolean>;
|
|
22
|
+
getMessages(chatId: string): Promise<MessageData[]>;
|
|
21
23
|
createBranch(branch: BranchData): Promise<void>;
|
|
22
24
|
getBranch(chatId: string, name: string): Promise<BranchData | undefined>;
|
|
23
25
|
getActiveBranch(chatId: string): Promise<BranchData | undefined>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.store.d.ts","sourceRoot":"","sources":["../../../src/lib/store/sqlite.store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,
|
|
1
|
+
{"version":3,"file":"sqlite.store.d.ts","sourceRoot":"","sources":["../../../src/lib/store/sqlite.store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EAGjB,SAAS,EAET,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0E1C;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;;gBAGtC,IAAI,EAAE,MAAM;IA2BlB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzC,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC;IA2CnD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IA4B5D,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,CAAC,CAAC,GACrD,OAAO,CAAC,cAAc,CAAC;IAqCpB,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2D1D,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAoCb,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC/C,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IA8B/D,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqCvD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBnD,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C,SAAS,CACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA4B5B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA4BhE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYhE,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC;IAMV,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA0DnD,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3D,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IA0BhC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAuB1D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7D,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IAgEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CA0EnD"}
|
|
@@ -12,6 +12,7 @@
|
|
|
12
12
|
*/
|
|
13
13
|
export interface ChatData {
|
|
14
14
|
id: string;
|
|
15
|
+
userId: string;
|
|
15
16
|
title?: string;
|
|
16
17
|
metadata?: Record<string, unknown>;
|
|
17
18
|
}
|
|
@@ -27,12 +28,31 @@ export interface StoredChatData extends ChatData {
|
|
|
27
28
|
*/
|
|
28
29
|
export interface ChatInfo {
|
|
29
30
|
id: string;
|
|
31
|
+
userId: string;
|
|
30
32
|
title?: string;
|
|
31
33
|
messageCount: number;
|
|
32
34
|
branchCount: number;
|
|
33
35
|
createdAt: number;
|
|
34
36
|
updatedAt: number;
|
|
35
37
|
}
|
|
38
|
+
/**
|
|
39
|
+
* Options for listing chats.
|
|
40
|
+
*/
|
|
41
|
+
export interface ListChatsOptions {
|
|
42
|
+
/** Filter by user ID */
|
|
43
|
+
userId?: string;
|
|
44
|
+
/** Maximum number of results to return */
|
|
45
|
+
limit?: number;
|
|
46
|
+
/** Number of results to skip (for pagination) */
|
|
47
|
+
offset?: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* Options for deleting a chat.
|
|
51
|
+
*/
|
|
52
|
+
export interface DeleteChatOptions {
|
|
53
|
+
/** If provided, only delete if chat belongs to this user */
|
|
54
|
+
userId?: string;
|
|
55
|
+
}
|
|
36
56
|
/**
|
|
37
57
|
* Data for creating/storing a message (graph node).
|
|
38
58
|
*/
|
|
@@ -178,9 +198,15 @@ export declare abstract class ContextStore {
|
|
|
178
198
|
*/
|
|
179
199
|
abstract updateChat(chatId: string, updates: Partial<Pick<ChatData, 'title' | 'metadata'>>): Promise<StoredChatData>;
|
|
180
200
|
/**
|
|
181
|
-
* List
|
|
201
|
+
* List chats, sorted by updatedAt descending.
|
|
202
|
+
* @param options - Optional filters for userId, limit, offset
|
|
203
|
+
*/
|
|
204
|
+
abstract listChats(options?: ListChatsOptions): Promise<ChatInfo[]>;
|
|
205
|
+
/**
|
|
206
|
+
* Delete a chat and all associated data (messages, branches, checkpoints).
|
|
207
|
+
* Returns true if deleted, false if not found or userId mismatch.
|
|
182
208
|
*/
|
|
183
|
-
abstract
|
|
209
|
+
abstract deleteChat(chatId: string, options?: DeleteChatOptions): Promise<boolean>;
|
|
184
210
|
/**
|
|
185
211
|
* Add a message to the graph.
|
|
186
212
|
*/
|
|
@@ -194,6 +220,14 @@ export declare abstract class ContextStore {
|
|
|
194
220
|
* chronological order (root first).
|
|
195
221
|
*/
|
|
196
222
|
abstract getMessageChain(headId: string): Promise<MessageData[]>;
|
|
223
|
+
/**
|
|
224
|
+
* Get all messages for a chat from the active branch.
|
|
225
|
+
* Returns messages in chronological order (oldest first).
|
|
226
|
+
*
|
|
227
|
+
* @throws Error if chat doesn't exist
|
|
228
|
+
* @returns Empty array if chat has no active branch or branch has no messages
|
|
229
|
+
*/
|
|
230
|
+
abstract getMessages(chatId: string): Promise<MessageData[]>;
|
|
197
231
|
/**
|
|
198
232
|
* Check if a message has children (is a fork point).
|
|
199
233
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lib/store/store.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lib/store/store.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepagents/context",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.12.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -35,12 +35,12 @@
|
|
|
35
35
|
"gpt-tokenizer": "^3.4.0",
|
|
36
36
|
"pluralize": "^8.0.0",
|
|
37
37
|
"stringcase": "^4.3.1",
|
|
38
|
-
"ai": "^
|
|
38
|
+
"ai": "^6.0.39",
|
|
39
39
|
"chalk": "^5.6.0",
|
|
40
40
|
"yaml": "^2.8.0",
|
|
41
41
|
"zod": "^3.25.76 || ^4.0.0",
|
|
42
|
-
"@deepagents/agent": "0.
|
|
43
|
-
"@ai-sdk/groq": "
|
|
42
|
+
"@deepagents/agent": "0.12.0",
|
|
43
|
+
"@ai-sdk/groq": "^3.0.10",
|
|
44
44
|
"bash-tool": "^1.3.1",
|
|
45
45
|
"just-bash": "^2.2.0",
|
|
46
46
|
"nano-spawn": "^2.0.0"
|