@deepagents/text2sql 0.10.2 → 0.11.0

package/dist/lib/agents/developer.agent.d.ts

@@ -1,31 +1,41 @@
+import { type ContextFragment } from '@deepagents/context';
 import type { Adapter } from '../adapters/adapter.ts';
-import type { Teachables } from '../teach/teachables.ts';
 /**
- * State passed to the developer agent
+ * Context variables passed to the developer agent tools via stream().
  */
-export type DeveloperAgentState = {
-    /** Database adapter for validation */
+export type DeveloperContextVariables = {
+    /** Database adapter for validation and execution */
     adapter: Adapter;
-    /** Schema introspection XML */
-    introspection: string;
-    /** Combined teachings/instructions */
-    teachings: string;
-    /** Instructions for SQL generation */
-    instructions: Teachables[];
 };
 /**
- * Developer Agent - Power-user conversational interface for SQL generation
- *
- * This agent provides tools for SQL generation, validation, and explanation
- * without execution. Designed for developers/DBAs who want full control
- * over query building and refinement.
- *
- * Tools:
- * - generate_sql: Convert natural language to validated SQL
- * - validate_sql: Check SQL syntax without execution
- * - explain_sql: Get plain-English explanation of SQL
- * - show_schema: Display schema introspection on demand
- * - scratchpad: Developer notes/reasoning
+ * Developer agent exports - tools and context fragments.
+ * The agent is constructed dynamically in sql.ts developer() method.
  */
-export declare const developerAgent: import("@deepagents/agent").Agent<never, DeveloperAgentState, DeveloperAgentState>;
+declare const _default: {
+    tools: {
+        /**
+         * Validate SQL query syntax before execution.
+         */
+        validate_query: import("ai").Tool<{
+            sql: string;
+        }, string>;
+        /**
+         * Execute SQL query against the database.
+         */
+        db_query: import("ai").Tool<{
+            reasoning: string;
+            sql: string;
+        }, any[]>;
+        /**
+         * Get plain-English explanation of a SQL query.
+         */
+        explain_sql: import("ai").Tool<{
+            sql: string;
+        }, {
+            explanation: string;
+        }>;
+    };
+    fragments: ContextFragment<import("@deepagents/context").FragmentData>[];
+};
+export default _default;
 //# sourceMappingURL=developer.agent.d.ts.map

package/dist/lib/agents/developer.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"developer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/developer.agent.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B,CAAC;AAsJF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,oFAuCzB,CAAC"}
+{"version":3,"file":"developer.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/developer.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AAE1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AA4FF;;;GAGG;;;QAxFD;;WAEG;;;;QAgBH;;WAEG;;;;;QA4BH;;WAEG;;;;;;;;;AAuCL,wBAAoC"}

package/dist/lib/agents/sql.agent.d.ts

@@ -1,15 +1,15 @@
 import { type AgentModel } from '@deepagents/agent';
+import { type ContextFragment } from '@deepagents/context';
 import type { Adapter } from '../adapters/adapter.ts';
-import { type Teachables } from '../teach/teachables.ts';
 export interface ToSqlOptions {
     /** The natural language input to convert to SQL */
     input: string;
     /** Database adapter for validation */
     adapter: Adapter;
-    /** Introspection/schema context */
-    introspection: string;
+    /** Schema fragments from adapter introspection */
+    schemaFragments: ContextFragment[];
     /** Instructions/teachings to include */
-    instructions: Teachables[];
+    instructions: ContextFragment[];
     /** Optional model override */
     model?: AgentModel;
     /** Maximum retry attempts on validation failure (default: 3) */

package/dist/lib/agents/sql.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA2DD,QAAA,MAAM,MAAM,eAA+B,CAAC;AAC5C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;gBACH,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;IAI3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;CAGjE;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA6DvE"}
+{"version":3,"file":"sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/sql.agent.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAEL,KAAK,eAAe,EAMrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kDAAkD;IAClD,eAAe,EAAE,eAAe,EAAE,CAAC;IACnC,wCAAwC;IACxC,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAiBD,QAAA,MAAM,MAAM,eAA+B,CAAC;AAC5C;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;gBACH,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAG/D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;IAI3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;CAGjE;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAqFvE"}

package/dist/lib/agents/teachables.agent.d.ts

@@ -1,10 +1,10 @@
 import { type AgentModel } from '@deepagents/agent';
-import { type Teachables } from '../teach/teachables.ts';
+import { type ContextFragment } from '@deepagents/context';
 export interface GenerateToTeachingsOptions {
     model?: AgentModel;
 }
 export declare function toTeachings(input: {
     schema: string;
     context?: string;
-}, options?: GenerateToTeachingsOptions): Promise<Teachables[]>;
+}, options?: GenerateToTeachingsOptions): Promise<ContextFragment[]>;
 //# sourceMappingURL=teachables.agent.d.ts.map

package/dist/lib/agents/teachables.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"teachables.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/teachables.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAE3E,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAC;AAwIhC,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,UAAU,EAAE,CAAC,CAoCvB"}
+{"version":3,"file":"teachables.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/teachables.agent.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EACL,KAAK,eAAe,EAWrB,MAAM,qBAAqB,CAAC;AAwI7B,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,eAAe,EAAE,CAAC,CAuE5B"}

package/dist/lib/agents/text2sql.agent.d.ts

@@ -1,77 +1,24 @@
 import { type Tool } from 'ai';
-import type { TeachablesStore } from '../memory/store.ts';
-import type { GeneratedTeachable } from '../teach/teachables.ts';
 export type RenderingTools = Record<string, Tool<unknown, never>>;
-export declare const memoryTools: {
-    remember_memory: Tool<{
-        memory: {
-            type: "identity";
-            description: string;
-        } | {
-            type: "alias";
-            term: string;
-            meaning: string;
-        } | {
-            type: "preference";
-            aspect: string;
-            value: string;
-        } | {
-            type: "context";
-            description: string;
-        } | {
-            type: "correction";
-            subject: string;
-            clarification: string;
-        };
-    }, string>;
-    forget_memory: Tool<{
-        id: string;
-    }, string>;
-    recall_memory: Tool<{
-        type?: "identity" | "alias" | "preference" | "context" | "correction" | undefined;
-    }, string | {
-        id: string;
-        type: "term" | "hint" | "guardrail" | "explain" | "example" | "clarification" | "workflow" | "quirk" | "styleGuide" | "analogy" | "glossary" | "identity" | "persona" | "alias" | "preference" | "context" | "correction";
-        data: GeneratedTeachable;
-        createdAt: string;
-    }[]>;
-    update_memory: Tool<{
-        memory: {
-            type: "identity";
-            description: string;
-        } | {
-            type: "alias";
-            term: string;
-            meaning: string;
-        } | {
-            type: "preference";
-            aspect: string;
-            value: string;
-        } | {
-            type: "context";
-            description: string;
-        } | {
-            type: "correction";
-            subject: string;
-            clarification: string;
-        };
-        id: string;
-    }, string>;
-};
 /**
  * An agent that does Table Augmented Generation for Text-to-SQL tasks.
  */
-export declare const t_a_g: import("@deepagents/agent").Agent<{
-    sql: string;
-}, {
-    introspection: string;
-    teachings: string;
-    memory?: TeachablesStore;
-    userId?: string;
-}, {
-    introspection: string;
-    teachings: string;
-    memory?: TeachablesStore;
-    userId?: string;
-}>;
+export declare const t_a_g: {
+    "__#private@#private": any;
+    readonly tools: import("ai").ToolSet;
+    generate<COut, CIn = COut>(contextVariables: CIn, config?: {
+        abortSignal?: AbortSignal;
+    }): Promise<import("ai").GenerateTextResult<import("ai").ToolSet, never>>;
+    stream<COut, CIn = COut>(contextVariables: CIn, config?: {
+        abortSignal?: AbortSignal;
+        transform?: import("ai").StreamTextTransform<import("ai").ToolSet> | import("ai").StreamTextTransform<import("ai").ToolSet>[];
+        maxRetries?: number;
+    }): Promise<import("ai").StreamTextResult<import("ai").ToolSet, never>>;
+    clone(overrides?: Partial<import("@deepagents/context").CreateAgent<{
+        sql: string;
+    }, {
+        introspection: string;
+        teachings: string;
+    }>> | undefined): /*elided*/ any;
+};
 //# sourceMappingURL=text2sql.agent.d.ts.map

package/dist/lib/agents/text2sql.agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text2sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/text2sql.agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,IAAI,CAAC;AAQrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAmHlE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEvB,CAAC;AAuGF;;GAEG;AACH,eAAO,MAAM,KAAK;SACT,MAAM;;mBAGI,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;;mBAHA,MAAM;eACV,MAAM;aACR,eAAe;aACf,MAAM;EAoBjB,CAAC"}
+{"version":3,"file":"text2sql.agent.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/text2sql.agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,IAAI,CAAC;AASrC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAmJlE;;GAEG;AACH,eAAO,MAAM,KAAK;;;;mBApImD,CAAC;;;mBAkB/B,CAAC;iBACpC,CAAA;kBAEsC,CAAC;;;aAgHlC,MAAM;;uBAEI,MAAM;mBACV,MAAM;;CAgBnB,CAAC"}

