@hasna/connectors 1.3.0 → 1.3.2

package/dist/db/agents.d.ts

@@ -1,38 +0,0 @@
-import type { Database } from "bun:sqlite";
-export interface Agent {
-    id: string;
-    name: string;
-    session_id: string | null;
-    role: string;
-    last_seen_at: string;
-    created_at: string;
-}
-export interface AgentConflictError {
-    conflict: true;
-    existing_id: string;
-    existing_name: string;
-    last_seen_at: string;
-    session_hint: string | null;
-    working_dir: null;
-    message: string;
-}
-export interface RegisterAgentInput {
-    name: string;
-    session_id?: string | null;
-    role?: string;
-}
-export declare function isAgentConflict(result: Agent | AgentConflictError): result is AgentConflictError;
-/**
- * Register an agent. Conflict rules (matching ecosystem standard):
- *  - Name free → create
- *  - Name taken, same session_id → heartbeat, return agent
- *  - Name taken, different session_id, agent ACTIVE (<30min) → CONFLICT error
- *  - Name taken, different session_id, agent STALE (>30min) → takeover
- *  - Name taken, no session_id → heartbeat (backward compat)
- */
-export declare function registerAgent(input: RegisterAgentInput, db?: Database): Agent | AgentConflictError;
-export declare function getAgent(id: string, db?: Database): Agent | null;
-export declare function getAgentByName(name: string, db?: Database): Agent | null;
-export declare function listAgents(db?: Database): Agent[];
-export declare function updateAgentActivity(id: string, db?: Database): void;
-export declare function deleteAgent(id: string, db?: Database): boolean;

package/dist/db/agents.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/database.d.ts

@@ -1,7 +0,0 @@
-import { Database } from "bun:sqlite";
-export declare function getDatabase(path?: string): Database;
-export declare function closeDatabase(): void;
-/** ISO timestamp string */
-export declare function now(): string;
-/** 8-char UUID prefix */
-export declare function shortUuid(): string;

package/dist/db/jobs.d.ts

@@ -1,53 +0,0 @@
-import type { Database } from "bun:sqlite";
-export interface ConnectorJob {
-    id: string;
-    name: string;
-    connector: string;
-    command: string;
-    args: string[];
-    cron: string;
-    enabled: boolean;
-    strip: boolean;
-    created_at: string;
-    last_run_at: string | null;
-}
-export interface ConnectorJobRun {
-    id: string;
-    job_id: string;
-    started_at: string;
-    finished_at: string | null;
-    exit_code: number | null;
-    raw_output: string | null;
-    stripped_output: string | null;
-}
-export declare function createJob(input: {
-    name: string;
-    connector: string;
-    command: string;
-    args?: string[];
-    cron: string;
-    strip?: boolean;
-}, db?: Database): ConnectorJob;
-export declare function getJob(id: string, db?: Database): ConnectorJob | null;
-export declare function getJobByName(name: string, db?: Database): ConnectorJob | null;
-export declare function listJobs(db?: Database): ConnectorJob[];
-export declare function listEnabledJobs(db?: Database): ConnectorJob[];
-export declare function updateJob(id: string, input: Partial<{
-    name: string;
-    connector: string;
-    command: string;
-    args: string[];
-    cron: string;
-    enabled: boolean;
-    strip: boolean;
-}>, db?: Database): ConnectorJob;
-export declare function deleteJob(id: string, db?: Database): boolean;
-export declare function touchJobLastRun(id: string, db?: Database): void;
-export declare function createJobRun(jobId: string, db?: Database): ConnectorJobRun;
-export declare function finishJobRun(id: string, result: {
-    exit_code: number;
-    raw_output: string;
-    stripped_output?: string;
-}, db?: Database): void;
-export declare function getLatestRun(jobId: string, db?: Database): ConnectorJobRun | null;
-export declare function listJobRuns(jobId: string, limit?: number, db?: Database): ConnectorJobRun[];

package/dist/db/jobs.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/locks.d.ts

@@ -1,59 +0,0 @@
-/**
- * Resource lock helpers for open-connectors.
- *
- * Same interface as open-mementos src/db/locks.ts — standard pattern across
- * all @hasna apps. Resource types are scoped to what connectors manages:
- *   connector — the connector itself (install/uninstall ops)
- *   agent     — agent records
- *   profile   — connector auth profiles
- *   token     — OAuth token refresh operations
- */
-import type { Database } from "bun:sqlite";
-export type ResourceType = "connector" | "agent" | "profile" | "token";
-export type LockType = "advisory" | "exclusive";
-export interface ResourceLock {
-    id: string;
-    resource_type: ResourceType;
-    resource_id: string;
-    agent_id: string;
-    lock_type: LockType;
-    locked_at: string;
-    expires_at: string;
-}
-/**
- * Acquire a lock on a resource.
- * - advisory: multiple agents can hold advisory locks simultaneously
- * - exclusive: only one agent can hold an exclusive lock at a time
- *
- * Returns the lock if acquired, null if blocked by an existing exclusive lock.
- * TTL is in seconds (default: 5 minutes).
- */
-export declare function acquireLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, ttlSeconds?: number, db?: Database): ResourceLock | null;
-/**
- * Release a specific lock by ID. Only the owning agent can release it.
- */
-export declare function releaseLock(lockId: string, agentId: string, db?: Database): boolean;
-/**
- * Release all locks held by an agent on a specific resource.
- */
-export declare function releaseResourceLocks(agentId: string, resourceType: ResourceType, resourceId: string, db?: Database): number;
-/**
- * Release all locks held by an agent (e.g., on session end).
- */
-export declare function releaseAllAgentLocks(agentId: string, db?: Database): number;
-/**
- * Check if a resource is currently locked. Returns active lock(s) or empty array.
- */
-export declare function checkLock(resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock[];
-/**
- * Check if a specific agent holds a lock on a resource.
- */
-export declare function agentHoldsLock(agentId: string, resourceType: ResourceType, resourceId: string, lockType?: LockType, db?: Database): ResourceLock | null;
-/**
- * List all active locks for an agent.
- */
-export declare function listAgentLocks(agentId: string, db?: Database): ResourceLock[];
-/**
- * Delete all expired locks. Called automatically by other lock functions.
- */
-export declare function cleanExpiredLocks(db?: Database): number;

package/dist/db/locks.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/promotions.d.ts

@@ -1,5 +0,0 @@
-import type { Database } from "bun:sqlite";
-export declare function promoteConnector(name: string, db?: Database): void;
-export declare function demoteConnector(name: string, db?: Database): boolean;
-export declare function getPromotedConnectors(db?: Database): string[];
-export declare function isPromoted(name: string, db?: Database): boolean;

package/dist/db/promotions.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/rate.d.ts

@@ -1,57 +0,0 @@
-/**
- * Agent-aware rate budget splitting for connector operations.
- *
- * When multiple agents share a connector, the connector's rate limit is split
- * evenly among active agents (last heartbeat < 30min). Each agent gets:
- *   budget = Math.floor(connectorRateLimit / activeAgentCount)
- *
- * Rate usage is tracked per-agent-per-connector in the DB:
- *   connector_rate_usage(agent_id, connector, window_start, call_count)
- *
- * The window resets every WINDOW_SECONDS (default: 60s = per-minute rate).
- */
-import type { Database } from "bun:sqlite";
-export interface RateBudget {
-    connector: string;
-    agent_id: string;
-    limit: number;
-    active_agents: number;
-    budget: number;
-    used: number;
-    remaining: number;
-    window_start: string;
-    window_resets_in_ms: number;
-}
-export interface RateExceededError {
-    exceeded: true;
-    connector: string;
-    agent_id: string;
-    budget: number;
-    used: number;
-    active_agents: number;
-    window_resets_in_ms: number;
-    message: string;
-}
-export declare function isRateExceeded(result: RateBudget | RateExceededError): result is RateExceededError;
-/**
- * Ensure the rate_usage table exists (idempotent).
- */
-export declare function ensureRateTable(db: Database): void;
-/**
- * Check and optionally consume one rate budget unit for an agent+connector.
- *
- * @param agentId - Agent ID (from agents table)
- * @param connector - Connector name (e.g. "stripe")
- * @param connectorLimit - The connector's documented rate limit (calls/min)
- * @param consume - If true, increment the call counter. If false, just peek.
- * @param db - Optional DB instance (defaults to singleton)
- */
-export declare function checkRateBudget(agentId: string, connector: string, connectorLimit: number, consume?: boolean, db?: Database): RateBudget | RateExceededError;
-/**
- * Get rate budget status without consuming a unit.
- */
-export declare function getRateBudget(agentId: string, connector: string, connectorLimit: number, db?: Database): RateBudget | RateExceededError;
-/**
- * Clean up old rate windows (older than 2 windows).
- */
-export declare function cleanExpiredRateWindows(db?: Database): number;

package/dist/db/rate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/usage.d.ts

@@ -1,17 +0,0 @@
-import type { Database } from "bun:sqlite";
-export declare function logUsage(connector: string, action: string, agentId?: string, db?: Database): void;
-export interface UsageStats {
-    connector: string;
-    total: number;
-    last7d: number;
-    last24h: number;
-}
-export declare function getUsageStats(connector: string, db?: Database): UsageStats;
-export interface TopConnector {
-    connector: string;
-    count: number;
-}
-export declare function getTopConnectors(limit?: number, days?: number, db?: Database): TopConnector[];
-/** Get usage counts as a Map for search context */
-export declare function getUsageMap(days?: number, db?: Database): Map<string, number>;
-export declare function cleanOldUsage(days?: number, db?: Database): number;

package/dist/db/usage.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/db/workflows.d.ts

@@ -1,26 +0,0 @@
-import type { Database } from "bun:sqlite";
-export interface WorkflowStep {
-    connector: string;
-    command: string;
-    args?: string[];
-}
-export interface ConnectorWorkflow {
-    id: string;
-    name: string;
-    steps: WorkflowStep[];
-    enabled: boolean;
-    created_at: string;
-}
-export declare function createWorkflow(input: {
-    name: string;
-    steps: WorkflowStep[];
-}, db?: Database): ConnectorWorkflow;
-export declare function getWorkflow(id: string, db?: Database): ConnectorWorkflow | null;
-export declare function getWorkflowByName(name: string, db?: Database): ConnectorWorkflow | null;
-export declare function listWorkflows(db?: Database): ConnectorWorkflow[];
-export declare function updateWorkflow(id: string, input: Partial<{
-    name: string;
-    steps: WorkflowStep[];
-    enabled: boolean;
-}>, db?: Database): ConnectorWorkflow;
-export declare function deleteWorkflow(id: string, db?: Database): boolean;

package/dist/db/workflows.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/fuzzy.d.ts

@@ -1,16 +0,0 @@
-/**
- * Levenshtein distance for fuzzy connector search.
- * No dependencies — pure implementation.
- */
-/** Compute edit distance between two strings */
-export declare function levenshtein(a: string, b: string): number;
-/**
- * Check if token fuzzy-matches target within maxDistance.
- * Only applies to tokens >= 3 chars to avoid false positives.
- */
-export declare function fuzzyMatch(token: string, target: string, maxDistance?: number): boolean;
-/**
- * Find best fuzzy match score for a token against a list of candidates.
- * Returns 0 if no match within threshold.
- */
-export declare function bestFuzzyScore(token: string, candidates: string[], maxDistance?: number): number;

package/dist/lib/fuzzy.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/llm.d.ts

@@ -1,38 +0,0 @@
-/**
- * Provider-agnostic LLM client for open-connectors.
- *
- * Supports: cerebras, groq, openai, anthropic
- * Config stored at: ~/.connectors/llm.json
- *
- * Cerebras and Groq are OpenAI-compatible (same SDK, different base URLs).
- * Anthropic has its own API format.
- */
-export type LLMProvider = "cerebras" | "groq" | "openai" | "anthropic";
-export interface LLMConfig {
-    provider: LLMProvider;
-    model: string;
-    api_key: string;
-    strip: boolean;
-}
-export interface LLMResponse {
-    content: string;
-    provider: LLMProvider;
-    model: string;
-    latency_ms: number;
-}
-export declare const PROVIDER_DEFAULTS: Record<LLMProvider, {
-    model: string;
-}>;
-export declare function getLlmConfig(): LLMConfig | null;
-export declare function saveLlmConfig(config: LLMConfig): void;
-export declare function setLlmStrip(enabled: boolean): void;
-export declare function isStripEnabled(): boolean;
-/** Mask API key for display: show first 8 chars + *** */
-export declare function maskKey(key: string): string;
-export declare class LLMClient {
-    private config;
-    constructor(config: LLMConfig);
-    static fromConfig(): LLMClient | null;
-    complete(prompt: string, content: string): Promise<LLMResponse>;
-    private _anthropicComplete;
-}

package/dist/lib/llm.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/lock.d.ts

@@ -1,22 +0,0 @@
-/**
- * Advisory file-based write lock for per-connector operations.
- *
- * Prevents concurrent agents from racing on token refresh and config writes.
- * Reads remain unaffected — only write operations (saveApiKey, refreshOAuthToken,
- * switchProfile) acquire the lock.
- *
- * Strategy: atomic O_EXCL file creation as the lock primitive (works on all
- * platforms including macOS). Lock files live at:
- *   ~/.connectors/connect-{name}/.write.lock
- *
- * Callers that cannot acquire the lock within the timeout receive a LockTimeoutError.
- */
-export declare class LockTimeoutError extends Error {
-    readonly connector: string;
-    constructor(connector: string);
-}
-/**
- * Acquire a write lock for a connector, run the callback, then release.
- * Throws LockTimeoutError if the lock cannot be acquired within LOCK_TIMEOUT_MS.
- */
-export declare function withWriteLock<T>(connector: string, fn: () => T | Promise<T>): Promise<T>;

package/dist/lib/lock.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/scheduler.d.ts

@@ -1,20 +0,0 @@
-/**
- * Connector job scheduler.
- *
- * Checks enabled jobs against their cron expressions and runs them
- * when due. Runs in-process as part of `connectors serve`.
- *
- * Cron format: minute hour day month weekday (5-field standard)
- * Uses a lightweight cron matcher — no external dep needed.
- */
-import type { Database } from "bun:sqlite";
-import { type ConnectorJob } from "../db/jobs.js";
-/** Start the scheduler. Checks every 30s, fires jobs when cron matches. */
-export declare function startScheduler(db: Database): void;
-export declare function stopScheduler(): void;
-/** Manually trigger a job by ID (for CLI 'connectors jobs run') */
-export declare function triggerJob(job: ConnectorJob, db: Database): Promise<{
-    run_id: string;
-    exit_code: number;
-    output: string;
-}>;

package/dist/lib/scheduler.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/strip.d.ts

@@ -1,20 +0,0 @@
-/**
- * Global output stripping middleware.
- *
- * When strip is enabled in ~/.connectors/llm.json, every output surface
- * (MCP, REST, CLI) passes through maybeStrip() before returning to the caller.
- * This reduces token consumption for AI agents consuming connector output.
- *
- * If strip is disabled or no LLM config exists, output is returned as-is.
- */
-export type StripType = "json" | "text";
-/**
- * Conditionally strip output through LLM if strip is enabled.
- * Returns output unchanged if strip is disabled or LLM not configured.
- */
-export declare function maybeStrip(output: string, _type?: StripType): Promise<string>;
-/**
- * Synchronous passthrough check — returns true if stripping is active.
- * Use this to decide whether to await maybeStrip or skip it.
- */
-export declare function isStrippingActive(): boolean;

package/dist/lib/strip.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/synonyms.d.ts

@@ -1,12 +0,0 @@
-/**
- * Synonym expansion for connector search.
- * Domain-specific terms only — not a general thesaurus.
- */
-/**
- * Expand search tokens with domain synonyms.
- * Returns original tokens + synonym tokens (deduplicated).
- */
-export declare function expandQuery(tokens: string[]): {
-    original: string[];
-    expanded: string[];
-};

package/dist/lib/synonyms.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/lib/workflow-runner.d.ts

@@ -1,22 +0,0 @@
-/**
- * Workflow runner — executes sequential connector pipelines.
- *
- * Each step receives the previous step's output as additional context
- * injected into its args as --input <previous_output>.
- */
-import type { ConnectorWorkflow } from "../db/workflows.js";
-export interface WorkflowStepResult {
-    step: number;
-    connector: string;
-    command: string;
-    exit_code: number;
-    output: string;
-}
-export interface WorkflowResult {
-    workflow_id: string;
-    workflow_name: string;
-    steps: WorkflowStepResult[];
-    success: boolean;
-    final_output: string;
-}
-export declare function runWorkflow(workflow: ConnectorWorkflow): Promise<WorkflowResult>;