@tangle-network/agent-core 0.2.0

package/dist/types-DiDSGM8K.d.ts

@@ -0,0 +1,320 @@
+import { n as SDKError } from "./index-DiQX9bjq.js";
+import { z } from "zod";
+
+//#region src/auth/shared-providers.d.ts
+/** Auth provider interface */
+interface AuthProvider {
+  /** Get current token (called on each request) */
+  getToken(): Promise<string | null>;
+  /** Refresh expired token */
+  refreshToken?(): Promise<string>;
+  /** Called when token is rejected by server */
+  onTokenRejected?(error: SDKError): Promise<void>;
+}
+/** Simple static token auth */
+declare class StaticTokenAuth implements AuthProvider {
+  private token;
+  constructor(token: string);
+  getToken(): Promise<string>;
+  setToken(token: string): void;
+}
+/** Token with refresh capability */
+declare class RefreshableTokenAuth implements AuthProvider {
+  private config;
+  private accessToken;
+  private refreshTokenValue;
+  private expiresAt;
+  private refreshPromise;
+  constructor(config: {
+    accessToken: string;
+    refreshToken: string;
+    expiresIn: number;
+    onRefresh: (refreshToken: string) => Promise<{
+      accessToken: string;
+      refreshToken?: string;
+      expiresIn: number;
+    }>;
+    onRefreshFailed?: (error: Error) => void; /** Buffer before expiry to trigger refresh (default: 60s) */
+    refreshBuffer?: number;
+  });
+  getToken(): Promise<string>;
+  refreshToken(): Promise<string>;
+  private doRefresh;
+  onTokenRejected(error: SDKError): Promise<void>;
+  /** Check if token needs refresh */
+  isExpired(): boolean;
+}
+/** No auth (for public endpoints) */
+declare class NoAuth implements AuthProvider {
+  getToken(): Promise<null>;
+}
+/**
+ * Callback-based auth for dynamic token retrieval.
+ * Useful when token comes from external source (user session, secure storage).
+ */
+declare class CallbackAuth implements AuthProvider {
+  private getTokenFn;
+  constructor(getTokenFn: () => string | null | Promise<string | null>);
+  getToken(): Promise<string | null>;
+}
+/**
+ * Read token auth for WebSocket connections.
+ * Wraps a read token with refresh capability.
+ */
+declare class ReadTokenAuth implements AuthProvider {
+  private config;
+  private token;
+  private expiresAt;
+  private refreshPromise;
+  private expiryWarned;
+  constructor(config: {
+    token: string;
+    expiresAt: number;
+    onRefresh: () => Promise<{
+      token: string;
+      expiresAt: number;
+    }>;
+    onExpiring?: (secondsRemaining: number) => void;
+    onRefreshFailed?: (error: Error) => void; /** Buffer before expiry to trigger refresh (default: 60s) */
+    refreshBuffer?: number; /** Buffer before expiry to trigger warning (default: 60s) */
+    warningBuffer?: number;
+  });
+  getToken(): Promise<string>;
+  refreshToken(): Promise<string>;
+  private doRefresh;
+  /** Check if token is expired */
+  isExpired(): boolean;
+  /** Get seconds until expiry */
+  getSecondsRemaining(): number;
+}
+//#endregion
+//#region src/auth/types.d.ts
+/**
+ * Product configuration for multi-tenant orchestrator.
+ */
+declare const ProductSchema: z.ZodObject<{
+  product_id: z.ZodString;
+  name: z.ZodString;
+  api_key: z.ZodString;
+  secrets: z.ZodObject<{
+    current: z.ZodObject<{
+      secret: z.ZodString;
+      created_at: z.ZodNumber;
+    }, z.core.$strip>;
+    previous: z.ZodOptional<z.ZodObject<{
+      secret: z.ZodString;
+      created_at: z.ZodNumber;
+      expires_at: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  token_config: z.ZodObject<{
+    free_ttl_minutes: z.ZodDefault<z.ZodNumber>;
+    paid_ttl_minutes: z.ZodDefault<z.ZodNumber>;
+    max_ttl_minutes: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  rate_limits: z.ZodObject<{
+    max_concurrent_sessions: z.ZodDefault<z.ZodNumber>;
+    max_sessions_per_minute: z.ZodDefault<z.ZodNumber>;
+    max_requests_per_minute: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  unlimited: z.ZodDefault<z.ZodBoolean>;
+  internal_notes: z.ZodOptional<z.ZodString>;
+  webhook_url: z.ZodOptional<z.ZodString>;
+  status: z.ZodDefault<z.ZodEnum<{
+    active: "active";
+    suspended: "suspended";
+    deleted: "deleted";
+  }>>;
+  deployment_type: z.ZodDefault<z.ZodEnum<{
+    shared: "shared";
+    "customer-hosted": "customer-hosted";
+  }>>;
+  customer_orchestrator: z.ZodOptional<z.ZodObject<{
+    url: z.ZodString;
+    api_key: z.ZodString;
+  }, z.core.$strip>>;
+  created_at: z.ZodString;
+  updated_at: z.ZodString;
+}, z.core.$strip>;
+type Product = z.infer<typeof ProductSchema>;
+/**
+ * Token scope types for multi-tenant access control.
+ *
+ * - "session": Access to a single session (requires sid)
+ * - "project": Access to all sessions within a project (requires projectId)
+ * - "batch": Access to multiple projects (requires projectIds array)
+ */
+type TokenScope = "session" | "project" | "batch";
+/**
+ * Session-scoped token payload.
+ * Grants access to a single session's events.
+ */
+declare const SessionScopedTokenPayloadSchema: z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodString;
+  projectId: z.ZodOptional<z.ZodUndefined>;
+  projectIds: z.ZodOptional<z.ZodUndefined>;
+}, z.core.$strip>;
+/**
+ * Project-scoped token payload.
+ * Grants access to all sessions within a single project.
+ */
+declare const ProjectScopedTokenPayloadSchema: z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodOptional<z.ZodUndefined>;
+  projectId: z.ZodString;
+  projectIds: z.ZodOptional<z.ZodUndefined>;
+}, z.core.$strip>;
+/**
+ * Batch-scoped token payload.
+ * Grants access to multiple projects (organization-level access).
+ */
+declare const BatchScopedTokenPayloadSchema: z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodOptional<z.ZodUndefined>;
+  projectId: z.ZodOptional<z.ZodUndefined>;
+  projectIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Read token payload (JWT claims for WebSocket auth).
+ *
+ * Supports three scopes:
+ * - Session: sid present (single session)
+ * - Project: projectId present (all sessions in project)
+ * - Batch: projectIds present (multiple projects)
+ *
+ * For backwards compatibility, tokens with sid are session-scoped.
+ */
+declare const ReadTokenPayloadSchema: z.ZodUnion<readonly [z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodString;
+  projectId: z.ZodOptional<z.ZodUndefined>;
+  projectIds: z.ZodOptional<z.ZodUndefined>;
+}, z.core.$strip>, z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodOptional<z.ZodUndefined>;
+  projectId: z.ZodString;
+  projectIds: z.ZodOptional<z.ZodUndefined>;
+}, z.core.$strip>, z.ZodObject<{
+  sub: z.ZodString;
+  pid: z.ZodString;
+  cid: z.ZodOptional<z.ZodString>;
+  typ: z.ZodLiteral<"read">;
+  iat: z.ZodNumber;
+  exp: z.ZodNumber;
+  sid: z.ZodOptional<z.ZodUndefined>;
+  projectId: z.ZodOptional<z.ZodUndefined>;
+  projectIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>]>;
+type ReadTokenPayload = z.infer<typeof ReadTokenPayloadSchema>;
+type SessionScopedTokenPayload = z.infer<typeof SessionScopedTokenPayloadSchema>;
+type ProjectScopedTokenPayload = z.infer<typeof ProjectScopedTokenPayloadSchema>;
+type BatchScopedTokenPayload = z.infer<typeof BatchScopedTokenPayloadSchema>;
+/**
+ * Token validation result.
+ */
+interface TokenValidationResult {
+  valid: boolean;
+  payload?: ReadTokenPayload;
+  /** Token scope (session, project, or batch) */
+  scope?: TokenScope;
+  error?: string;
+  errorCode?: "TOKEN_MISSING" | "TOKEN_INVALID" | "TOKEN_EXPIRED" | "TOKEN_WRONG_TYPE" | "PRODUCT_NOT_FOUND" | "PRODUCT_SUSPENDED" | "SIGNATURE_INVALID";
+}
+/**
+ * Product secrets structure.
+ */
+interface ProductSecrets {
+  current: {
+    secret: string;
+    created_at: number;
+  };
+  previous?: {
+    secret: string;
+    created_at: number;
+    expires_at: number;
+  };
+}
+/**
+ * Minimal product info for token validation (avoids full product lookup).
+ */
+interface ProductAuthInfo {
+  product_id: string;
+  secrets: ProductSecrets;
+  status: "active" | "suspended" | "deleted";
+}
+/**
+ * Session creation request from product backend.
+ */
+declare const CreateSessionRequestSchema: z.ZodObject<{
+  user_id: z.ZodString;
+  project_ref: z.ZodOptional<z.ZodString>;
+  tier: z.ZodDefault<z.ZodUnion<[z.ZodEnum<{
+    free: "free";
+    pro: "pro";
+    enterprise: "enterprise";
+  }>, z.ZodPipe<z.ZodLiteral<"paid">, z.ZodTransform<"pro", "paid">>]>>;
+  config: z.ZodOptional<z.ZodObject<{
+    image: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    resources: z.ZodOptional<z.ZodObject<{
+      cpu: z.ZodOptional<z.ZodNumber>;
+      memory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CreateSessionRequest = z.infer<typeof CreateSessionRequestSchema>;
+/**
+ * Session creation response to product backend.
+ */
+interface CreateSessionResponse {
+  session_id: string;
+  sidecar_id: string;
+  websocket_url: string;
+}
+/**
+ * Message send request from product backend.
+ *
+ * `metadata` is intentionally free-form (.passthrough): the wire format
+ * accepts arbitrary product-specific keys without requiring a schema bump.
+ * Only `model` is named today; legacy gateway-credential fields previously
+ * declared here were never read internally and have been dropped — any
+ * such fields sent by older callers continue to flow through .passthrough.
+ */
+declare const SendMessageRequestSchema: z.ZodObject<{
+  content: z.ZodString;
+  user_id: z.ZodString;
+  execution_id: z.ZodOptional<z.ZodString>;
+  metadata: z.ZodOptional<z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>>;
+}, z.core.$strip>;
+type SendMessageRequest = z.infer<typeof SendMessageRequestSchema>;
+//#endregion
+export { ReadTokenAuth as C, NoAuth as S, StaticTokenAuth as T, SessionScopedTokenPayloadSchema as _, CreateSessionResponse as a, AuthProvider as b, ProductSchema as c, ProjectScopedTokenPayloadSchema as d, ReadTokenPayload as f, SessionScopedTokenPayload as g, SendMessageRequestSchema as h, CreateSessionRequestSchema as i, ProductSecrets as l, SendMessageRequest as m, BatchScopedTokenPayloadSchema as n, Product as o, ReadTokenPayloadSchema as p, CreateSessionRequest as r, ProductAuthInfo as s, BatchScopedTokenPayload as t, ProjectScopedTokenPayload as u, TokenScope as v, RefreshableTokenAuth as w, CallbackAuth as x, TokenValidationResult as y };
+//# sourceMappingURL=types-DiDSGM8K.d.ts.map

package/dist/types-DiDSGM8K.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DiDSGM8K.d.ts","names":[],"sources":["../src/auth/shared-providers.ts","../src/auth/types.ts"],"mappings":"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"}

package/package.json

@@ -0,0 +1,132 @@
+{
+  "name": "@tangle-network/agent-core",
+  "version": "0.2.0",
+  "description": "Core transport interfaces, event utilities, auth, SSE parsing, and resilience primitives for talking to Tangle agents",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./transport": {
+      "import": "./dist/transport/index.js",
+      "types": "./dist/transport/index.d.ts",
+      "default": "./dist/transport/index.js"
+    },
+    "./events": {
+      "import": "./dist/events/index.js",
+      "types": "./dist/events/index.d.ts",
+      "default": "./dist/events/index.js"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts",
+      "default": "./dist/types/index.js"
+    },
+    "./sse": {
+      "import": "./dist/sse/index.js",
+      "types": "./dist/sse/index.d.ts",
+      "default": "./dist/sse/index.js"
+    },
+    "./auth": {
+      "import": "./dist/auth/index.js",
+      "types": "./dist/auth/index.d.ts",
+      "default": "./dist/auth/index.js"
+    },
+    "./auth/browser": {
+      "import": "./dist/auth/browser.js",
+      "types": "./dist/auth/browser.d.ts",
+      "default": "./dist/auth/browser.js"
+    },
+    "./resilience": {
+      "import": "./dist/resilience/index.js",
+      "types": "./dist/resilience/index.d.ts",
+      "default": "./dist/resilience/index.js"
+    },
+    "./computer-use": {
+      "import": "./dist/computer-use/index.js",
+      "types": "./dist/computer-use/index.d.ts",
+      "default": "./dist/computer-use/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "auth": [
+        "src/auth/index.ts"
+      ],
+      "auth/*": [
+        "src/auth/*"
+      ],
+      "auth/browser": [
+        "src/auth/browser.ts"
+      ],
+      "events": [
+        "src/events/index.ts"
+      ],
+      "events/*": [
+        "src/events/*"
+      ],
+      "resilience": [
+        "src/resilience/index.ts"
+      ],
+      "resilience/*": [
+        "src/resilience/*"
+      ],
+      "computer-use": [
+        "src/computer-use/index.ts"
+      ],
+      "computer-use/*": [
+        "src/computer-use/*"
+      ],
+      "transport": [
+        "src/transport/index.ts"
+      ],
+      "transport/*": [
+        "src/transport/*"
+      ],
+      "types": [
+        "src/types/index.ts"
+      ],
+      "types/*": [
+        "src/types/*"
+      ],
+      "*": [
+        "src/index.ts"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tangle-network/agent-sdk.git",
+    "directory": "packages/agent-core"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "zod": "4.4.3",
+    "@tangle-network/agent-interface": "0.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.6.0",
+    "tsdown": "0.21.10",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}