package/dist/lib/fragments/schema.d.ts

@@ -0,0 +1,214 @@
+import type { ContextFragment } from '@deepagents/context';
+/**
+ * Schema fragment builders.
+ *
+ * These fragments represent database schema metadata that can be injected
+ * into AI prompts. Use with renderers (XML, Markdown, TOML, TOON) to format.
+ *
+ * @example
+ * ```ts
+ * import { dialectInfo, table, column, relationship } from '@deepagents/text2sql';
+ *
+ * const schemaFragments = [
+ *   dialectInfo({ dialect: 'PostgreSQL', version: '14.5' }),
+ *   table({
+ *     name: 'users',
+ *     columns: [
+ *       column({ name: 'id', type: 'integer', pk: true }),
+ *       column({ name: 'email', type: 'varchar', unique: true }),
+ *     ],
+ *   }),
+ * ];
+ * ```
+ */
+/**
+ * Database dialect and version information.
+ *
+ * @param input.dialect - Database type (PostgreSQL, SQLite, SQL Server, etc.)
+ * @param input.version - Database version string
+ * @param input.database - Database name
+ *
+ * @example
+ * dialectInfo({ dialect: 'PostgreSQL', version: '14.5', database: 'myapp' })
+ */
+export declare function dialectInfo(input: {
+    dialect: string;
+    version?: string;
+    database?: string;
+}): ContextFragment;
+/**
+ * Database table with columns and optional metadata.
+ *
+ * @param input.name - Table name
+ * @param input.schema - Schema name (e.g., 'public' for PostgreSQL)
+ * @param input.rowCount - Approximate row count
+ * @param input.sizeHint - Size category for query optimization hints
+ * @param input.columns - Array of column() fragments
+ * @param input.indexes - Array of index() fragments
+ * @param input.constraints - Array of constraint() fragments
+ *
+ * @example
+ * table({
+ *   name: 'users',
+ *   rowCount: 1500,
+ *   sizeHint: 'medium',
+ *   columns: [
+ *     column({ name: 'id', type: 'integer', pk: true }),
+ *     column({ name: 'email', type: 'varchar', unique: true, indexed: true }),
+ *   ],
+ *   indexes: [
+ *     index({ name: 'idx_email', columns: ['email'], unique: true }),
+ *   ],
+ * })
+ */
+export declare function table(input: {
+    name: string;
+    schema?: string;
+    rowCount?: number;
+    sizeHint?: 'tiny' | 'small' | 'medium' | 'large' | 'huge';
+    columns: ContextFragment[];
+    indexes?: ContextFragment[];
+    constraints?: ContextFragment[];
+}): ContextFragment;
+/**
+ * Table column with type and annotations.
+ *
+ * @param input.name - Column name
+ * @param input.type - Column data type (e.g., 'integer', 'varchar(255)')
+ * @param input.pk - Is primary key
+ * @param input.fk - Foreign key reference in "table.column" format
+ * @param input.unique - Has unique constraint
+ * @param input.notNull - Has NOT NULL constraint
+ * @param input.default - Default value expression
+ * @param input.indexed - Has index on this column
+ * @param input.values - Enum or low cardinality values
+ * @param input.stats - Column statistics (min, max, null fraction)
+ *
+ * @example
+ * column({
+ *   name: 'status',
+ *   type: 'varchar',
+ *   notNull: true,
+ *   indexed: true,
+ *   values: ['active', 'inactive', 'suspended'],
+ * })
+ */
+export declare function column(input: {
+    name: string;
+    type: string;
+    pk?: boolean;
+    fk?: string;
+    unique?: boolean;
+    notNull?: boolean;
+    default?: string;
+    indexed?: boolean;
+    values?: string[];
+    stats?: {
+        min?: string;
+        max?: string;
+        nullFraction?: number;
+    };
+}): ContextFragment;
+/**
+ * Table index.
+ *
+ * @param input.name - Index name
+ * @param input.columns - Columns included in the index
+ * @param input.unique - Is unique index
+ * @param input.type - Index type (BTREE, HASH, GIN, etc.)
+ *
+ * @example
+ * index({ name: 'idx_user_email', columns: ['email'], unique: true, type: 'BTREE' })
+ */
+export declare function index(input: {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    type?: string;
+}): ContextFragment;
+/**
+ * Table constraint (CHECK, UNIQUE, PRIMARY_KEY, FOREIGN_KEY, etc).
+ *
+ * @param input.name - Constraint name
+ * @param input.type - Constraint type
+ * @param input.columns - Columns involved in the constraint
+ * @param input.definition - CHECK constraint SQL definition
+ * @param input.defaultValue - DEFAULT constraint value
+ * @param input.referencedTable - For FK: referenced table name
+ * @param input.referencedColumns - For FK: referenced column names
+ *
+ * @example
+ * constraint({
+ *   name: 'chk_amount_positive',
+ *   type: 'CHECK',
+ *   definition: 'amount > 0',
+ * })
+ *
+ * @example
+ * constraint({
+ *   name: 'fk_order_user',
+ *   type: 'FOREIGN_KEY',
+ *   columns: ['user_id'],
+ *   referencedTable: 'users',
+ *   referencedColumns: ['id'],
+ * })
+ */
+export declare function constraint(input: {
+    name: string;
+    type: 'CHECK' | 'UNIQUE' | 'NOT_NULL' | 'DEFAULT' | 'PRIMARY_KEY' | 'FOREIGN_KEY';
+    columns?: string[];
+    definition?: string;
+    defaultValue?: string;
+    referencedTable?: string;
+    referencedColumns?: string[];
+}): ContextFragment;
+/**
+ * Database view.
+ *
+ * @param input.name - View name
+ * @param input.schema - Schema name
+ * @param input.columns - Array of column() fragments
+ * @param input.definition - View SQL definition
+ *
+ * @example
+ * view({
+ *   name: 'active_users',
+ *   columns: [
+ *     column({ name: 'id', type: 'integer' }),
+ *     column({ name: 'email', type: 'varchar' }),
+ *   ],
+ *   definition: "SELECT id, email FROM users WHERE status = 'active'",
+ * })
+ */
+export declare function view(input: {
+    name: string;
+    schema?: string;
+    columns: ContextFragment[];
+    definition?: string;
+}): ContextFragment;
+/**
+ * Relationship between tables (foreign key connection).
+ *
+ * @param input.from - Source table and columns
+ * @param input.to - Referenced table and columns
+ * @param input.cardinality - Relationship cardinality
+ *
+ * @example
+ * relationship({
+ *   from: { table: 'orders', columns: ['user_id'] },
+ *   to: { table: 'users', columns: ['id'] },
+ *   cardinality: 'many-to-one',
+ * })
+ */
+export declare function relationship(input: {
+    from: {
+        table: string;
+        columns: string[];
+    };
+    to: {
+        table: string;
+        columns: string[];
+    };
+    cardinality?: 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
+}): ContextFragment;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/fragments/schema.d.ts.map

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

