@executor-js/sdk 0.0.1 → 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,84 @@
+import { Schema } from "effect";
+import type { ToolAnnotations } from "./core-schema";
+export interface Source {
+    readonly id: string;
+    /** Owning scope of the visible source row. Present for dynamic
+     *  sources; static sources omit it. */
+    readonly scopeId?: string;
+    readonly kind: string;
+    readonly name: string;
+    readonly url?: string;
+    /** Which plugin owns this source. */
+    readonly pluginId: string;
+    /** Whether the user can remove this source via
+     *  `executor.sources.remove(id)`. `false` for static / built-in
+     *  sources declared by plugins at startup. */
+    readonly canRemove: boolean;
+    /** Whether the plugin supports `executor.sources.refresh(id)`. */
+    readonly canRefresh: boolean;
+    /** Whether the source has editable config (headers, base url, etc.).
+     *  Editing is done via plugin-specific extension methods
+     *  (`executor.openapi.updateSource(id, patch)` etc.) — this flag is
+     *  just a UI signal. */
+    readonly canEdit: boolean;
+    /** True if the source was declared statically by a plugin at startup
+     *  (in-memory only, no DB row). False if it was added at runtime via
+     *  `ctx.core.sources.register(...)`. UI differentiates built-in vs
+     *  user-added with this. */
+    readonly runtime: boolean;
+}
+export interface Tool {
+    readonly id: string;
+    readonly sourceId: string;
+    /** Which plugin owns this tool. Matches the owning source's `pluginId`. */
+    readonly pluginId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema?: unknown;
+    readonly outputSchema?: unknown;
+    readonly annotations?: ToolAnnotations;
+}
+declare const ToolSchema_base: Schema.Class<ToolSchema, Schema.Struct<{
+    readonly id: Schema.brand<Schema.String, "ToolId">;
+    readonly name: Schema.optional<Schema.String>;
+    readonly description: Schema.optional<Schema.String>;
+    readonly inputSchema: Schema.optional<Schema.Unknown>;
+    readonly outputSchema: Schema.optional<Schema.Unknown>;
+    readonly inputTypeScript: Schema.optional<Schema.String>;
+    readonly outputTypeScript: Schema.optional<Schema.String>;
+    readonly typeScriptDefinitions: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+}>, {}>;
+export declare class ToolSchema extends ToolSchema_base {
+}
+declare const SourceDetectionResult_base: Schema.Class<SourceDetectionResult, Schema.Struct<{
+    /** Plugin id that recognized the URL (e.g. "openapi", "graphql"). */
+    readonly kind: Schema.String;
+    /** Confidence tier — UI uses this to pick a winner when multiple
+     *  plugins claim a URL. */
+    readonly confidence: Schema.Literals<readonly ["high", "medium", "low"]>;
+    /** The (possibly normalized) endpoint the plugin will use. */
+    readonly endpoint: Schema.String;
+    /** Human-readable name suggestion, typically derived from spec title
+     *  or URL hostname. */
+    readonly name: Schema.String;
+    /** Namespace suggestion — the plugin's recommendation for the source
+     *  id. UI may override. */
+    readonly namespace: Schema.String;
+}>, {}>;
+export declare class SourceDetectionResult extends SourceDetectionResult_base {
+}
+export interface ToolListFilter {
+    /** Only tools under this source id. */
+    readonly sourceId?: string;
+    /** Case-insensitive substring match against `name` OR `description`. */
+    readonly query?: string;
+    /** Resolve plugin-derived annotations. Defaults to true. */
+    readonly includeAnnotations?: boolean;
+    /** Include tools whose effective `tool_policy` is `block`. Defaults to
+     *  `false` so the agent-facing surfaces (`searchTools`, sandbox `tools.list`)
+     *  silently omit blocked tools. The settings UI for managing policies
+     *  should pass `true` so users can author rules against blocked tools. */
+    readonly includeBlocked?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;2CACuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;kDAE8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B;;;4BAGwB;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B;;;gCAG4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;CACxC;;;;;;;;;;;AAUD,qBAAa,UAAW,SAAQ,eAW9B;CAAG;;IAaH,qEAAqE;;IAErE;+BAC2B;;IAE3B,8DAA8D;;IAE9D;2BACuB;;IAEvB;+BAC2B;;;AAd7B,qBAAa,qBAAsB,SAAQ,0BAgBzC;CAAG;AAML,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC;;;8EAG0E;IAC1E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@executor-js/sdk",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "homepage": "https://github.com/RhysSullivan/executor/tree/main/packages/core/sdk",
   "bugs": {
     "url": "https://github.com/RhysSullivan/executor/issues"
@@ -27,6 +27,12 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/core.js"
       }
+    },
+    "./client": {
+      "import": {
+        "types": "./dist/client.d.ts",
+        "default": "./dist/client.js"
+      }
     }
   },
   "publishConfig": {
@@ -39,13 +45,31 @@
     "typecheck:slow": "tsc --noEmit"
   },
   "dependencies": {
-    "effect": "^3.21.0"
+    "@executor-js/storage-core": "0.1.0",
+    "effect": "4.0.0-beta.59",
+    "oauth4webapi": "^3.8.5",
+    "fractional-indexing": "^3.2.0"
+  },
+  "peerDependencies": {
+    "@effect/atom-react": "4.0.0-beta.59",
+    "react": "^19.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@effect/atom-react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@effect/vitest": "^0.29.0",
+    "@effect/atom-react": "4.0.0-beta.59",
+    "@effect/vitest": "4.0.0-beta.59",
     "@types/node": "^24.3.1",
+    "@types/react": "^19.1.0",
+    "react": "^19.1.0",
     "tsup": "^8.5.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.3"
+    "vitest": "^4.1.5"
   }
 }