@hasna/connectors 1.1.17 → 1.2.0

package/dist/db/jobs.d.ts

@@ -0,0 +1,53 @@
+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

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

package/dist/db/workflows.d.ts

@@ -0,0 +1,26 @@
+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

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

package/dist/lib/llm.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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

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

package/dist/lib/scheduler.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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

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

package/dist/lib/strip.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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

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

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

@@ -0,0 +1,22 @@
+/**
+ * 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>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "1.1.17",
+  "version": "1.2.0",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {