@blacklake-systems/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BlackLake Systems Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# @blacklake-systems/sdk
+
+TypeScript SDK for the [BlackLake Control Plane](https://blacklake.systems/product) — agent governance infrastructure.
+
+## Install
+
+```bash
+npm install @blacklake-systems/sdk
+```
+
+## Quick Start
+
+```typescript
+import { BlackLake } from '@blacklake-systems/sdk';
+
+const bl = new BlackLake({
+  apiKey: process.env.BLACKLAKE_API_KEY!,
+  baseUrl: 'https://api.blacklake.systems',
+});
+
+// Evaluate governance before executing a tool call
+const result = await bl.govern({
+  agent: 'expense-bot',
+  tool: 'payments.send',
+  action: { amount: 4200, vendor: 'Acme Corp' },
+});
+
+if (result.decision === 'allow') {
+  // proceed with tool call
+}
+```
+
+## API Reference
+
+### `new BlackLake(config)`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | — | Your BlackLake API key (required) |
+| `baseUrl` | `string` | `http://localhost:3100` | API base URL |
+
+### `bl.govern(request)`
+
+Evaluate whether an agent is allowed to invoke a tool.
+
+```typescript
+const result = await bl.govern({
+  agent: 'expense-bot',       // agent name
+  tool: 'payments.send',      // tool name
+  action: { amount: 4200 },   // optional: tool invocation payload
+  context: { ip: '10.0.0.1' } // optional: request metadata
+});
+
+// result.decision: 'allow' | 'deny' | 'approval_required'
+// result.evaluation_id: string
+// result.policy_id: string | null
+// result.reason: string
+// result.evaluated_at: string (ISO 8601)
+```
+
+### `bl.agents`
+
+```typescript
+await bl.agents.create({ name, environment, risk_classification, description?, approval_mode? });
+await bl.agents.list({ environment?, status? });
+await bl.agents.get(id);
+await bl.agents.update(id, { name?, environment?, risk_classification?, status?, approval_mode? });
+await bl.agents.suspend(id);
+await bl.agents.activate(id);
+await bl.agents.bindTool(agentId, toolId);
+await bl.agents.listTools(agentId);
+await bl.agents.unbindTool(agentId, toolId);
+```
+
+### `bl.tools`
+
+```typescript
+await bl.tools.create({ name, risk_classification, description? });
+await bl.tools.list();
+await bl.tools.get(id);
+```
+
+### `bl.policies`
+
+```typescript
+await bl.policies.create({ name, priority, outcome, agent_selector?, tool_selector?, enabled? });
+await bl.policies.list();
+await bl.policies.get(id);
+await bl.policies.update(id, { name?, priority?, outcome?, agent_selector?, tool_selector?, enabled? });
+await bl.policies.delete(id);
+```
+
+### `bl.evaluations`
+
+```typescript
+await bl.evaluations.list({ agent_id?, tool_id?, outcome?, limit?, offset? });
+await bl.evaluations.get(id);
+```
+
+### Error Handling
+
+```typescript
+import { BlackLake, BlackLakeError } from '@blacklake-systems/sdk';
+
+try {
+  await bl.govern({ agent: 'unknown', tool: 'unknown' });
+} catch (err) {
+  if (err instanceof BlackLakeError) {
+    console.error(err.status, err.code, err.message);
+  }
+}
+```
+
+## Documentation
+
+Full documentation at [blacklake.systems/product](https://blacklake.systems/product).

package/dist/index.d.ts

@@ -0,0 +1,173 @@
+export interface Organisation {
+    id: string;
+    name: string;
+    contact_email: string | null;
+    created_at: string;
+}
+export interface Agent {
+    id: string;
+    organisation_id: string;
+    name: string;
+    description: string | null;
+    environment: 'development' | 'staging' | 'production';
+    risk_classification: 'low' | 'medium' | 'high' | 'critical';
+    status: 'active' | 'suspended' | 'disabled';
+    approval_mode: 'auto_approve' | 'require_approval' | 'block';
+    created_at: string;
+    updated_at: string;
+}
+export interface Tool {
+    id: string;
+    organisation_id: string;
+    name: string;
+    description: string | null;
+    risk_classification: 'low' | 'medium' | 'high' | 'critical';
+    created_at: string;
+}
+export interface Policy {
+    id: string;
+    organisation_id: string;
+    name: string;
+    priority: number;
+    agent_selector: Record<string, unknown>;
+    tool_selector: Record<string, unknown>;
+    outcome: 'allow' | 'deny' | 'approval_required';
+    enabled: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface GovernRequest {
+    agent: string;
+    tool: string;
+    action?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+}
+export interface GovernResponse {
+    decision: 'allow' | 'deny' | 'approval_required';
+    evaluation_id: string;
+    policy_id: string | null;
+    reason: string;
+    evaluated_at: string;
+}
+export interface Evaluation {
+    id: string;
+    organisation_id: string;
+    agent_id: string;
+    tool_id: string;
+    policy_id: string | null;
+    action_payload: Record<string, unknown> | null;
+    outcome: 'allow' | 'deny' | 'approval_required' | 'default_deny';
+    evaluated_at: string;
+    request_context: Record<string, unknown> | null;
+}
+export interface PaginatedResponse<T> {
+    data: T[];
+    total: number;
+}
+export declare class BlackLakeError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface BlackLakeConfig {
+    apiKey: string;
+    baseUrl?: string;
+}
+declare class AgentsResource {
+    private client;
+    constructor(client: BlackLakeClient);
+    create(data: {
+        name: string;
+        description?: string;
+        environment: Agent['environment'];
+        risk_classification: Agent['risk_classification'];
+        approval_mode?: Agent['approval_mode'];
+    }): Promise<Agent>;
+    list(params?: {
+        environment?: string;
+        status?: string;
+    }): Promise<Agent[]>;
+    get(id: string): Promise<Agent>;
+    update(id: string, data: Partial<Pick<Agent, 'name' | 'description' | 'environment' | 'risk_classification' | 'status' | 'approval_mode'>>): Promise<Agent>;
+    suspend(id: string): Promise<Agent>;
+    activate(id: string): Promise<Agent>;
+    bindTool(agentId: string, toolId: string): Promise<{
+        id: string;
+        agent_id: string;
+        tool_id: string;
+        created_at: string;
+    }>;
+    listTools(agentId: string): Promise<Tool[]>;
+    unbindTool(agentId: string, toolId: string): Promise<void>;
+}
+declare class ToolsResource {
+    private client;
+    constructor(client: BlackLakeClient);
+    create(data: {
+        name: string;
+        description?: string;
+        risk_classification: Tool['risk_classification'];
+    }): Promise<Tool>;
+    list(): Promise<Tool[]>;
+    get(id: string): Promise<Tool>;
+}
+declare class PoliciesResource {
+    private client;
+    constructor(client: BlackLakeClient);
+    create(data: {
+        name: string;
+        priority: number;
+        agent_selector?: Record<string, unknown>;
+        tool_selector?: Record<string, unknown>;
+        outcome: Policy['outcome'];
+        enabled?: boolean;
+    }): Promise<Policy>;
+    list(): Promise<Policy[]>;
+    get(id: string): Promise<Policy>;
+    update(id: string, data: Partial<Pick<Policy, 'name' | 'priority' | 'agent_selector' | 'tool_selector' | 'outcome' | 'enabled'>>): Promise<Policy>;
+    delete(id: string): Promise<void>;
+}
+declare class EvaluationsResource {
+    private client;
+    constructor(client: BlackLakeClient);
+    list(params?: {
+        agent_id?: string;
+        tool_id?: string;
+        outcome?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<PaginatedResponse<Evaluation>>;
+    get(id: string): Promise<Evaluation>;
+}
+declare class OrganisationResource {
+    private client;
+    constructor(client: BlackLakeClient);
+    /** Fetch the current organisation (derived from the API key). */
+    get(): Promise<Organisation>;
+    /**
+     * Permanently delete the organisation and all associated data.
+     *
+     * This deletes agents, tools, policies, bindings, the audit log, and all API keys.
+     * The deletion is irreversible. The caller must pass the organisation's exact
+     * name as `confirmation` — any other value will be rejected.
+     */
+    delete(confirmation: string): Promise<void>;
+}
+declare class BlackLakeClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: BlackLakeConfig);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+}
+export declare class BlackLake {
+    private client;
+    readonly agents: AgentsResource;
+    readonly tools: ToolsResource;
+    readonly policies: PoliciesResource;
+    readonly evaluations: EvaluationsResource;
+    readonly organisation: OrganisationResource;
+    constructor(config: BlackLakeConfig);
+    govern(request: GovernRequest): Promise<GovernResponse>;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,aAAa,EAAE,cAAc,GAAG,kBAAkB,GAAG,OAAO,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,mBAAmB,CAAC;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,mBAAmB,GAAG,cAAc,CAAC;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAGD,qBAAa,cAAe,SAAQ,KAAK;aAErB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAGD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,cAAM,cAAc;IACN,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAClC,mBAAmB,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAClD,aAAa,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;KACxC,GAAG,OAAO,CAAC,KAAK,CAAC;IAIZ,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAQ1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAI/B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,qBAAqB,GAAG,QAAQ,GAAG,eAAe,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAI3J,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAInC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAI3C,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE;AAED,cAAM,aAAa;IACL,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrH,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAIvB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrC;AAED,cAAM,gBAAgB;IACR,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,MAAM,CAAC,IAAI,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIb,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,eAAe,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlJ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC;AAED,cAAM,mBAAmB;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAErC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAWjJ,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAG3C;AAED,cAAM,oBAAoB;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAE3C,iEAAiE;IAC3D,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;IAIlC;;;;;;OAMG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD;AAGD,cAAM,eAAe;IACnB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,eAAe;IAK7B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;CAgC3E;AAGD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,SAAgB,MAAM,EAAE,cAAc,CAAC;IACvC,SAAgB,KAAK,EAAE,aAAa,CAAC;IACrC,SAAgB,QAAQ,EAAE,gBAAgB,CAAC;IAC3C,SAAgB,WAAW,EAAE,mBAAmB,CAAC;IACjD,SAAgB,YAAY,EAAE,oBAAoB,CAAC;gBAEvC,MAAM,EAAE,eAAe;IAS7B,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAG9D"}

package/dist/index.js

@@ -0,0 +1,183 @@
+// Error types
+export class BlackLakeError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'BlackLakeError';
+    }
+}
+// Resource classes for namespaced methods
+class AgentsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(data) {
+        return this.client.request('POST', '/v1/agents', data);
+    }
+    async list(params) {
+        const query = new URLSearchParams();
+        if (params?.environment)
+            query.set('environment', params.environment);
+        if (params?.status)
+            query.set('status', params.status);
+        const qs = query.toString();
+        return this.client.request('GET', `/v1/agents${qs ? `?${qs}` : ''}`);
+    }
+    async get(id) {
+        return this.client.request('GET', `/v1/agents/${id}`);
+    }
+    async update(id, data) {
+        return this.client.request('PATCH', `/v1/agents/${id}`, data);
+    }
+    async suspend(id) {
+        return this.client.request('POST', `/v1/agents/${id}/suspend`);
+    }
+    async activate(id) {
+        return this.client.request('POST', `/v1/agents/${id}/activate`);
+    }
+    async bindTool(agentId, toolId) {
+        return this.client.request('POST', `/v1/agents/${agentId}/tools`, { tool_id: toolId });
+    }
+    async listTools(agentId) {
+        return this.client.request('GET', `/v1/agents/${agentId}/tools`);
+    }
+    async unbindTool(agentId, toolId) {
+        await this.client.request('DELETE', `/v1/agents/${agentId}/tools/${toolId}`);
+    }
+}
+class ToolsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(data) {
+        return this.client.request('POST', '/v1/tools', data);
+    }
+    async list() {
+        return this.client.request('GET', '/v1/tools');
+    }
+    async get(id) {
+        return this.client.request('GET', `/v1/tools/${id}`);
+    }
+}
+class PoliciesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(data) {
+        return this.client.request('POST', '/v1/policies', data);
+    }
+    async list() {
+        return this.client.request('GET', '/v1/policies');
+    }
+    async get(id) {
+        return this.client.request('GET', `/v1/policies/${id}`);
+    }
+    async update(id, data) {
+        return this.client.request('PATCH', `/v1/policies/${id}`, data);
+    }
+    async delete(id) {
+        await this.client.request('DELETE', `/v1/policies/${id}`);
+    }
+}
+class EvaluationsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(params) {
+        const query = new URLSearchParams();
+        if (params?.agent_id)
+            query.set('agent_id', params.agent_id);
+        if (params?.tool_id)
+            query.set('tool_id', params.tool_id);
+        if (params?.outcome)
+            query.set('outcome', params.outcome);
+        if (params?.limit)
+            query.set('limit', String(params.limit));
+        if (params?.offset)
+            query.set('offset', String(params.offset));
+        const qs = query.toString();
+        return this.client.request('GET', `/v1/evaluations${qs ? `?${qs}` : ''}`);
+    }
+    async get(id) {
+        return this.client.request('GET', `/v1/evaluations/${id}`);
+    }
+}
+class OrganisationResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Fetch the current organisation (derived from the API key). */
+    async get() {
+        return this.client.request('GET', '/v1/organisation');
+    }
+    /**
+     * Permanently delete the organisation and all associated data.
+     *
+     * This deletes agents, tools, policies, bindings, the audit log, and all API keys.
+     * The deletion is irreversible. The caller must pass the organisation's exact
+     * name as `confirmation` — any other value will be rejected.
+     */
+    async delete(confirmation) {
+        await this.client.request('POST', '/v1/organisation/delete', { confirmation });
+    }
+}
+// Internal HTTP client
+class BlackLakeClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? 'http://localhost:3100').replace(/\/$/, '');
+    }
+    async request(method, path, body) {
+        const headers = {
+            'x-api-key': this.apiKey,
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (response.status === 204) {
+            return undefined;
+        }
+        const data = await response.json();
+        if (!response.ok) {
+            const error = data['error'];
+            throw new BlackLakeError(response.status, error?.code ?? 'UNKNOWN_ERROR', error?.message ?? 'An unknown error occurred');
+        }
+        return data;
+    }
+}
+// Main SDK class
+export class BlackLake {
+    client;
+    agents;
+    tools;
+    policies;
+    evaluations;
+    organisation;
+    constructor(config) {
+        this.client = new BlackLakeClient(config);
+        this.agents = new AgentsResource(this.client);
+        this.tools = new ToolsResource(this.client);
+        this.policies = new PoliciesResource(this.client);
+        this.evaluations = new EvaluationsResource(this.client);
+        this.organisation = new OrganisationResource(this.client);
+    }
+    async govern(request) {
+        return this.client.request('POST', '/v1/govern', request);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@blacklake-systems/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the BlackLake Control Plane — agent governance infrastructure",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "license": "MIT",
+  "homepage": "https://blacklake.systems/product",
+  "bugs": {
+    "url": "https://blacklake.systems/support"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/blacklake-systems/control-plane",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "blacklake",
+    "agent",
+    "governance",
+    "control-plane",
+    "sdk"
+  ],
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}