@azmxailabs/agent-sdk 0.1.0

package/dist/providers/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Shared provider types — minimal, intentionally close to the union of
+ * OpenAI-shape and Anthropic-shape APIs so adapters can translate
+ * losslessly in both directions.
+ */
+export type Role = "system" | "user" | "assistant";
+export interface ChatMessage {
+    role: Role;
+    content: string;
+}
+export interface ChatRequest {
+    /** Logical model alias registered in the router (NOT the provider's model id). */
+    model: string;
+    messages: ChatMessage[];
+    /** Temperature 0..2. */
+    temperature?: number;
+    /** Max tokens to generate. */
+    maxTokens?: number;
+    /** Stop sequences. */
+    stop?: string[];
+    /** Provider-specific overrides; forwarded as-is. */
+    providerOptions?: Record<string, unknown>;
+    /** AbortSignal — adapter MUST honor it. */
+    signal?: AbortSignal;
+}
+export interface ChatResponse {
+    /** Concatenated text content. */
+    text: string;
+    /** Reason the provider stopped: "stop", "length", "abort", "error" etc. */
+    finishReason: string;
+    /** Usage if the provider reports it. */
+    usage?: TokenUsage;
+    /** The raw provider response, for callers that need it. */
+    raw?: unknown;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    /** Some providers (Anthropic) report cache hits — surface them. */
+    cacheReadTokens?: number;
+    cacheCreationTokens?: number;
+}
+export interface StreamChunk {
+    /** Incremental text — append in order. */
+    delta: string;
+    /** Set on the final chunk only. */
+    done?: boolean;
+    /** Usage on the final chunk if provider reports it. */
+    usage?: TokenUsage;
+    /** Finish reason on the final chunk. */
+    finishReason?: string;
+}
+/**
+ * Provider — implement this to add a new BYOK backend. The SDK doesn't
+ * inspect the body; it just calls .complete or .stream and surfaces
+ * whatever you return. Errors should throw with a clear message.
+ */
+export interface Provider {
+    /** Stable identifier for logs / errors. */
+    readonly name: string;
+    complete(req: ChatRequest): Promise<ChatResponse>;
+    stream(req: ChatRequest): AsyncIterable<StreamChunk>;
+}

package/dist/providers/types.js

@@ -0,0 +1,6 @@
+/**
+ * Shared provider types — minimal, intentionally close to the union of
+ * OpenAI-shape and Anthropic-shape APIs so adapters can translate
+ * losslessly in both directions.
+ */
+export {};

package/dist/security/deny-list.d.ts

@@ -0,0 +1,41 @@
+/**
+ * DenyList — refuses sensitive file paths by glob.
+ *
+ * Default list matches AZMX's desktop app defaults: .env, .ssh, common
+ * credential files, well-known token paths, and the SDK's own secrets.
+ * Extend with .add() / .addAll(); replace with .reset().
+ *
+ * Globs supported:
+ *   *       any chars except /
+ *   **      any chars including /
+ *   ?       single char except /
+ *   [abc]   character class
+ *
+ * Matches are case-sensitive on Linux/macOS and case-insensitive on Windows
+ * (caller passes `caseInsensitive: true` to the constructor).
+ */
+export declare const DEFAULT_DENY_LIST: readonly string[];
+export interface DenyListOptions {
+    caseInsensitive?: boolean;
+}
+export declare class DenyList {
+    private patterns;
+    private caseInsensitive;
+    private sources;
+    constructor(initial?: readonly string[], opts?: DenyListOptions);
+    add(glob: string): void;
+    addAll(globs: readonly string[]): void;
+    reset(globs?: readonly string[]): void;
+    /** true if the path matches any pattern. */
+    matches(path: string): boolean;
+    /** Returns every source glob that matched (debug / explainability). */
+    matching(path: string): string[];
+    /** Snapshot of the current rule set. */
+    list(): readonly string[];
+}
+import type { Policy } from "../approval/gate.js";
+/**
+ * Convenience: a Policy that denies any file:* or shell action that
+ * touches a deny-listed path. Plug into ApprovalGate.use().
+ */
+export declare function denyListPolicy(deny?: DenyList): Policy;

package/dist/security/index.d.ts

@@ -0,0 +1 @@
+export * from "./deny-list.js";

package/dist/security/index.js

@@ -0,0 +1 @@
+export * from "./deny-list.js";

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@azmxailabs/agent-sdk",
+  "version": "0.1.0",
+  "description": "Build approval-gated AI agents with the same primitives that power AZMX AI — BYOK provider router, approval gate, deny-list, hash-chained audit log. Secure by default, BYOK direct (no proxy), no telemetry.",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://azmx.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AzmxAI/azmx.git",
+    "directory": "packages/agent-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/AzmxAI/azmx/issues"
+  },
+  "keywords": [
+    "azmx",
+    "azmx-ai",
+    "azmxai",
+    "azmxailabs",
+    "agent",
+    "ai-agent",
+    "agent-sdk",
+    "approval-gate",
+    "byok",
+    "anthropic",
+    "openai",
+    "ollama",
+    "audit-log",
+    "deny-list",
+    "sovereign-ai",
+    "local-ai"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./approval": {
+      "types": "./dist/approval/index.d.ts",
+      "import": "./dist/approval/index.js"
+    },
+    "./security": {
+      "types": "./dist/security/index.d.ts",
+      "import": "./dist/security/index.js"
+    },
+    "./audit": {
+      "types": "./dist/audit/index.d.ts",
+      "import": "./dist/audit/index.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "import": "./dist/providers/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "clean": "rm -rf dist",
+    "test": "node --test dist/**/*.test.js",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^20.14.10",
+    "typescript": "^5.5.3"
+  }
+}