@deepagents/text2sql 0.26.0 → 0.27.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/README.md +1 -1
- package/dist/index.js +72 -53
- package/dist/index.js.map +2 -2
- package/dist/lib/adapters/bigquery/index.js +2 -1
- package/dist/lib/adapters/bigquery/index.js.map +2 -2
- package/dist/lib/adapters/groundings/abstract.grounding.d.ts +2 -1
- package/dist/lib/adapters/groundings/abstract.grounding.d.ts.map +1 -1
- package/dist/lib/adapters/groundings/index.js.map +2 -2
- package/dist/lib/adapters/mysql/index.js +2 -1
- package/dist/lib/adapters/mysql/index.js.map +2 -2
- package/dist/lib/adapters/postgres/index.js +2 -1
- package/dist/lib/adapters/postgres/index.js.map +2 -2
- package/dist/lib/adapters/runtime-scope.d.ts +14 -0
- package/dist/lib/adapters/runtime-scope.d.ts.map +1 -0
- package/dist/lib/adapters/spreadsheet/index.js +2 -1
- package/dist/lib/adapters/spreadsheet/index.js.map +2 -2
- package/dist/lib/adapters/sqlite/index.js +2 -1
- package/dist/lib/adapters/sqlite/index.js.map +2 -2
- package/dist/lib/adapters/sqlserver/index.js +2 -1
- package/dist/lib/adapters/sqlserver/index.js.map +2 -2
- package/dist/lib/agents/exceptions.d.ts +22 -0
- package/dist/lib/agents/exceptions.d.ts.map +1 -1
- package/dist/lib/fragments/schema.d.ts +2 -1
- package/dist/lib/fragments/schema.d.ts.map +1 -1
- package/dist/lib/instructions.d.ts +1 -9
- package/dist/lib/instructions.d.ts.map +1 -1
- package/dist/lib/sql.d.ts +0 -3
- package/dist/lib/sql.d.ts.map +1 -1
- package/dist/lib/synthesis/index.js +428 -621
- package/dist/lib/synthesis/index.js.map +4 -4
- package/dist/lib/synthesis/synthesizers/index.d.ts +1 -2
- package/dist/lib/synthesis/synthesizers/index.d.ts.map +1 -1
- package/package.json +7 -6
- package/dist/lib/agents/teachables.agent.d.ts +0 -10
- package/dist/lib/agents/teachables.agent.d.ts.map +0 -1
- package/dist/lib/synthesis/synthesizers/teachings-generator.d.ts +0 -20
- package/dist/lib/synthesis/synthesizers/teachings-generator.d.ts.map +0 -1
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
declare const sqlValidationMarker: unique symbol;
|
|
2
2
|
declare const unanswerableSqlMarker: unique symbol;
|
|
3
|
+
declare const sqlScopeMarker: unique symbol;
|
|
4
|
+
export type SQLScopeErrorType = 'OUT_OF_SCOPE' | 'SQL_SCOPE_PARSE_ERROR';
|
|
5
|
+
export interface SQLScopeErrorPayload {
|
|
6
|
+
error: string;
|
|
7
|
+
error_type: SQLScopeErrorType;
|
|
8
|
+
suggestion: string;
|
|
9
|
+
sql_attempted: string;
|
|
10
|
+
referenced_entities?: string[];
|
|
11
|
+
allowed_entities?: string[];
|
|
12
|
+
parser_dialect?: string;
|
|
13
|
+
parser_error?: string;
|
|
14
|
+
}
|
|
3
15
|
/**
|
|
4
16
|
* Error thrown when SQL validation fails.
|
|
5
17
|
*/
|
|
@@ -16,5 +28,15 @@ export declare class UnanswerableSQLError extends Error {
|
|
|
16
28
|
constructor(message: string);
|
|
17
29
|
static isInstance(error: unknown): error is UnanswerableSQLError;
|
|
18
30
|
}
|
|
31
|
+
/**
|
|
32
|
+
* Error thrown when a query falls outside the grounded runtime scope.
|
|
33
|
+
*/
|
|
34
|
+
export declare class SQLScopeError extends Error {
|
|
35
|
+
[sqlScopeMarker]: true;
|
|
36
|
+
readonly payload: SQLScopeErrorPayload;
|
|
37
|
+
readonly errorType: SQLScopeErrorType;
|
|
38
|
+
constructor(payload: SQLScopeErrorPayload);
|
|
39
|
+
static isInstance(error: unknown): error is SQLScopeError;
|
|
40
|
+
}
|
|
19
41
|
export {};
|
|
20
42
|
//# sourceMappingURL=exceptions.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/exceptions.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,mBAAmB,eAA+B,CAAC;AACzD,QAAA,MAAM,qBAAqB,eAAiC,CAAC;
|
|
1
|
+
{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../../../src/lib/agents/exceptions.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,mBAAmB,eAA+B,CAAC;AACzD,QAAA,MAAM,qBAAqB,eAAiC,CAAC;AAC7D,QAAA,MAAM,cAAc,eAA0B,CAAC;AAE/C,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,uBAAuB,CAAC;AAEzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,iBAAiB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC;gBAEhB,OAAO,EAAE,MAAM;IAM3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB;CAK/D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,CAAC,qBAAqB,CAAC,EAAE,IAAI,CAAC;gBAElB,OAAO,EAAE,MAAM;IAM3B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB;CAMjE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;gBAE1B,OAAO,EAAE,oBAAoB;IAQzC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa;CAG1D"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ContextFragment } from '@deepagents/context';
|
|
1
|
+
import type { ContextFragment, FragmentObject } from '@deepagents/context';
|
|
2
2
|
/**
|
|
3
3
|
* Schema fragment builders.
|
|
4
4
|
*
|
|
@@ -35,6 +35,7 @@ export declare function dialectInfo(input: {
|
|
|
35
35
|
dialect: string;
|
|
36
36
|
version?: string;
|
|
37
37
|
database?: string;
|
|
38
|
+
details?: FragmentObject;
|
|
38
39
|
}): ContextFragment;
|
|
39
40
|
/**
|
|
40
41
|
* Database table with columns and optional metadata.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/schema.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,11 +1,3 @@
|
|
|
1
1
|
import { type ContextFragment } from '@deepagents/context';
|
|
2
|
-
export
|
|
3
|
-
/**
|
|
4
|
-
* Controls date/time clarification behavior:
|
|
5
|
-
* - 'strict': Ask for clarification when date range is missing (production default)
|
|
6
|
-
* - false: Skip date clarifications, assume all matching data (useful for evals/benchmarks)
|
|
7
|
-
*/
|
|
8
|
-
date?: 'strict' | false;
|
|
9
|
-
}
|
|
10
|
-
export declare function guidelines(options?: TeachingsOptions): ContextFragment[];
|
|
2
|
+
export declare function guidelines(): ContextFragment[];
|
|
11
3
|
//# sourceMappingURL=instructions.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAarB,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EAarB,MAAM,qBAAqB,CAAC;AAgJ7B,wBAAgB,UAAU,IAAI,eAAe,EAAE,CA4T9C"}
|
package/dist/lib/sql.d.ts
CHANGED
|
@@ -3,7 +3,6 @@ import { type IFileSystem } from 'just-bash';
|
|
|
3
3
|
import { type AgentModel } from '@deepagents/agent';
|
|
4
4
|
import { type ChatMessage, ContextEngine, type ContextFragment } from '@deepagents/context';
|
|
5
5
|
import type { Adapter } from './adapters/adapter.ts';
|
|
6
|
-
import { type TeachingsOptions } from './instructions.ts';
|
|
7
6
|
import { type ExtractedPair, type PairProducer } from './synthesis/types.ts';
|
|
8
7
|
export type RenderingTools = Record<string, Tool<unknown, never>>;
|
|
9
8
|
export declare class Text2Sql {
|
|
@@ -15,8 +14,6 @@ export declare class Text2Sql {
|
|
|
15
14
|
tools?: RenderingTools;
|
|
16
15
|
model: AgentModel;
|
|
17
16
|
transform?: StreamTextTransform<ToolSet> | StreamTextTransform<ToolSet>[];
|
|
18
|
-
/** @see TeachingsOptions */
|
|
19
|
-
teachingsOptions?: TeachingsOptions;
|
|
20
17
|
filesystem: IFileSystem;
|
|
21
18
|
});
|
|
22
19
|
toSql(input: string): Promise<string>;
|
package/dist/lib/sql.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/lib/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,IAAI,EAET,KAAK,OAAO,EAGb,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,eAAe,EAMrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/lib/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,IAAI,EAET,KAAK,OAAO,EAGb,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,eAAe,EAMrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAMrD,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAElE,qBAAa,QAAQ;;gBAWP,MAAM,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,CAAC,GAAG,SAAS,EAAE,eAAe,EAAE,KAAK,aAAa,CAAC;QAC5D,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,KAAK,EAAE,UAAU,CAAC;QAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,UAAU,EAAE,WAAW,CAAC;KACzB;IAcY,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWlD;;;OAGG;IACU,KAAK,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAUhD;;;;;;;;;;;;;;;;;;OAkBG;IACU,OAAO,CAAC,CAAC,SAAS,YAAY,EACzC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC;IAKd,IAAI,CACf,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,WAAW,CAAA;KAAE;CAwH1C"}
|