package/dist/lib/instructions.d.ts

@@ -1,3 +1,30 @@
-export * from './teach/teachables.ts';
-export { default } from './teach/teachables.ts';
+import { type ContextFragment } from '@deepagents/context';
+/**
+ * Instructions module - re-exports domain fragments from @deepagents/context.
+ *
+ * This module provides fragment builders for injecting domain knowledge
+ * into AI prompts. All fragments are rendered using the context package renderers.
+ */
+export { term, hint, guardrail, explain, example, clarification, workflow, quirk, styleGuide, analogy, glossary, identity, persona, alias, preference, userContext, correction, fragment, role, type ContextFragment, } from '@deepagents/context';
+/**
+ * Render fragments to XML instructions.
+ *
+ * This is a convenience function that wraps fragments in a parent tag
+ * and renders them using XmlRenderer with groupFragments enabled.
+ *
+ * @param tag - Parent tag name (e.g., 'instructions')
+ * @param fragments - Fragments to render
+ * @returns XML string
+ *
+ * @example
+ * ```ts
+ * const xml = toInstructions(
+ *   'instructions',
+ *   persona({ name: 'Freya', role: 'Data Assistant' }),
+ *   guardrail({ rule: 'Never expose PII' }),
+ *   hint('Always filter by status'),
+ * );
+ * ```
+ */
+export declare function toInstructions(tag: string, ...fragments: ContextFragment[]): string;
 //# sourceMappingURL=instructions.d.ts.map

package/dist/lib/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAGrB,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AAGH,OAAO,EAEL,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,OAAO,EACP,OAAO,EACP,aAAa,EACb,QAAQ,EACR,KAAK,EACL,UAAU,EACV,OAAO,EACP,QAAQ,EAER,QAAQ,EACR,OAAO,EACP,KAAK,EACL,UAAU,EACV,WAAW,EACX,UAAU,EAEV,QAAQ,EACR,IAAI,EACJ,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,SAAS,EAAE,eAAe,EAAE,GAC9B,MAAM,CAQR"}