@polpo-ai/core 0.15.143 → 0.16.0

package/dist/data/data.test.js

@@ -0,0 +1,233 @@
+import { describe, expect, it, vi } from "vitest";
+import { DataService, DataSchema, DataName, validateDataOperation, } from "./index.js";
+const schema = {
+    tables: {
+        customers: {
+            columns: {
+                name: { type: "text" },
+                email: { type: "text", unique: true },
+                age: { type: "integer", nullable: true },
+            },
+        },
+    },
+};
+const resource = {
+    id: "11111111-1111-4111-8111-111111111111",
+    name: "crm",
+    schema,
+    schemaVersion: 1,
+    createdAt: "2026-10-09T00:00:00.000Z",
+};
+function setup(grants = []) {
+    const provider = {
+        capabilities: {
+            transactions: true,
+            relations: true,
+            schemaEvolution: "additive",
+        },
+        list: vi.fn().mockResolvedValue([resource]),
+        get: vi.fn().mockResolvedValue(resource),
+        create: vi.fn().mockResolvedValue(resource),
+        migrate: vi.fn().mockResolvedValue(resource),
+        rename: vi.fn().mockResolvedValue(resource),
+        remove: vi.fn().mockResolvedValue(undefined),
+        execute: vi
+            .fn()
+            .mockResolvedValue([{ rows: [], total: 0, nextOffset: null }]),
+    };
+    return {
+        provider,
+        service: new DataService(provider, {
+            scope: "project-a",
+            principalId: "agent:leo",
+            grants,
+        }),
+    };
+}
+describe("Data contracts and scoped service", () => {
+    it("reserves UUID-shaped names so names cannot shadow immutable identities", () => {
+        expect(DataName.safeParse("abcdefab-1111-4111-8111-111111111111").success).toBe(false);
+        expect(DataName.safeParse("crm-live").success).toBe(true);
+    });
+    it("denies by default before resolving or mutating a resource", async () => {
+        const { service, provider } = setup();
+        await expect(service.execute("crm", {
+            operations: [{ op: "list", table: "customers" }],
+        })).rejects.toMatchObject({ code: "data_forbidden" });
+        expect(provider.get).not.toHaveBeenCalled();
+        expect(provider.execute).not.toHaveBeenCalled();
+    });
+    it("binds host scope and identity and resolves immutable resource grants", async () => {
+        const { service, provider } = setup([
+            { resource: resource.id, actions: ["read"] },
+        ]);
+        await service.execute("crm", {
+            operations: [{ op: "list", table: "customers" }],
+        });
+        expect(provider.execute).toHaveBeenCalledWith("project-a", resource.id, "agent:leo", expect.objectContaining({
+            operations: [expect.objectContaining({ op: "list" })],
+        }));
+    });
+    it("rejects write escalation, foreign resources and table escalation", async () => {
+        const { service, provider } = setup([
+            { resource: resource.id, tables: ["orders"], actions: ["read"] },
+        ]);
+        await expect(service.execute("crm", {
+            operations: [{ op: "list", table: "customers" }],
+        })).rejects.toMatchObject({ code: "data_forbidden" });
+        await expect(service.execute("crm", {
+            operations: [
+                {
+                    op: "insert",
+                    table: "customers",
+                    values: { name: "A", email: "a" },
+                },
+            ],
+        })).rejects.toMatchObject({ code: "data_forbidden" });
+        expect(provider.execute).not.toHaveBeenCalled();
+        const other = setup([
+            { resource: "22222222-2222-4222-8222-222222222222", actions: ["read"] },
+        ]);
+        await expect(other.service.describe("crm")).rejects.toMatchObject({
+            code: "data_forbidden",
+        });
+    });
+    it("filters both resource listing and table metadata to grants", async () => {
+        const { service } = setup([
+            { resource: resource.id, tables: ["orders"], actions: ["read"] },
+        ]);
+        expect((await service.describe("crm")).schema.tables).toEqual({});
+        expect(await setup().service.list()).toEqual([]);
+    });
+    it("separates schema management from record writes", async () => {
+        const { service } = setup([{ resource: resource.id, actions: ["write"] }]);
+        await expect(service.migrate("crm", { expectedVersion: 1, schema })).rejects.toMatchObject({ code: "data_forbidden" });
+        await expect(service.create({ name: "new", schema })).rejects.toMatchObject({ code: "data_forbidden" });
+    });
+    it("snapshots grants so callers cannot mutate their authorization after binding", async () => {
+        const grants = [{ resource: resource.id, actions: ["read"] }];
+        const { service } = setup(grants);
+        grants[0].actions.push("manage");
+        await expect(service.rename("crm", { name: "other", expectedVersion: 1 })).rejects.toMatchObject({ code: "data_forbidden" });
+    });
+    it("validates every batch item before making any provider write", async () => {
+        const { service, provider } = setup([
+            { resource: "*", actions: ["manage"] },
+        ]);
+        await expect(service.execute("crm", {
+            operations: [
+                {
+                    op: "insert",
+                    table: "customers",
+                    values: { name: "A", email: "a" },
+                },
+                {
+                    op: "insert",
+                    table: "customers",
+                    values: { name: "B", email: "b", age: "invalid" },
+                },
+            ],
+        })).rejects.toMatchObject({ code: "data_invalid" });
+        expect(provider.execute).not.toHaveBeenCalled();
+    });
+    it.each([
+        { op: "delete", table: "customers" },
+        { op: "list", table: "customers; DROP SCHEMA public" },
+        { op: "list", table: "customers", limit: 100000 },
+        { op: "list", table: "customers", scope: "project-b" },
+        { op: "list", table: "customers", filter: { age: { eq: "not-a-number" } } },
+        {
+            op: "insert",
+            table: "customers",
+            values: { name: "A", email: "a", _version: 99 },
+        },
+        {
+            op: "upsert",
+            table: "customers",
+            values: { name: "A", email: "a" },
+            onConflict: ["name"],
+        },
+    ])("rejects malformed or unsafe operation %j", (operation) => {
+        expect(() => validateDataOperation(schema, operation)).toThrow();
+    });
+    it("validates types, references and identifiers in the canonical schema", () => {
+        expect(DataSchema.safeParse({ tables: { "public.customers": { columns: {} } } })
+            .success).toBe(false);
+        expect(DataSchema.safeParse({
+            tables: { users: { columns: { _id: { type: "uuid" } } } },
+        }).success).toBe(false);
+        expect(DataSchema.safeParse({
+            tables: {
+                users: {
+                    columns: {
+                        customer: {
+                            type: "uuid",
+                            references: { table: "missing", column: "_id" },
+                        },
+                    },
+                },
+            },
+        }).success).toBe(false);
+        expect(DataSchema.safeParse({ ...schema, secret: "no" }).success).toBe(false);
+    });
+    it("requires bounded idempotency keys and batches", async () => {
+        const { service } = setup([{ resource: "*", actions: ["manage"] }]);
+        await expect(service.execute("crm", { operations: [] })).rejects.toMatchObject({ code: "data_invalid" });
+        await expect(service.execute("crm", {
+            idempotencyKey: "x".repeat(201),
+            operations: [{ op: "list", table: "customers" }],
+        })).rejects.toMatchObject({ code: "data_invalid" });
+    });
+});
+describe("Remote Data capability", () => {
+    it("keeps bearer credentials out of the tool capability and preserves denial", async () => {
+        const { createRemoteDataClient } = await import("./index.js");
+        const fetcher = vi
+            .fn()
+            .mockResolvedValue(Response.json({ ok: false, code: "data_forbidden", error: "Access revoked" }, { status: 403 }));
+        const client = createRemoteDataClient({
+            url: "https://example.test/data",
+            token: "private",
+            headers: { "x-sandbox": "one" },
+            fetch: fetcher,
+        });
+        expect(Object.keys(client).sort()).toEqual([
+            "describe",
+            "execute",
+            "list",
+            "query",
+        ]);
+        expect(Object.isFrozen(client)).toBe(true);
+        await expect(client.describe("crm")).rejects.toMatchObject({
+            code: "data_forbidden",
+        });
+        expect(fetcher).toHaveBeenCalledWith("https://example.test/data", expect.objectContaining({
+            redirect: "error",
+            headers: expect.objectContaining({
+                Authorization: "Bearer private",
+                "x-sandbox": "one",
+            }),
+        }));
+    });
+    it("validates batch input before sending and never automatically retries ambiguous writes", async () => {
+        const { createRemoteDataClient } = await import("./index.js");
+        const fetcher = vi
+            .fn()
+            .mockRejectedValue(new Error("private network detail"));
+        const client = createRemoteDataClient({
+            url: "https://example.test/data",
+            token: "private",
+            fetch: fetcher,
+        });
+        expect(() => client.execute("crm", { operations: [] })).toThrow();
+        expect(fetcher).not.toHaveBeenCalled();
+        await expect(client.execute("crm", {
+            operations: [
+                { op: "insert", table: "contacts", values: { name: "Mario" } },
+            ],
+            idempotencyKey: "retry",
+        })).rejects.toMatchObject({ code: "data_unavailable" });
+        expect(fetcher).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=data.test.js.map

package/dist/data/data.test.js.map

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

package/dist/data/index.d.ts

@@ -0,0 +1,384 @@
+import { z } from "zod";
+export type DataErrorCode = "data_invalid" | "data_forbidden" | "data_not_found" | "data_conflict" | "data_constraint" | "data_limit" | "data_unavailable";
+export declare class DataError extends Error {
+    readonly code: DataErrorCode;
+    constructor(code: DataErrorCode, message: string);
+}
+export declare const DataIdentifier: z.ZodString;
+export declare const DataIndexName: z.ZodString;
+export declare const DataName: z.ZodString;
+export declare const DataColumnSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        number: "number";
+        boolean: "boolean";
+        text: "text";
+        json: "json";
+        timestamp: "timestamp";
+        integer: "integer";
+        uuid: "uuid";
+    }>;
+    nullable: z.ZodOptional<z.ZodBoolean>;
+    unique: z.ZodOptional<z.ZodBoolean>;
+    references: z.ZodOptional<z.ZodObject<{
+        table: z.ZodString;
+        column: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DataColumn = z.infer<typeof DataColumnSchema>;
+export declare const DataTableSchema: z.ZodObject<{
+    columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            text: "text";
+            json: "json";
+            timestamp: "timestamp";
+            integer: "integer";
+            uuid: "uuid";
+        }>;
+        nullable: z.ZodOptional<z.ZodBoolean>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+        references: z.ZodOptional<z.ZodObject<{
+            table: z.ZodString;
+            column: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    indexes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        columns: z.ZodArray<z.ZodString>;
+        unique: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const DataSchema: z.ZodObject<{
+    tables: z.ZodRecord<z.ZodString, z.ZodObject<{
+        columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+            type: z.ZodEnum<{
+                number: "number";
+                boolean: "boolean";
+                text: "text";
+                json: "json";
+                timestamp: "timestamp";
+                integer: "integer";
+                uuid: "uuid";
+            }>;
+            nullable: z.ZodOptional<z.ZodBoolean>;
+            unique: z.ZodOptional<z.ZodBoolean>;
+            references: z.ZodOptional<z.ZodObject<{
+                table: z.ZodString;
+                column: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        indexes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            columns: z.ZodArray<z.ZodString>;
+            unique: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DataSchemaDefinition = z.infer<typeof DataSchema>;
+export type DataTable = z.infer<typeof DataTableSchema>;
+export declare const CreateDataSchema: z.ZodObject<{
+    name: z.ZodString;
+    schema: z.ZodObject<{
+        tables: z.ZodRecord<z.ZodString, z.ZodObject<{
+            columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    number: "number";
+                    boolean: "boolean";
+                    text: "text";
+                    json: "json";
+                    timestamp: "timestamp";
+                    integer: "integer";
+                    uuid: "uuid";
+                }>;
+                nullable: z.ZodOptional<z.ZodBoolean>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+                references: z.ZodOptional<z.ZodObject<{
+                    table: z.ZodString;
+                    column: z.ZodString;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            indexes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                columns: z.ZodArray<z.ZodString>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const MigrateDataSchema: z.ZodObject<{
+    expectedVersion: z.ZodNumber;
+    schema: z.ZodObject<{
+        tables: z.ZodRecord<z.ZodString, z.ZodObject<{
+            columns: z.ZodRecord<z.ZodString, z.ZodObject<{
+                type: z.ZodEnum<{
+                    number: "number";
+                    boolean: "boolean";
+                    text: "text";
+                    json: "json";
+                    timestamp: "timestamp";
+                    integer: "integer";
+                    uuid: "uuid";
+                }>;
+                nullable: z.ZodOptional<z.ZodBoolean>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+                references: z.ZodOptional<z.ZodObject<{
+                    table: z.ZodString;
+                    column: z.ZodString;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            indexes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                columns: z.ZodArray<z.ZodString>;
+                unique: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const RenameDataSchema: z.ZodObject<{
+    expectedVersion: z.ZodNumber;
+    name: z.ZodString;
+}, z.core.$strict>;
+export type CreateDataInput = z.infer<typeof CreateDataSchema>;
+export type DataMigration = z.infer<typeof MigrateDataSchema>;
+export type DataRename = z.infer<typeof RenameDataSchema>;
+export interface DataResource {
+    id: string;
+    name: string;
+    schema: DataSchemaDefinition;
+    schemaVersion: number;
+    createdAt: string;
+}
+export type DataValue = null | string | number | boolean | DataValue[] | {
+    [key: string]: DataValue;
+};
+export type DataRow = Record<string, DataValue> & {
+    _id: string;
+    _version: number;
+    _created_at: string;
+    _updated_at: string;
+};
+/** Canonical recursive JSON values, also named by API schema generators. */
+export declare const DataValueSchema: z.ZodJSONSchema;
+export declare const DataFilterSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    eq: z.ZodOptional<z.ZodJSONSchema>;
+    ne: z.ZodOptional<z.ZodJSONSchema>;
+    gt: z.ZodOptional<z.ZodJSONSchema>;
+    gte: z.ZodOptional<z.ZodJSONSchema>;
+    lt: z.ZodOptional<z.ZodJSONSchema>;
+    lte: z.ZodOptional<z.ZodJSONSchema>;
+    in: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+    isNull: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>>;
+export declare const DataOperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    op: z.ZodLiteral<"list">;
+    table: z.ZodString;
+    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        eq: z.ZodOptional<z.ZodJSONSchema>;
+        ne: z.ZodOptional<z.ZodJSONSchema>;
+        gt: z.ZodOptional<z.ZodJSONSchema>;
+        gte: z.ZodOptional<z.ZodJSONSchema>;
+        lt: z.ZodOptional<z.ZodJSONSchema>;
+        lte: z.ZodOptional<z.ZodJSONSchema>;
+        in: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+        isNull: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        column: z.ZodString;
+        direction: z.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>;
+    }, z.core.$strict>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"insert">;
+    table: z.ZodString;
+    values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"upsert">;
+    table: z.ZodString;
+    values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    onConflict: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"update">;
+    table: z.ZodString;
+    id: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+}, z.core.$strict>, z.ZodObject<{
+    op: z.ZodLiteral<"delete">;
+    table: z.ZodString;
+    id: z.ZodString;
+    expectedVersion: z.ZodNumber;
+}, z.core.$strict>], "op">;
+export declare const DataBatchSchema: z.ZodObject<{
+    operations: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        op: z.ZodLiteral<"list">;
+        table: z.ZodString;
+        filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            eq: z.ZodOptional<z.ZodJSONSchema>;
+            ne: z.ZodOptional<z.ZodJSONSchema>;
+            gt: z.ZodOptional<z.ZodJSONSchema>;
+            gte: z.ZodOptional<z.ZodJSONSchema>;
+            lt: z.ZodOptional<z.ZodJSONSchema>;
+            lte: z.ZodOptional<z.ZodJSONSchema>;
+            in: z.ZodOptional<z.ZodArray<z.ZodJSONSchema>>;
+            isNull: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
+        orderBy: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            direction: z.ZodEnum<{
+                asc: "asc";
+                desc: "desc";
+            }>;
+        }, z.core.$strict>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"insert">;
+        table: z.ZodString;
+        values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"upsert">;
+        table: z.ZodString;
+        values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        onConflict: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"update">;
+        table: z.ZodString;
+        id: z.ZodString;
+        expectedVersion: z.ZodNumber;
+        values: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strict>, z.ZodObject<{
+        op: z.ZodLiteral<"delete">;
+        table: z.ZodString;
+        id: z.ZodString;
+        expectedVersion: z.ZodNumber;
+    }, z.core.$strict>], "op">>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DataOperation = z.infer<typeof DataOperationSchema>;
+export type DataBatch = z.infer<typeof DataBatchSchema>;
+export type DataListQuery = Omit<Extract<DataOperation, {
+    op: "list";
+}>, "op" | "table">;
+export type DataResult = {
+    rows: DataRow[];
+    total?: number;
+    nextOffset?: number | null;
+};
+export declare const DataQuerySchema: z.ZodObject<{
+    sql: z.ZodString;
+    params: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    mode: z.ZodOptional<z.ZodEnum<{
+        read: "read";
+        write: "write";
+    }>>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type DataQuery = z.infer<typeof DataQuerySchema>;
+export type DataQueryResult = {
+    rows: Record<string, DataValue>[];
+    rowCount: number;
+    truncated: boolean;
+};
+export declare const DataSqlMigrationSchema: z.ZodObject<{
+    id: z.ZodString;
+    expectedVersion: z.ZodNumber;
+    statements: z.ZodArray<z.ZodObject<{
+        sql: z.ZodString;
+        params: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
+    }, z.core.$strict>>;
+    allowDestructive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type DataSqlMigration = z.infer<typeof DataSqlMigrationSchema>;
+export type DataMigrationRecord = {
+    id: string;
+    checksum: string;
+    schemaVersion: number;
+    appliedAt: string;
+};
+/** Host-computed permissions; never accept these from query arguments. */
+export type DataQueryAccess = {
+    readTables: string[];
+    writeTables: string[];
+};
+export declare const DataGrantSchema: z.ZodObject<{
+    resource: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"*">]>;
+    tables: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    actions: z.ZodArray<z.ZodEnum<{
+        read: "read";
+        write: "write";
+        manage: "manage";
+    }>>;
+}, z.core.$strict>;
+export type DataGrant = z.infer<typeof DataGrantSchema>;
+export interface DataAccess {
+    scope: string;
+    principalId: string;
+    grants: readonly DataGrant[];
+}
+export interface DataCapabilities {
+    transactions: boolean;
+    relations: boolean;
+    schemaEvolution: "additive";
+    sql?: {
+        dialect: "postgresql";
+        migrations: boolean;
+    };
+}
+export interface DataProvider {
+    readonly capabilities: DataCapabilities;
+    list(scope: string): Promise<DataResource[]>;
+    get(scope: string, reference: string): Promise<DataResource | undefined>;
+    create(scope: string, input: CreateDataInput): Promise<DataResource>;
+    migrate(scope: string, id: string, input: DataMigration): Promise<DataResource>;
+    rename(scope: string, id: string, input: DataRename): Promise<DataResource>;
+    remove(scope: string, id: string, expectedVersion: number): Promise<void>;
+    execute(scope: string, id: string, principalId: string, batch: DataBatch): Promise<DataResult[]>;
+    query?(scope: string, id: string, principalId: string, input: DataQuery, access: DataQueryAccess): Promise<DataQueryResult>;
+    migrateSql?(scope: string, id: string, input: DataSqlMigration): Promise<DataResource>;
+    migrations?(scope: string, id: string): Promise<DataMigrationRecord[]>;
+}
+/** Bound capability safe to pass to a custom tool; no credentials or mutable host context. */
+export interface DataClient {
+    list(): Promise<DataResource[]>;
+    describe(reference: string): Promise<DataResource>;
+    execute(reference: string, batch: DataBatch): Promise<DataResult[]>;
+    query?(reference: string, input: DataQuery): Promise<DataQueryResult>;
+}
+/** Re-resolve authorization on each call; expose no provider or host internals. */
+export declare function createDataCapability(resolve: () => DataClient | Promise<DataClient>): DataClient;
+export declare function parseData<T>(schema: z.ZodType<T>, input: unknown): T;
+export declare function dataColumn(table: DataTable, name: string): DataColumn;
+export declare function validateDataOperation(schema: DataSchemaDefinition, input: unknown): DataOperation;
+export declare function canonicalDataJson(value: unknown): string;
+export declare class DataService implements DataClient {
+    #private;
+    private readonly provider;
+    constructor(provider: DataProvider, access: DataAccess);
+    private allows;
+    private resolve;
+    private visible;
+    list(): Promise<DataResource[]>;
+    describe(reference: string): Promise<DataResource>;
+    create(input: CreateDataInput): Promise<DataResource>;
+    migrate(reference: string, input: DataMigration): Promise<DataResource>;
+    rename(reference: string, input: DataRename): Promise<DataResource>;
+    remove(reference: string, expectedVersion: number): Promise<void>;
+    execute(reference: string, input: DataBatch): Promise<DataResult[]>;
+    query(reference: string, input: DataQuery): Promise<DataQueryResult>;
+    migrateSql(reference: string, input: DataSqlMigration): Promise<DataResource>;
+    migrations(reference: string): Promise<DataMigrationRecord[]>;
+}
+/** Credential-bearing transport for a trusted host. Returned tools see only DataClient. */
+export declare function createRemoteDataClient(options: {
+    url: string;
+    token: string;
+    headers?: Record<string, string>;
+    fetch?: typeof fetch;
+}): DataClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

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