Skip to content

The open-source app everyone uses to manage agents at work

Expand plugin host surface (#5205)

Dotta3c73ed26b514
diff --git a/doc/plugins/PLUGIN_AUTHORING_GUIDE.md b/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
index e3c243783a..01edfcffbd 100644
--- a/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
+++ b/doc/plugins/PLUGIN_AUTHORING_GUIDE.md
@@ -13,7 +13,9 @@ It is intentionally narrower than [PLUGIN_SPEC.md](./PLUGIN_SPEC.md). The spec i
- Plugin database migrations are restricted to a host-derived plugin namespace.
- Plugin-owned JSON API routes must be declared in the manifest and are mounted
only under `/api/plugins/:pluginId/api/*`.
-- There is no host-provided shared React component kit for plugins yet.
+- The host provides a small shared React component kit through
+ `@paperclipai/plugin-sdk/ui`; use it for common Paperclip controls before
+ building custom versions.
- `ctx.assets` is not supported in the current runtime.
## Scaffold a plugin
@@ -168,6 +170,187 @@ Mount surfaces currently wired in the host include:
- `commentAnnotation`
- `commentContextMenuItem`
+## Shared host components
+
+Use shared components from `@paperclipai/plugin-sdk/ui` when the plugin needs a
+Paperclip-native control. The host owns the implementation, so plugins inherit
+the board's current styling, ordering, recent selections, and dark-mode behavior
+without importing `ui/src` internals.
+
+Currently exposed components include:
+
+- `MarkdownBlock` and `MarkdownEditor` for rendered and editable markdown.
+- `FileTree` for serializable file and directory trees.
+- `IssuesList` for a native company-scoped issue table.
+- `AssigneePicker` for the same agent/user selector used in the new issue pane.
+ Use the controlled `value` format `agent:<id>`, `user:<id>`, or `""`.
+- `ProjectPicker` for the same project selector used in the new issue pane.
+ Use the controlled project id value, or `""` for no project.
+- `ManagedRoutinesList` for plugin-owned routine settings pages.
+
+```tsx
+import { AssigneePicker, ProjectPicker } from "@paperclipai/plugin-sdk/ui";
+
+export function PluginAssignmentControls({ companyId }: { companyId: string }) {
+ const [assignee, setAssignee] = useState("");
+ const [projectId, setProjectId] = useState("");
+
+ return (
+ <>
+ <AssigneePicker
+ companyId={companyId}
+ value={assignee}
+ onChange={(value) => setAssignee(value)}
+ />
+ <ProjectPicker
+ companyId={companyId}
+ value={projectId}
+ onChange={setProjectId}
+ />
+ </>
+ );
+}
+```
+
+## File and path UI
+
+Plugin UI often needs to render a file tree, accept a folder path, or browse a
+project workspace. There are three different surfaces for that, and they map to
+different trust and data-flow boundaries. Pick the surface that matches the
+data the plugin actually has.
+
+### When to use the shared `FileTree`
+
+Use `FileTree` from `@paperclipai/plugin-sdk/ui` whenever the plugin only needs
+to render a serializable file/directory list and react to selection or
+expand/collapse. The host owns the implementation, so plugin UI inherits the
+board's icons, indent, focus ring, and dark-mode styling without importing host
+internals.
+
+```tsx
+import {
+ FileTree,
+ type FileTreeNode,
+} from "@paperclipai/plugin-sdk/ui";
+
+const nodes: FileTreeNode[] = [
+ { name: "AGENTS.md", path: "AGENTS.md", kind: "file", children: [] },
+ {
+ name: "wiki",
+ path: "wiki",
+ kind: "dir",
+ children: [
+ { name: "index.md", path: "wiki/index.md", kind: "file", children: [] },
+ ],
+ },
+];
+
+export function WikiTree() {
+ const [expanded, setExpanded] = useState<Set<string>>(() => new Set(["wiki"]));
+ const [selected, setSelected] = useState<string | null>(null);
+
+ return (
+ <FileTree
+ nodes={nodes}
+ selectedFile={selected}
+ expandedPaths={expanded}
+ onSelectFile={(path) => setSelected(path)}
+ onToggleDir={(path) =>
+ setExpanded((current) => {
+ const next = new Set(current);
+ next.has(path) ? next.delete(path) : next.add(path);
+ return next;
+ })
+ }
+ />
+ );
+}
+```
+
+Good fits:
+
+- LLM Wiki page navigation in `packages/plugins/plugin-llm-wiki` builds a
+ `FileTreeNode[]` from worker query results and renders it through `FileTree`.
+- The example `plugin-file-browser-example` lazily fetches a directory's
+ children through a `loadFileList` action when `onToggleDir` fires, then
+ merges the children into the local tree state — letting the shared component
+ handle rendering and selection.
+
+Boundary rules:
+
+- Keep the prop surface serializable (`nodes`, `expandedPaths`, `checkedPaths`,
+ `fileBadges`, `fileTones`). Do not pass arbitrary render functions across the
+ plugin/host boundary in v1; the supported escape hatches are
+ `fileBadges` (status pill keyed by path) and `fileTones` (row tone keyed by
+ path).
+- Do not import the host's `FileTree.tsx` or any `ui/src/*` module. The SDK
+ declaration is the only supported import path for plugin UI.
+- The shared `FileTree` is for rendering and selection. Plugin-specific editors,
+ ingest flows, query forms, and lint runs stay inside the plugin and do not
+ belong as `FileTree` props.
+
+### When to declare `localFolders`
+
+When the plugin needs operator-configured filesystem roots — typically for
+trusted local plugins like wiki tooling — declare `localFolders[]` on the
+manifest and add the `local.folders` capability. The host renders a settings
+surface for the operator to set the absolute path, validates the path
+server-side (containment, symlinks, required files/directories), and exposes
+`ctx.localFolders.readText()` and `ctx.localFolders.writeTextAtomic()` in the
+worker.
+
+```ts
+export const manifest = {
+ capabilities: ["local.folders"],
+ localFolders: [
+ {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "readWrite",
+ requiredDirectories: ["sources", "pages"],
+ requiredFiles: ["schema.md"],
+ },
+ ],
+};
+```
+
+Use this when:
+
+- The data lives outside any project workspace.
+- Reads and writes need company-scoped configuration.
+- The operator picks the path once in plugin settings and the worker resolves
+ files relative to that root.
+
+Do not use `localFolders` to grant the UI direct browser-side access to the
+filesystem — there is no such capability. The browser still goes through the
+worker via `getData` / `performAction`, and the worker only exposes paths it
+chose to expose.
+
+### When to keep worker-mediated project workspace browsing
+
+When the data lives inside an existing project workspace, keep the browsing
+flow worker-mediated:
+
+- The worker uses `ctx.projects.listWorkspaces()` to resolve the workspace
+ path, then reads its filesystem with normal Node APIs.
+- The plugin UI calls a `getData` handler for the root listing and an action
+ for lazy children, then renders them through `FileTree`.
+- The worker is the only side that touches the disk. The browser receives a
+ serializable tree and never sees raw absolute paths it can replay.
+
+The example `plugin-file-browser-example` is the reference for this pattern:
+the worker registers `fileList` (data) and `loadFileList` (action) over the
+same handler, and the UI uses the action for on-toggle directory loading so the
+shared `FileTree` stays the rendering surface.
+
+### Mixing surfaces
+
+A single plugin can use more than one of these. The LLM Wiki uses
+`localFolders` for its content root, then renders the resulting page list
+through `FileTree`. The file browser example uses `ctx.projects.listWorkspaces`
+to pick a workspace and renders its on-disk tree through `FileTree` with lazy
+loading. Pick the boundary per data source, not per plugin.
+
## Company routes
Plugins may declare a `page` slot with `routePath` to own a company route like:
diff --git a/doc/plugins/PLUGIN_SPEC.md b/doc/plugins/PLUGIN_SPEC.md
index ed8dea6b2c..31b9c9d0d7 100644
--- a/doc/plugins/PLUGIN_SPEC.md
+++ b/doc/plugins/PLUGIN_SPEC.md
@@ -27,7 +27,7 @@ Current limitations to keep in mind:
- Published npm packages are the intended install artifact for deployed plugins.
- The repo example plugins under `packages/plugins/examples/` are development conveniences. They work from a source checkout and should not be assumed to exist in a generic published build unless they are explicitly shipped with that build.
- Dynamic plugin install is not yet cloud-ready for horizontally scaled or ephemeral deployments. There is no shared artifact store, install coordination, or cross-node distribution layer yet.
-- The current runtime does not yet ship a real host-provided plugin UI component kit, and it does not support plugin asset uploads/reads. Treat those as future-scope ideas in this spec, not current implementation promises.
+- The current runtime ships a small host-provided plugin UI component kit through `@paperclipai/plugin-sdk/ui`, but does not support plugin asset uploads/reads yet. Treat plugin asset APIs as future-scope ideas, not current implementation promises.
- Scoped plugin API routes are JSON-only and must be declared in `apiRoutes`.
They mount under `/api/plugins/:pluginId/api/*`; plugins cannot shadow core
API routes.
@@ -976,13 +976,23 @@ export function DashboardWidget({ context }: PluginWidgetProps) {
The SDK includes a `ui` subpath export that plugin frontends import. This subpath provides:
-- **Bridge hooks**: `usePluginData(key, params)`, `usePluginAction(key)`, `useHostContext()`
+- **Bridge hooks**: `usePluginData(key, params)`, `usePluginAction(key)`, `useHostContext()`, `useHostNavigation()`
- **Design tokens**: colors, spacing, typography, shadows matching the host theme
- **Shared components**: `MetricCard`, `StatusBadge`, `DataTable`, `LogView`, `ActionBar`, `Spinner`, etc.
- **Type definitions**: `PluginPageProps`, `PluginWidgetProps`, `PluginDetailTabProps`
Plugins are encouraged but not required to use the shared components. A plugin may render entirely custom UI as long as it communicates through the bridge.
+`useHostNavigation()` is the supported way for plugin UI to navigate to
+Paperclip-internal pages. It exposes `resolveHref(to)`, `navigate(to,
+options?)`, and `linkProps(to, options?)`. Plugin links should prefer
+`linkProps()` so anchors keep real `href` values for copy-link, modifier-click,
+middle-click, and open-in-new-tab behavior while plain left-clicks route through
+the host SPA router. The host resolves company-scoped paths against the active
+company prefix without double-prefixing already-prefixed paths. Plugin UI should
+not use raw same-origin `href`s or `window.location.assign()` for internal
+Paperclip navigation because those can force a full document reload.
+
### 19.0.2 Bundle Isolation
Plugin UI bundles are loaded as standard ES modules, not iframed. This gives plugins full rendering performance and access to the host's design tokens.
@@ -1062,6 +1072,11 @@ The host SDK ships shared components that plugins can import to quickly build UI
| `LogView` | Scrollable log output with timestamps | Webhook deliveries, job output, process logs |
| `JsonTree` | Collapsible JSON tree for debugging | Raw API responses, plugin state inspection |
| `Spinner` | Loading indicator | Data fetch states |
+| `FileTree` | Host-styled file/directory tree | Wiki pages, workspace files, import previews |
+| `IssuesList` | Host issue list | Plugin pages that need a native issue view |
+| `AssigneePicker` | Host assignee picker for agents and board users | Creating issues, assigning routines, filtering work |
+| `ProjectPicker` | Host project picker | Creating issues, scoping dashboards, filtering work |
+| `ManagedRoutinesList` | Host routine list | Plugin settings pages that manage routines |
Plugins may also use entirely custom components. The shared components exist to reduce boilerplate and keep visual consistency, not to limit what plugins can render.
diff --git a/packages/db/src/migrations/0076_useful_elektra.sql b/packages/db/src/migrations/0076_useful_elektra.sql
new file mode 100644
index 0000000000..3620f16917
--- /dev/null
+++ b/packages/db/src/migrations/0076_useful_elektra.sql
@@ -0,0 +1,29 @@
+CREATE TABLE IF NOT EXISTS "plugin_managed_resources" (
+ "id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+ "company_id" uuid NOT NULL,
+ "plugin_id" uuid NOT NULL,
+ "plugin_key" text NOT NULL,
+ "resource_kind" text NOT NULL,
+ "resource_key" text NOT NULL,
+ "resource_id" uuid NOT NULL,
+ "defaults_json" jsonb DEFAULT '{}'::jsonb NOT NULL,
+ "created_at" timestamp with time zone DEFAULT now() NOT NULL,
+ "updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "plugin_managed_resources" ADD CONSTRAINT "plugin_managed_resources_company_id_companies_id_fk" FOREIGN KEY ("company_id") REFERENCES "public"."companies"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN NULL;
+END $$;
+--> statement-breakpoint
+DO $$ BEGIN
+ ALTER TABLE "plugin_managed_resources" ADD CONSTRAINT "plugin_managed_resources_plugin_id_plugins_id_fk" FOREIGN KEY ("plugin_id") REFERENCES "public"."plugins"("id") ON DELETE cascade ON UPDATE no action;
+EXCEPTION
+ WHEN duplicate_object THEN NULL;
+END $$;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "plugin_managed_resources_company_idx" ON "plugin_managed_resources" USING btree ("company_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "plugin_managed_resources_plugin_idx" ON "plugin_managed_resources" USING btree ("plugin_id");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "plugin_managed_resources_resource_idx" ON "plugin_managed_resources" USING btree ("resource_kind","resource_id");--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS "plugin_managed_resources_company_plugin_resource_uq" ON "plugin_managed_resources" USING btree ("company_id","plugin_id","resource_kind","resource_key");
diff --git a/packages/db/src/migrations/meta/0076_snapshot.json b/packages/db/src/migrations/meta/0076_snapshot.json
new file mode 100644
index 0000000000..d002c17760
--- /dev/null
+++ b/packages/db/src/migrations/meta/0076_snapshot.json
@@ -0,0 +1,16134 @@
+{
+ "id": "063c8887-ed46-4125-a08f-51c16b636245",
+ "prevId": "fdc9cd8b-5423-4d64-b255-9bc1497fdd6a",
+ "version": "7",
+ "dialect": "postgresql",
+ "tables": {
+ "public.activity_log": {
+ "name": "activity_log",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "actor_type": {
+ "name": "actor_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'system'"
+ },
+ "actor_id": {
+ "name": "actor_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "action": {
+ "name": "action",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "entity_type": {
+ "name": "entity_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "entity_id": {
+ "name": "entity_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "run_id": {
+ "name": "run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "details": {
+ "name": "details",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "activity_log_company_created_idx": {
+ "name": "activity_log_company_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "activity_log_run_id_idx": {
+ "name": "activity_log_run_id_idx",
+ "columns": [
+ {
+ "expression": "run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "activity_log_entity_type_id_idx": {
+ "name": "activity_log_entity_type_id_idx",
+ "columns": [
+ {
+ "expression": "entity_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "entity_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "activity_log_company_id_companies_id_fk": {
+ "name": "activity_log_company_id_companies_id_fk",
+ "tableFrom": "activity_log",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "activity_log_agent_id_agents_id_fk": {
+ "name": "activity_log_agent_id_agents_id_fk",
+ "tableFrom": "activity_log",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "activity_log_run_id_heartbeat_runs_id_fk": {
+ "name": "activity_log_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "activity_log",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agent_api_keys": {
+ "name": "agent_api_keys",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "key_hash": {
+ "name": "key_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "last_used_at": {
+ "name": "last_used_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "revoked_at": {
+ "name": "revoked_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agent_api_keys_key_hash_idx": {
+ "name": "agent_api_keys_key_hash_idx",
+ "columns": [
+ {
+ "expression": "key_hash",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_api_keys_company_agent_idx": {
+ "name": "agent_api_keys_company_agent_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agent_api_keys_agent_id_agents_id_fk": {
+ "name": "agent_api_keys_agent_id_agents_id_fk",
+ "tableFrom": "agent_api_keys",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_api_keys_company_id_companies_id_fk": {
+ "name": "agent_api_keys_company_id_companies_id_fk",
+ "tableFrom": "agent_api_keys",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agent_config_revisions": {
+ "name": "agent_config_revisions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source": {
+ "name": "source",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'patch'"
+ },
+ "rolled_back_from_revision_id": {
+ "name": "rolled_back_from_revision_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "changed_keys": {
+ "name": "changed_keys",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "before_config": {
+ "name": "before_config",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "after_config": {
+ "name": "after_config",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agent_config_revisions_company_agent_created_idx": {
+ "name": "agent_config_revisions_company_agent_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_config_revisions_agent_created_idx": {
+ "name": "agent_config_revisions_agent_created_idx",
+ "columns": [
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agent_config_revisions_company_id_companies_id_fk": {
+ "name": "agent_config_revisions_company_id_companies_id_fk",
+ "tableFrom": "agent_config_revisions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_config_revisions_agent_id_agents_id_fk": {
+ "name": "agent_config_revisions_agent_id_agents_id_fk",
+ "tableFrom": "agent_config_revisions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "agent_config_revisions_created_by_agent_id_agents_id_fk": {
+ "name": "agent_config_revisions_created_by_agent_id_agents_id_fk",
+ "tableFrom": "agent_config_revisions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agent_runtime_state": {
+ "name": "agent_runtime_state",
+ "schema": "",
+ "columns": {
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "adapter_type": {
+ "name": "adapter_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "session_id": {
+ "name": "session_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "state_json": {
+ "name": "state_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "last_run_id": {
+ "name": "last_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_run_status": {
+ "name": "last_run_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "total_input_tokens": {
+ "name": "total_input_tokens",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "total_output_tokens": {
+ "name": "total_output_tokens",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "total_cached_input_tokens": {
+ "name": "total_cached_input_tokens",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "total_cost_cents": {
+ "name": "total_cost_cents",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "last_error": {
+ "name": "last_error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agent_runtime_state_company_agent_idx": {
+ "name": "agent_runtime_state_company_agent_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_runtime_state_company_updated_idx": {
+ "name": "agent_runtime_state_company_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agent_runtime_state_agent_id_agents_id_fk": {
+ "name": "agent_runtime_state_agent_id_agents_id_fk",
+ "tableFrom": "agent_runtime_state",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_runtime_state_company_id_companies_id_fk": {
+ "name": "agent_runtime_state_company_id_companies_id_fk",
+ "tableFrom": "agent_runtime_state",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agent_task_sessions": {
+ "name": "agent_task_sessions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "adapter_type": {
+ "name": "adapter_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "task_key": {
+ "name": "task_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "session_params_json": {
+ "name": "session_params_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "session_display_id": {
+ "name": "session_display_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_run_id": {
+ "name": "last_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_error": {
+ "name": "last_error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agent_task_sessions_company_agent_adapter_task_uniq": {
+ "name": "agent_task_sessions_company_agent_adapter_task_uniq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "adapter_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "task_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_task_sessions_company_agent_updated_idx": {
+ "name": "agent_task_sessions_company_agent_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_task_sessions_company_task_updated_idx": {
+ "name": "agent_task_sessions_company_task_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "task_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agent_task_sessions_company_id_companies_id_fk": {
+ "name": "agent_task_sessions_company_id_companies_id_fk",
+ "tableFrom": "agent_task_sessions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_task_sessions_agent_id_agents_id_fk": {
+ "name": "agent_task_sessions_agent_id_agents_id_fk",
+ "tableFrom": "agent_task_sessions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_task_sessions_last_run_id_heartbeat_runs_id_fk": {
+ "name": "agent_task_sessions_last_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "agent_task_sessions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "last_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agent_wakeup_requests": {
+ "name": "agent_wakeup_requests",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source": {
+ "name": "source",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "trigger_detail": {
+ "name": "trigger_detail",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "reason": {
+ "name": "reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "payload": {
+ "name": "payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'queued'"
+ },
+ "coalesced_count": {
+ "name": "coalesced_count",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "requested_by_actor_type": {
+ "name": "requested_by_actor_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "requested_by_actor_id": {
+ "name": "requested_by_actor_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "idempotency_key": {
+ "name": "idempotency_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "run_id": {
+ "name": "run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "requested_at": {
+ "name": "requested_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "claimed_at": {
+ "name": "claimed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "finished_at": {
+ "name": "finished_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error": {
+ "name": "error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agent_wakeup_requests_company_agent_status_idx": {
+ "name": "agent_wakeup_requests_company_agent_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_wakeup_requests_company_requested_idx": {
+ "name": "agent_wakeup_requests_company_requested_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "requested_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agent_wakeup_requests_agent_requested_idx": {
+ "name": "agent_wakeup_requests_agent_requested_idx",
+ "columns": [
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "requested_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agent_wakeup_requests_company_id_companies_id_fk": {
+ "name": "agent_wakeup_requests_company_id_companies_id_fk",
+ "tableFrom": "agent_wakeup_requests",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agent_wakeup_requests_agent_id_agents_id_fk": {
+ "name": "agent_wakeup_requests_agent_id_agents_id_fk",
+ "tableFrom": "agent_wakeup_requests",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.agents": {
+ "name": "agents",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "role": {
+ "name": "role",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'general'"
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "icon": {
+ "name": "icon",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'idle'"
+ },
+ "reports_to": {
+ "name": "reports_to",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "capabilities": {
+ "name": "capabilities",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "adapter_type": {
+ "name": "adapter_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'process'"
+ },
+ "adapter_config": {
+ "name": "adapter_config",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "runtime_config": {
+ "name": "runtime_config",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "default_environment_id": {
+ "name": "default_environment_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "budget_monthly_cents": {
+ "name": "budget_monthly_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "spent_monthly_cents": {
+ "name": "spent_monthly_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "pause_reason": {
+ "name": "pause_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "paused_at": {
+ "name": "paused_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "permissions": {
+ "name": "permissions",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "last_heartbeat_at": {
+ "name": "last_heartbeat_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "agents_company_status_idx": {
+ "name": "agents_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agents_company_reports_to_idx": {
+ "name": "agents_company_reports_to_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "reports_to",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "agents_company_default_environment_idx": {
+ "name": "agents_company_default_environment_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "default_environment_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "agents_company_id_companies_id_fk": {
+ "name": "agents_company_id_companies_id_fk",
+ "tableFrom": "agents",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agents_reports_to_agents_id_fk": {
+ "name": "agents_reports_to_agents_id_fk",
+ "tableFrom": "agents",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "reports_to"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "agents_default_environment_id_environments_id_fk": {
+ "name": "agents_default_environment_id_environments_id_fk",
+ "tableFrom": "agents",
+ "tableTo": "environments",
+ "columnsFrom": [
+ "default_environment_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.approval_comments": {
+ "name": "approval_comments",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "approval_id": {
+ "name": "approval_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "author_agent_id": {
+ "name": "author_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "author_user_id": {
+ "name": "author_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "body": {
+ "name": "body",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "approval_comments_company_idx": {
+ "name": "approval_comments_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "approval_comments_approval_idx": {
+ "name": "approval_comments_approval_idx",
+ "columns": [
+ {
+ "expression": "approval_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "approval_comments_approval_created_idx": {
+ "name": "approval_comments_approval_created_idx",
+ "columns": [
+ {
+ "expression": "approval_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "approval_comments_company_id_companies_id_fk": {
+ "name": "approval_comments_company_id_companies_id_fk",
+ "tableFrom": "approval_comments",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "approval_comments_approval_id_approvals_id_fk": {
+ "name": "approval_comments_approval_id_approvals_id_fk",
+ "tableFrom": "approval_comments",
+ "tableTo": "approvals",
+ "columnsFrom": [
+ "approval_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "approval_comments_author_agent_id_agents_id_fk": {
+ "name": "approval_comments_author_agent_id_agents_id_fk",
+ "tableFrom": "approval_comments",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "author_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.approvals": {
+ "name": "approvals",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "type": {
+ "name": "type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "requested_by_agent_id": {
+ "name": "requested_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "requested_by_user_id": {
+ "name": "requested_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'pending'"
+ },
+ "payload": {
+ "name": "payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "decision_note": {
+ "name": "decision_note",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "decided_by_user_id": {
+ "name": "decided_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "decided_at": {
+ "name": "decided_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "approvals_company_status_type_idx": {
+ "name": "approvals_company_status_type_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "approvals_company_id_companies_id_fk": {
+ "name": "approvals_company_id_companies_id_fk",
+ "tableFrom": "approvals",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "approvals_requested_by_agent_id_agents_id_fk": {
+ "name": "approvals_requested_by_agent_id_agents_id_fk",
+ "tableFrom": "approvals",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "requested_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.assets": {
+ "name": "assets",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "object_key": {
+ "name": "object_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "content_type": {
+ "name": "content_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "byte_size": {
+ "name": "byte_size",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "sha256": {
+ "name": "sha256",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "original_filename": {
+ "name": "original_filename",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "assets_company_created_idx": {
+ "name": "assets_company_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "assets_company_provider_idx": {
+ "name": "assets_company_provider_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "provider",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "assets_company_object_key_uq": {
+ "name": "assets_company_object_key_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "object_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "assets_company_id_companies_id_fk": {
+ "name": "assets_company_id_companies_id_fk",
+ "tableFrom": "assets",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "assets_created_by_agent_id_agents_id_fk": {
+ "name": "assets_created_by_agent_id_agents_id_fk",
+ "tableFrom": "assets",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.account": {
+ "name": "account",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "text",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "account_id": {
+ "name": "account_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider_id": {
+ "name": "provider_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "access_token": {
+ "name": "access_token",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "refresh_token": {
+ "name": "refresh_token",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "id_token": {
+ "name": "id_token",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "access_token_expires_at": {
+ "name": "access_token_expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "refresh_token_expires_at": {
+ "name": "refresh_token_expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "scope": {
+ "name": "scope",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "password": {
+ "name": "password",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ }
+ },
+ "indexes": {},
+ "foreignKeys": {
+ "account_user_id_user_id_fk": {
+ "name": "account_user_id_user_id_fk",
+ "tableFrom": "account",
+ "tableTo": "user",
+ "columnsFrom": [
+ "user_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.session": {
+ "name": "session",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "text",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "token": {
+ "name": "token",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "ip_address": {
+ "name": "ip_address",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "user_agent": {
+ "name": "user_agent",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ }
+ },
+ "indexes": {},
+ "foreignKeys": {
+ "session_user_id_user_id_fk": {
+ "name": "session_user_id_user_id_fk",
+ "tableFrom": "session",
+ "tableTo": "user",
+ "columnsFrom": [
+ "user_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.user": {
+ "name": "user",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "text",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "email": {
+ "name": "email",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "email_verified": {
+ "name": "email_verified",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "image": {
+ "name": "image",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ }
+ },
+ "indexes": {},
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.verification": {
+ "name": "verification",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "text",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "identifier": {
+ "name": "identifier",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "value": {
+ "name": "value",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ }
+ },
+ "indexes": {},
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.board_api_keys": {
+ "name": "board_api_keys",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "key_hash": {
+ "name": "key_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "last_used_at": {
+ "name": "last_used_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "revoked_at": {
+ "name": "revoked_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "board_api_keys_key_hash_idx": {
+ "name": "board_api_keys_key_hash_idx",
+ "columns": [
+ {
+ "expression": "key_hash",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "board_api_keys_user_idx": {
+ "name": "board_api_keys_user_idx",
+ "columns": [
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "board_api_keys_user_id_user_id_fk": {
+ "name": "board_api_keys_user_id_user_id_fk",
+ "tableFrom": "board_api_keys",
+ "tableTo": "user",
+ "columnsFrom": [
+ "user_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.budget_incidents": {
+ "name": "budget_incidents",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "policy_id": {
+ "name": "policy_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_type": {
+ "name": "scope_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_id": {
+ "name": "scope_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "metric": {
+ "name": "metric",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "window_kind": {
+ "name": "window_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "window_start": {
+ "name": "window_start",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "window_end": {
+ "name": "window_end",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "threshold_type": {
+ "name": "threshold_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "amount_limit": {
+ "name": "amount_limit",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "amount_observed": {
+ "name": "amount_observed",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'open'"
+ },
+ "approval_id": {
+ "name": "approval_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "resolved_at": {
+ "name": "resolved_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "budget_incidents_company_status_idx": {
+ "name": "budget_incidents_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "budget_incidents_company_scope_idx": {
+ "name": "budget_incidents_company_scope_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "budget_incidents_policy_window_threshold_idx": {
+ "name": "budget_incidents_policy_window_threshold_idx",
+ "columns": [
+ {
+ "expression": "policy_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "window_start",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "threshold_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"budget_incidents\".\"status\" <> 'dismissed'",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "budget_incidents_company_id_companies_id_fk": {
+ "name": "budget_incidents_company_id_companies_id_fk",
+ "tableFrom": "budget_incidents",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "budget_incidents_policy_id_budget_policies_id_fk": {
+ "name": "budget_incidents_policy_id_budget_policies_id_fk",
+ "tableFrom": "budget_incidents",
+ "tableTo": "budget_policies",
+ "columnsFrom": [
+ "policy_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "budget_incidents_approval_id_approvals_id_fk": {
+ "name": "budget_incidents_approval_id_approvals_id_fk",
+ "tableFrom": "budget_incidents",
+ "tableTo": "approvals",
+ "columnsFrom": [
+ "approval_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.budget_policies": {
+ "name": "budget_policies",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_type": {
+ "name": "scope_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_id": {
+ "name": "scope_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "metric": {
+ "name": "metric",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'billed_cents'"
+ },
+ "window_kind": {
+ "name": "window_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "amount": {
+ "name": "amount",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "warn_percent": {
+ "name": "warn_percent",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 80
+ },
+ "hard_stop_enabled": {
+ "name": "hard_stop_enabled",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": true
+ },
+ "notify_enabled": {
+ "name": "notify_enabled",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": true
+ },
+ "is_active": {
+ "name": "is_active",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": true
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_user_id": {
+ "name": "updated_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "budget_policies_company_scope_active_idx": {
+ "name": "budget_policies_company_scope_active_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "is_active",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "budget_policies_company_window_idx": {
+ "name": "budget_policies_company_window_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "window_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "metric",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "budget_policies_company_scope_metric_unique_idx": {
+ "name": "budget_policies_company_scope_metric_unique_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "metric",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "window_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "budget_policies_company_id_companies_id_fk": {
+ "name": "budget_policies_company_id_companies_id_fk",
+ "tableFrom": "budget_policies",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.cli_auth_challenges": {
+ "name": "cli_auth_challenges",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "secret_hash": {
+ "name": "secret_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "command": {
+ "name": "command",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "client_name": {
+ "name": "client_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "requested_access": {
+ "name": "requested_access",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'board'"
+ },
+ "requested_company_id": {
+ "name": "requested_company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "pending_key_hash": {
+ "name": "pending_key_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "pending_key_name": {
+ "name": "pending_key_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "approved_by_user_id": {
+ "name": "approved_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "board_api_key_id": {
+ "name": "board_api_key_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "approved_at": {
+ "name": "approved_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cancelled_at": {
+ "name": "cancelled_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "cli_auth_challenges_secret_hash_idx": {
+ "name": "cli_auth_challenges_secret_hash_idx",
+ "columns": [
+ {
+ "expression": "secret_hash",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cli_auth_challenges_approved_by_idx": {
+ "name": "cli_auth_challenges_approved_by_idx",
+ "columns": [
+ {
+ "expression": "approved_by_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cli_auth_challenges_requested_company_idx": {
+ "name": "cli_auth_challenges_requested_company_idx",
+ "columns": [
+ {
+ "expression": "requested_company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "cli_auth_challenges_requested_company_id_companies_id_fk": {
+ "name": "cli_auth_challenges_requested_company_id_companies_id_fk",
+ "tableFrom": "cli_auth_challenges",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "requested_company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "cli_auth_challenges_approved_by_user_id_user_id_fk": {
+ "name": "cli_auth_challenges_approved_by_user_id_user_id_fk",
+ "tableFrom": "cli_auth_challenges",
+ "tableTo": "user",
+ "columnsFrom": [
+ "approved_by_user_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "cli_auth_challenges_board_api_key_id_board_api_keys_id_fk": {
+ "name": "cli_auth_challenges_board_api_key_id_board_api_keys_id_fk",
+ "tableFrom": "cli_auth_challenges",
+ "tableTo": "board_api_keys",
+ "columnsFrom": [
+ "board_api_key_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.companies": {
+ "name": "companies",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "pause_reason": {
+ "name": "pause_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "paused_at": {
+ "name": "paused_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_prefix": {
+ "name": "issue_prefix",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'PAP'"
+ },
+ "issue_counter": {
+ "name": "issue_counter",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "budget_monthly_cents": {
+ "name": "budget_monthly_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "spent_monthly_cents": {
+ "name": "spent_monthly_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "attachment_max_bytes": {
+ "name": "attachment_max_bytes",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 10485760
+ },
+ "require_board_approval_for_new_agents": {
+ "name": "require_board_approval_for_new_agents",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "feedback_data_sharing_enabled": {
+ "name": "feedback_data_sharing_enabled",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "feedback_data_sharing_consent_at": {
+ "name": "feedback_data_sharing_consent_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "feedback_data_sharing_consent_by_user_id": {
+ "name": "feedback_data_sharing_consent_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "feedback_data_sharing_terms_version": {
+ "name": "feedback_data_sharing_terms_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "brand_color": {
+ "name": "brand_color",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "companies_issue_prefix_idx": {
+ "name": "companies_issue_prefix_idx",
+ "columns": [
+ {
+ "expression": "issue_prefix",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_logos": {
+ "name": "company_logos",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "asset_id": {
+ "name": "asset_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "company_logos_company_uq": {
+ "name": "company_logos_company_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_logos_asset_uq": {
+ "name": "company_logos_asset_uq",
+ "columns": [
+ {
+ "expression": "asset_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_logos_company_id_companies_id_fk": {
+ "name": "company_logos_company_id_companies_id_fk",
+ "tableFrom": "company_logos",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "company_logos_asset_id_assets_id_fk": {
+ "name": "company_logos_asset_id_assets_id_fk",
+ "tableFrom": "company_logos",
+ "tableTo": "assets",
+ "columnsFrom": [
+ "asset_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_memberships": {
+ "name": "company_memberships",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "principal_type": {
+ "name": "principal_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "principal_id": {
+ "name": "principal_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "membership_role": {
+ "name": "membership_role",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "company_memberships_company_principal_unique_idx": {
+ "name": "company_memberships_company_principal_unique_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "principal_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "principal_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_memberships_principal_status_idx": {
+ "name": "company_memberships_principal_status_idx",
+ "columns": [
+ {
+ "expression": "principal_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "principal_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_memberships_company_status_idx": {
+ "name": "company_memberships_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_memberships_company_id_companies_id_fk": {
+ "name": "company_memberships_company_id_companies_id_fk",
+ "tableFrom": "company_memberships",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_secret_versions": {
+ "name": "company_secret_versions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "secret_id": {
+ "name": "secret_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "version": {
+ "name": "version",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "material": {
+ "name": "material",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "value_sha256": {
+ "name": "value_sha256",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "revoked_at": {
+ "name": "revoked_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ }
+ },
+ "indexes": {
+ "company_secret_versions_secret_idx": {
+ "name": "company_secret_versions_secret_idx",
+ "columns": [
+ {
+ "expression": "secret_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_secret_versions_value_sha256_idx": {
+ "name": "company_secret_versions_value_sha256_idx",
+ "columns": [
+ {
+ "expression": "value_sha256",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_secret_versions_secret_version_uq": {
+ "name": "company_secret_versions_secret_version_uq",
+ "columns": [
+ {
+ "expression": "secret_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "version",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_secret_versions_secret_id_company_secrets_id_fk": {
+ "name": "company_secret_versions_secret_id_company_secrets_id_fk",
+ "tableFrom": "company_secret_versions",
+ "tableTo": "company_secrets",
+ "columnsFrom": [
+ "secret_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "company_secret_versions_created_by_agent_id_agents_id_fk": {
+ "name": "company_secret_versions_created_by_agent_id_agents_id_fk",
+ "tableFrom": "company_secret_versions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_secrets": {
+ "name": "company_secrets",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local_encrypted'"
+ },
+ "external_ref": {
+ "name": "external_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "latest_version": {
+ "name": "latest_version",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 1
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "company_secrets_company_idx": {
+ "name": "company_secrets_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_secrets_company_provider_idx": {
+ "name": "company_secrets_company_provider_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "provider",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_secrets_company_name_uq": {
+ "name": "company_secrets_company_name_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_secrets_company_id_companies_id_fk": {
+ "name": "company_secrets_company_id_companies_id_fk",
+ "tableFrom": "company_secrets",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "company_secrets_created_by_agent_id_agents_id_fk": {
+ "name": "company_secrets_created_by_agent_id_agents_id_fk",
+ "tableFrom": "company_secrets",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_skills": {
+ "name": "company_skills",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "key": {
+ "name": "key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "slug": {
+ "name": "slug",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "markdown": {
+ "name": "markdown",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source_type": {
+ "name": "source_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local_path'"
+ },
+ "source_locator": {
+ "name": "source_locator",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source_ref": {
+ "name": "source_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "trust_level": {
+ "name": "trust_level",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'markdown_only'"
+ },
+ "compatibility": {
+ "name": "compatibility",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'compatible'"
+ },
+ "file_inventory": {
+ "name": "file_inventory",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "company_skills_company_key_idx": {
+ "name": "company_skills_company_key_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_skills_company_name_idx": {
+ "name": "company_skills_company_name_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_skills_company_id_companies_id_fk": {
+ "name": "company_skills_company_id_companies_id_fk",
+ "tableFrom": "company_skills",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.company_user_sidebar_preferences": {
+ "name": "company_user_sidebar_preferences",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_order": {
+ "name": "project_order",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "company_user_sidebar_preferences_company_idx": {
+ "name": "company_user_sidebar_preferences_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_user_sidebar_preferences_user_idx": {
+ "name": "company_user_sidebar_preferences_user_idx",
+ "columns": [
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "company_user_sidebar_preferences_company_user_uq": {
+ "name": "company_user_sidebar_preferences_company_user_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "company_user_sidebar_preferences_company_id_companies_id_fk": {
+ "name": "company_user_sidebar_preferences_company_id_companies_id_fk",
+ "tableFrom": "company_user_sidebar_preferences",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.cost_events": {
+ "name": "cost_events",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "heartbeat_run_id": {
+ "name": "heartbeat_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "billing_code": {
+ "name": "billing_code",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "biller": {
+ "name": "biller",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'unknown'"
+ },
+ "billing_type": {
+ "name": "billing_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'unknown'"
+ },
+ "model": {
+ "name": "model",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "input_tokens": {
+ "name": "input_tokens",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "cached_input_tokens": {
+ "name": "cached_input_tokens",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "output_tokens": {
+ "name": "output_tokens",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "cost_cents": {
+ "name": "cost_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "occurred_at": {
+ "name": "occurred_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "cost_events_company_occurred_idx": {
+ "name": "cost_events_company_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cost_events_company_agent_occurred_idx": {
+ "name": "cost_events_company_agent_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cost_events_company_provider_occurred_idx": {
+ "name": "cost_events_company_provider_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "provider",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cost_events_company_biller_occurred_idx": {
+ "name": "cost_events_company_biller_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "biller",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "cost_events_company_heartbeat_run_idx": {
+ "name": "cost_events_company_heartbeat_run_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "heartbeat_run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "cost_events_company_id_companies_id_fk": {
+ "name": "cost_events_company_id_companies_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "cost_events_agent_id_agents_id_fk": {
+ "name": "cost_events_agent_id_agents_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "cost_events_issue_id_issues_id_fk": {
+ "name": "cost_events_issue_id_issues_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "cost_events_project_id_projects_id_fk": {
+ "name": "cost_events_project_id_projects_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "cost_events_goal_id_goals_id_fk": {
+ "name": "cost_events_goal_id_goals_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "cost_events_heartbeat_run_id_heartbeat_runs_id_fk": {
+ "name": "cost_events_heartbeat_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "cost_events",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "heartbeat_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.document_revisions": {
+ "name": "document_revisions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "document_id": {
+ "name": "document_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "revision_number": {
+ "name": "revision_number",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "format": {
+ "name": "format",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'markdown'"
+ },
+ "body": {
+ "name": "body",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "change_summary": {
+ "name": "change_summary",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "document_revisions_document_revision_uq": {
+ "name": "document_revisions_document_revision_uq",
+ "columns": [
+ {
+ "expression": "document_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "revision_number",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "document_revisions_company_document_created_idx": {
+ "name": "document_revisions_company_document_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "document_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "document_revisions_company_id_companies_id_fk": {
+ "name": "document_revisions_company_id_companies_id_fk",
+ "tableFrom": "document_revisions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "document_revisions_document_id_documents_id_fk": {
+ "name": "document_revisions_document_id_documents_id_fk",
+ "tableFrom": "document_revisions",
+ "tableTo": "documents",
+ "columnsFrom": [
+ "document_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "document_revisions_created_by_agent_id_agents_id_fk": {
+ "name": "document_revisions_created_by_agent_id_agents_id_fk",
+ "tableFrom": "document_revisions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "document_revisions_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "document_revisions_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "document_revisions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.documents": {
+ "name": "documents",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "format": {
+ "name": "format",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'markdown'"
+ },
+ "latest_body": {
+ "name": "latest_body",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "latest_revision_id": {
+ "name": "latest_revision_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "latest_revision_number": {
+ "name": "latest_revision_number",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 1
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_agent_id": {
+ "name": "updated_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_user_id": {
+ "name": "updated_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "documents_company_updated_idx": {
+ "name": "documents_company_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "documents_company_created_idx": {
+ "name": "documents_company_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "documents_company_id_companies_id_fk": {
+ "name": "documents_company_id_companies_id_fk",
+ "tableFrom": "documents",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "documents_created_by_agent_id_agents_id_fk": {
+ "name": "documents_created_by_agent_id_agents_id_fk",
+ "tableFrom": "documents",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "documents_updated_by_agent_id_agents_id_fk": {
+ "name": "documents_updated_by_agent_id_agents_id_fk",
+ "tableFrom": "documents",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "updated_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.environment_leases": {
+ "name": "environment_leases",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "environment_id": {
+ "name": "environment_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "execution_workspace_id": {
+ "name": "execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "heartbeat_run_id": {
+ "name": "heartbeat_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "lease_policy": {
+ "name": "lease_policy",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'ephemeral'"
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "provider_lease_id": {
+ "name": "provider_lease_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "acquired_at": {
+ "name": "acquired_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "last_used_at": {
+ "name": "last_used_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_at": {
+ "name": "released_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "failure_reason": {
+ "name": "failure_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cleanup_status": {
+ "name": "cleanup_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "environment_leases_company_environment_status_idx": {
+ "name": "environment_leases_company_environment_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "environment_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environment_leases_company_execution_workspace_idx": {
+ "name": "environment_leases_company_execution_workspace_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "execution_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environment_leases_company_issue_idx": {
+ "name": "environment_leases_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environment_leases_heartbeat_run_idx": {
+ "name": "environment_leases_heartbeat_run_idx",
+ "columns": [
+ {
+ "expression": "heartbeat_run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environment_leases_company_last_used_idx": {
+ "name": "environment_leases_company_last_used_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "last_used_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environment_leases_provider_lease_idx": {
+ "name": "environment_leases_provider_lease_idx",
+ "columns": [
+ {
+ "expression": "provider_lease_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "environment_leases_company_id_companies_id_fk": {
+ "name": "environment_leases_company_id_companies_id_fk",
+ "tableFrom": "environment_leases",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "environment_leases_environment_id_environments_id_fk": {
+ "name": "environment_leases_environment_id_environments_id_fk",
+ "tableFrom": "environment_leases",
+ "tableTo": "environments",
+ "columnsFrom": [
+ "environment_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "environment_leases_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "environment_leases_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "environment_leases",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "environment_leases_issue_id_issues_id_fk": {
+ "name": "environment_leases_issue_id_issues_id_fk",
+ "tableFrom": "environment_leases",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "environment_leases_heartbeat_run_id_heartbeat_runs_id_fk": {
+ "name": "environment_leases_heartbeat_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "environment_leases",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "heartbeat_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.environments": {
+ "name": "environments",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "driver": {
+ "name": "driver",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local'"
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "config": {
+ "name": "config",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "environments_company_status_idx": {
+ "name": "environments_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environments_company_driver_idx": {
+ "name": "environments_company_driver_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "driver",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"environments\".\"driver\" = 'local'",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "environments_company_name_idx": {
+ "name": "environments_company_name_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "environments_company_id_companies_id_fk": {
+ "name": "environments_company_id_companies_id_fk",
+ "tableFrom": "environments",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.execution_workspaces": {
+ "name": "execution_workspaces",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_workspace_id": {
+ "name": "project_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source_issue_id": {
+ "name": "source_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "mode": {
+ "name": "mode",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "strategy_type": {
+ "name": "strategy_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "cwd": {
+ "name": "cwd",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "repo_url": {
+ "name": "repo_url",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "base_ref": {
+ "name": "base_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "branch_name": {
+ "name": "branch_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "provider_type": {
+ "name": "provider_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local_fs'"
+ },
+ "provider_ref": {
+ "name": "provider_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "derived_from_execution_workspace_id": {
+ "name": "derived_from_execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_used_at": {
+ "name": "last_used_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "opened_at": {
+ "name": "opened_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "closed_at": {
+ "name": "closed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cleanup_eligible_at": {
+ "name": "cleanup_eligible_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cleanup_reason": {
+ "name": "cleanup_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "execution_workspaces_company_project_status_idx": {
+ "name": "execution_workspaces_company_project_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "execution_workspaces_company_project_workspace_status_idx": {
+ "name": "execution_workspaces_company_project_workspace_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "execution_workspaces_company_source_issue_idx": {
+ "name": "execution_workspaces_company_source_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "execution_workspaces_company_last_used_idx": {
+ "name": "execution_workspaces_company_last_used_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "last_used_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "execution_workspaces_company_branch_idx": {
+ "name": "execution_workspaces_company_branch_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "branch_name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "execution_workspaces_company_id_companies_id_fk": {
+ "name": "execution_workspaces_company_id_companies_id_fk",
+ "tableFrom": "execution_workspaces",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "execution_workspaces_project_id_projects_id_fk": {
+ "name": "execution_workspaces_project_id_projects_id_fk",
+ "tableFrom": "execution_workspaces",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "execution_workspaces_project_workspace_id_project_workspaces_id_fk": {
+ "name": "execution_workspaces_project_workspace_id_project_workspaces_id_fk",
+ "tableFrom": "execution_workspaces",
+ "tableTo": "project_workspaces",
+ "columnsFrom": [
+ "project_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "execution_workspaces_source_issue_id_issues_id_fk": {
+ "name": "execution_workspaces_source_issue_id_issues_id_fk",
+ "tableFrom": "execution_workspaces",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "source_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "execution_workspaces_derived_from_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "execution_workspaces_derived_from_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "execution_workspaces",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "derived_from_execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.feedback_exports": {
+ "name": "feedback_exports",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "feedback_vote_id": {
+ "name": "feedback_vote_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "author_user_id": {
+ "name": "author_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "target_type": {
+ "name": "target_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "target_id": {
+ "name": "target_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "vote": {
+ "name": "vote",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local_only'"
+ },
+ "destination": {
+ "name": "destination",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "export_id": {
+ "name": "export_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "consent_version": {
+ "name": "consent_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "schema_version": {
+ "name": "schema_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'paperclip-feedback-envelope-v2'"
+ },
+ "bundle_version": {
+ "name": "bundle_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'paperclip-feedback-bundle-v2'"
+ },
+ "payload_version": {
+ "name": "payload_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'paperclip-feedback-v1'"
+ },
+ "payload_digest": {
+ "name": "payload_digest",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "payload_snapshot": {
+ "name": "payload_snapshot",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "target_summary": {
+ "name": "target_summary",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "redaction_summary": {
+ "name": "redaction_summary",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "attempt_count": {
+ "name": "attempt_count",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "last_attempted_at": {
+ "name": "last_attempted_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "exported_at": {
+ "name": "exported_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "failure_reason": {
+ "name": "failure_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "feedback_exports_feedback_vote_idx": {
+ "name": "feedback_exports_feedback_vote_idx",
+ "columns": [
+ {
+ "expression": "feedback_vote_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_exports_company_created_idx": {
+ "name": "feedback_exports_company_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_exports_company_status_idx": {
+ "name": "feedback_exports_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_exports_company_issue_idx": {
+ "name": "feedback_exports_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_exports_company_project_idx": {
+ "name": "feedback_exports_company_project_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_exports_company_author_idx": {
+ "name": "feedback_exports_company_author_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "author_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "feedback_exports_company_id_companies_id_fk": {
+ "name": "feedback_exports_company_id_companies_id_fk",
+ "tableFrom": "feedback_exports",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "feedback_exports_feedback_vote_id_feedback_votes_id_fk": {
+ "name": "feedback_exports_feedback_vote_id_feedback_votes_id_fk",
+ "tableFrom": "feedback_exports",
+ "tableTo": "feedback_votes",
+ "columnsFrom": [
+ "feedback_vote_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "feedback_exports_issue_id_issues_id_fk": {
+ "name": "feedback_exports_issue_id_issues_id_fk",
+ "tableFrom": "feedback_exports",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "feedback_exports_project_id_projects_id_fk": {
+ "name": "feedback_exports_project_id_projects_id_fk",
+ "tableFrom": "feedback_exports",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.feedback_votes": {
+ "name": "feedback_votes",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "target_type": {
+ "name": "target_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "target_id": {
+ "name": "target_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "author_user_id": {
+ "name": "author_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "vote": {
+ "name": "vote",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "reason": {
+ "name": "reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "shared_with_labs": {
+ "name": "shared_with_labs",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "shared_at": {
+ "name": "shared_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "consent_version": {
+ "name": "consent_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "redaction_summary": {
+ "name": "redaction_summary",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "feedback_votes_company_issue_idx": {
+ "name": "feedback_votes_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_votes_issue_target_idx": {
+ "name": "feedback_votes_issue_target_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_votes_author_idx": {
+ "name": "feedback_votes_author_idx",
+ "columns": [
+ {
+ "expression": "author_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "feedback_votes_company_target_author_idx": {
+ "name": "feedback_votes_company_target_author_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "author_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "feedback_votes_company_id_companies_id_fk": {
+ "name": "feedback_votes_company_id_companies_id_fk",
+ "tableFrom": "feedback_votes",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "feedback_votes_issue_id_issues_id_fk": {
+ "name": "feedback_votes_issue_id_issues_id_fk",
+ "tableFrom": "feedback_votes",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.finance_events": {
+ "name": "finance_events",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "heartbeat_run_id": {
+ "name": "heartbeat_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cost_event_id": {
+ "name": "cost_event_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "billing_code": {
+ "name": "billing_code",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "event_kind": {
+ "name": "event_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "direction": {
+ "name": "direction",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'debit'"
+ },
+ "biller": {
+ "name": "biller",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_adapter_type": {
+ "name": "execution_adapter_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "pricing_tier": {
+ "name": "pricing_tier",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "region": {
+ "name": "region",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "model": {
+ "name": "model",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "quantity": {
+ "name": "quantity",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "unit": {
+ "name": "unit",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "amount_cents": {
+ "name": "amount_cents",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "currency": {
+ "name": "currency",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'USD'"
+ },
+ "estimated": {
+ "name": "estimated",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "external_invoice_id": {
+ "name": "external_invoice_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata_json": {
+ "name": "metadata_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "occurred_at": {
+ "name": "occurred_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "finance_events_company_occurred_idx": {
+ "name": "finance_events_company_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "finance_events_company_biller_occurred_idx": {
+ "name": "finance_events_company_biller_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "biller",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "finance_events_company_kind_occurred_idx": {
+ "name": "finance_events_company_kind_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "event_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "finance_events_company_direction_occurred_idx": {
+ "name": "finance_events_company_direction_occurred_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "direction",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "occurred_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "finance_events_company_heartbeat_run_idx": {
+ "name": "finance_events_company_heartbeat_run_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "heartbeat_run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "finance_events_company_cost_event_idx": {
+ "name": "finance_events_company_cost_event_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "cost_event_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "finance_events_company_id_companies_id_fk": {
+ "name": "finance_events_company_id_companies_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_agent_id_agents_id_fk": {
+ "name": "finance_events_agent_id_agents_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_issue_id_issues_id_fk": {
+ "name": "finance_events_issue_id_issues_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_project_id_projects_id_fk": {
+ "name": "finance_events_project_id_projects_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_goal_id_goals_id_fk": {
+ "name": "finance_events_goal_id_goals_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_heartbeat_run_id_heartbeat_runs_id_fk": {
+ "name": "finance_events_heartbeat_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "heartbeat_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "finance_events_cost_event_id_cost_events_id_fk": {
+ "name": "finance_events_cost_event_id_cost_events_id_fk",
+ "tableFrom": "finance_events",
+ "tableTo": "cost_events",
+ "columnsFrom": [
+ "cost_event_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.goals": {
+ "name": "goals",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "level": {
+ "name": "level",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'task'"
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'planned'"
+ },
+ "parent_id": {
+ "name": "parent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "owner_agent_id": {
+ "name": "owner_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "goals_company_idx": {
+ "name": "goals_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "goals_company_id_companies_id_fk": {
+ "name": "goals_company_id_companies_id_fk",
+ "tableFrom": "goals",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "goals_parent_id_goals_id_fk": {
+ "name": "goals_parent_id_goals_id_fk",
+ "tableFrom": "goals",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "parent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "goals_owner_agent_id_agents_id_fk": {
+ "name": "goals_owner_agent_id_agents_id_fk",
+ "tableFrom": "goals",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "owner_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.heartbeat_run_events": {
+ "name": "heartbeat_run_events",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "bigserial",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "run_id": {
+ "name": "run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "seq": {
+ "name": "seq",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "event_type": {
+ "name": "event_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "stream": {
+ "name": "stream",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "level": {
+ "name": "level",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "color": {
+ "name": "color",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "message": {
+ "name": "message",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "payload": {
+ "name": "payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "heartbeat_run_events_run_seq_idx": {
+ "name": "heartbeat_run_events_run_seq_idx",
+ "columns": [
+ {
+ "expression": "run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "seq",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_run_events_company_run_idx": {
+ "name": "heartbeat_run_events_company_run_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_run_events_company_created_idx": {
+ "name": "heartbeat_run_events_company_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "heartbeat_run_events_company_id_companies_id_fk": {
+ "name": "heartbeat_run_events_company_id_companies_id_fk",
+ "tableFrom": "heartbeat_run_events",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_events_run_id_heartbeat_runs_id_fk": {
+ "name": "heartbeat_run_events_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "heartbeat_run_events",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_events_agent_id_agents_id_fk": {
+ "name": "heartbeat_run_events_agent_id_agents_id_fk",
+ "tableFrom": "heartbeat_run_events",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.heartbeat_run_watchdog_decisions": {
+ "name": "heartbeat_run_watchdog_decisions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "run_id": {
+ "name": "run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "evaluation_issue_id": {
+ "name": "evaluation_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "decision": {
+ "name": "decision",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "snoozed_until": {
+ "name": "snoozed_until",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "reason": {
+ "name": "reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "heartbeat_run_watchdog_decisions_company_run_created_idx": {
+ "name": "heartbeat_run_watchdog_decisions_company_run_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_run_watchdog_decisions_company_run_snooze_idx": {
+ "name": "heartbeat_run_watchdog_decisions_company_run_snooze_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "snoozed_until",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "heartbeat_run_watchdog_decisions_company_id_companies_id_fk": {
+ "name": "heartbeat_run_watchdog_decisions_company_id_companies_id_fk",
+ "tableFrom": "heartbeat_run_watchdog_decisions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_watchdog_decisions_run_id_heartbeat_runs_id_fk": {
+ "name": "heartbeat_run_watchdog_decisions_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "heartbeat_run_watchdog_decisions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_watchdog_decisions_evaluation_issue_id_issues_id_fk": {
+ "name": "heartbeat_run_watchdog_decisions_evaluation_issue_id_issues_id_fk",
+ "tableFrom": "heartbeat_run_watchdog_decisions",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "evaluation_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_watchdog_decisions_created_by_agent_id_agents_id_fk": {
+ "name": "heartbeat_run_watchdog_decisions_created_by_agent_id_agents_id_fk",
+ "tableFrom": "heartbeat_run_watchdog_decisions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "heartbeat_run_watchdog_decisions_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "heartbeat_run_watchdog_decisions_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "heartbeat_run_watchdog_decisions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.heartbeat_runs": {
+ "name": "heartbeat_runs",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "agent_id": {
+ "name": "agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "invocation_source": {
+ "name": "invocation_source",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'on_demand'"
+ },
+ "trigger_detail": {
+ "name": "trigger_detail",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'queued'"
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "finished_at": {
+ "name": "finished_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error": {
+ "name": "error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "wakeup_request_id": {
+ "name": "wakeup_request_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "exit_code": {
+ "name": "exit_code",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "signal": {
+ "name": "signal",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "usage_json": {
+ "name": "usage_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "result_json": {
+ "name": "result_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "session_id_before": {
+ "name": "session_id_before",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "session_id_after": {
+ "name": "session_id_after",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_store": {
+ "name": "log_store",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_ref": {
+ "name": "log_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_bytes": {
+ "name": "log_bytes",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_sha256": {
+ "name": "log_sha256",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_compressed": {
+ "name": "log_compressed",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "stdout_excerpt": {
+ "name": "stdout_excerpt",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "stderr_excerpt": {
+ "name": "stderr_excerpt",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error_code": {
+ "name": "error_code",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "external_run_id": {
+ "name": "external_run_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "process_pid": {
+ "name": "process_pid",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "process_group_id": {
+ "name": "process_group_id",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "process_started_at": {
+ "name": "process_started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_output_at": {
+ "name": "last_output_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_output_seq": {
+ "name": "last_output_seq",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "last_output_stream": {
+ "name": "last_output_stream",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_output_bytes": {
+ "name": "last_output_bytes",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "retry_of_run_id": {
+ "name": "retry_of_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "process_loss_retry_count": {
+ "name": "process_loss_retry_count",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "scheduled_retry_at": {
+ "name": "scheduled_retry_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "scheduled_retry_attempt": {
+ "name": "scheduled_retry_attempt",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "scheduled_retry_reason": {
+ "name": "scheduled_retry_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_comment_status": {
+ "name": "issue_comment_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'not_applicable'"
+ },
+ "issue_comment_satisfied_by_comment_id": {
+ "name": "issue_comment_satisfied_by_comment_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_comment_retry_queued_at": {
+ "name": "issue_comment_retry_queued_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "liveness_state": {
+ "name": "liveness_state",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "liveness_reason": {
+ "name": "liveness_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "continuation_attempt": {
+ "name": "continuation_attempt",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "last_useful_action_at": {
+ "name": "last_useful_action_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "next_action": {
+ "name": "next_action",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "context_snapshot": {
+ "name": "context_snapshot",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "heartbeat_runs_company_agent_started_idx": {
+ "name": "heartbeat_runs_company_agent_started_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "started_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_runs_company_liveness_idx": {
+ "name": "heartbeat_runs_company_liveness_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "liveness_state",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_runs_company_status_last_output_idx": {
+ "name": "heartbeat_runs_company_status_last_output_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "last_output_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "heartbeat_runs_company_status_process_started_idx": {
+ "name": "heartbeat_runs_company_status_process_started_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "process_started_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "heartbeat_runs_company_id_companies_id_fk": {
+ "name": "heartbeat_runs_company_id_companies_id_fk",
+ "tableFrom": "heartbeat_runs",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_runs_agent_id_agents_id_fk": {
+ "name": "heartbeat_runs_agent_id_agents_id_fk",
+ "tableFrom": "heartbeat_runs",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_runs_wakeup_request_id_agent_wakeup_requests_id_fk": {
+ "name": "heartbeat_runs_wakeup_request_id_agent_wakeup_requests_id_fk",
+ "tableFrom": "heartbeat_runs",
+ "tableTo": "agent_wakeup_requests",
+ "columnsFrom": [
+ "wakeup_request_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "heartbeat_runs_retry_of_run_id_heartbeat_runs_id_fk": {
+ "name": "heartbeat_runs_retry_of_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "heartbeat_runs",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "retry_of_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.inbox_dismissals": {
+ "name": "inbox_dismissals",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "item_key": {
+ "name": "item_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "dismissed_at": {
+ "name": "dismissed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "inbox_dismissals_company_user_idx": {
+ "name": "inbox_dismissals_company_user_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "inbox_dismissals_company_item_idx": {
+ "name": "inbox_dismissals_company_item_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "item_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "inbox_dismissals_company_user_item_idx": {
+ "name": "inbox_dismissals_company_user_item_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "item_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "inbox_dismissals_company_id_companies_id_fk": {
+ "name": "inbox_dismissals_company_id_companies_id_fk",
+ "tableFrom": "inbox_dismissals",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.instance_settings": {
+ "name": "instance_settings",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "singleton_key": {
+ "name": "singleton_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'default'"
+ },
+ "general": {
+ "name": "general",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "experimental": {
+ "name": "experimental",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "instance_settings_singleton_key_idx": {
+ "name": "instance_settings_singleton_key_idx",
+ "columns": [
+ {
+ "expression": "singleton_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.instance_user_roles": {
+ "name": "instance_user_roles",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "role": {
+ "name": "role",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'instance_admin'"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "instance_user_roles_user_role_unique_idx": {
+ "name": "instance_user_roles_user_role_unique_idx",
+ "columns": [
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "role",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "instance_user_roles_role_idx": {
+ "name": "instance_user_roles_role_idx",
+ "columns": [
+ {
+ "expression": "role",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.invites": {
+ "name": "invites",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "invite_type": {
+ "name": "invite_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'company_join'"
+ },
+ "token_hash": {
+ "name": "token_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "allowed_join_types": {
+ "name": "allowed_join_types",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'both'"
+ },
+ "defaults_payload": {
+ "name": "defaults_payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "expires_at": {
+ "name": "expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "invited_by_user_id": {
+ "name": "invited_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "revoked_at": {
+ "name": "revoked_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "accepted_at": {
+ "name": "accepted_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "invites_token_hash_unique_idx": {
+ "name": "invites_token_hash_unique_idx",
+ "columns": [
+ {
+ "expression": "token_hash",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "invites_company_invite_state_idx": {
+ "name": "invites_company_invite_state_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "invite_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "revoked_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "expires_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "invites_company_id_companies_id_fk": {
+ "name": "invites_company_id_companies_id_fk",
+ "tableFrom": "invites",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_approvals": {
+ "name": "issue_approvals",
+ "schema": "",
+ "columns": {
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "approval_id": {
+ "name": "approval_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "linked_by_agent_id": {
+ "name": "linked_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "linked_by_user_id": {
+ "name": "linked_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_approvals_issue_idx": {
+ "name": "issue_approvals_issue_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_approvals_approval_idx": {
+ "name": "issue_approvals_approval_idx",
+ "columns": [
+ {
+ "expression": "approval_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_approvals_company_idx": {
+ "name": "issue_approvals_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_approvals_company_id_companies_id_fk": {
+ "name": "issue_approvals_company_id_companies_id_fk",
+ "tableFrom": "issue_approvals",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_approvals_issue_id_issues_id_fk": {
+ "name": "issue_approvals_issue_id_issues_id_fk",
+ "tableFrom": "issue_approvals",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_approvals_approval_id_approvals_id_fk": {
+ "name": "issue_approvals_approval_id_approvals_id_fk",
+ "tableFrom": "issue_approvals",
+ "tableTo": "approvals",
+ "columnsFrom": [
+ "approval_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_approvals_linked_by_agent_id_agents_id_fk": {
+ "name": "issue_approvals_linked_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_approvals",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "linked_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {
+ "issue_approvals_pk": {
+ "name": "issue_approvals_pk",
+ "columns": [
+ "issue_id",
+ "approval_id"
+ ]
+ }
+ },
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_attachments": {
+ "name": "issue_attachments",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "asset_id": {
+ "name": "asset_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_comment_id": {
+ "name": "issue_comment_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_attachments_company_issue_idx": {
+ "name": "issue_attachments_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_attachments_issue_comment_idx": {
+ "name": "issue_attachments_issue_comment_idx",
+ "columns": [
+ {
+ "expression": "issue_comment_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_attachments_asset_uq": {
+ "name": "issue_attachments_asset_uq",
+ "columns": [
+ {
+ "expression": "asset_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_attachments_company_id_companies_id_fk": {
+ "name": "issue_attachments_company_id_companies_id_fk",
+ "tableFrom": "issue_attachments",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_attachments_issue_id_issues_id_fk": {
+ "name": "issue_attachments_issue_id_issues_id_fk",
+ "tableFrom": "issue_attachments",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_attachments_asset_id_assets_id_fk": {
+ "name": "issue_attachments_asset_id_assets_id_fk",
+ "tableFrom": "issue_attachments",
+ "tableTo": "assets",
+ "columnsFrom": [
+ "asset_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_attachments_issue_comment_id_issue_comments_id_fk": {
+ "name": "issue_attachments_issue_comment_id_issue_comments_id_fk",
+ "tableFrom": "issue_attachments",
+ "tableTo": "issue_comments",
+ "columnsFrom": [
+ "issue_comment_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_comments": {
+ "name": "issue_comments",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "author_agent_id": {
+ "name": "author_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "author_user_id": {
+ "name": "author_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "body": {
+ "name": "body",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_comments_issue_idx": {
+ "name": "issue_comments_issue_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_comments_company_idx": {
+ "name": "issue_comments_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_comments_company_issue_created_at_idx": {
+ "name": "issue_comments_company_issue_created_at_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_comments_company_author_issue_created_at_idx": {
+ "name": "issue_comments_company_author_issue_created_at_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "author_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_comments_body_search_idx": {
+ "name": "issue_comments_body_search_idx",
+ "columns": [
+ {
+ "expression": "body",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last",
+ "opclass": "gin_trgm_ops"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "gin",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_comments_company_id_companies_id_fk": {
+ "name": "issue_comments_company_id_companies_id_fk",
+ "tableFrom": "issue_comments",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_comments_issue_id_issues_id_fk": {
+ "name": "issue_comments_issue_id_issues_id_fk",
+ "tableFrom": "issue_comments",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_comments_author_agent_id_agents_id_fk": {
+ "name": "issue_comments_author_agent_id_agents_id_fk",
+ "tableFrom": "issue_comments",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "author_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_comments_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_comments_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_comments",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_documents": {
+ "name": "issue_documents",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "document_id": {
+ "name": "document_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "key": {
+ "name": "key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_documents_company_issue_key_uq": {
+ "name": "issue_documents_company_issue_key_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_documents_document_uq": {
+ "name": "issue_documents_document_uq",
+ "columns": [
+ {
+ "expression": "document_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_documents_company_issue_updated_idx": {
+ "name": "issue_documents_company_issue_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_documents_company_id_companies_id_fk": {
+ "name": "issue_documents_company_id_companies_id_fk",
+ "tableFrom": "issue_documents",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_documents_issue_id_issues_id_fk": {
+ "name": "issue_documents_issue_id_issues_id_fk",
+ "tableFrom": "issue_documents",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_documents_document_id_documents_id_fk": {
+ "name": "issue_documents_document_id_documents_id_fk",
+ "tableFrom": "issue_documents",
+ "tableTo": "documents",
+ "columnsFrom": [
+ "document_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_execution_decisions": {
+ "name": "issue_execution_decisions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "stage_id": {
+ "name": "stage_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "stage_type": {
+ "name": "stage_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "actor_agent_id": {
+ "name": "actor_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "actor_user_id": {
+ "name": "actor_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "outcome": {
+ "name": "outcome",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "body": {
+ "name": "body",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_execution_decisions_company_issue_idx": {
+ "name": "issue_execution_decisions_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_execution_decisions_stage_idx": {
+ "name": "issue_execution_decisions_stage_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "stage_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_execution_decisions_company_id_companies_id_fk": {
+ "name": "issue_execution_decisions_company_id_companies_id_fk",
+ "tableFrom": "issue_execution_decisions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_execution_decisions_issue_id_issues_id_fk": {
+ "name": "issue_execution_decisions_issue_id_issues_id_fk",
+ "tableFrom": "issue_execution_decisions",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_execution_decisions_actor_agent_id_agents_id_fk": {
+ "name": "issue_execution_decisions_actor_agent_id_agents_id_fk",
+ "tableFrom": "issue_execution_decisions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "actor_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_execution_decisions_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_execution_decisions_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_execution_decisions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_inbox_archives": {
+ "name": "issue_inbox_archives",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "archived_at": {
+ "name": "archived_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_inbox_archives_company_issue_idx": {
+ "name": "issue_inbox_archives_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_inbox_archives_company_user_idx": {
+ "name": "issue_inbox_archives_company_user_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_inbox_archives_company_issue_user_idx": {
+ "name": "issue_inbox_archives_company_issue_user_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_inbox_archives_company_id_companies_id_fk": {
+ "name": "issue_inbox_archives_company_id_companies_id_fk",
+ "tableFrom": "issue_inbox_archives",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_inbox_archives_issue_id_issues_id_fk": {
+ "name": "issue_inbox_archives_issue_id_issues_id_fk",
+ "tableFrom": "issue_inbox_archives",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_labels": {
+ "name": "issue_labels",
+ "schema": "",
+ "columns": {
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "label_id": {
+ "name": "label_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_labels_issue_idx": {
+ "name": "issue_labels_issue_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_labels_label_idx": {
+ "name": "issue_labels_label_idx",
+ "columns": [
+ {
+ "expression": "label_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_labels_company_idx": {
+ "name": "issue_labels_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_labels_issue_id_issues_id_fk": {
+ "name": "issue_labels_issue_id_issues_id_fk",
+ "tableFrom": "issue_labels",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_labels_label_id_labels_id_fk": {
+ "name": "issue_labels_label_id_labels_id_fk",
+ "tableFrom": "issue_labels",
+ "tableTo": "labels",
+ "columnsFrom": [
+ "label_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_labels_company_id_companies_id_fk": {
+ "name": "issue_labels_company_id_companies_id_fk",
+ "tableFrom": "issue_labels",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {
+ "issue_labels_pk": {
+ "name": "issue_labels_pk",
+ "columns": [
+ "issue_id",
+ "label_id"
+ ]
+ }
+ },
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_read_states": {
+ "name": "issue_read_states",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "last_read_at": {
+ "name": "last_read_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_read_states_company_issue_idx": {
+ "name": "issue_read_states_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_read_states_company_user_idx": {
+ "name": "issue_read_states_company_user_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_read_states_company_issue_user_idx": {
+ "name": "issue_read_states_company_issue_user_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_read_states_company_id_companies_id_fk": {
+ "name": "issue_read_states_company_id_companies_id_fk",
+ "tableFrom": "issue_read_states",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_read_states_issue_id_issues_id_fk": {
+ "name": "issue_read_states_issue_id_issues_id_fk",
+ "tableFrom": "issue_read_states",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_reference_mentions": {
+ "name": "issue_reference_mentions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source_issue_id": {
+ "name": "source_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "target_issue_id": {
+ "name": "target_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source_kind": {
+ "name": "source_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source_record_id": {
+ "name": "source_record_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "document_key": {
+ "name": "document_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "matched_text": {
+ "name": "matched_text",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_reference_mentions_company_source_issue_idx": {
+ "name": "issue_reference_mentions_company_source_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_reference_mentions_company_target_issue_idx": {
+ "name": "issue_reference_mentions_company_target_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_reference_mentions_company_issue_pair_idx": {
+ "name": "issue_reference_mentions_company_issue_pair_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_reference_mentions_company_source_mention_record_uq": {
+ "name": "issue_reference_mentions_company_source_mention_record_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_record_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issue_reference_mentions\".\"source_record_id\" is not null",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_reference_mentions_company_source_mention_null_record_uq": {
+ "name": "issue_reference_mentions_company_source_mention_null_record_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "target_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issue_reference_mentions\".\"source_record_id\" is null",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_reference_mentions_company_id_companies_id_fk": {
+ "name": "issue_reference_mentions_company_id_companies_id_fk",
+ "tableFrom": "issue_reference_mentions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_reference_mentions_source_issue_id_issues_id_fk": {
+ "name": "issue_reference_mentions_source_issue_id_issues_id_fk",
+ "tableFrom": "issue_reference_mentions",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "source_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_reference_mentions_target_issue_id_issues_id_fk": {
+ "name": "issue_reference_mentions_target_issue_id_issues_id_fk",
+ "tableFrom": "issue_reference_mentions",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "target_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_relations": {
+ "name": "issue_relations",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "related_issue_id": {
+ "name": "related_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "type": {
+ "name": "type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_relations_company_issue_idx": {
+ "name": "issue_relations_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_relations_company_related_issue_idx": {
+ "name": "issue_relations_company_related_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "related_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_relations_company_type_idx": {
+ "name": "issue_relations_company_type_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_relations_company_edge_uq": {
+ "name": "issue_relations_company_edge_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "related_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_relations_company_id_companies_id_fk": {
+ "name": "issue_relations_company_id_companies_id_fk",
+ "tableFrom": "issue_relations",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_relations_issue_id_issues_id_fk": {
+ "name": "issue_relations_issue_id_issues_id_fk",
+ "tableFrom": "issue_relations",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_relations_related_issue_id_issues_id_fk": {
+ "name": "issue_relations_related_issue_id_issues_id_fk",
+ "tableFrom": "issue_relations",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "related_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_relations_created_by_agent_id_agents_id_fk": {
+ "name": "issue_relations_created_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_relations",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_thread_interactions": {
+ "name": "issue_thread_interactions",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "kind": {
+ "name": "kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'pending'"
+ },
+ "continuation_policy": {
+ "name": "continuation_policy",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'wake_assignee'"
+ },
+ "idempotency_key": {
+ "name": "idempotency_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source_comment_id": {
+ "name": "source_comment_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source_run_id": {
+ "name": "source_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "summary": {
+ "name": "summary",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "resolved_by_agent_id": {
+ "name": "resolved_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "resolved_by_user_id": {
+ "name": "resolved_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "payload": {
+ "name": "payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "result": {
+ "name": "result",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "resolved_at": {
+ "name": "resolved_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_thread_interactions_issue_idx": {
+ "name": "issue_thread_interactions_issue_idx",
+ "columns": [
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_thread_interactions_company_issue_created_at_idx": {
+ "name": "issue_thread_interactions_company_issue_created_at_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_thread_interactions_company_issue_status_idx": {
+ "name": "issue_thread_interactions_company_issue_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_thread_interactions_company_issue_idempotency_uq": {
+ "name": "issue_thread_interactions_company_issue_idempotency_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "idempotency_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issue_thread_interactions\".\"idempotency_key\" IS NOT NULL",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_thread_interactions_source_comment_idx": {
+ "name": "issue_thread_interactions_source_comment_idx",
+ "columns": [
+ {
+ "expression": "source_comment_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_thread_interactions_company_id_companies_id_fk": {
+ "name": "issue_thread_interactions_company_id_companies_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_thread_interactions_issue_id_issues_id_fk": {
+ "name": "issue_thread_interactions_issue_id_issues_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_thread_interactions_source_comment_id_issue_comments_id_fk": {
+ "name": "issue_thread_interactions_source_comment_id_issue_comments_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "issue_comments",
+ "columnsFrom": [
+ "source_comment_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_thread_interactions_source_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_thread_interactions_source_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "source_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_thread_interactions_created_by_agent_id_agents_id_fk": {
+ "name": "issue_thread_interactions_created_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_thread_interactions_resolved_by_agent_id_agents_id_fk": {
+ "name": "issue_thread_interactions_resolved_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_thread_interactions",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "resolved_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_tree_hold_members": {
+ "name": "issue_tree_hold_members",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "hold_id": {
+ "name": "hold_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "parent_issue_id": {
+ "name": "parent_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "depth": {
+ "name": "depth",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "issue_identifier": {
+ "name": "issue_identifier",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_title": {
+ "name": "issue_title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "issue_status": {
+ "name": "issue_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "assignee_agent_id": {
+ "name": "assignee_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "assignee_user_id": {
+ "name": "assignee_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "active_run_id": {
+ "name": "active_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "active_run_status": {
+ "name": "active_run_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "skipped": {
+ "name": "skipped",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "skip_reason": {
+ "name": "skip_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_tree_hold_members_hold_issue_uq": {
+ "name": "issue_tree_hold_members_hold_issue_uq",
+ "columns": [
+ {
+ "expression": "hold_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_tree_hold_members_company_issue_idx": {
+ "name": "issue_tree_hold_members_company_issue_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_tree_hold_members_hold_depth_idx": {
+ "name": "issue_tree_hold_members_hold_depth_idx",
+ "columns": [
+ {
+ "expression": "hold_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "depth",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_tree_hold_members_company_id_companies_id_fk": {
+ "name": "issue_tree_hold_members_company_id_companies_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_tree_hold_members_hold_id_issue_tree_holds_id_fk": {
+ "name": "issue_tree_hold_members_hold_id_issue_tree_holds_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "issue_tree_holds",
+ "columnsFrom": [
+ "hold_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_tree_hold_members_issue_id_issues_id_fk": {
+ "name": "issue_tree_hold_members_issue_id_issues_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_tree_hold_members_parent_issue_id_issues_id_fk": {
+ "name": "issue_tree_hold_members_parent_issue_id_issues_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "parent_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_tree_hold_members_assignee_agent_id_agents_id_fk": {
+ "name": "issue_tree_hold_members_assignee_agent_id_agents_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "assignee_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_tree_hold_members_active_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_tree_hold_members_active_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_tree_hold_members",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "active_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_tree_holds": {
+ "name": "issue_tree_holds",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "root_issue_id": {
+ "name": "root_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "mode": {
+ "name": "mode",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "reason": {
+ "name": "reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "release_policy": {
+ "name": "release_policy",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_actor_type": {
+ "name": "created_by_actor_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'system'"
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_at": {
+ "name": "released_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_by_actor_type": {
+ "name": "released_by_actor_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_by_agent_id": {
+ "name": "released_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_by_user_id": {
+ "name": "released_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "released_by_run_id": {
+ "name": "released_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "release_reason": {
+ "name": "release_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "release_metadata": {
+ "name": "release_metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_tree_holds_company_root_status_idx": {
+ "name": "issue_tree_holds_company_root_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "root_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_tree_holds_company_status_mode_idx": {
+ "name": "issue_tree_holds_company_status_mode_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "mode",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_tree_holds_company_id_companies_id_fk": {
+ "name": "issue_tree_holds_company_id_companies_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_tree_holds_root_issue_id_issues_id_fk": {
+ "name": "issue_tree_holds_root_issue_id_issues_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "root_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_tree_holds_created_by_agent_id_agents_id_fk": {
+ "name": "issue_tree_holds_created_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_tree_holds_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_tree_holds_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_tree_holds_released_by_agent_id_agents_id_fk": {
+ "name": "issue_tree_holds_released_by_agent_id_agents_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "released_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_tree_holds_released_by_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_tree_holds_released_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_tree_holds",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "released_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issue_work_products": {
+ "name": "issue_work_products",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "execution_workspace_id": {
+ "name": "execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "runtime_service_id": {
+ "name": "runtime_service_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "type": {
+ "name": "type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "external_id": {
+ "name": "external_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "url": {
+ "name": "url",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "review_state": {
+ "name": "review_state",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'none'"
+ },
+ "is_primary": {
+ "name": "is_primary",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "health_status": {
+ "name": "health_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'unknown'"
+ },
+ "summary": {
+ "name": "summary",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_run_id": {
+ "name": "created_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issue_work_products_company_issue_type_idx": {
+ "name": "issue_work_products_company_issue_type_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_work_products_company_execution_workspace_type_idx": {
+ "name": "issue_work_products_company_execution_workspace_type_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "execution_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_work_products_company_provider_external_id_idx": {
+ "name": "issue_work_products_company_provider_external_id_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "provider",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "external_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issue_work_products_company_updated_idx": {
+ "name": "issue_work_products_company_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issue_work_products_company_id_companies_id_fk": {
+ "name": "issue_work_products_company_id_companies_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issue_work_products_project_id_projects_id_fk": {
+ "name": "issue_work_products_project_id_projects_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_work_products_issue_id_issues_id_fk": {
+ "name": "issue_work_products_issue_id_issues_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "issue_work_products_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "issue_work_products_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_work_products_runtime_service_id_workspace_runtime_services_id_fk": {
+ "name": "issue_work_products_runtime_service_id_workspace_runtime_services_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "workspace_runtime_services",
+ "columnsFrom": [
+ "runtime_service_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issue_work_products_created_by_run_id_heartbeat_runs_id_fk": {
+ "name": "issue_work_products_created_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issue_work_products",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "created_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.issues": {
+ "name": "issues",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "project_workspace_id": {
+ "name": "project_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "parent_id": {
+ "name": "parent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'backlog'"
+ },
+ "priority": {
+ "name": "priority",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'medium'"
+ },
+ "assignee_agent_id": {
+ "name": "assignee_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "assignee_user_id": {
+ "name": "assignee_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "checkout_run_id": {
+ "name": "checkout_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_run_id": {
+ "name": "execution_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_agent_name_key": {
+ "name": "execution_agent_name_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_locked_at": {
+ "name": "execution_locked_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_number": {
+ "name": "issue_number",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "identifier": {
+ "name": "identifier",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "origin_kind": {
+ "name": "origin_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'manual'"
+ },
+ "origin_id": {
+ "name": "origin_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "origin_run_id": {
+ "name": "origin_run_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "origin_fingerprint": {
+ "name": "origin_fingerprint",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'default'"
+ },
+ "request_depth": {
+ "name": "request_depth",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "billing_code": {
+ "name": "billing_code",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "assignee_adapter_overrides": {
+ "name": "assignee_adapter_overrides",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_policy": {
+ "name": "execution_policy",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_state": {
+ "name": "execution_state",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "monitor_next_check_at": {
+ "name": "monitor_next_check_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "monitor_wake_requested_at": {
+ "name": "monitor_wake_requested_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "monitor_last_triggered_at": {
+ "name": "monitor_last_triggered_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "monitor_attempt_count": {
+ "name": "monitor_attempt_count",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 0
+ },
+ "monitor_notes": {
+ "name": "monitor_notes",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "monitor_scheduled_by": {
+ "name": "monitor_scheduled_by",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_workspace_id": {
+ "name": "execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_workspace_preference": {
+ "name": "execution_workspace_preference",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_workspace_settings": {
+ "name": "execution_workspace_settings",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "completed_at": {
+ "name": "completed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cancelled_at": {
+ "name": "cancelled_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "hidden_at": {
+ "name": "hidden_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "issues_company_status_idx": {
+ "name": "issues_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_assignee_status_idx": {
+ "name": "issues_company_assignee_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "assignee_agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_assignee_user_status_idx": {
+ "name": "issues_company_assignee_user_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "assignee_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_parent_idx": {
+ "name": "issues_company_parent_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "parent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_project_idx": {
+ "name": "issues_company_project_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_origin_idx": {
+ "name": "issues_company_origin_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_project_workspace_idx": {
+ "name": "issues_company_project_workspace_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_execution_workspace_idx": {
+ "name": "issues_company_execution_workspace_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "execution_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_company_monitor_due_idx": {
+ "name": "issues_company_monitor_due_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "monitor_next_check_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_identifier_idx": {
+ "name": "issues_identifier_idx",
+ "columns": [
+ {
+ "expression": "identifier",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_title_search_idx": {
+ "name": "issues_title_search_idx",
+ "columns": [
+ {
+ "expression": "title",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last",
+ "opclass": "gin_trgm_ops"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "gin",
+ "with": {}
+ },
+ "issues_identifier_search_idx": {
+ "name": "issues_identifier_search_idx",
+ "columns": [
+ {
+ "expression": "identifier",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last",
+ "opclass": "gin_trgm_ops"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "gin",
+ "with": {}
+ },
+ "issues_description_search_idx": {
+ "name": "issues_description_search_idx",
+ "columns": [
+ {
+ "expression": "description",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last",
+ "opclass": "gin_trgm_ops"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "gin",
+ "with": {}
+ },
+ "issues_open_routine_execution_uq": {
+ "name": "issues_open_routine_execution_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_fingerprint",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'routine_execution'\n and \"issues\".\"origin_id\" is not null\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"execution_run_id\" is not null\n and \"issues\".\"status\" in ('backlog', 'todo', 'in_progress', 'in_review', 'blocked')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_active_liveness_recovery_incident_uq": {
+ "name": "issues_active_liveness_recovery_incident_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'harness_liveness_escalation'\n and \"issues\".\"origin_id\" is not null\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"status\" not in ('done', 'cancelled')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_active_liveness_recovery_leaf_uq": {
+ "name": "issues_active_liveness_recovery_leaf_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_fingerprint",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'harness_liveness_escalation'\n and \"issues\".\"origin_fingerprint\" <> 'default'\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"status\" not in ('done', 'cancelled')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_active_stale_run_evaluation_uq": {
+ "name": "issues_active_stale_run_evaluation_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'stale_active_run_evaluation'\n and \"issues\".\"origin_id\" is not null\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"status\" not in ('done', 'cancelled')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_active_productivity_review_uq": {
+ "name": "issues_active_productivity_review_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'issue_productivity_review'\n and \"issues\".\"origin_id\" is not null\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"status\" not in ('done', 'cancelled')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "issues_active_stranded_issue_recovery_uq": {
+ "name": "issues_active_stranded_issue_recovery_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "origin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"issues\".\"origin_kind\" = 'stranded_issue_recovery'\n and \"issues\".\"origin_id\" is not null\n and \"issues\".\"hidden_at\" is null\n and \"issues\".\"status\" not in ('done', 'cancelled')",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "issues_company_id_companies_id_fk": {
+ "name": "issues_company_id_companies_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_project_id_projects_id_fk": {
+ "name": "issues_project_id_projects_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_project_workspace_id_project_workspaces_id_fk": {
+ "name": "issues_project_workspace_id_project_workspaces_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "project_workspaces",
+ "columnsFrom": [
+ "project_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issues_goal_id_goals_id_fk": {
+ "name": "issues_goal_id_goals_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_parent_id_issues_id_fk": {
+ "name": "issues_parent_id_issues_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "parent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_assignee_agent_id_agents_id_fk": {
+ "name": "issues_assignee_agent_id_agents_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "assignee_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_checkout_run_id_heartbeat_runs_id_fk": {
+ "name": "issues_checkout_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "checkout_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issues_execution_run_id_heartbeat_runs_id_fk": {
+ "name": "issues_execution_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "execution_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "issues_created_by_agent_id_agents_id_fk": {
+ "name": "issues_created_by_agent_id_agents_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "issues_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "issues_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "issues",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.join_requests": {
+ "name": "join_requests",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "invite_id": {
+ "name": "invite_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "request_type": {
+ "name": "request_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'pending_approval'"
+ },
+ "request_ip": {
+ "name": "request_ip",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "requesting_user_id": {
+ "name": "requesting_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "request_email_snapshot": {
+ "name": "request_email_snapshot",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "agent_name": {
+ "name": "agent_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "adapter_type": {
+ "name": "adapter_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "capabilities": {
+ "name": "capabilities",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "agent_defaults_payload": {
+ "name": "agent_defaults_payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "claim_secret_hash": {
+ "name": "claim_secret_hash",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "claim_secret_expires_at": {
+ "name": "claim_secret_expires_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "claim_secret_consumed_at": {
+ "name": "claim_secret_consumed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_agent_id": {
+ "name": "created_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "approved_by_user_id": {
+ "name": "approved_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "approved_at": {
+ "name": "approved_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "rejected_by_user_id": {
+ "name": "rejected_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "rejected_at": {
+ "name": "rejected_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "join_requests_invite_unique_idx": {
+ "name": "join_requests_invite_unique_idx",
+ "columns": [
+ {
+ "expression": "invite_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "join_requests_company_status_type_created_idx": {
+ "name": "join_requests_company_status_type_created_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "request_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "join_requests_pending_human_user_uq": {
+ "name": "join_requests_pending_human_user_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "requesting_user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"join_requests\".\"request_type\" = 'human' AND \"join_requests\".\"status\" = 'pending_approval' AND \"join_requests\".\"requesting_user_id\" IS NOT NULL",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "join_requests_pending_human_email_uq": {
+ "name": "join_requests_pending_human_email_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "lower(\"request_email_snapshot\")",
+ "asc": true,
+ "isExpression": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "where": "\"join_requests\".\"request_type\" = 'human' AND \"join_requests\".\"status\" = 'pending_approval' AND \"join_requests\".\"request_email_snapshot\" IS NOT NULL",
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "join_requests_invite_id_invites_id_fk": {
+ "name": "join_requests_invite_id_invites_id_fk",
+ "tableFrom": "join_requests",
+ "tableTo": "invites",
+ "columnsFrom": [
+ "invite_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "join_requests_company_id_companies_id_fk": {
+ "name": "join_requests_company_id_companies_id_fk",
+ "tableFrom": "join_requests",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "join_requests_created_agent_id_agents_id_fk": {
+ "name": "join_requests_created_agent_id_agents_id_fk",
+ "tableFrom": "join_requests",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.labels": {
+ "name": "labels",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "color": {
+ "name": "color",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "labels_company_idx": {
+ "name": "labels_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "labels_company_name_idx": {
+ "name": "labels_company_name_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "labels_company_id_companies_id_fk": {
+ "name": "labels_company_id_companies_id_fk",
+ "tableFrom": "labels",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_company_settings": {
+ "name": "plugin_company_settings",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "enabled": {
+ "name": "enabled",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": true
+ },
+ "settings_json": {
+ "name": "settings_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "last_error": {
+ "name": "last_error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_company_settings_company_idx": {
+ "name": "plugin_company_settings_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_company_settings_plugin_idx": {
+ "name": "plugin_company_settings_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_company_settings_company_plugin_uq": {
+ "name": "plugin_company_settings_company_plugin_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_company_settings_company_id_companies_id_fk": {
+ "name": "plugin_company_settings_company_id_companies_id_fk",
+ "tableFrom": "plugin_company_settings",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "plugin_company_settings_plugin_id_plugins_id_fk": {
+ "name": "plugin_company_settings_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_company_settings",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_config": {
+ "name": "plugin_config",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "config_json": {
+ "name": "config_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "last_error": {
+ "name": "last_error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_config_plugin_id_idx": {
+ "name": "plugin_config_plugin_id_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_config_plugin_id_plugins_id_fk": {
+ "name": "plugin_config_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_config",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_database_namespaces": {
+ "name": "plugin_database_namespaces",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_key": {
+ "name": "plugin_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "namespace_name": {
+ "name": "namespace_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "namespace_mode": {
+ "name": "namespace_mode",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'schema'"
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_database_namespaces_plugin_idx": {
+ "name": "plugin_database_namespaces_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_database_namespaces_namespace_idx": {
+ "name": "plugin_database_namespaces_namespace_idx",
+ "columns": [
+ {
+ "expression": "namespace_name",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_database_namespaces_status_idx": {
+ "name": "plugin_database_namespaces_status_idx",
+ "columns": [
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_database_namespaces_plugin_id_plugins_id_fk": {
+ "name": "plugin_database_namespaces_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_database_namespaces",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_entities": {
+ "name": "plugin_entities",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "entity_type": {
+ "name": "entity_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_kind": {
+ "name": "scope_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_id": {
+ "name": "scope_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "external_id": {
+ "name": "external_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "data": {
+ "name": "data",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_entities_plugin_idx": {
+ "name": "plugin_entities_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_entities_type_idx": {
+ "name": "plugin_entities_type_idx",
+ "columns": [
+ {
+ "expression": "entity_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_entities_scope_idx": {
+ "name": "plugin_entities_scope_idx",
+ "columns": [
+ {
+ "expression": "scope_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_entities_external_idx": {
+ "name": "plugin_entities_external_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "entity_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "external_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_entities_plugin_id_plugins_id_fk": {
+ "name": "plugin_entities_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_entities",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_job_runs": {
+ "name": "plugin_job_runs",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "job_id": {
+ "name": "job_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "trigger": {
+ "name": "trigger",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'pending'"
+ },
+ "duration_ms": {
+ "name": "duration_ms",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error": {
+ "name": "error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "logs": {
+ "name": "logs",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "finished_at": {
+ "name": "finished_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_job_runs_job_idx": {
+ "name": "plugin_job_runs_job_idx",
+ "columns": [
+ {
+ "expression": "job_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_job_runs_plugin_idx": {
+ "name": "plugin_job_runs_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_job_runs_status_idx": {
+ "name": "plugin_job_runs_status_idx",
+ "columns": [
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_job_runs_job_id_plugin_jobs_id_fk": {
+ "name": "plugin_job_runs_job_id_plugin_jobs_id_fk",
+ "tableFrom": "plugin_job_runs",
+ "tableTo": "plugin_jobs",
+ "columnsFrom": [
+ "job_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "plugin_job_runs_plugin_id_plugins_id_fk": {
+ "name": "plugin_job_runs_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_job_runs",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_jobs": {
+ "name": "plugin_jobs",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "job_key": {
+ "name": "job_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "schedule": {
+ "name": "schedule",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "last_run_at": {
+ "name": "last_run_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "next_run_at": {
+ "name": "next_run_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_jobs_plugin_idx": {
+ "name": "plugin_jobs_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_jobs_next_run_idx": {
+ "name": "plugin_jobs_next_run_idx",
+ "columns": [
+ {
+ "expression": "next_run_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_jobs_unique_idx": {
+ "name": "plugin_jobs_unique_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "job_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_jobs_plugin_id_plugins_id_fk": {
+ "name": "plugin_jobs_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_jobs",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_logs": {
+ "name": "plugin_logs",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "level": {
+ "name": "level",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'info'"
+ },
+ "message": {
+ "name": "message",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "meta": {
+ "name": "meta",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_logs_plugin_time_idx": {
+ "name": "plugin_logs_plugin_time_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_logs_level_idx": {
+ "name": "plugin_logs_level_idx",
+ "columns": [
+ {
+ "expression": "level",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_logs_plugin_id_plugins_id_fk": {
+ "name": "plugin_logs_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_logs",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_migrations": {
+ "name": "plugin_migrations",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_key": {
+ "name": "plugin_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "namespace_name": {
+ "name": "namespace_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "migration_key": {
+ "name": "migration_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "checksum": {
+ "name": "checksum",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_version": {
+ "name": "plugin_version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "applied_at": {
+ "name": "applied_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error_message": {
+ "name": "error_message",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ }
+ },
+ "indexes": {
+ "plugin_migrations_plugin_key_idx": {
+ "name": "plugin_migrations_plugin_key_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "migration_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_migrations_plugin_idx": {
+ "name": "plugin_migrations_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_migrations_status_idx": {
+ "name": "plugin_migrations_status_idx",
+ "columns": [
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_migrations_plugin_id_plugins_id_fk": {
+ "name": "plugin_migrations_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_migrations",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_state": {
+ "name": "plugin_state",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_kind": {
+ "name": "scope_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_id": {
+ "name": "scope_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "namespace": {
+ "name": "namespace",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'default'"
+ },
+ "state_key": {
+ "name": "state_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "value_json": {
+ "name": "value_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_state_plugin_scope_idx": {
+ "name": "plugin_state_plugin_scope_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "scope_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_state_plugin_id_plugins_id_fk": {
+ "name": "plugin_state_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_state",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {
+ "plugin_state_unique_entry_idx": {
+ "name": "plugin_state_unique_entry_idx",
+ "nullsNotDistinct": true,
+ "columns": [
+ "plugin_id",
+ "scope_kind",
+ "scope_id",
+ "namespace",
+ "state_key"
+ ]
+ }
+ },
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_webhook_deliveries": {
+ "name": "plugin_webhook_deliveries",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "webhook_key": {
+ "name": "webhook_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "external_id": {
+ "name": "external_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'pending'"
+ },
+ "duration_ms": {
+ "name": "duration_ms",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "error": {
+ "name": "error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "payload": {
+ "name": "payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "headers": {
+ "name": "headers",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "finished_at": {
+ "name": "finished_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_webhook_deliveries_plugin_idx": {
+ "name": "plugin_webhook_deliveries_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_webhook_deliveries_status_idx": {
+ "name": "plugin_webhook_deliveries_status_idx",
+ "columns": [
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_webhook_deliveries_key_idx": {
+ "name": "plugin_webhook_deliveries_key_idx",
+ "columns": [
+ {
+ "expression": "webhook_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_webhook_deliveries_plugin_id_plugins_id_fk": {
+ "name": "plugin_webhook_deliveries_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_webhook_deliveries",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugins": {
+ "name": "plugins",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "plugin_key": {
+ "name": "plugin_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "package_name": {
+ "name": "package_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "version": {
+ "name": "version",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "api_version": {
+ "name": "api_version",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": true,
+ "default": 1
+ },
+ "categories": {
+ "name": "categories",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "manifest_json": {
+ "name": "manifest_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'installed'"
+ },
+ "install_order": {
+ "name": "install_order",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "package_path": {
+ "name": "package_path",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_error": {
+ "name": "last_error",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "installed_at": {
+ "name": "installed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugins_plugin_key_idx": {
+ "name": "plugins_plugin_key_idx",
+ "columns": [
+ {
+ "expression": "plugin_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugins_status_idx": {
+ "name": "plugins_status_idx",
+ "columns": [
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.principal_permission_grants": {
+ "name": "principal_permission_grants",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "principal_type": {
+ "name": "principal_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "principal_id": {
+ "name": "principal_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "permission_key": {
+ "name": "permission_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope": {
+ "name": "scope",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "granted_by_user_id": {
+ "name": "granted_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "principal_permission_grants_unique_idx": {
+ "name": "principal_permission_grants_unique_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "principal_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "principal_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "permission_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "principal_permission_grants_company_permission_idx": {
+ "name": "principal_permission_grants_company_permission_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "permission_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "principal_permission_grants_company_id_companies_id_fk": {
+ "name": "principal_permission_grants_company_id_companies_id_fk",
+ "tableFrom": "principal_permission_grants",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.project_goals": {
+ "name": "project_goals",
+ "schema": "",
+ "columns": {
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "project_goals_project_idx": {
+ "name": "project_goals_project_idx",
+ "columns": [
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_goals_goal_idx": {
+ "name": "project_goals_goal_idx",
+ "columns": [
+ {
+ "expression": "goal_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_goals_company_idx": {
+ "name": "project_goals_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "project_goals_project_id_projects_id_fk": {
+ "name": "project_goals_project_id_projects_id_fk",
+ "tableFrom": "project_goals",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "project_goals_goal_id_goals_id_fk": {
+ "name": "project_goals_goal_id_goals_id_fk",
+ "tableFrom": "project_goals",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "project_goals_company_id_companies_id_fk": {
+ "name": "project_goals_company_id_companies_id_fk",
+ "tableFrom": "project_goals",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {
+ "project_goals_project_id_goal_id_pk": {
+ "name": "project_goals_project_id_goal_id_pk",
+ "columns": [
+ "project_id",
+ "goal_id"
+ ]
+ }
+ },
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.project_workspaces": {
+ "name": "project_workspaces",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "source_type": {
+ "name": "source_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'local_path'"
+ },
+ "cwd": {
+ "name": "cwd",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "repo_url": {
+ "name": "repo_url",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "repo_ref": {
+ "name": "repo_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "default_ref": {
+ "name": "default_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "visibility": {
+ "name": "visibility",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'default'"
+ },
+ "setup_command": {
+ "name": "setup_command",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cleanup_command": {
+ "name": "cleanup_command",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "remote_provider": {
+ "name": "remote_provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "remote_workspace_ref": {
+ "name": "remote_workspace_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "shared_workspace_key": {
+ "name": "shared_workspace_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "is_primary": {
+ "name": "is_primary",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "project_workspaces_company_project_idx": {
+ "name": "project_workspaces_company_project_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_workspaces_project_primary_idx": {
+ "name": "project_workspaces_project_primary_idx",
+ "columns": [
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "is_primary",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_workspaces_project_source_type_idx": {
+ "name": "project_workspaces_project_source_type_idx",
+ "columns": [
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "source_type",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_workspaces_company_shared_key_idx": {
+ "name": "project_workspaces_company_shared_key_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "shared_workspace_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "project_workspaces_project_remote_ref_idx": {
+ "name": "project_workspaces_project_remote_ref_idx",
+ "columns": [
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "remote_provider",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "remote_workspace_ref",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "project_workspaces_company_id_companies_id_fk": {
+ "name": "project_workspaces_company_id_companies_id_fk",
+ "tableFrom": "project_workspaces",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "project_workspaces_project_id_projects_id_fk": {
+ "name": "project_workspaces_project_id_projects_id_fk",
+ "tableFrom": "project_workspaces",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.projects": {
+ "name": "projects",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "name": {
+ "name": "name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'backlog'"
+ },
+ "lead_agent_id": {
+ "name": "lead_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "target_date": {
+ "name": "target_date",
+ "type": "date",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "color": {
+ "name": "color",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "env": {
+ "name": "env",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "pause_reason": {
+ "name": "pause_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "paused_at": {
+ "name": "paused_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_workspace_policy": {
+ "name": "execution_workspace_policy",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "archived_at": {
+ "name": "archived_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "projects_company_idx": {
+ "name": "projects_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "projects_company_id_companies_id_fk": {
+ "name": "projects_company_id_companies_id_fk",
+ "tableFrom": "projects",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "projects_goal_id_goals_id_fk": {
+ "name": "projects_goal_id_goals_id_fk",
+ "tableFrom": "projects",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "projects_lead_agent_id_agents_id_fk": {
+ "name": "projects_lead_agent_id_agents_id_fk",
+ "tableFrom": "projects",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "lead_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.routine_runs": {
+ "name": "routine_runs",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "routine_id": {
+ "name": "routine_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "trigger_id": {
+ "name": "trigger_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "source": {
+ "name": "source",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'received'"
+ },
+ "triggered_at": {
+ "name": "triggered_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "idempotency_key": {
+ "name": "idempotency_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "trigger_payload": {
+ "name": "trigger_payload",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "dispatch_fingerprint": {
+ "name": "dispatch_fingerprint",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "linked_issue_id": {
+ "name": "linked_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "coalesced_into_run_id": {
+ "name": "coalesced_into_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "failure_reason": {
+ "name": "failure_reason",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "completed_at": {
+ "name": "completed_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "routine_runs_company_routine_idx": {
+ "name": "routine_runs_company_routine_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "routine_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_runs_trigger_idx": {
+ "name": "routine_runs_trigger_idx",
+ "columns": [
+ {
+ "expression": "trigger_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "created_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_runs_dispatch_fingerprint_idx": {
+ "name": "routine_runs_dispatch_fingerprint_idx",
+ "columns": [
+ {
+ "expression": "routine_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "dispatch_fingerprint",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_runs_linked_issue_idx": {
+ "name": "routine_runs_linked_issue_idx",
+ "columns": [
+ {
+ "expression": "linked_issue_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_runs_trigger_idempotency_idx": {
+ "name": "routine_runs_trigger_idempotency_idx",
+ "columns": [
+ {
+ "expression": "trigger_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "idempotency_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "routine_runs_company_id_companies_id_fk": {
+ "name": "routine_runs_company_id_companies_id_fk",
+ "tableFrom": "routine_runs",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routine_runs_routine_id_routines_id_fk": {
+ "name": "routine_runs_routine_id_routines_id_fk",
+ "tableFrom": "routine_runs",
+ "tableTo": "routines",
+ "columnsFrom": [
+ "routine_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routine_runs_trigger_id_routine_triggers_id_fk": {
+ "name": "routine_runs_trigger_id_routine_triggers_id_fk",
+ "tableFrom": "routine_runs",
+ "tableTo": "routine_triggers",
+ "columnsFrom": [
+ "trigger_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routine_runs_linked_issue_id_issues_id_fk": {
+ "name": "routine_runs_linked_issue_id_issues_id_fk",
+ "tableFrom": "routine_runs",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "linked_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.routine_triggers": {
+ "name": "routine_triggers",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "routine_id": {
+ "name": "routine_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "kind": {
+ "name": "kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "label": {
+ "name": "label",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "enabled": {
+ "name": "enabled",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": true
+ },
+ "cron_expression": {
+ "name": "cron_expression",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "timezone": {
+ "name": "timezone",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "next_run_at": {
+ "name": "next_run_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_fired_at": {
+ "name": "last_fired_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "public_id": {
+ "name": "public_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "secret_id": {
+ "name": "secret_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "signing_mode": {
+ "name": "signing_mode",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "replay_window_sec": {
+ "name": "replay_window_sec",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_rotated_at": {
+ "name": "last_rotated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_result": {
+ "name": "last_result",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_agent_id": {
+ "name": "updated_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_user_id": {
+ "name": "updated_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "routine_triggers_company_routine_idx": {
+ "name": "routine_triggers_company_routine_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "routine_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_triggers_company_kind_idx": {
+ "name": "routine_triggers_company_kind_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_triggers_next_run_idx": {
+ "name": "routine_triggers_next_run_idx",
+ "columns": [
+ {
+ "expression": "next_run_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_triggers_public_id_idx": {
+ "name": "routine_triggers_public_id_idx",
+ "columns": [
+ {
+ "expression": "public_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routine_triggers_public_id_uq": {
+ "name": "routine_triggers_public_id_uq",
+ "columns": [
+ {
+ "expression": "public_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "routine_triggers_company_id_companies_id_fk": {
+ "name": "routine_triggers_company_id_companies_id_fk",
+ "tableFrom": "routine_triggers",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routine_triggers_routine_id_routines_id_fk": {
+ "name": "routine_triggers_routine_id_routines_id_fk",
+ "tableFrom": "routine_triggers",
+ "tableTo": "routines",
+ "columnsFrom": [
+ "routine_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routine_triggers_secret_id_company_secrets_id_fk": {
+ "name": "routine_triggers_secret_id_company_secrets_id_fk",
+ "tableFrom": "routine_triggers",
+ "tableTo": "company_secrets",
+ "columnsFrom": [
+ "secret_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routine_triggers_created_by_agent_id_agents_id_fk": {
+ "name": "routine_triggers_created_by_agent_id_agents_id_fk",
+ "tableFrom": "routine_triggers",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routine_triggers_updated_by_agent_id_agents_id_fk": {
+ "name": "routine_triggers_updated_by_agent_id_agents_id_fk",
+ "tableFrom": "routine_triggers",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "updated_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.routines": {
+ "name": "routines",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "goal_id": {
+ "name": "goal_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "parent_issue_id": {
+ "name": "parent_issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "title": {
+ "name": "title",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "description": {
+ "name": "description",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "assignee_agent_id": {
+ "name": "assignee_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "priority": {
+ "name": "priority",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'medium'"
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'active'"
+ },
+ "concurrency_policy": {
+ "name": "concurrency_policy",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'coalesce_if_active'"
+ },
+ "catch_up_policy": {
+ "name": "catch_up_policy",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'skip_missed'"
+ },
+ "variables": {
+ "name": "variables",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "created_by_agent_id": {
+ "name": "created_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_by_user_id": {
+ "name": "created_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_agent_id": {
+ "name": "updated_by_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "updated_by_user_id": {
+ "name": "updated_by_user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_triggered_at": {
+ "name": "last_triggered_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_enqueued_at": {
+ "name": "last_enqueued_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "routines_company_status_idx": {
+ "name": "routines_company_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routines_company_assignee_idx": {
+ "name": "routines_company_assignee_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "assignee_agent_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "routines_company_project_idx": {
+ "name": "routines_company_project_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "routines_company_id_companies_id_fk": {
+ "name": "routines_company_id_companies_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routines_project_id_projects_id_fk": {
+ "name": "routines_project_id_projects_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "routines_goal_id_goals_id_fk": {
+ "name": "routines_goal_id_goals_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "goals",
+ "columnsFrom": [
+ "goal_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routines_parent_issue_id_issues_id_fk": {
+ "name": "routines_parent_issue_id_issues_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "parent_issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routines_assignee_agent_id_agents_id_fk": {
+ "name": "routines_assignee_agent_id_agents_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "assignee_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "routines_created_by_agent_id_agents_id_fk": {
+ "name": "routines_created_by_agent_id_agents_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "created_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "routines_updated_by_agent_id_agents_id_fk": {
+ "name": "routines_updated_by_agent_id_agents_id_fk",
+ "tableFrom": "routines",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "updated_by_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.user_sidebar_preferences": {
+ "name": "user_sidebar_preferences",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "user_id": {
+ "name": "user_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "company_order": {
+ "name": "company_order",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'[]'::jsonb"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "user_sidebar_preferences_user_uq": {
+ "name": "user_sidebar_preferences_user_uq",
+ "columns": [
+ {
+ "expression": "user_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {},
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.workspace_operations": {
+ "name": "workspace_operations",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "execution_workspace_id": {
+ "name": "execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "heartbeat_run_id": {
+ "name": "heartbeat_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "phase": {
+ "name": "phase",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "command": {
+ "name": "command",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cwd": {
+ "name": "cwd",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'running'"
+ },
+ "exit_code": {
+ "name": "exit_code",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_store": {
+ "name": "log_store",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_ref": {
+ "name": "log_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_bytes": {
+ "name": "log_bytes",
+ "type": "bigint",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_sha256": {
+ "name": "log_sha256",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "log_compressed": {
+ "name": "log_compressed",
+ "type": "boolean",
+ "primaryKey": false,
+ "notNull": true,
+ "default": false
+ },
+ "stdout_excerpt": {
+ "name": "stdout_excerpt",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "stderr_excerpt": {
+ "name": "stderr_excerpt",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "metadata": {
+ "name": "metadata",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "finished_at": {
+ "name": "finished_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "workspace_operations_company_run_started_idx": {
+ "name": "workspace_operations_company_run_started_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "heartbeat_run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "started_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "workspace_operations_company_workspace_started_idx": {
+ "name": "workspace_operations_company_workspace_started_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "execution_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "started_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "workspace_operations_company_id_companies_id_fk": {
+ "name": "workspace_operations_company_id_companies_id_fk",
+ "tableFrom": "workspace_operations",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "workspace_operations_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "workspace_operations_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "workspace_operations",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_operations_heartbeat_run_id_heartbeat_runs_id_fk": {
+ "name": "workspace_operations_heartbeat_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "workspace_operations",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "heartbeat_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.workspace_runtime_services": {
+ "name": "workspace_runtime_services",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "project_id": {
+ "name": "project_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "project_workspace_id": {
+ "name": "project_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "execution_workspace_id": {
+ "name": "execution_workspace_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "issue_id": {
+ "name": "issue_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "scope_type": {
+ "name": "scope_type",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "scope_id": {
+ "name": "scope_id",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "service_name": {
+ "name": "service_name",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "status": {
+ "name": "status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "lifecycle": {
+ "name": "lifecycle",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "reuse_key": {
+ "name": "reuse_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "command": {
+ "name": "command",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "cwd": {
+ "name": "cwd",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "port": {
+ "name": "port",
+ "type": "integer",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "url": {
+ "name": "url",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "provider": {
+ "name": "provider",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "provider_ref": {
+ "name": "provider_ref",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "owner_agent_id": {
+ "name": "owner_agent_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "started_by_run_id": {
+ "name": "started_by_run_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "last_used_at": {
+ "name": "last_used_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "started_at": {
+ "name": "started_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "stopped_at": {
+ "name": "stopped_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "stop_policy": {
+ "name": "stop_policy",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": false
+ },
+ "health_status": {
+ "name": "health_status",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'unknown'"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "workspace_runtime_services_company_workspace_status_idx": {
+ "name": "workspace_runtime_services_company_workspace_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "workspace_runtime_services_company_execution_workspace_status_idx": {
+ "name": "workspace_runtime_services_company_execution_workspace_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "execution_workspace_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "workspace_runtime_services_company_project_status_idx": {
+ "name": "workspace_runtime_services_company_project_status_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "project_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "status",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "workspace_runtime_services_run_idx": {
+ "name": "workspace_runtime_services_run_idx",
+ "columns": [
+ {
+ "expression": "started_by_run_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "workspace_runtime_services_company_updated_idx": {
+ "name": "workspace_runtime_services_company_updated_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "updated_at",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "workspace_runtime_services_company_id_companies_id_fk": {
+ "name": "workspace_runtime_services_company_id_companies_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "no action",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_project_id_projects_id_fk": {
+ "name": "workspace_runtime_services_project_id_projects_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "projects",
+ "columnsFrom": [
+ "project_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_project_workspace_id_project_workspaces_id_fk": {
+ "name": "workspace_runtime_services_project_workspace_id_project_workspaces_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "project_workspaces",
+ "columnsFrom": [
+ "project_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_execution_workspace_id_execution_workspaces_id_fk": {
+ "name": "workspace_runtime_services_execution_workspace_id_execution_workspaces_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "execution_workspaces",
+ "columnsFrom": [
+ "execution_workspace_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_issue_id_issues_id_fk": {
+ "name": "workspace_runtime_services_issue_id_issues_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "issues",
+ "columnsFrom": [
+ "issue_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_owner_agent_id_agents_id_fk": {
+ "name": "workspace_runtime_services_owner_agent_id_agents_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "agents",
+ "columnsFrom": [
+ "owner_agent_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ },
+ "workspace_runtime_services_started_by_run_id_heartbeat_runs_id_fk": {
+ "name": "workspace_runtime_services_started_by_run_id_heartbeat_runs_id_fk",
+ "tableFrom": "workspace_runtime_services",
+ "tableTo": "heartbeat_runs",
+ "columnsFrom": [
+ "started_by_run_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "set null",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ },
+ "public.plugin_managed_resources": {
+ "name": "plugin_managed_resources",
+ "schema": "",
+ "columns": {
+ "id": {
+ "name": "id",
+ "type": "uuid",
+ "primaryKey": true,
+ "notNull": true,
+ "default": "gen_random_uuid()"
+ },
+ "company_id": {
+ "name": "company_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_id": {
+ "name": "plugin_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "plugin_key": {
+ "name": "plugin_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "resource_kind": {
+ "name": "resource_kind",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "resource_key": {
+ "name": "resource_key",
+ "type": "text",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "resource_id": {
+ "name": "resource_id",
+ "type": "uuid",
+ "primaryKey": false,
+ "notNull": true
+ },
+ "defaults_json": {
+ "name": "defaults_json",
+ "type": "jsonb",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "'{}'::jsonb"
+ },
+ "created_at": {
+ "name": "created_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ },
+ "updated_at": {
+ "name": "updated_at",
+ "type": "timestamp with time zone",
+ "primaryKey": false,
+ "notNull": true,
+ "default": "now()"
+ }
+ },
+ "indexes": {
+ "plugin_managed_resources_company_idx": {
+ "name": "plugin_managed_resources_company_idx",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_managed_resources_plugin_idx": {
+ "name": "plugin_managed_resources_plugin_idx",
+ "columns": [
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_managed_resources_resource_idx": {
+ "name": "plugin_managed_resources_resource_idx",
+ "columns": [
+ {
+ "expression": "resource_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "resource_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": false,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ },
+ "plugin_managed_resources_company_plugin_resource_uq": {
+ "name": "plugin_managed_resources_company_plugin_resource_uq",
+ "columns": [
+ {
+ "expression": "company_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "plugin_id",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "resource_kind",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ },
+ {
+ "expression": "resource_key",
+ "isExpression": false,
+ "asc": true,
+ "nulls": "last"
+ }
+ ],
+ "isUnique": true,
+ "concurrently": false,
+ "method": "btree",
+ "with": {}
+ }
+ },
+ "foreignKeys": {
+ "plugin_managed_resources_company_id_companies_id_fk": {
+ "name": "plugin_managed_resources_company_id_companies_id_fk",
+ "tableFrom": "plugin_managed_resources",
+ "tableTo": "companies",
+ "columnsFrom": [
+ "company_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ },
+ "plugin_managed_resources_plugin_id_plugins_id_fk": {
+ "name": "plugin_managed_resources_plugin_id_plugins_id_fk",
+ "tableFrom": "plugin_managed_resources",
+ "tableTo": "plugins",
+ "columnsFrom": [
+ "plugin_id"
+ ],
+ "columnsTo": [
+ "id"
+ ],
+ "onDelete": "cascade",
+ "onUpdate": "no action"
+ }
+ },
+ "compositePrimaryKeys": {},
+ "uniqueConstraints": {},
+ "policies": {},
+ "checkConstraints": {},
+ "isRLSEnabled": false
+ }
+ },
+ "enums": {},
+ "schemas": {},
+ "sequences": {},
+ "roles": {},
+ "policies": {},
+ "views": {},
+ "_meta": {
+ "columns": {},
+ "schemas": {},
+ "tables": {}
+ }
+}
diff --git a/packages/db/src/migrations/meta/_journal.json b/packages/db/src/migrations/meta/_journal.json
index f0d21b9988..0c82238a6e 100644
--- a/packages/db/src/migrations/meta/_journal.json
+++ b/packages/db/src/migrations/meta/_journal.json
@@ -533,6 +533,13 @@
"when": 1777572332006,
"tag": "0075_cultured_sebastian_shaw",
"breakpoints": true
+ },
+ {
+ "idx": 76,
+ "version": "7",
+ "when": 1777675301279,
+ "tag": "0076_useful_elektra",
+ "breakpoints": true
}
]
-}
\ No newline at end of file
+}
diff --git a/packages/db/src/schema/index.ts b/packages/db/src/schema/index.ts
index 322a326dfc..7e4a0eb1ba 100644
--- a/packages/db/src/schema/index.ts
+++ b/packages/db/src/schema/index.ts
@@ -65,6 +65,7 @@ export { companySkills } from "./company_skills.js";
export { plugins } from "./plugins.js";
export { pluginConfig } from "./plugin_config.js";
export { pluginCompanySettings } from "./plugin_company_settings.js";
+export { pluginManagedResources } from "./plugin_managed_resources.js";
export { pluginState } from "./plugin_state.js";
export { pluginEntities } from "./plugin_entities.js";
export { pluginDatabaseNamespaces, pluginMigrations } from "./plugin_database.js";
diff --git a/packages/db/src/schema/plugin_managed_resources.ts b/packages/db/src/schema/plugin_managed_resources.ts
new file mode 100644
index 0000000000..ec254d1496
--- /dev/null
+++ b/packages/db/src/schema/plugin_managed_resources.ts
@@ -0,0 +1,34 @@
+import { pgTable, uuid, text, timestamp, jsonb, index, uniqueIndex } from "drizzle-orm/pg-core";
+import { companies } from "./companies.js";
+import { plugins } from "./plugins.js";
+
+export const pluginManagedResources = pgTable(
+ "plugin_managed_resources",
+ {
+ id: uuid("id").primaryKey().defaultRandom(),
+ companyId: uuid("company_id")
+ .notNull()
+ .references(() => companies.id, { onDelete: "cascade" }),
+ pluginId: uuid("plugin_id")
+ .notNull()
+ .references(() => plugins.id, { onDelete: "cascade" }),
+ pluginKey: text("plugin_key").notNull(),
+ resourceKind: text("resource_kind").notNull(),
+ resourceKey: text("resource_key").notNull(),
+ resourceId: uuid("resource_id").notNull(),
+ defaultsJson: jsonb("defaults_json").$type<Record<string, unknown>>().notNull().default({}),
+ createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+ updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow(),
+ },
+ (table) => ({
+ companyIdx: index("plugin_managed_resources_company_idx").on(table.companyId),
+ pluginIdx: index("plugin_managed_resources_plugin_idx").on(table.pluginId),
+ resourceIdx: index("plugin_managed_resources_resource_idx").on(table.resourceKind, table.resourceId),
+ companyPluginResourceUq: uniqueIndex("plugin_managed_resources_company_plugin_resource_uq").on(
+ table.companyId,
+ table.pluginId,
+ table.resourceKind,
+ table.resourceKey,
+ ),
+ }),
+);
diff --git a/packages/plugins/create-paperclip-plugin/README.md b/packages/plugins/create-paperclip-plugin/README.md
index 2429412267..967fe56a91 100644
--- a/packages/plugins/create-paperclip-plugin/README.md
+++ b/packages/plugins/create-paperclip-plugin/README.md
@@ -27,7 +27,7 @@ Generates:
- `esbuild` and `rollup` config files using SDK bundler presets
- dev server script for hot-reload (`paperclip-plugin-dev-server`)
-The scaffold intentionally uses plain React elements rather than host-provided UI kit components, because the current plugin runtime does not ship a stable shared component library yet.
+The scaffold starts with plain React elements so the generated plugin stays minimal. For Paperclip-native controls, import shared host components such as `MarkdownEditor`, `FileTree`, `AssigneePicker`, and `ProjectPicker` from `@paperclipai/plugin-sdk/ui`.
Inside this repo, the generated package uses `@paperclipai/plugin-sdk` via `workspace:*`.
diff --git a/packages/plugins/examples/plugin-file-browser-example/src/ui/index.tsx b/packages/plugins/examples/plugin-file-browser-example/src/ui/index.tsx
index 0e12d903dc..e7088fbc8b 100644
--- a/packages/plugins/examples/plugin-file-browser-example/src/ui/index.tsx
+++ b/packages/plugins/examples/plugin-file-browser-example/src/ui/index.tsx
@@ -1,11 +1,12 @@
import type {
+ FileTreeNode,
PluginProjectSidebarItemProps,
PluginDetailTabProps,
PluginCommentAnnotationProps,
PluginCommentContextMenuItemProps,
} from "@paperclipai/plugin-sdk/ui";
-import { usePluginAction, usePluginData } from "@paperclipai/plugin-sdk/ui";
-import { useMemo, useState, useEffect, useRef, type MouseEvent, type RefObject } from "react";
+import { FileTree, usePluginAction, usePluginData } from "@paperclipai/plugin-sdk/ui";
+import { useCallback, useMemo, useState, useEffect, useRef, type MouseEvent, type RefObject } from "react";
import { EditorView } from "@codemirror/view";
import { basicSetup } from "codemirror";
import { javascript } from "@codemirror/lang-javascript";
@@ -129,15 +130,31 @@ const editorLightHighlightStyle = HighlightStyle.define([
type Workspace = { id: string; projectId: string; name: string; path: string; isPrimary: boolean };
type FileEntry = { name: string; path: string; isDirectory: boolean };
-type FileTreeNodeProps = {
- entry: FileEntry;
- companyId: string | null;
- projectId: string;
- workspaceId: string;
- selectedPath: string | null;
- onSelect: (path: string) => void;
- depth?: number;
-};
+
+function entryToFileTreeNode(entry: FileEntry): FileTreeNode {
+ return {
+ name: entry.name,
+ path: entry.path,
+ kind: entry.isDirectory ? "dir" : "file",
+ children: [],
+ };
+}
+
+function entriesToFileTreeNodes(entries: FileEntry[]): FileTreeNode[] {
+ return entries.map(entryToFileTreeNode);
+}
+
+function setChildrenAtPath(nodes: FileTreeNode[], path: string, children: FileTreeNode[]): FileTreeNode[] {
+ return nodes.map((node) => {
+ if (node.path === path) {
+ return { ...node, children };
+ }
+ if (node.kind === "dir" && node.children.length > 0 && (path === node.path || path.startsWith(`${node.path}/`))) {
+ return { ...node, children: setChildrenAtPath(node.children, path, children) };
+ }
+ return node;
+ });
+}
const PathLikePattern = /[\\/]/;
const WindowsDrivePathPattern = /^[A-Za-z]:[\\/]/;
@@ -235,109 +252,6 @@ function useAvailableHeight(
return height;
}
-function FileTreeNode({
- entry,
- companyId,
- projectId,
- workspaceId,
- selectedPath,
- onSelect,
- depth = 0,
-}: FileTreeNodeProps) {
- const [isExpanded, setIsExpanded] = useState(false);
- const isSelected = selectedPath === entry.path;
-
- if (entry.isDirectory) {
- return (
- <li>
- <button
- type="button"
- className="flex w-full items-center gap-2 rounded-none px-2 py-1.5 text-left text-sm text-foreground hover:bg-accent/60"
- style={{ paddingLeft: `${depth * 14 + 8}px` }}
- onClick={() => setIsExpanded((value) => !value)}
- aria-expanded={isExpanded}
- >
- <span className="w-3 text-xs text-muted-foreground">{isExpanded ? "▾" : "▸"}</span>
- <span className="truncate font-medium">{entry.name}</span>
- </button>
- {isExpanded ? (
- <ExpandedDirectoryChildren
- directoryPath={entry.path}
- companyId={companyId}
- projectId={projectId}
- workspaceId={workspaceId}
- selectedPath={selectedPath}
- onSelect={onSelect}
- depth={depth}
- />
- ) : null}
- </li>
- );
- }
-
- return (
- <li>
- <button
- type="button"
- className={`block w-full rounded-none px-2 py-1.5 text-left text-sm transition-colors ${
- isSelected ? "bg-accent text-foreground" : "text-muted-foreground hover:bg-accent/50 hover:text-foreground"
- }`}
- style={{ paddingLeft: `${depth * 14 + 23}px` }}
- onClick={() => onSelect(entry.path)}
- >
- <span className="truncate">{entry.name}</span>
- </button>
- </li>
- );
-}
-
-function ExpandedDirectoryChildren({
- directoryPath,
- companyId,
- projectId,
- workspaceId,
- selectedPath,
- onSelect,
- depth,
-}: {
- directoryPath: string;
- companyId: string | null;
- projectId: string;
- workspaceId: string;
- selectedPath: string | null;
- onSelect: (path: string) => void;
- depth: number;
-}) {
- const { data: childData } = usePluginData<{ entries: FileEntry[] }>("fileList", {
- companyId,
- projectId,
- workspaceId,
- directoryPath,
- });
- const children = childData?.entries ?? [];
-
- if (children.length === 0) {
- return null;
- }
-
- return (
- <ul className="space-y-0.5">
- {children.map((child) => (
- <FileTreeNode
- key={child.path}
- entry={child}
- companyId={companyId}
- projectId={projectId}
- workspaceId={workspaceId}
- selectedPath={selectedPath}
- onSelect={onSelect}
- depth={depth + 1}
- />
- ))}
- </ul>
- );
-}
-
/**
* Project sidebar item: link "Files" that opens the project detail with the Files plugin tab.
*/
@@ -430,11 +344,60 @@ export function FilesTab({ context }: PluginDetailTabProps) {
() => (selectedWorkspace ? { projectId, companyId, workspaceId: selectedWorkspace.id } : {}),
[companyId, projectId, selectedWorkspace],
);
- const { data: fileListData, loading: fileListLoading } = usePluginData<{ entries: FileEntry[] }>(
+ const { data: fileListData, loading: fileListLoading, error: fileListError } = usePluginData<{ entries: FileEntry[] }>(
"fileList",
fileListParams,
);
- const entries = fileListData?.entries ?? [];
+
+ // Lazy-load directory children through an imperative action so the shared
+ // FileTree can reuse `expandedPaths` for state without spawning a hook per
+ // expanded directory.
+ const loadFileList = usePluginAction("loadFileList");
+ const [nodes, setNodes] = useState<FileTreeNode[]>([]);
+ const [expandedPaths, setExpandedPaths] = useState<Set<string>>(() => new Set());
+ const [loadedDirs, setLoadedDirs] = useState<Set<string>>(() => new Set());
+ const [loadingDirs, setLoadingDirs] = useState<Set<string>>(() => new Set());
+
+ useEffect(() => {
+ setNodes(fileListData?.entries ? entriesToFileTreeNodes(fileListData.entries) : []);
+ setExpandedPaths(new Set());
+ setLoadedDirs(new Set());
+ setLoadingDirs(new Set());
+ }, [fileListData, selectedWorkspace?.id]);
+
+ const handleToggleDir = useCallback(
+ (dirPath: string) => {
+ setExpandedPaths((current) => {
+ const next = new Set(current);
+ if (next.has(dirPath)) next.delete(dirPath);
+ else next.add(dirPath);
+ return next;
+ });
+ if (!selectedWorkspace) return;
+ if (loadedDirs.has(dirPath) || loadingDirs.has(dirPath)) return;
+ setLoadingDirs((current) => new Set(current).add(dirPath));
+ void loadFileList({
+ projectId,
+ companyId,
+ workspaceId: selectedWorkspace.id,
+ directoryPath: dirPath,
+ })
+ .then((response) => {
+ const entries = (response as { entries?: FileEntry[] })?.entries ?? [];
+ const children = entriesToFileTreeNodes(entries);
+ setNodes((current) => setChildrenAtPath(current, dirPath, children));
+ setLoadedDirs((current) => new Set(current).add(dirPath));
+ })
+ .finally(() => {
+ setLoadingDirs((current) => {
+ const next = new Set(current);
+ next.delete(dirPath);
+ return next;
+ });
+ });
+ },
+ [companyId, loadFileList, loadedDirs, loadingDirs, projectId, selectedWorkspace],
+ );
// Track the `?file=` query parameter across navigations (popstate).
const [urlFilePath, setUrlFilePath] = useState<string | null>(() => {
@@ -610,28 +573,23 @@ export function FilesTab({ context }: PluginDetailTabProps) {
</div>
<div className="min-h-0 flex-1 overflow-auto p-2">
{selectedWorkspace ? (
- fileListLoading ? (
- <p className="px-2 py-3 text-sm text-muted-foreground">Loading files...</p>
- ) : entries.length > 0 ? (
- <ul className="space-y-0.5">
- {entries.map((entry) => (
- <FileTreeNode
- key={entry.path}
- entry={entry}
- companyId={companyId}
- projectId={projectId}
- workspaceId={selectedWorkspace.id}
- selectedPath={selectedPath}
- onSelect={(path) => {
- setSelectedPath(path);
- setMobileView("editor");
- }}
- />
- ))}
- </ul>
- ) : (
- <p className="px-2 py-3 text-sm text-muted-foreground">No files found in this workspace.</p>
- )
+ <FileTree
+ nodes={nodes}
+ selectedFile={selectedPath}
+ expandedPaths={expandedPaths}
+ onToggleDir={handleToggleDir}
+ onSelectFile={(path: string) => {
+ setSelectedPath(path);
+ setMobileView("editor");
+ }}
+ loading={fileListLoading}
+ error={fileListError ? { message: fileListError.message } : null}
+ empty={{
+ title: "No files",
+ description: "No files found in this workspace.",
+ }}
+ ariaLabel="Workspace files"
+ />
) : (
<p className="px-2 py-3 text-sm text-muted-foreground">Select a workspace to browse files.</p>
)}
diff --git a/packages/plugins/examples/plugin-file-browser-example/src/worker.ts b/packages/plugins/examples/plugin-file-browser-example/src/worker.ts
index a168983406..cf038cf017 100644
--- a/packages/plugins/examples/plugin-file-browser-example/src/worker.ts
+++ b/packages/plugins/examples/plugin-file-browser-example/src/worker.ts
@@ -106,43 +106,46 @@ const plugin = definePlugin({
}));
});
- ctx.data.register(
- "fileList",
- async (params: Record<string, unknown>) => {
- const projectId = params.projectId as string;
- const companyId = typeof params.companyId === "string" ? params.companyId : "";
- const workspaceId = params.workspaceId as string;
- const directoryPath = typeof params.directoryPath === "string" ? params.directoryPath : "";
- if (!projectId || !companyId || !workspaceId) return { entries: [] };
- const workspaces = await ctx.projects.listWorkspaces(projectId, companyId);
- const workspace = workspaces.find((w) => w.id === workspaceId);
- if (!workspace) return { entries: [] };
- const workspacePath = sanitizeWorkspacePath(workspace.path);
- if (!workspacePath) return { entries: [] };
- const dirPath = resolveWorkspace(workspacePath, directoryPath);
- if (!dirPath) {
- return { entries: [] };
- }
- if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
- return { entries: [] };
- }
- const names = fs.readdirSync(dirPath).sort((a, b) => a.localeCompare(b));
- const entries = names.map((name) => {
- const full = path.join(dirPath, name);
- const stat = fs.lstatSync(full);
- const relativePath = path.relative(workspacePath, full);
- return {
- name,
- path: relativePath,
- isDirectory: stat.isDirectory(),
- };
- }).sort((a, b) => {
- if (a.isDirectory !== b.isDirectory) return a.isDirectory ? -1 : 1;
- return a.name.localeCompare(b.name);
- });
- return { entries };
- },
- );
+ async function readFileList(params: Record<string, unknown>) {
+ const projectId = params.projectId as string;
+ const companyId = typeof params.companyId === "string" ? params.companyId : "";
+ const workspaceId = params.workspaceId as string;
+ const directoryPath = typeof params.directoryPath === "string" ? params.directoryPath : "";
+ if (!projectId || !companyId || !workspaceId) return { entries: [] };
+ const workspaces = await ctx.projects.listWorkspaces(projectId, companyId);
+ const workspace = workspaces.find((w) => w.id === workspaceId);
+ if (!workspace) return { entries: [] };
+ const workspacePath = sanitizeWorkspacePath(workspace.path);
+ if (!workspacePath) return { entries: [] };
+ const dirPath = resolveWorkspace(workspacePath, directoryPath);
+ if (!dirPath) {
+ return { entries: [] };
+ }
+ if (!fs.existsSync(dirPath) || !fs.statSync(dirPath).isDirectory()) {
+ return { entries: [] };
+ }
+ const names = fs.readdirSync(dirPath).sort((a, b) => a.localeCompare(b));
+ const entries = names.map((name) => {
+ const full = path.join(dirPath, name);
+ const stat = fs.lstatSync(full);
+ const relativePath = path.relative(workspacePath, full);
+ return {
+ name,
+ path: relativePath,
+ isDirectory: stat.isDirectory(),
+ };
+ }).sort((a, b) => {
+ if (a.isDirectory !== b.isDirectory) return a.isDirectory ? -1 : 1;
+ return a.name.localeCompare(b.name);
+ });
+ return { entries };
+ }
+
+ ctx.data.register("fileList", readFileList);
+
+ // Mirror `fileList` as an action so the UI can lazily fetch directory
+ // children on tree expand without spawning a usePluginData hook per dir.
+ ctx.actions.register("loadFileList", readFileList);
ctx.data.register(
"fileContent",
diff --git a/packages/plugins/examples/plugin-kitchen-sink-example/src/ui/index.tsx b/packages/plugins/examples/plugin-kitchen-sink-example/src/ui/index.tsx
index 826dd83258..ea3cb491e3 100644
--- a/packages/plugins/examples/plugin-kitchen-sink-example/src/ui/index.tsx
+++ b/packages/plugins/examples/plugin-kitchen-sink-example/src/ui/index.tsx
@@ -1,6 +1,9 @@
import { useEffect, useMemo, useState, type CSSProperties, type FormEvent, type ReactNode } from "react";
import {
+ AssigneePicker,
+ ProjectPicker,
useHostContext,
+ useHostNavigation,
usePluginAction,
usePluginData,
usePluginStream,
@@ -248,14 +251,6 @@ const mutedTextStyle: CSSProperties = {
lineHeight: 1.45,
};
-function hostPath(companyPrefix: string | null | undefined, suffix: string): string {
- return companyPrefix ? `/${companyPrefix}${suffix}` : suffix;
-}
-
-function pluginPagePath(companyPrefix: string | null | undefined): string {
- return hostPath(companyPrefix, `/${PAGE_ROUTE}`);
-}
-
function getErrorMessage(error: unknown): string {
return error instanceof Error ? error.message : String(error);
}
@@ -521,6 +516,7 @@ function CompactSurfaceSummary({ label, entityType }: { label: string; entityTyp
function KitchenSinkPageWidgets({ context }: { context: PluginPageProps["context"] }) {
const overview = usePluginOverview(context.companyId);
const toast = usePluginToast();
+ const hostNavigation = useHostNavigation();
const emitDemoEvent = usePluginAction("emit-demo-event");
const startProgressStream = usePluginAction("start-progress-stream");
const writeMetric = usePluginAction("write-metric");
@@ -591,7 +587,7 @@ function KitchenSinkPageWidgets({ context }: { context: PluginPageProps["context
tone: "info",
action: {
label: "Go",
- href: hostPath(context.companyPrefix, "/dashboard"),
+ href: hostNavigation.resolveHref("/dashboard"),
},
})}
>
@@ -1079,6 +1075,7 @@ function KitchenSinkCompanyCrudDemo({ context }: { context: PluginPageProps["con
}
function KitchenSinkTopRow({ context }: { context: PluginPageProps["context"] }) {
+ const hostNavigation = useHostNavigation();
return (
<div
style={{
@@ -1098,8 +1095,8 @@ function KitchenSinkTopRow({ context }: { context: PluginPageProps["context"] })
<div style={mutedTextStyle}>
The company sidebar entry opens this route directly, so the plugin feels like a first-class company page instead of a settings subpage.
</div>
- <a href={pluginPagePath(context.companyPrefix)} style={{ fontSize: "12px" }}>
- {pluginPagePath(context.companyPrefix)}
+ <a {...hostNavigation.linkProps(`/${PAGE_ROUTE}`)} style={{ fontSize: "12px" }}>
+ {hostNavigation.resolveHref(`/${PAGE_ROUTE}`)}
</a>
</Section>
<Section title="Paperclip Animation">
@@ -1193,6 +1190,7 @@ function KitchenSinkStorageDemo({ context }: { context: PluginPageProps["context
}
function KitchenSinkHostIntegrationDemo({ context }: { context: PluginPageProps["context"] }) {
+ const hostNavigation = useHostNavigation();
const [liveRuns, setLiveRuns] = useState<HostLiveRunRecord[]>([]);
const [recentRuns, setRecentRuns] = useState<HostHeartbeatRunRecord[]>([]);
const [loading, setLoading] = useState(false);
@@ -1228,7 +1226,7 @@ function KitchenSinkHostIntegrationDemo({ context }: { context: PluginPageProps[
<div style={subtleCardStyle}>
<div style={rowStyle}>
<strong>Company Route</strong>
- <Pill label={pluginPagePath(context.companyPrefix)} />
+ <Pill label={hostNavigation.resolveHref(`/${PAGE_ROUTE}`)} />
</div>
<div style={mutedTextStyle}>
This page is mounted as a real company route instead of living only under `/plugins/:pluginId`.
@@ -1260,7 +1258,7 @@ function KitchenSinkHostIntegrationDemo({ context }: { context: PluginPageProps[
</div>
<div>{run.id}</div>
{run.agentId ? (
- <a href={hostPath(context.companyPrefix, `/agents/${run.agentId}/runs/${run.id}`)}>
+ <a {...hostNavigation.linkProps(`/agents/${run.agentId}/runs/${run.id}`)}>
Open run
</a>
) : null}
@@ -1294,6 +1292,44 @@ function KitchenSinkHostIntegrationDemo({ context }: { context: PluginPageProps[
);
}
+function KitchenSinkSharedPickerDemo({ context }: { context: PluginPageProps["context"] }) {
+ const [assigneeValue, setAssigneeValue] = useState("");
+ const [projectId, setProjectId] = useState(context.projectId ?? "");
+
+ useEffect(() => {
+ setProjectId(context.projectId ?? "");
+ }, [context.projectId]);
+
+ return (
+ <Section title="Shared Host Pickers">
+ <div style={mutedTextStyle}>
+ These controls are imported from `@paperclipai/plugin-sdk/ui` and reuse the host's assignee and project pickers from the new issue pane.
+ </div>
+ {!context.companyId ? (
+ <div style={mutedTextStyle}>Select a company to load picker options.</div>
+ ) : (
+ <div style={subtleCardStyle}>
+ <div style={{ display: "flex", flexWrap: "wrap", gap: "8px", alignItems: "center" }}>
+ <AssigneePicker
+ companyId={context.companyId}
+ value={assigneeValue}
+ onChange={(value) => setAssigneeValue(value)}
+ />
+ <ProjectPicker
+ companyId={context.companyId}
+ value={projectId}
+ onChange={setProjectId}
+ />
+ </div>
+ <div style={{ ...mutedTextStyle, marginTop: "8px" }}>
+ Selected assignee: {assigneeValue || "none"}, selected project: {projectId || "none"}
+ </div>
+ </div>
+ )}
+ </Section>
+ );
+}
+
function KitchenSinkEmbeddedApp({ context }: { context: PluginPageProps["context"] }) {
return (
<div style={{ display: "grid", gap: "14px" }}>
@@ -1301,12 +1337,14 @@ function KitchenSinkEmbeddedApp({ context }: { context: PluginPageProps["context
<KitchenSinkStorageDemo context={context} />
<KitchenSinkIssueCrudDemo context={context} />
<KitchenSinkCompanyCrudDemo context={context} />
+ <KitchenSinkSharedPickerDemo context={context} />
<KitchenSinkHostIntegrationDemo context={context} />
</div>
);
}
function KitchenSinkConsole({ context }: { context: { companyId: string | null; companyPrefix?: string | null; projectId?: string | null; entityId?: string | null; entityType?: string | null } }) {
+ const hostNavigation = useHostNavigation();
const companyId = context.companyId;
const overview = usePluginOverview(companyId);
const [companiesLimit, setCompaniesLimit] = useState(20);
@@ -1531,10 +1569,10 @@ function KitchenSinkConsole({ context }: { context: { companyId: string | null;
<Section title="UI Surfaces">
<div style={rowStyle}>
- <a href={pluginPagePath(context.companyPrefix)} style={{ fontSize: "12px" }}>Open plugin page</a>
+ <a {...hostNavigation.linkProps(`/${PAGE_ROUTE}`)} style={{ fontSize: "12px" }}>Open plugin page</a>
{projectRef ? (
<a
- href={hostPath(context.companyPrefix, `/projects/${projectRef}?tab=plugin:${PLUGIN_ID}:${SLOT_IDS.projectTab}`)}
+ {...hostNavigation.linkProps(`/projects/${projectRef}?tab=plugin:${PLUGIN_ID}:${SLOT_IDS.projectTab}`)}
style={{ fontSize: "12px" }}
>
Open project tab
@@ -1542,7 +1580,7 @@ function KitchenSinkConsole({ context }: { context: { companyId: string | null;
) : null}
{selectedIssueId ? (
<a
- href={hostPath(context.companyPrefix, `/issues/${selectedIssueId}`)}
+ {...hostNavigation.linkProps(`/issues/${selectedIssueId}`)}
style={{ fontSize: "12px" }}
>
Open selected issue
@@ -2199,6 +2237,7 @@ export function KitchenSinkSettingsPage({ context }: PluginSettingsPageProps) {
}
export function KitchenSinkDashboardWidget({ context }: PluginWidgetProps) {
+ const hostNavigation = useHostNavigation();
const overview = usePluginOverview(context.companyId);
const writeMetric = usePluginAction("write-metric");
@@ -2217,7 +2256,7 @@ export function KitchenSinkDashboardWidget({ context }: PluginWidgetProps) {
<div>Issues: {overview.data?.counts.issues ?? 0}</div>
</div>
<div style={rowStyle}>
- <a href={pluginPagePath(context.companyPrefix)} style={{ fontSize: "12px" }}>Open page</a>
+ <a {...hostNavigation.linkProps(`/${PAGE_ROUTE}`)} style={{ fontSize: "12px" }}>Open page</a>
<button
type="button"
style={buttonStyle}
@@ -2234,13 +2273,14 @@ export function KitchenSinkDashboardWidget({ context }: PluginWidgetProps) {
}
export function KitchenSinkSidebarLink({ context }: PluginSidebarProps) {
+ const hostNavigation = useHostNavigation();
const config = usePluginConfigData();
if (config.data && config.data.showSidebarEntry === false) return null;
- const href = pluginPagePath(context.companyPrefix);
+ const href = hostNavigation.resolveHref(`/${PAGE_ROUTE}`);
const isActive = typeof window !== "undefined" && window.location.pathname === href;
return (
<a
- href={href}
+ {...hostNavigation.linkProps(`/${PAGE_ROUTE}`)}
aria-current={isActive ? "page" : undefined}
className={[
"flex items-center gap-2.5 px-3 py-2 text-[13px] font-medium transition-colors",
@@ -2267,6 +2307,7 @@ export function KitchenSinkSidebarLink({ context }: PluginSidebarProps) {
export function KitchenSinkSidebarPanel() {
const context = useHostContext();
+ const hostNavigation = useHostNavigation();
const config = usePluginConfigData();
const overview = usePluginOverview(context.companyId);
if (config.data && config.data.showSidebarPanel === false) return null;
@@ -2274,17 +2315,18 @@ export function KitchenSinkSidebarPanel() {
<div style={{ ...layoutStack, ...subtleCardStyle, fontSize: "12px" }}>
<strong>Kitchen Sink Panel</strong>
<div>Recent plugin records: {overview.data?.recentRecords.length ?? 0}</div>
- <a href={pluginPagePath(context.companyPrefix)}>Open plugin page</a>
+ <a {...hostNavigation.linkProps(`/${PAGE_ROUTE}`)}>Open plugin page</a>
</div>
);
}
export function KitchenSinkProjectSidebarItem({ context }: PluginProjectSidebarItemProps) {
+ const hostNavigation = useHostNavigation();
const config = usePluginConfigData();
if (config.data && config.data.showProjectSidebarItem === false) return null;
return (
<a
- href={hostPath(context.companyPrefix, `/projects/${context.entityId}?tab=plugin:${PLUGIN_ID}:${SLOT_IDS.projectTab}`)}
+ {...hostNavigation.linkProps(`/projects/${context.entityId}?tab=plugin:${PLUGIN_ID}:${SLOT_IDS.projectTab}`)}
style={{ fontSize: "12px", textDecoration: "none" }}
>
Kitchen Sink
diff --git a/packages/plugins/sdk/README.md b/packages/plugins/sdk/README.md
index faadc50157..c1f73d98ba 100644
--- a/packages/plugins/sdk/README.md
+++ b/packages/plugins/sdk/README.md
@@ -15,7 +15,7 @@ Reference: `doc/plugins/PLUGIN_SPEC.md`
| Import | Purpose |
|--------|--------|
| `@paperclipai/plugin-sdk` | Worker entry: `definePlugin`, `runWorker`, context types, protocol helpers |
-| `@paperclipai/plugin-sdk/ui` | UI entry: `usePluginData`, `usePluginAction`, `usePluginStream`, `useHostContext`, slot prop types |
+| `@paperclipai/plugin-sdk/ui` | UI entry: `usePluginData`, `usePluginAction`, `usePluginStream`, `useHostContext`, `useHostNavigation`, slot prop types |
| `@paperclipai/plugin-sdk/ui/hooks` | Hooks only |
| `@paperclipai/plugin-sdk/ui/types` | UI types and slot prop interfaces |
| `@paperclipai/plugin-sdk/testing` | `createTestHarness` for unit/integration tests |
@@ -47,7 +47,7 @@ The SDK is stable enough for local development and first-party examples, but the
- For deployed plugins, publish an npm package and install that package into the Paperclip instance at runtime.
- The current host runtime expects a writable filesystem, `npm` available at runtime, and network access to the package registry used for plugin installation.
- Dynamic plugin install is currently best suited to single-node persistent deployments. Multi-instance cloud deployments still need a shared artifact/distribution model before runtime installs are reliable across nodes.
-- The host does not currently ship a real shared React component kit for plugins. Build your plugin UI with ordinary React components and CSS.
+- The host ships a small shared React component kit through `@paperclipai/plugin-sdk/ui`. Use it for native Paperclip controls; custom React and CSS are still supported.
- `ctx.assets` is not part of the supported runtime in this build. Do not depend on asset upload/read APIs yet.
If you are authoring a plugin for others to deploy, treat npm-packaged installation as the supported path and treat repo-local example installs as a development convenience.
@@ -100,12 +100,14 @@ runWorker(plugin, import.meta.url);
| `onValidateConfig?(config)` | Optional. Return `{ ok, warnings?, errors? }` for settings UI / Test Connection. |
| `onWebhook?(input)` | Optional. Handle `POST /api/plugins/:pluginId/webhooks/:endpointKey`; required if webhooks declared. |
-**Context (`ctx`) in setup:** `config`, `events`, `jobs`, `launchers`, `http`, `secrets`, `activity`, `state`, `entities`, `projects`, `companies`, `issues`, `agents`, `goals`, `data`, `actions`, `streams`, `tools`, `metrics`, `logger`, `manifest`. Worker-side host APIs are capability-gated; declare capabilities in the manifest.
+**Context (`ctx`) in setup:** `config`, `localFolders`, `events`, `jobs`, `launchers`, `http`, `secrets`, `activity`, `state`, `entities`, `projects`, `companies`, `issues`, `agents`, `goals`, `data`, `actions`, `streams`, `tools`, `metrics`, `logger`, `manifest`. Worker-side host APIs are capability-gated; declare capabilities in the manifest.
**Agents:** `ctx.agents.invoke(agentId, companyId, opts)` for one-shot invocation. `ctx.agents.sessions` for two-way chat: `create`, `list`, `sendMessage` (with streaming `onEvent` callback), `close`. See the [Plugin Authoring Guide](../../doc/plugins/PLUGIN_AUTHORING_GUIDE.md#agent-sessions-two-way-chat) for details.
**Jobs:** Declare in `manifest.jobs` with `jobKey`, `displayName`, `schedule` (cron). Register handler with `ctx.jobs.register(jobKey, fn)`. **Webhooks:** Declare in `manifest.webhooks` with `endpointKey`; handle in `onWebhook(input)`. **State:** `ctx.state.get/set/delete(scopeKey)`; scope kinds: `instance`, `company`, `project`, `project_workspace`, `agent`, `issue`, `goal`, `run`.
+**Trusted local folders:** Declare `manifest.localFolders[]` and the `local.folders` capability when a plugin needs an operator-configured company-scoped folder. Use `ctx.localFolders.configure()`, `status()`, `readText()`, and `writeTextAtomic()` instead of resolving arbitrary filesystem paths yourself. The host validates absolute roots, read/write access, required relative folders/files, traversal attempts, symlink escapes, and writes through temp-file-plus-rename atomic replacement.
+
## Events
Subscribe in `setup` with `ctx.events.on(name, handler)` or `ctx.events.on(name, filter, handler)`. Emit plugin-scoped events with `ctx.events.emit(name, companyId, payload)` (requires `events.emit`).
@@ -201,12 +203,13 @@ Slots are mount points for plugin React components. Launchers are host-rendered
### Slot types / launcher placement zones
-The same set of values is used as **slot types** (where a component mounts) and **launcher placement zones** (where a launcher can appear). Hierarchy:
+Slot types describe where a component mounts. Most values also exist as launcher placement zones.
| Slot type / placement zone | Scope | Entity types (when context-sensitive) |
|----------------------------|-------|---------------------------------------|
| `page` | Global | — |
| `sidebar` | Global | — |
+| `routeSidebar` | Global | — |
| `sidebarPanel` | Global | — |
| `settingsPage` | Global | — |
| `dashboardWidget` | Global | — |
@@ -233,6 +236,10 @@ A full-page extension mounted at `/plugins/:pluginId` (global) or `/:company/plu
Adds a navigation-style entry to the main company sidebar navigation area, rendered alongside the core nav items (Dashboard, Issues, Goals, etc.). Use this for lightweight, always-visible links or status indicators that feel native to the sidebar. Receives `PluginSidebarProps` with `context.companyId` set to the active company. Requires the `ui.sidebar.register` capability.
+#### `routeSidebar`
+
+Replaces the normal company sidebar while the current route is a plugin page route with the same `routePath`. Use this for full-page plugin workspaces that need their own local navigation while keeping the company rail and account footer. Receives `PluginRouteSidebarProps` with `context.companyId` and `context.companyPrefix` set to the active company. Requires the `ui.sidebar.register` capability.
+
#### `sidebarPanel`
Renders richer inline content in a dedicated panel area below the company sidebar navigation sections. Use this for mini-widgets, summary cards, quick-action panels, or at-a-glance status views that need more vertical space than a nav link. Receives `context.companyId` set to the active company via `useHostContext()`. Requires the `ui.sidebar.register` capability.
@@ -338,6 +345,7 @@ Declare in `manifest.capabilities`. Grouped by scope:
| | `http.outbound` |
| | `secrets.read-ref` |
| | `environment.drivers.register` |
+| | `local.folders` |
| **Agent** | `agent.tools.register` |
| | `agents.invoke` |
| | `agent.sessions.create` |
@@ -372,6 +380,38 @@ only inside the plugin namespace. Runtime `ctx.db.query()` allows `SELECT` from
`ctx.db.execute()` allows `INSERT`, `UPDATE`, and `DELETE` only against the
plugin namespace.
+### Trusted Local Folders
+
+Trusted local plugins can request operator-configured folders per company:
+
+```ts
+export const manifest = {
+ // ...
+ capabilities: ["local.folders"],
+ localFolders: [
+ {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "readWrite",
+ requiredDirectories: ["sources", "pages"],
+ requiredFiles: ["schema.md"],
+ },
+ ],
+};
+```
+
+The host stores the selected path in company-scoped plugin settings and exposes
+readiness through:
+
+- `GET /api/plugins/:pluginId/companies/:companyId/local-folders`
+- `GET /api/plugins/:pluginId/companies/:companyId/local-folders/:folderKey/status`
+- `POST /api/plugins/:pluginId/companies/:companyId/local-folders/:folderKey/validate`
+- `PUT /api/plugins/:pluginId/companies/:companyId/local-folders/:folderKey`
+
+Worker code should access files through `ctx.localFolders.readText()` and
+`ctx.localFolders.writeTextAtomic()`. Relative paths must stay inside the
+configured root; symlinks that escape the root are rejected.
+
### Scoped API Routes
Manifest-declared `apiRoutes` expose JSON routes under
@@ -599,6 +639,23 @@ export function IssueLinearLink({ context }: PluginDetailTabProps) {
}
```
+#### `useHostNavigation()`
+
+Routes Paperclip-internal plugin links through the host router without a full document reload. Use `linkProps()` for anchors so the browser still gets a real `href` for copy-link, modifier-click, middle-click, and open-in-new-tab behavior.
+
+```tsx
+import { useHostNavigation } from "@paperclipai/plugin-sdk/ui";
+
+export function WikiSidebarLink() {
+ const hostNavigation = useHostNavigation();
+ return <a {...hostNavigation.linkProps("/wiki")}>Wiki</a>;
+}
+```
+
+`linkProps("/wiki")` resolves against the active company prefix, so in company `PAP` it renders `href="/PAP/wiki"`. Already-prefixed paths such as `/PAP/wiki` are not prefixed again. For button-style commands, call `hostNavigation.navigate("/issues/PAP-123")`.
+
+Avoid raw same-origin `href`s or `window.location.assign()` for Paperclip-internal navigation from plugin UI. Those bypass the host router and can reload the whole app. External links should keep normal anchors with `target="_blank"` and `rel="noopener noreferrer"` as appropriate.
+
#### `usePluginStream<T>(channel, options?)`
Subscribes to a real-time event stream pushed from the plugin worker via SSE. The worker pushes events using `ctx.streams.emit(channel, event)` and the hook receives them as they arrive. Returns `{ events, lastEvent, connecting, connected, error, close }`.
@@ -629,7 +686,118 @@ The SSE connection targets `GET /api/plugins/:pluginId/bridge/stream/:channel?co
### UI authoring note
-The current host does **not** provide a real shared component library to plugins yet. Use normal React components, your own CSS, or your own small design primitives inside the plugin package.
+The host provides selected shared UI components through `@paperclipai/plugin-sdk/ui`.
+Plugins can also use normal React components, their own CSS, or small design
+primitives inside the plugin package.
+
+Use the shared components when the plugin needs to look and behave like a native
+Paperclip surface:
+
+| Component | Use when |
+|---|---|
+| `MarkdownBlock` | Rendering markdown from plugin or host data |
+| `MarkdownEditor` | Editing markdown with the host editor treatment |
+| `FileTree` | Showing serializable workspace/wiki/import paths |
+| `IssuesList` | Embedding a company-scoped native issue list |
+| `AssigneePicker` | Selecting an agent or board user with the same picker as the new issue pane |
+| `ProjectPicker` | Selecting a project with the same picker as the new issue pane |
+| `ManagedRoutinesList` | Showing plugin-managed routines in settings UI |
+
+#### Shared Markdown Components
+
+Plugin UI can render markdown and edit markdown using the same host components
+used by Paperclip issue comments and documents:
+
+```tsx
+import { MarkdownBlock, MarkdownEditor } from "@paperclipai/plugin-sdk/ui";
+
+export function WikiPageEditor() {
+ const [body, setBody] = useState("# Wiki page");
+
+ return (
+ <>
+ <MarkdownBlock content={body} />
+ <MarkdownEditor value={body} onChange={setBody} bordered />
+ </>
+ );
+}
+```
+
+`MarkdownBlock` can opt into Obsidian-style wikilinks when a plugin owns the
+target URL shape:
+
+```tsx
+<MarkdownBlock
+ content={"See [[wiki/entities/paperclip|Paperclip]]."}
+ enableWikiLinks
+ wikiLinkRoot="/wiki/page"
+/>
+```
+
+#### Shared FileTree
+
+Plugin UI can render the host file tree without importing host internals:
+
+```tsx
+import { FileTree, type FileTreeNode } from "@paperclipai/plugin-sdk/ui";
+
+const nodes: FileTreeNode[] = [
+ { name: "AGENTS.md", path: "AGENTS.md", kind: "file", children: [] },
+ {
+ name: "wiki",
+ path: "wiki",
+ kind: "dir",
+ children: [
+ { name: "index.md", path: "wiki/index.md", kind: "file", children: [] },
+ ],
+ },
+];
+
+export function WikiFiles() {
+ return (
+ <FileTree
+ nodes={nodes}
+ expandedPaths={["wiki"]}
+ selectedFile="wiki/index.md"
+ onToggleDir={(path) => console.log("toggle", path)}
+ onSelectFile={(path) => console.log("select", path)}
+ />
+ );
+}
+```
+
+#### Shared Assignee and Project Pickers
+
+Use `AssigneePicker` and `ProjectPicker` when a plugin needs to create, filter,
+or configure work against Paperclip entities. Both are controlled components and
+load their options from the host for the provided company.
+
+```tsx
+import { AssigneePicker, ProjectPicker } from "@paperclipai/plugin-sdk/ui";
+
+export function AssignmentControls({ companyId }: { companyId: string }) {
+ const [assignee, setAssignee] = useState("");
+ const [projectId, setProjectId] = useState("");
+
+ return (
+ <>
+ <AssigneePicker
+ companyId={companyId}
+ value={assignee}
+ onChange={(value, selection) => {
+ setAssignee(value);
+ console.log(selection.assigneeAgentId, selection.assigneeUserId);
+ }}
+ />
+ <ProjectPicker
+ companyId={companyId}
+ value={projectId}
+ onChange={setProjectId}
+ />
+ </>
+ );
+}
+```
### Slot component props
@@ -639,6 +807,7 @@ Each slot type receives a typed props object with `context: PluginHostContext`.
|-----------|----------------|------------------|
| `page` | `PluginPageProps` | — |
| `sidebar` | `PluginSidebarProps` | — |
+| `routeSidebar` | `PluginRouteSidebarProps` | — |
| `settingsPage` | `PluginSettingsPageProps` | — |
| `dashboardWidget` | `PluginWidgetProps` | — |
| `globalToolbarButton` | `PluginGlobalToolbarButtonProps` | — |
@@ -741,14 +910,17 @@ Plugins can add a link under each project in the sidebar via the `projectSidebar
Minimal React component that links to the project’s plugin tab (see project detail tabs in the spec):
```tsx
-import type { PluginProjectSidebarItemProps } from "@paperclipai/plugin-sdk/ui";
+import {
+ useHostNavigation,
+ type PluginProjectSidebarItemProps,
+} from "@paperclipai/plugin-sdk/ui";
export function FilesLink({ context }: PluginProjectSidebarItemProps) {
+ const hostNavigation = useHostNavigation();
const projectId = context.entityId;
- const prefix = context.companyPrefix ? `/${context.companyPrefix}` : "";
const projectRef = projectId; // or resolve from host; entityId is project id
return (
- <a href={`${prefix}/projects/${projectRef}?tab=plugin:your-plugin:files`}>
+ <a {...hostNavigation.linkProps(`/projects/${projectRef}?tab=plugin:your-plugin:files`)}>
Files
</a>
);
diff --git a/packages/plugins/sdk/src/bundlers.ts b/packages/plugins/sdk/src/bundlers.ts
index b17989e600..e761489c09 100644
--- a/packages/plugins/sdk/src/bundlers.ts
+++ b/packages/plugins/sdk/src/bundlers.ts
@@ -89,11 +89,12 @@ export function createPluginBundlerPresets(input: PluginBundlerPresetInput = {})
const esbuildManifest: EsbuildLikeOptions = {
entryPoints: [manifestEntry],
outdir,
- bundle: false,
+ bundle: true,
format: "esm",
platform: "node",
target: "node20",
sourcemap,
+ external: ["@paperclipai/plugin-sdk"],
};
const esbuildUi = uiEntry
diff --git a/packages/plugins/sdk/src/host-client-factory.ts b/packages/plugins/sdk/src/host-client-factory.ts
index 8e1af813d6..13f0a5925d 100644
--- a/packages/plugins/sdk/src/host-client-factory.ts
+++ b/packages/plugins/sdk/src/host-client-factory.ts
@@ -90,6 +90,16 @@ export interface HostServices {
get(): Promise<Record<string, unknown>>;
};
+ /** Provides trusted company-scoped local folder helpers. */
+ localFolders: {
+ declarations(params: WorkerToHostMethods["localFolders.declarations"][0]): Promise<WorkerToHostMethods["localFolders.declarations"][1]>;
+ configure(params: WorkerToHostMethods["localFolders.configure"][0]): Promise<WorkerToHostMethods["localFolders.configure"][1]>;
+ status(params: WorkerToHostMethods["localFolders.status"][0]): Promise<WorkerToHostMethods["localFolders.status"][1]>;
+ list(params: WorkerToHostMethods["localFolders.list"][0]): Promise<WorkerToHostMethods["localFolders.list"][1]>;
+ readText(params: WorkerToHostMethods["localFolders.readText"][0]): Promise<WorkerToHostMethods["localFolders.readText"][1]>;
+ writeTextAtomic(params: WorkerToHostMethods["localFolders.writeTextAtomic"][0]): Promise<WorkerToHostMethods["localFolders.writeTextAtomic"][1]>;
+ };
+
/** Provides `state.get`, `state.set`, `state.delete`. */
state: {
get(params: WorkerToHostMethods["state.get"][0]): Promise<WorkerToHostMethods["state.get"][1]>;
@@ -165,6 +175,18 @@ export interface HostServices {
listWorkspaces(params: WorkerToHostMethods["projects.listWorkspaces"][0]): Promise<WorkerToHostMethods["projects.listWorkspaces"][1]>;
getPrimaryWorkspace(params: WorkerToHostMethods["projects.getPrimaryWorkspace"][0]): Promise<WorkerToHostMethods["projects.getPrimaryWorkspace"][1]>;
getWorkspaceForIssue(params: WorkerToHostMethods["projects.getWorkspaceForIssue"][0]): Promise<WorkerToHostMethods["projects.getWorkspaceForIssue"][1]>;
+ getManaged(params: WorkerToHostMethods["projects.managed.get"][0]): Promise<WorkerToHostMethods["projects.managed.get"][1]>;
+ reconcileManaged(params: WorkerToHostMethods["projects.managed.reconcile"][0]): Promise<WorkerToHostMethods["projects.managed.reconcile"][1]>;
+ resetManaged(params: WorkerToHostMethods["projects.managed.reset"][0]): Promise<WorkerToHostMethods["projects.managed.reset"][1]>;
+ };
+
+ /** Provides `routines.managed.*`. */
+ routines: {
+ managedGet(params: WorkerToHostMethods["routines.managed.get"][0]): Promise<WorkerToHostMethods["routines.managed.get"][1]>;
+ managedReconcile(params: WorkerToHostMethods["routines.managed.reconcile"][0]): Promise<WorkerToHostMethods["routines.managed.reconcile"][1]>;
+ managedReset(params: WorkerToHostMethods["routines.managed.reset"][0]): Promise<WorkerToHostMethods["routines.managed.reset"][1]>;
+ managedUpdate(params: WorkerToHostMethods["routines.managed.update"][0]): Promise<WorkerToHostMethods["routines.managed.update"][1]>;
+ managedRun(params: WorkerToHostMethods["routines.managed.run"][0]): Promise<WorkerToHostMethods["routines.managed.run"][1]>;
};
/** Provides issue read/write, relation, checkout, wakeup, summary, comment methods. */
@@ -202,6 +224,9 @@ export interface HostServices {
pause(params: WorkerToHostMethods["agents.pause"][0]): Promise<WorkerToHostMethods["agents.pause"][1]>;
resume(params: WorkerToHostMethods["agents.resume"][0]): Promise<WorkerToHostMethods["agents.resume"][1]>;
invoke(params: WorkerToHostMethods["agents.invoke"][0]): Promise<WorkerToHostMethods["agents.invoke"][1]>;
+ managedGet(params: WorkerToHostMethods["agents.managed.get"][0]): Promise<WorkerToHostMethods["agents.managed.get"][1]>;
+ managedReconcile(params: WorkerToHostMethods["agents.managed.reconcile"][0]): Promise<WorkerToHostMethods["agents.managed.reconcile"][1]>;
+ managedReset(params: WorkerToHostMethods["agents.managed.reset"][0]): Promise<WorkerToHostMethods["agents.managed.reset"][1]>;
};
/** Provides `agents.sessions.create`, `agents.sessions.list`, `agents.sessions.sendMessage`, `agents.sessions.close`. */
@@ -281,6 +306,14 @@ const METHOD_CAPABILITY_MAP: Record<WorkerToHostMethodName, PluginCapability | n
// Config — always allowed
"config.get": null,
+ // Trusted local folders
+ "localFolders.declarations": null,
+ "localFolders.configure": "local.folders",
+ "localFolders.status": "local.folders",
+ "localFolders.list": "local.folders",
+ "localFolders.readText": "local.folders",
+ "localFolders.writeTextAtomic": "local.folders",
+
// State
"state.get": "plugin.state.read",
"state.set": "plugin.state.write",
@@ -326,6 +359,14 @@ const METHOD_CAPABILITY_MAP: Record<WorkerToHostMethodName, PluginCapability | n
"projects.listWorkspaces": "project.workspaces.read",
"projects.getPrimaryWorkspace": "project.workspaces.read",
"projects.getWorkspaceForIssue": "project.workspaces.read",
+ "projects.managed.get": "projects.managed",
+ "projects.managed.reconcile": "projects.managed",
+ "projects.managed.reset": "projects.managed",
+ "routines.managed.get": "routines.managed",
+ "routines.managed.reconcile": "routines.managed",
+ "routines.managed.reset": "routines.managed",
+ "routines.managed.update": "routines.managed",
+ "routines.managed.run": "routines.managed",
// Issues
"issues.list": "issues.read",
@@ -357,6 +398,9 @@ const METHOD_CAPABILITY_MAP: Record<WorkerToHostMethodName, PluginCapability | n
"agents.pause": "agents.pause",
"agents.resume": "agents.resume",
"agents.invoke": "agents.invoke",
+ "agents.managed.get": "agents.managed",
+ "agents.managed.reconcile": "agents.managed",
+ "agents.managed.reset": "agents.managed",
// Agent Sessions
"agents.sessions.create": "agent.sessions.create",
@@ -439,6 +483,25 @@ export function createHostClientHandlers(
return services.config.get();
}),
+ "localFolders.declarations": gated("localFolders.declarations", async (params) => {
+ return services.localFolders.declarations(params);
+ }),
+ "localFolders.configure": gated("localFolders.configure", async (params) => {
+ return services.localFolders.configure(params);
+ }),
+ "localFolders.status": gated("localFolders.status", async (params) => {
+ return services.localFolders.status(params);
+ }),
+ "localFolders.list": gated("localFolders.list", async (params) => {
+ return services.localFolders.list(params);
+ }),
+ "localFolders.readText": gated("localFolders.readText", async (params) => {
+ return services.localFolders.readText(params);
+ }),
+ "localFolders.writeTextAtomic": gated("localFolders.writeTextAtomic", async (params) => {
+ return services.localFolders.writeTextAtomic(params);
+ }),
+
// State
"state.get": gated("state.get", async (params) => {
return services.state.get(params);
@@ -530,6 +593,32 @@ export function createHostClientHandlers(
"projects.getWorkspaceForIssue": gated("projects.getWorkspaceForIssue", async (params) => {
return services.projects.getWorkspaceForIssue(params);
}),
+ "projects.managed.get": gated("projects.managed.get", async (params) => {
+ return services.projects.getManaged(params);
+ }),
+ "projects.managed.reconcile": gated("projects.managed.reconcile", async (params) => {
+ return services.projects.reconcileManaged(params);
+ }),
+ "projects.managed.reset": gated("projects.managed.reset", async (params) => {
+ return services.projects.resetManaged(params);
+ }),
+
+ // Routines
+ "routines.managed.get": gated("routines.managed.get", async (params) => {
+ return services.routines.managedGet(params);
+ }),
+ "routines.managed.reconcile": gated("routines.managed.reconcile", async (params) => {
+ return services.routines.managedReconcile(params);
+ }),
+ "routines.managed.reset": gated("routines.managed.reset", async (params) => {
+ return services.routines.managedReset(params);
+ }),
+ "routines.managed.update": gated("routines.managed.update", async (params) => {
+ return services.routines.managedUpdate(params);
+ }),
+ "routines.managed.run": gated("routines.managed.run", async (params) => {
+ return services.routines.managedRun(params);
+ }),
// Issues
"issues.list": gated("issues.list", async (params) => {
@@ -611,6 +700,15 @@ export function createHostClientHandlers(
"agents.invoke": gated("agents.invoke", async (params) => {
return services.agents.invoke(params);
}),
+ "agents.managed.get": gated("agents.managed.get", async (params) => {
+ return services.agents.managedGet(params);
+ }),
+ "agents.managed.reconcile": gated("agents.managed.reconcile", async (params) => {
+ return services.agents.managedReconcile(params);
+ }),
+ "agents.managed.reset": gated("agents.managed.reset", async (params) => {
+ return services.agents.managedReset(params);
+ }),
// Agent Sessions
"agents.sessions.create": gated("agents.sessions.create", async (params) => {
diff --git a/packages/plugins/sdk/src/index.ts b/packages/plugins/sdk/src/index.ts
index 92b60bbfb0..3d0bd07e19 100644
--- a/packages/plugins/sdk/src/index.ts
+++ b/packages/plugins/sdk/src/index.ts
@@ -180,6 +180,13 @@ export type {
export type {
PluginContext,
PluginConfigClient,
+ PluginLocalFolderProblem,
+ PluginLocalFolderStatus,
+ PluginLocalFolderConfigureInput,
+ PluginLocalFolderListOptions,
+ PluginLocalFolderEntry,
+ PluginLocalFolderListing,
+ PluginLocalFoldersClient,
PluginEventsClient,
PluginJobsClient,
PluginLaunchersClient,
@@ -255,6 +262,14 @@ export type {
PluginWebhookDeclaration,
PluginToolDeclaration,
PluginEnvironmentDriverDeclaration,
+ PluginManagedAgentDeclaration,
+ PluginManagedAgentResolution,
+ PluginManagedProjectDeclaration,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineDeclaration,
+ PluginManagedRoutineResolution,
+ PluginManagedResourceKind,
+ PluginManagedResourceRef,
PluginUiSlotDeclaration,
PluginUiDeclaration,
PluginLauncherActionDeclaration,
@@ -264,6 +279,8 @@ export type {
PluginDatabaseDeclaration,
PluginApiRouteCompanyResolution,
PluginApiRouteDeclaration,
+ PluginLocalFolderDeclaration,
+ PluginCompanySettings,
PluginRecord,
PluginDatabaseNamespaceRecord,
PluginMigrationRecord,
diff --git a/packages/plugins/sdk/src/protocol.ts b/packages/plugins/sdk/src/protocol.ts
index 19566570c1..6961c9294b 100644
--- a/packages/plugins/sdk/src/protocol.ts
+++ b/packages/plugins/sdk/src/protocol.ts
@@ -29,8 +29,14 @@ import type {
IssueDocumentSummary,
IssueThreadInteraction,
CreateIssueThreadInteraction,
+ PluginManagedAgentResolution,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineResolution,
+ Routine,
+ RoutineRun,
Agent,
Goal,
+ PluginLocalFolderDeclaration,
} from "@paperclipai/shared";
export type { PluginLauncherRenderContextSnapshot } from "@paperclipai/shared";
@@ -46,6 +52,8 @@ import type {
PluginWorkspace,
ToolRunContext,
ToolResult,
+ PluginLocalFolderListing,
+ PluginLocalFolderStatus,
} from "./types.js";
import type {
PluginHealthDiagnostics,
@@ -566,6 +574,44 @@ export interface WorkerToHostMethods {
// Config
"config.get": [params: Record<string, never>, result: Record<string, unknown>];
+ // Trusted local folders
+ "localFolders.declarations": [
+ params: Record<string, never>,
+ result: PluginLocalFolderDeclaration[],
+ ];
+ "localFolders.configure": [
+ params: {
+ companyId: string;
+ folderKey: string;
+ path: string;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+ },
+ result: PluginLocalFolderStatus,
+ ];
+ "localFolders.status": [
+ params: { companyId: string; folderKey: string },
+ result: PluginLocalFolderStatus,
+ ];
+ "localFolders.list": [
+ params: { companyId: string; folderKey: string; relativePath?: string | null; recursive?: boolean; maxEntries?: number },
+ result: PluginLocalFolderListing,
+ ];
+ "localFolders.readText": [
+ params: { companyId: string; folderKey: string; relativePath: string },
+ result: string,
+ ];
+ "localFolders.writeTextAtomic": [
+ params: {
+ companyId: string;
+ folderKey: string;
+ relativePath: string;
+ contents: string;
+ },
+ result: PluginLocalFolderStatus,
+ ];
+
// State
"state.get": [
params: { scopeKind: string; scopeId?: string; namespace?: string; stateKey: string },
@@ -724,6 +770,57 @@ export interface WorkerToHostMethods {
params: { issueId: string; companyId: string },
result: PluginWorkspace | null,
];
+ "projects.managed.get": [
+ params: { projectKey: string; companyId: string },
+ result: PluginManagedProjectResolution,
+ ];
+ "projects.managed.reconcile": [
+ params: { projectKey: string; companyId: string },
+ result: PluginManagedProjectResolution,
+ ];
+ "projects.managed.reset": [
+ params: { projectKey: string; companyId: string },
+ result: PluginManagedProjectResolution,
+ ];
+ "routines.managed.get": [
+ params: { routineKey: string; companyId: string },
+ result: PluginManagedRoutineResolution,
+ ];
+ "routines.managed.reconcile": [
+ params: {
+ routineKey: string;
+ companyId: string;
+ assigneeAgentId?: string | null;
+ projectId?: string | null;
+ },
+ result: PluginManagedRoutineResolution,
+ ];
+ "routines.managed.reset": [
+ params: {
+ routineKey: string;
+ companyId: string;
+ assigneeAgentId?: string | null;
+ projectId?: string | null;
+ },
+ result: PluginManagedRoutineResolution,
+ ];
+ "routines.managed.update": [
+ params: {
+ routineKey: string;
+ companyId: string;
+ status?: string;
+ },
+ result: Routine,
+ ];
+ "routines.managed.run": [
+ params: {
+ routineKey: string;
+ companyId: string;
+ assigneeAgentId?: string | null;
+ projectId?: string | null;
+ },
+ result: RoutineRun,
+ ];
// Issues
"issues.list": [
@@ -732,8 +829,10 @@ export interface WorkerToHostMethods {
projectId?: string;
assigneeAgentId?: string;
originKind?: string;
+ originKindPrefix?: string;
originId?: string;
status?: string;
+ includePluginOperations?: boolean;
limit?: number;
offset?: number;
},
@@ -758,6 +857,7 @@ export interface WorkerToHostMethods {
assigneeUserId?: string | null;
requestDepth?: number;
billingCode?: string | null;
+ surfaceVisibility?: string | null;
originKind?: string | null;
originId?: string | null;
originRunId?: string | null;
@@ -940,6 +1040,18 @@ export interface WorkerToHostMethods {
params: { agentId: string; companyId: string; prompt: string; reason?: string },
result: { runId: string },
];
+ "agents.managed.get": [
+ params: { agentKey: string; companyId: string },
+ result: PluginManagedAgentResolution,
+ ];
+ "agents.managed.reconcile": [
+ params: { agentKey: string; companyId: string },
+ result: PluginManagedAgentResolution,
+ ];
+ "agents.managed.reset": [
+ params: { agentKey: string; companyId: string },
+ result: PluginManagedAgentResolution,
+ ];
// Agent Sessions
"agents.sessions.create": [
diff --git a/packages/plugins/sdk/src/testing.ts b/packages/plugins/sdk/src/testing.ts
index 16efee05d0..5ed1c1c4fa 100644
--- a/packages/plugins/sdk/src/testing.ts
+++ b/packages/plugins/sdk/src/testing.ts
@@ -1,11 +1,16 @@
import { randomUUID } from "node:crypto";
+import { pluginOperationIssueOriginKind } from "@paperclipai/shared";
import type {
PaperclipPluginManifestV1,
PluginCapability,
PluginEventType,
PluginIssueOriginKind,
+ PluginManagedAgentResolution,
+ PluginManagedRoutineResolution,
Company,
Project,
+ Routine,
+ RoutineRun,
Issue,
IssueComment,
IssueThreadInteraction,
@@ -419,6 +424,8 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
const entityExternalIndex = new Map<string, string>();
const companies = new Map<string, Company>();
const projects = new Map<string, Project>();
+ const routines = new Map<string, Routine>();
+ const routineRuns = new Map<string, RoutineRun>();
const issues = new Map<string, Issue>();
const blockedByIssueIds = new Map<string, string[]>();
const issueComments = new Map<string, IssueComment[]>();
@@ -465,6 +472,53 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
}
const defaultPluginOriginKind: PluginIssueOriginKind = `plugin:${manifest.id}`;
+
+ function managedAgentDeclaration(agentKey: string) {
+ const declaration = manifest.agents?.find((agent) => agent.agentKey === agentKey);
+ if (!declaration) throw new Error(`Managed agent declaration not found: ${agentKey}`);
+ return declaration;
+ }
+
+ function isManagedAgent(agent: Agent, agentKey: string) {
+ const marker = agent.metadata?.paperclipManagedResource;
+ return Boolean(
+ marker
+ && typeof marker === "object"
+ && !Array.isArray(marker)
+ && (marker as Record<string, unknown>).pluginKey === manifest.id
+ && (marker as Record<string, unknown>).resourceKind === "agent"
+ && (marker as Record<string, unknown>).resourceKey === agentKey,
+ );
+ }
+
+ function managedAgentMetadata(agentKey: string, existing?: Record<string, unknown> | null) {
+ return {
+ ...(existing ?? {}),
+ paperclipManagedResource: {
+ pluginKey: manifest.id,
+ resourceKind: "agent",
+ resourceKey: agentKey,
+ },
+ };
+ }
+
+ function managedResolution(
+ agentKey: string,
+ companyId: string,
+ agent: Agent | null,
+ status: PluginManagedAgentResolution["status"],
+ ): PluginManagedAgentResolution {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "agent",
+ resourceKey: agentKey,
+ companyId,
+ agentId: agent?.id ?? null,
+ agent,
+ status,
+ approvalId: null,
+ };
+ }
function normalizePluginOriginKind(originKind: unknown = defaultPluginOriginKind): PluginIssueOriginKind {
if (originKind == null || originKind === "") return defaultPluginOriginKind;
if (typeof originKind !== "string") throw new Error("Plugin issue originKind must be a string");
@@ -481,6 +535,81 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
return { ...currentConfig };
},
},
+ localFolders: {
+ declarations() {
+ return manifest.localFolders ?? [];
+ },
+ async configure(input) {
+ requireCapability(manifest, capabilitySet, "local.folders");
+ return {
+ folderKey: input.folderKey,
+ configured: true,
+ path: input.path,
+ realPath: input.path,
+ access: input.access ?? "readWrite",
+ readable: true,
+ writable: input.access === "read" ? false : true,
+ requiredDirectories: input.requiredDirectories ?? [],
+ requiredFiles: input.requiredFiles ?? [],
+ missingDirectories: [],
+ missingFiles: [],
+ healthy: true,
+ problems: [],
+ checkedAt: new Date().toISOString(),
+ };
+ },
+ async status(_companyId, folderKey) {
+ requireCapability(manifest, capabilitySet, "local.folders");
+ return {
+ folderKey,
+ configured: false,
+ path: null,
+ realPath: null,
+ access: "readWrite",
+ readable: false,
+ writable: false,
+ requiredDirectories: [],
+ requiredFiles: [],
+ missingDirectories: [],
+ missingFiles: [],
+ healthy: false,
+ problems: [{ code: "not_configured", message: "No local folder path is configured." }],
+ checkedAt: new Date().toISOString(),
+ };
+ },
+ async list(_companyId, folderKey, options) {
+ requireCapability(manifest, capabilitySet, "local.folders");
+ return {
+ folderKey,
+ relativePath: options?.relativePath ?? null,
+ entries: [],
+ truncated: false,
+ };
+ },
+ async readText() {
+ requireCapability(manifest, capabilitySet, "local.folders");
+ throw new Error("Test harness local folder readText is not implemented");
+ },
+ async writeTextAtomic(_companyId, folderKey) {
+ requireCapability(manifest, capabilitySet, "local.folders");
+ return {
+ folderKey,
+ configured: false,
+ path: null,
+ realPath: null,
+ access: "readWrite",
+ readable: false,
+ writable: false,
+ requiredDirectories: [],
+ requiredFiles: [],
+ missingDirectories: [],
+ missingFiles: [],
+ healthy: false,
+ problems: [{ code: "not_configured", message: "No local folder path is configured." }],
+ checkedAt: new Date().toISOString(),
+ };
+ },
+ },
events: {
on(name: PluginEventType | `plugin.${string}`, filterOrFn: EventFilter | ((event: PluginEvent) => Promise<void>), maybeFn?: (event: PluginEvent) => Promise<void>): () => void {
requireCapability(manifest, capabilitySet, "events.subscribe");
@@ -647,6 +776,314 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
const workspaces = projectWorkspaces.get(projectId) ?? [];
return workspaces.find((workspace) => workspace.isPrimary) ?? null;
},
+ managed: {
+ async get(projectKey, companyId) {
+ requireCapability(manifest, capabilitySet, "projects.managed");
+ const declaration = manifest.projects?.find((project) => project.projectKey === projectKey);
+ if (!declaration) {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "project",
+ resourceKey: projectKey,
+ companyId,
+ projectId: null,
+ project: null,
+ status: "missing",
+ };
+ }
+ const externalId = `${manifest.id}:project:${projectKey}`;
+ const existingEntity = [...entities.values()].find((entity) =>
+ entity.entityType === "managed_resource"
+ && entity.scopeKind === "company"
+ && entity.scopeId === companyId
+ && entity.externalId === externalId
+ );
+ const existingProject = existingEntity ? projects.get(String(existingEntity.data?.projectId ?? "")) : null;
+ if (existingProject && isInCompany(existingProject, companyId)) {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "project",
+ resourceKey: projectKey,
+ companyId,
+ projectId: existingProject.id,
+ project: existingProject,
+ status: "resolved",
+ };
+ }
+ const now = new Date();
+ const project = {
+ id: `project-${projects.size + 1}`,
+ companyId,
+ urlKey: declaration.projectKey,
+ goalId: null,
+ goalIds: [],
+ goals: [],
+ name: declaration.displayName,
+ description: declaration.description ?? null,
+ status: declaration.status ?? "in_progress",
+ leadAgentId: null,
+ targetDate: null,
+ color: declaration.color ?? null,
+ env: null,
+ pauseReason: null,
+ pausedAt: null,
+ executionWorkspacePolicy: null,
+ codebase: {
+ workspaceId: null,
+ repoUrl: null,
+ repoRef: null,
+ defaultRef: null,
+ repoName: null,
+ localFolder: null,
+ managedFolder: `/tmp/${declaration.projectKey}`,
+ effectiveLocalFolder: `/tmp/${declaration.projectKey}`,
+ origin: "managed_checkout",
+ },
+ workspaces: [],
+ primaryWorkspace: null,
+ managedByPlugin: {
+ id: `managed-${projects.size + 1}`,
+ pluginId: manifest.id,
+ pluginKey: manifest.id,
+ pluginDisplayName: manifest.displayName,
+ resourceKind: "project",
+ resourceKey: projectKey,
+ defaultsJson: { displayName: declaration.displayName, settings: declaration.settings ?? {} },
+ createdAt: now,
+ updatedAt: now,
+ },
+ archivedAt: null,
+ createdAt: now,
+ updatedAt: now,
+ } as Project;
+ projects.set(project.id, project);
+ const externalKey = `managed_resource|company|${companyId}|${externalId}`;
+ const nowIso = now.toISOString();
+ const record: PluginEntityRecord = {
+ id: randomUUID(),
+ entityType: "managed_resource",
+ scopeKind: "company",
+ scopeId: companyId,
+ externalId,
+ title: declaration.displayName,
+ status: null,
+ data: { resourceKind: "project", resourceKey: projectKey, projectId: project.id },
+ createdAt: nowIso,
+ updatedAt: nowIso,
+ };
+ entities.set(record.id, record);
+ entityExternalIndex.set(externalKey, record.id);
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "project",
+ resourceKey: projectKey,
+ companyId,
+ projectId: project.id,
+ project,
+ status: "created",
+ };
+ },
+ async reconcile(projectKey, companyId) {
+ return this.get(projectKey, companyId);
+ },
+ async reset(projectKey, companyId) {
+ const resolved = await this.get(projectKey, companyId);
+ return { ...resolved, status: resolved.project ? "reset" : resolved.status };
+ },
+ },
+ },
+ routines: {
+ managed: {
+ async get(routineKey, companyId) {
+ requireCapability(manifest, capabilitySet, "routines.managed");
+ const declaration = manifest.routines?.find((routine) => routine.routineKey === routineKey);
+ if (!declaration) {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ companyId,
+ routineId: null,
+ routine: null,
+ status: "missing",
+ missingRefs: [],
+ } satisfies PluginManagedRoutineResolution;
+ }
+ const externalId = `${manifest.id}:routine:${routineKey}`;
+ const existingEntity = [...entities.values()].find((entity) =>
+ entity.entityType === "managed_resource"
+ && entity.scopeKind === "company"
+ && entity.scopeId === companyId
+ && entity.externalId === externalId
+ );
+ const existingRoutine = existingEntity ? routines.get(String(existingEntity.data?.routineId ?? "")) : null;
+ if (existingRoutine && isInCompany(existingRoutine, companyId)) {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ companyId,
+ routineId: existingRoutine.id,
+ routine: existingRoutine,
+ status: "resolved",
+ missingRefs: [],
+ } satisfies PluginManagedRoutineResolution;
+ }
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ companyId,
+ routineId: null,
+ routine: null,
+ status: "missing",
+ missingRefs: [],
+ } satisfies PluginManagedRoutineResolution;
+ },
+ async reconcile(routineKey, companyId, overrides) {
+ const existing = await this.get(routineKey, companyId);
+ if (existing.routine) return existing;
+ const declaration = manifest.routines?.find((routine) => routine.routineKey === routineKey);
+ if (!declaration) return existing;
+ const now = new Date();
+ const agentRef = declaration.assigneeRef;
+ const projectRef = declaration.projectRef;
+ const assigneeAgentId = overrides?.assigneeAgentId
+ ?? (agentRef?.resourceKind === "agent"
+ ? [...agents.values()].find((agent) => isInCompany(agent, companyId) && isManagedAgent(agent, agentRef.resourceKey))?.id
+ : null)
+ ?? null;
+ const projectId = overrides?.projectId
+ ?? (projectRef?.resourceKind === "project"
+ ? [...projects.values()].find((project) => (
+ isInCompany(project, companyId)
+ && project.managedByPlugin?.pluginKey === manifest.id
+ && project.managedByPlugin?.resourceKey === projectRef.resourceKey
+ ))?.id
+ : null)
+ ?? null;
+ const missingRefs: NonNullable<PluginManagedRoutineResolution["missingRefs"]> = [];
+ if (agentRef && !assigneeAgentId) missingRefs.push({ ...agentRef, pluginKey: manifest.id });
+ if (projectRef && !projectId) missingRefs.push({ ...projectRef, pluginKey: manifest.id });
+ if (missingRefs.length > 0) {
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ companyId,
+ routineId: null,
+ routine: null,
+ status: "missing_refs",
+ missingRefs,
+ } satisfies PluginManagedRoutineResolution;
+ }
+ const routine = {
+ id: `routine-${routines.size + 1}`,
+ companyId,
+ projectId,
+ goalId: declaration.goalId ?? null,
+ parentIssueId: null,
+ title: declaration.title,
+ description: declaration.description ?? null,
+ assigneeAgentId,
+ priority: declaration.priority ?? "medium",
+ status: declaration.status ?? (assigneeAgentId ? "active" : "paused"),
+ concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+ catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+ variables: declaration.variables ?? [],
+ createdByAgentId: null,
+ createdByUserId: null,
+ updatedByAgentId: null,
+ updatedByUserId: null,
+ lastTriggeredAt: null,
+ lastEnqueuedAt: null,
+ createdAt: now,
+ updatedAt: now,
+ managedByPlugin: {
+ id: `managed-routine-${routines.size + 1}`,
+ pluginId: manifest.id,
+ pluginKey: manifest.id,
+ pluginDisplayName: manifest.displayName,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ defaultsJson: { title: declaration.title, issueTemplate: declaration.issueTemplate ?? null },
+ createdAt: now,
+ updatedAt: now,
+ },
+ } as Routine;
+ routines.set(routine.id, routine);
+ const nowIso = now.toISOString();
+ const record: PluginEntityRecord = {
+ id: randomUUID(),
+ entityType: "managed_resource",
+ scopeKind: "company",
+ scopeId: companyId,
+ externalId: `${manifest.id}:routine:${routineKey}`,
+ title: declaration.title,
+ status: null,
+ data: { resourceKind: "routine", resourceKey: routineKey, routineId: routine.id },
+ createdAt: nowIso,
+ updatedAt: nowIso,
+ };
+ entities.set(record.id, record);
+ return {
+ pluginKey: manifest.id,
+ resourceKind: "routine",
+ resourceKey: routineKey,
+ companyId,
+ routineId: routine.id,
+ routine,
+ status: "created",
+ missingRefs: [],
+ } satisfies PluginManagedRoutineResolution;
+ },
+ async reset(routineKey, companyId, overrides) {
+ const resolved = await this.reconcile(routineKey, companyId, overrides);
+ return { ...resolved, status: resolved.routine ? "reset" : resolved.status } satisfies PluginManagedRoutineResolution;
+ },
+ async update(routineKey, companyId, patch) {
+ const resolved = await this.get(routineKey, companyId);
+ if (!resolved.routine) throw new Error(`Managed routine not found: ${routineKey}`);
+ const next = {
+ ...resolved.routine,
+ ...(patch.status !== undefined ? { status: patch.status } : {}),
+ updatedAt: new Date(),
+ };
+ routines.set(next.id, next);
+ return next;
+ },
+ async run(routineKey, companyId) {
+ const resolved = await this.get(routineKey, companyId);
+ if (!resolved.routine) throw new Error(`Managed routine not found: ${routineKey}`);
+ const now = new Date();
+ const run = {
+ id: `routine-run-${routineRuns.size + 1}`,
+ companyId,
+ routineId: resolved.routine.id,
+ triggerId: null,
+ source: "manual",
+ status: "queued",
+ triggeredAt: now,
+ idempotencyKey: null,
+ triggerPayload: null,
+ dispatchFingerprint: null,
+ linkedIssueId: null,
+ coalescedIntoRunId: null,
+ failureReason: null,
+ completedAt: null,
+ createdAt: now,
+ updatedAt: now,
+ } satisfies RoutineRun;
+ routineRuns.set(run.id, run);
+ routines.set(resolved.routine.id, {
+ ...resolved.routine,
+ lastTriggeredAt: now,
+ lastEnqueuedAt: now,
+ updatedAt: now,
+ });
+ return run;
+ },
+ },
},
companies: {
async list(input) {
@@ -673,6 +1110,12 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
if (input.originKind.startsWith("plugin:")) normalizePluginOriginKind(input.originKind);
out = out.filter((issue) => issue.originKind === input.originKind);
}
+ if (input?.originKindPrefix) {
+ const prefix = input.originKindPrefix;
+ out = out.filter((issue) =>
+ typeof issue.originKind === "string" && issue.originKind.startsWith(prefix),
+ );
+ }
if (input?.originId) out = out.filter((issue) => issue.originId === input.originId);
if (input?.status) out = out.filter((issue) => issue.status === input.status);
if (input?.offset) out = out.slice(input.offset);
@@ -687,6 +1130,11 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
async create(input) {
requireCapability(manifest, capabilitySet, "issues.create");
const now = new Date();
+ const originKind = normalizePluginOriginKind(
+ input.surfaceVisibility === "plugin_operation" && !input.originKind
+ ? pluginOperationIssueOriginKind(manifest.id)
+ : input.originKind,
+ );
const record: Issue = {
id: randomUUID(),
companyId: input.companyId,
@@ -708,7 +1156,7 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
createdByUserId: null,
issueNumber: null,
identifier: null,
- originKind: normalizePluginOriginKind(input.originKind),
+ originKind,
originId: input.originId ?? null,
originRunId: input.originRunId ?? null,
requestDepth: input.requestDepth ?? 0,
@@ -1064,6 +1512,115 @@ export function createTestHarness(options: TestHarnessOptions): TestHarness {
}
return { runId: randomUUID() };
},
+ managed: {
+ async get(agentKey, companyId) {
+ requireCapability(manifest, capabilitySet, "agents.managed");
+ const cid = requireCompanyId(companyId);
+ managedAgentDeclaration(agentKey);
+ const agent = [...agents.values()].find((candidate) =>
+ candidate.companyId === cid &&
+ candidate.status !== "terminated" &&
+ isManagedAgent(candidate, agentKey),
+ ) ?? null;
+ return managedResolution(agentKey, cid, agent, agent ? "resolved" : "missing");
+ },
+ async reconcile(agentKey, companyId) {
+ requireCapability(manifest, capabilitySet, "agents.managed");
+ const cid = requireCompanyId(companyId);
+ const declaration = managedAgentDeclaration(agentKey);
+ const existingAgent = [...agents.values()].find((candidate) =>
+ candidate.companyId === cid &&
+ candidate.status !== "terminated" &&
+ isManagedAgent(candidate, agentKey),
+ ) ?? null;
+ const existing = managedResolution(agentKey, cid, existingAgent, existingAgent ? "resolved" : "missing");
+ if (existing.agent) return existing;
+ const now = new Date();
+ const created: Agent = {
+ id: randomUUID(),
+ companyId: cid,
+ name: declaration.displayName,
+ urlKey: declaration.displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, ""),
+ role: (declaration.role ?? "general") as Agent["role"],
+ title: declaration.title ?? null,
+ icon: declaration.icon ?? null,
+ status: declaration.status ?? "idle",
+ reportsTo: null,
+ capabilities: declaration.capabilities ?? null,
+ adapterType: (declaration.adapterType ?? "process") as Agent["adapterType"],
+ adapterConfig: declaration.adapterConfig ?? {},
+ runtimeConfig: declaration.runtimeConfig ?? {},
+ budgetMonthlyCents: declaration.budgetMonthlyCents ?? 0,
+ spentMonthlyCents: 0,
+ pauseReason: null,
+ pausedAt: null,
+ permissions: { canCreateAgents: Boolean(declaration.permissions?.canCreateAgents) },
+ lastHeartbeatAt: null,
+ metadata: managedAgentMetadata(agentKey),
+ createdAt: now,
+ updatedAt: now,
+ };
+ agents.set(created.id, created);
+ return managedResolution(agentKey, cid, created, "created");
+ },
+ async reset(agentKey, companyId) {
+ requireCapability(manifest, capabilitySet, "agents.managed");
+ const cid = requireCompanyId(companyId);
+ const declaration = managedAgentDeclaration(agentKey);
+ let agent = [...agents.values()].find((candidate) =>
+ candidate.companyId === cid &&
+ candidate.status !== "terminated" &&
+ isManagedAgent(candidate, agentKey),
+ ) ?? null;
+ if (!agent) {
+ const now = new Date();
+ agent = {
+ id: randomUUID(),
+ companyId: cid,
+ name: declaration.displayName,
+ urlKey: declaration.displayName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, ""),
+ role: (declaration.role ?? "general") as Agent["role"],
+ title: declaration.title ?? null,
+ icon: declaration.icon ?? null,
+ status: declaration.status ?? "idle",
+ reportsTo: null,
+ capabilities: declaration.capabilities ?? null,
+ adapterType: (declaration.adapterType ?? "process") as Agent["adapterType"],
+ adapterConfig: declaration.adapterConfig ?? {},
+ runtimeConfig: declaration.runtimeConfig ?? {},
+ budgetMonthlyCents: declaration.budgetMonthlyCents ?? 0,
+ spentMonthlyCents: 0,
+ pauseReason: null,
+ pausedAt: null,
+ permissions: { canCreateAgents: Boolean(declaration.permissions?.canCreateAgents) },
+ lastHeartbeatAt: null,
+ metadata: managedAgentMetadata(agentKey),
+ createdAt: now,
+ updatedAt: now,
+ };
+ agents.set(agent.id, agent);
+ }
+ const resolved = managedResolution(agentKey, cid, agent, "resolved");
+ if (!resolved.agent) return resolved;
+ const updated: Agent = {
+ ...resolved.agent,
+ name: declaration.displayName,
+ role: (declaration.role ?? "general") as Agent["role"],
+ title: declaration.title ?? null,
+ icon: declaration.icon ?? null,
+ capabilities: declaration.capabilities ?? null,
+ adapterType: (declaration.adapterType ?? "process") as Agent["adapterType"],
+ adapterConfig: declaration.adapterConfig ?? {},
+ runtimeConfig: declaration.runtimeConfig ?? {},
+ budgetMonthlyCents: declaration.budgetMonthlyCents ?? 0,
+ permissions: { canCreateAgents: Boolean(declaration.permissions?.canCreateAgents) },
+ metadata: managedAgentMetadata(agentKey, resolved.agent.metadata),
+ updatedAt: new Date(),
+ };
+ agents.set(updated.id, updated);
+ return managedResolution(agentKey, cid, updated, "reset");
+ },
+ },
sessions: {
async create(agentId, companyId, opts) {
requireCapability(manifest, capabilitySet, "agent.sessions.create");
diff --git a/packages/plugins/sdk/src/types.ts b/packages/plugins/sdk/src/types.ts
index 599a06ecac..f4a946f9ec 100644
--- a/packages/plugins/sdk/src/types.ts
+++ b/packages/plugins/sdk/src/types.ts
@@ -28,6 +28,12 @@ import type {
RequestConfirmationInteraction,
CreateIssueThreadInteraction,
PluginIssueOriginKind,
+ IssueSurfaceVisibility,
+ PluginManagedAgentResolution,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineResolution,
+ Routine,
+ RoutineRun,
Agent,
Goal,
} from "@paperclipai/shared";
@@ -42,6 +48,18 @@ export type {
PluginWebhookDeclaration,
PluginToolDeclaration,
PluginEnvironmentDriverDeclaration,
+ PluginManagedAgentDeclaration,
+ PluginManagedAgentResolution,
+ PluginManagedProjectDeclaration,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineDeclaration,
+ PluginManagedRoutineResolution,
+ Routine,
+ RoutineRun,
+ PluginLocalFolderDeclaration,
+ PluginCompanySettings,
+ PluginManagedResourceKind,
+ PluginManagedResourceRef,
PluginUiSlotDeclaration,
PluginUiDeclaration,
PluginLauncherActionDeclaration,
@@ -92,6 +110,7 @@ export type {
RequestConfirmationInteraction,
CreateIssueThreadInteraction,
PluginIssueOriginKind,
+ IssueSurfaceVisibility,
Agent,
Goal,
} from "@paperclipai/shared";
@@ -349,6 +368,90 @@ export interface PluginConfigClient {
get(): Promise<Record<string, unknown>>;
}
+export interface PluginLocalFolderProblem {
+ code:
+ | "not_configured"
+ | "not_absolute"
+ | "missing"
+ | "not_directory"
+ | "not_readable"
+ | "not_writable"
+ | "missing_directory"
+ | "missing_file"
+ | "path_traversal"
+ | "symlink_escape"
+ | "atomic_write_failed";
+ message: string;
+ path?: string;
+}
+
+export interface PluginLocalFolderStatus {
+ folderKey: string;
+ configured: boolean;
+ path: string | null;
+ realPath: string | null;
+ access: "read" | "readWrite";
+ readable: boolean;
+ writable: boolean;
+ requiredDirectories: string[];
+ requiredFiles: string[];
+ missingDirectories: string[];
+ missingFiles: string[];
+ healthy: boolean;
+ problems: PluginLocalFolderProblem[];
+ checkedAt: string;
+}
+
+export interface PluginLocalFolderConfigureInput {
+ companyId: string;
+ folderKey: string;
+ path: string;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+}
+
+export interface PluginLocalFolderListOptions {
+ relativePath?: string | null;
+ recursive?: boolean;
+ maxEntries?: number;
+}
+
+export interface PluginLocalFolderEntry {
+ path: string;
+ name: string;
+ kind: "file" | "directory";
+ size: number | null;
+ modifiedAt: string | null;
+}
+
+export interface PluginLocalFolderListing {
+ folderKey: string;
+ relativePath: string | null;
+ entries: PluginLocalFolderEntry[];
+ truncated: boolean;
+}
+
+export interface PluginLocalFoldersClient {
+ /** Manifest-declared local folders for this plugin. */
+ declarations(): import("@paperclipai/shared").PluginLocalFolderDeclaration[];
+ /** Persist a company-scoped local folder path after validating it. */
+ configure(input: PluginLocalFolderConfigureInput): Promise<PluginLocalFolderStatus>;
+ /** Check the stored folder readiness for a company and folder key. */
+ status(companyId: string, folderKey: string): Promise<PluginLocalFolderStatus>;
+ /** List entries below a configured folder after containment checks. */
+ list(companyId: string, folderKey: string, options?: PluginLocalFolderListOptions): Promise<PluginLocalFolderListing>;
+ /** Read a UTF-8 text file below a configured folder after containment checks. */
+ readText(companyId: string, folderKey: string, relativePath: string): Promise<string>;
+ /** Write a UTF-8 text file below a configured folder using atomic rename. */
+ writeTextAtomic(
+ companyId: string,
+ folderKey: string,
+ relativePath: string,
+ contents: string,
+ ): Promise<PluginLocalFolderStatus>;
+}
+
/**
* `ctx.events` — subscribe to and emit Paperclip domain events.
*
@@ -697,6 +800,44 @@ export interface PluginProjectsClient {
* @see PLUGIN_SPEC.md §20 — Local Tooling
*/
getWorkspaceForIssue(issueId: string, companyId: string): Promise<PluginWorkspace | null>;
+
+ /** Resolve and reconcile manifest-declared plugin-managed projects by stable key. Requires `projects.managed`. */
+ managed: {
+ get(projectKey: string, companyId: string): Promise<PluginManagedProjectResolution>;
+ reconcile(projectKey: string, companyId: string): Promise<PluginManagedProjectResolution>;
+ reset(projectKey: string, companyId: string): Promise<PluginManagedProjectResolution>;
+ };
+}
+
+/**
+ * `ctx.routines` — resolve and reconcile plugin-managed Paperclip routines.
+ *
+ * Requires `routines.managed` capability.
+ */
+export interface PluginRoutinesClient {
+ managed: {
+ get(routineKey: string, companyId: string): Promise<PluginManagedRoutineResolution>;
+ reconcile(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ): Promise<PluginManagedRoutineResolution>;
+ reset(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ): Promise<PluginManagedRoutineResolution>;
+ update(
+ routineKey: string,
+ companyId: string,
+ patch: { status?: string },
+ ): Promise<Routine>;
+ run(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ): Promise<RoutineRun>;
+ };
}
/**
@@ -1099,8 +1240,10 @@ export interface PluginIssuesClient {
projectId?: string;
assigneeAgentId?: string;
originKind?: PluginIssueOriginKind;
+ originKindPrefix?: string;
originId?: string;
status?: Issue["status"];
+ includePluginOperations?: boolean;
limit?: number;
offset?: number;
}): Promise<Issue[]>;
@@ -1119,6 +1262,7 @@ export interface PluginIssuesClient {
assigneeUserId?: string | null;
requestDepth?: number;
billingCode?: string | null;
+ surfaceVisibility?: IssueSurfaceVisibility;
originKind?: PluginIssueOriginKind;
originId?: string | null;
originRunId?: string | null;
@@ -1241,6 +1385,12 @@ export interface PluginAgentsClient {
resume(agentId: string, companyId: string): Promise<Agent>;
/** Invoke (wake up) an agent with a prompt payload. Throws if paused, terminated, pending_approval, or not found. Requires `agents.invoke`. */
invoke(agentId: string, companyId: string, opts: { prompt: string; reason?: string }): Promise<{ runId: string }>;
+ /** Resolve and reconcile manifest-declared plugin-managed agents by stable key. Requires `agents.managed`. */
+ managed: {
+ get(agentKey: string, companyId: string): Promise<PluginManagedAgentResolution>;
+ reconcile(agentKey: string, companyId: string): Promise<PluginManagedAgentResolution>;
+ reset(agentKey: string, companyId: string): Promise<PluginManagedAgentResolution>;
+ };
/** Create, message, and close agent chat sessions. Requires `agent.sessions.*` capabilities. */
sessions: PluginAgentSessionsClient;
}
@@ -1436,6 +1586,9 @@ export interface PluginContext {
/** Read resolved operator configuration. */
config: PluginConfigClient;
+ /** Configure and safely access trusted company-scoped local folders. */
+ localFolders: PluginLocalFoldersClient;
+
/** Subscribe to and emit domain events. Requires `events.subscribe` / `events.emit`. */
events: PluginEventsClient;
@@ -1466,6 +1619,9 @@ export interface PluginContext {
/** Read project and workspace metadata. Requires `projects.read` / `project.workspaces.read`. */
projects: PluginProjectsClient;
+ /** Resolve and reconcile plugin-managed routines. Requires `routines.managed`. */
+ routines: PluginRoutinesClient;
+
/** Read company metadata. Requires `companies.read`. */
companies: PluginCompaniesClient;
diff --git a/packages/plugins/sdk/src/ui/components.ts b/packages/plugins/sdk/src/ui/components.ts
index b93c1db44e..c148fc8014 100644
--- a/packages/plugins/sdk/src/ui/components.ts
+++ b/packages/plugins/sdk/src/ui/components.ts
@@ -125,6 +125,36 @@ export interface TimeseriesChartProps {
export interface MarkdownBlockProps {
/** Markdown content to render. */
content: string;
+ /** Optional CSS class name forwarded to the host renderer. */
+ className?: string;
+ /** Opt into Obsidian-style [[target]] / [[target|label]] wikilinks. */
+ enableWikiLinks?: boolean;
+ /** Base href used for wikilinks when no resolver is supplied. */
+ wikiLinkRoot?: string;
+ /** Optional href resolver for wikilinks. Return null to leave a token as plain text. */
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
+}
+
+/** Props for `MarkdownEditor`. */
+export interface MarkdownEditorProps {
+ /** Markdown source controlled by the plugin. */
+ value: string;
+ /** Called whenever the markdown source changes. */
+ onChange: (value: string) => void;
+ /** Placeholder text shown when the document is empty. */
+ placeholder?: string;
+ /** Optional wrapper CSS class name. */
+ className?: string;
+ /** Optional editable content CSS class name. */
+ contentClassName?: string;
+ /** Called when the editor loses focus. */
+ onBlur?: () => void;
+ /** Render the editor with a host border treatment. */
+ bordered?: boolean;
+ /** Render the rich editor without allowing edits. */
+ readOnly?: boolean;
+ /** Called on Cmd/Ctrl+Enter. */
+ onSubmit?: () => void;
}
/** A single key-value pair for `KeyValueList`. */
@@ -217,6 +247,211 @@ export interface ErrorBoundaryProps {
onError?: (error: Error, info: React.ErrorInfo) => void;
}
+/** File or directory node rendered by `FileTree`. */
+export interface FileTreeNode {
+ /** Display name for this path segment. */
+ name: string;
+ /** Slash-separated path relative to the tree root. */
+ path: string;
+ /** Whether this node is a directory or file. */
+ kind: "dir" | "file";
+ /** Child nodes. Files should use an empty array. */
+ children: FileTreeNode[];
+ /** Optional stable action metadata for host/plugin workflows. */
+ action?: string | null;
+}
+
+/** Badge status variants supported by `FileTree`. */
+export type FileTreeBadgeVariant = "ok" | "warning" | "error" | "info" | "pending";
+
+/** Serializable badge metadata keyed by file path. */
+export interface FileTreeBadge {
+ label: string;
+ status: FileTreeBadgeVariant;
+ tooltip?: string;
+}
+
+/** Row tone variants supported by `FileTree`. */
+export type FileTreeTone = "default" | "warning" | "error" | "muted";
+
+/** Empty-state content shown when a tree has no nodes. */
+export interface FileTreeEmptyState {
+ title?: string;
+ description?: string;
+}
+
+/** Error-state content shown when a tree cannot be loaded. */
+export interface FileTreeErrorState {
+ message: string;
+ retry?: () => void;
+}
+
+/** Accepted path collection shape for expanded and checked file tree state. */
+export type FileTreePathCollection = ReadonlySet<string> | readonly string[];
+
+/** Props for `FileTree`. */
+export interface FileTreeProps {
+ /** Tree nodes to render. */
+ nodes: FileTreeNode[];
+ /** Currently selected file path. */
+ selectedFile?: string | null;
+ /** Expanded directory paths. */
+ expandedPaths?: FileTreePathCollection;
+ /** Checked file paths. */
+ checkedPaths?: FileTreePathCollection;
+ /** Called when a directory row is toggled. */
+ onToggleDir?: (path: string) => void;
+ /** Called when a file row is selected. */
+ onSelectFile?: (path: string) => void;
+ /** Called when a checkbox is toggled. */
+ onToggleCheck?: (path: string, kind: "file" | "dir") => void;
+ /** Badge metadata keyed by path. */
+ fileBadges?: Record<string, FileTreeBadge | undefined>;
+ /** Row tone metadata keyed by path. */
+ fileTones?: Record<string, FileTreeTone | undefined>;
+ /** Whether to render checkboxes. Defaults to false for plugin UIs. */
+ showCheckboxes?: boolean;
+ /** Allow long file and directory names to wrap. */
+ wrapLabels?: boolean;
+ /** Render a loading skeleton instead of nodes. */
+ loading?: boolean;
+ /** Render a structured error state instead of nodes. */
+ error?: FileTreeErrorState | null;
+ /** Empty state content. */
+ empty?: FileTreeEmptyState;
+ /** Accessible label for the tree. */
+ ariaLabel?: string;
+}
+
+export interface IssuesListFilters {
+ status?: string;
+ projectId?: string;
+ parentId?: string;
+ assigneeAgentId?: string;
+ participantAgentId?: string;
+ assigneeUserId?: string;
+ labelId?: string;
+ workspaceId?: string;
+ executionWorkspaceId?: string;
+ originKind?: string;
+ originKindPrefix?: string;
+ originId?: string;
+ descendantOf?: string;
+ includeRoutineExecutions?: boolean;
+}
+
+export interface IssuesListProps {
+ companyId: string | null;
+ projectId?: string | null;
+ filters?: IssuesListFilters;
+ viewStateKey?: string;
+ initialSearch?: string;
+ createIssueLabel?: string;
+ searchWithinLoadedIssues?: boolean;
+}
+
+export interface AssigneePickerSelection {
+ assigneeAgentId: string | null;
+ assigneeUserId: string | null;
+}
+
+export interface AssigneePickerProps {
+ /** Company whose agents and users should be listed. Defaults to host context. */
+ companyId?: string | null;
+ /** Controlled value. Use `agent:<id>`, `user:<id>`, or an empty string. */
+ value: string;
+ /** Called with the encoded value plus parsed assignee IDs. */
+ onChange: (value: string, selection: AssigneePickerSelection) => void;
+ /** Button placeholder when no assignee is selected. */
+ placeholder?: string;
+ /** Label for the empty option. */
+ noneLabel?: string;
+ /** Search input placeholder. */
+ searchPlaceholder?: string;
+ /** Empty search result message. */
+ emptyMessage?: string;
+ /** Include active board users alongside agents. Defaults to true. */
+ includeUsers?: boolean;
+ /** Include terminated agents. Defaults to false. */
+ includeTerminatedAgents?: boolean;
+ /** CSS class forwarded to the trigger button. */
+ className?: string;
+ /** Called after the user confirms a selection with Enter, Tab, or click. */
+ onConfirm?: () => void;
+}
+
+export interface ProjectPickerProps {
+ /** Company whose projects should be listed. Defaults to host context. */
+ companyId?: string | null;
+ /** Controlled project id, or an empty string for no project. */
+ value: string;
+ /** Called with the selected project id. Empty string means no project. */
+ onChange: (projectId: string) => void;
+ /** Button placeholder when no project is selected. */
+ placeholder?: string;
+ /** Label for the empty option. */
+ noneLabel?: string;
+ /** Search input placeholder. */
+ searchPlaceholder?: string;
+ /** Empty search result message. */
+ emptyMessage?: string;
+ /** Include archived projects. Defaults to false. */
+ includeArchived?: boolean;
+ /** CSS class forwarded to the trigger button. */
+ className?: string;
+ /** Called after the user confirms a selection with Enter, Tab, or click. */
+ onConfirm?: () => void;
+}
+
+export interface ManagedRoutinesListAgent {
+ id: string;
+ name: string;
+ icon?: string | null;
+}
+
+export interface ManagedRoutinesListProject {
+ id: string;
+ name: string;
+ color?: string | null;
+}
+
+export interface ManagedRoutineMissingRef {
+ resourceKind: string;
+ resourceKey: string;
+}
+
+export interface ManagedRoutinesListItem {
+ key: string;
+ title: string;
+ status: string;
+ routineId?: string | null;
+ href?: string | null;
+ resourceKey?: string | null;
+ projectId?: string | null;
+ assigneeAgentId?: string | null;
+ cronExpression?: string | null;
+ lastRunAt?: Date | string | null;
+ lastRunStatus?: string | null;
+ managedByPluginDisplayName?: string | null;
+ missingRefs?: ManagedRoutineMissingRef[];
+}
+
+export interface ManagedRoutinesListProps {
+ routines: ManagedRoutinesListItem[];
+ agents?: ManagedRoutinesListAgent[];
+ projects?: ManagedRoutinesListProject[];
+ pluginDisplayName?: string | null;
+ emptyMessage?: string;
+ runningRoutineKey?: string | null;
+ statusMutationRoutineKey?: string | null;
+ reconcilingRoutineKey?: string | null;
+ resettingRoutineKey?: string | null;
+ onRunNow?: (routine: ManagedRoutinesListItem) => void;
+ onToggleEnabled?: (routine: ManagedRoutinesListItem, enabled: boolean) => void;
+ onReconcile?: (routine: ManagedRoutinesListItem) => void;
+ onReset?: (routine: ManagedRoutinesListItem) => void;
+}
+
// ---------------------------------------------------------------------------
// Component declarations (provided by host at runtime)
// ---------------------------------------------------------------------------
@@ -266,6 +501,13 @@ export const TimeseriesChart = createSdkUiComponent<TimeseriesChartProps>("Times
*/
export const MarkdownBlock = createSdkUiComponent<MarkdownBlockProps>("MarkdownBlock");
+/**
+ * Renders Paperclip's shared Markdown editor.
+ *
+ * @see PLUGIN_SPEC.md §19.6 — Shared Components
+ */
+export const MarkdownEditor = createSdkUiComponent<MarkdownEditorProps>("MarkdownEditor");
+
/**
* Renders a definition-list of label/value pairs.
*
@@ -308,3 +550,40 @@ export const Spinner = createSdkUiComponent<SpinnerProps>("Spinner");
* @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
*/
export const ErrorBoundary = createSdkUiComponent<ErrorBoundaryProps>("ErrorBoundary");
+
+/**
+ * Renders the host file tree component with a stable plugin-safe prop surface.
+ *
+ * @example
+ * ```tsx
+ * import { FileTree, type FileTreeNode } from "@paperclipai/plugin-sdk/ui";
+ *
+ * const nodes: FileTreeNode[] = [
+ * { name: "README.md", path: "README.md", kind: "file", children: [] },
+ * ];
+ *
+ * <FileTree nodes={nodes} onSelectFile={(path) => console.log(path)} />;
+ * ```
+ */
+export const FileTree = createSdkUiComponent<FileTreeProps>("FileTree");
+
+/**
+ * Renders Paperclip's native issue list component for company-scoped plugin
+ * pages that need a standard board issue view.
+ */
+export const IssuesList = createSdkUiComponent<IssuesListProps>("IssuesList");
+
+/**
+ * Renders the same host assignee picker used by the new issue pane.
+ */
+export const AssigneePicker = createSdkUiComponent<AssigneePickerProps>("AssigneePicker");
+
+/**
+ * Renders the same host project picker used by the new issue pane.
+ */
+export const ProjectPicker = createSdkUiComponent<ProjectPickerProps>("ProjectPicker");
+
+/**
+ * Renders Paperclip's native managed routines list for plugin settings pages.
+ */
+export const ManagedRoutinesList = createSdkUiComponent<ManagedRoutinesListProps>("ManagedRoutinesList");
diff --git a/packages/plugins/sdk/src/ui/hooks.ts b/packages/plugins/sdk/src/ui/hooks.ts
index 56a0938b80..686d02cf4b 100644
--- a/packages/plugins/sdk/src/ui/hooks.ts
+++ b/packages/plugins/sdk/src/ui/hooks.ts
@@ -1,6 +1,8 @@
import type {
PluginDataResult,
PluginActionFn,
+ HostLocation,
+ HostNavigation,
PluginHostContext,
PluginStreamResult,
PluginToastFn,
@@ -115,6 +117,57 @@ export function useHostContext(): PluginHostContext {
return impl();
}
+// ---------------------------------------------------------------------------
+// useHostNavigation
+// ---------------------------------------------------------------------------
+
+/**
+ * Navigate within the Paperclip host without forcing a full document reload.
+ *
+ * Use `linkProps()` for links so browser-native behavior still works:
+ * modifier-click, middle-click, copy-link, and open-in-new-tab all use the
+ * returned real `href`.
+ *
+ * @example
+ * ```tsx
+ * function WikiSidebarLink() {
+ * const hostNavigation = useHostNavigation();
+ * return <a {...hostNavigation.linkProps("/wiki")}>Wiki</a>;
+ * }
+ * ```
+ */
+export function useHostNavigation(): HostNavigation {
+ const impl = getSdkUiRuntimeValue<() => HostNavigation>("useHostNavigation");
+ return impl();
+}
+
+// ---------------------------------------------------------------------------
+// useHostLocation
+// ---------------------------------------------------------------------------
+
+/**
+ * Observe the current host router location.
+ *
+ * Returns a snapshot of the active `pathname`, `search`, and `hash`. The
+ * component re-renders when any of these change (e.g. after the host router
+ * pushes a new entry, or after the browser back/forward gestures). Use this
+ * for URL-driven plugin UI such as a takeover sidebar with section-aware
+ * active state.
+ *
+ * @example
+ * ```tsx
+ * function WikiSection() {
+ * const { pathname } = useHostLocation();
+ * const section = pathname.split("/").filter(Boolean).at(-1) ?? "wiki";
+ * return <div>Active section: {section}</div>;
+ * }
+ * ```
+ */
+export function useHostLocation(): HostLocation {
+ const impl = getSdkUiRuntimeValue<() => HostLocation>("useHostLocation");
+ return impl();
+}
+
// ---------------------------------------------------------------------------
// usePluginStream
// ---------------------------------------------------------------------------
diff --git a/packages/plugins/sdk/src/ui/index.ts b/packages/plugins/sdk/src/ui/index.ts
index 68b8a43ba4..8f90af70a3 100644
--- a/packages/plugins/sdk/src/ui/index.ts
+++ b/packages/plugins/sdk/src/ui/index.ts
@@ -43,20 +43,89 @@
* - `usePluginData(key, params)` — fetch data from the worker's `getData` handler
* - `usePluginAction(key)` — get a callable that invokes the worker's `performAction` handler
* - `useHostContext()` — read the current active company, project, entity, and user IDs
+ * - `useHostNavigation()` — navigate Paperclip-internal links through the host router
+ * - `useHostLocation()` — observe the current host pathname/search/hash for URL-driven UI
* - `usePluginStream(channel)` — subscribe to real-time SSE events from the worker
*/
export {
usePluginData,
usePluginAction,
useHostContext,
+ useHostNavigation,
+ useHostLocation,
usePluginStream,
usePluginToast,
} from "./hooks.js";
+export {
+ MetricCard,
+ StatusBadge,
+ DataTable,
+ TimeseriesChart,
+ MarkdownBlock,
+ MarkdownEditor,
+ KeyValueList,
+ ActionBar,
+ LogView,
+ JsonTree,
+ Spinner,
+ ErrorBoundary,
+ FileTree,
+ IssuesList,
+ AssigneePicker,
+ ProjectPicker,
+ ManagedRoutinesList,
+} from "./components.js";
+
+export type {
+ MetricTrend,
+ MetricCardProps,
+ StatusBadgeVariant,
+ StatusBadgeProps,
+ DataTableColumn,
+ DataTableProps,
+ TimeseriesDataPoint,
+ TimeseriesChartProps,
+ MarkdownBlockProps,
+ MarkdownEditorProps,
+ KeyValuePair,
+ KeyValueListProps,
+ ActionBarItem,
+ ActionBarProps,
+ LogViewEntry,
+ LogViewProps,
+ JsonTreeProps,
+ SpinnerProps,
+ ErrorBoundaryProps,
+ FileTreeNode,
+ FileTreeBadgeVariant,
+ FileTreeBadge,
+ FileTreeTone,
+ FileTreeEmptyState,
+ FileTreeErrorState,
+ FileTreePathCollection,
+ FileTreeProps,
+ IssuesListFilters,
+ IssuesListProps,
+ AssigneePickerSelection,
+ AssigneePickerProps,
+ ProjectPickerProps,
+ ManagedRoutineMissingRef,
+ ManagedRoutinesListAgent,
+ ManagedRoutinesListItem,
+ ManagedRoutinesListProject,
+ ManagedRoutinesListProps,
+} from "./components.js";
+
// Bridge error and host context types
export type {
PluginBridgeError,
PluginBridgeErrorCode,
+ HostNavigation,
+ HostNavigationOptions,
+ HostNavigationLinkOptions,
+ HostNavigationLinkProps,
+ HostLocation,
PluginHostContext,
PluginModalBoundsRequest,
PluginRenderCloseEvent,
@@ -80,6 +149,7 @@ export type {
PluginWidgetProps,
PluginDetailTabProps,
PluginSidebarProps,
+ PluginRouteSidebarProps,
PluginProjectSidebarItemProps,
PluginCommentAnnotationProps,
PluginCommentContextMenuItemProps,
diff --git a/packages/plugins/sdk/src/ui/types.ts b/packages/plugins/sdk/src/ui/types.ts
index b1eddea5a2..b821683615 100644
--- a/packages/plugins/sdk/src/ui/types.ts
+++ b/packages/plugins/sdk/src/ui/types.ts
@@ -14,6 +14,10 @@
* @see PLUGIN_SPEC.md §29.2 — SDK Versioning
*/
+import type {
+ AnchorHTMLAttributes,
+ MouseEvent as ReactMouseEvent,
+} from "react";
import type {
PluginBridgeErrorCode,
PluginLauncherBounds,
@@ -131,6 +135,83 @@ export interface PluginRenderEnvironmentContext
closeLifecycle?: PluginRenderCloseLifecycle | null;
}
+// ---------------------------------------------------------------------------
+// Host navigation
+// ---------------------------------------------------------------------------
+
+/**
+ * Options for host-managed Paperclip navigation from plugin UI.
+ */
+export interface HostNavigationOptions {
+ /** Replace the current history entry instead of pushing a new one. */
+ replace?: boolean;
+ /** Optional state forwarded to the host router. */
+ state?: unknown;
+}
+
+/**
+ * Options for `useHostNavigation().linkProps()`.
+ */
+export interface HostNavigationLinkOptions extends HostNavigationOptions {
+ /** Standard anchor target. Non-`_self` targets are not intercepted. */
+ target?: AnchorHTMLAttributes<HTMLAnchorElement>["target"];
+ /** Standard anchor rel attribute. */
+ rel?: AnchorHTMLAttributes<HTMLAnchorElement>["rel"];
+}
+
+/**
+ * Anchor props returned by `useHostNavigation().linkProps()`.
+ *
+ * The `href` is always real so browser affordances such as copy-link,
+ * modifier-click, middle-click, and open-in-new-tab continue to work.
+ */
+export interface HostNavigationLinkProps
+ extends Pick<AnchorHTMLAttributes<HTMLAnchorElement>, "href" | "target" | "rel"> {
+ onClick: (event: ReactMouseEvent<HTMLAnchorElement>) => void;
+}
+
+/**
+ * Snapshot of the host router location, exposed to plugin UI through
+ * `useHostLocation()`. Mirrors the relevant subset of `Location` from
+ * `react-router-dom` so plugins can react to URL changes without importing
+ * router internals.
+ *
+ * @see PLUGIN_SPEC.md §19 — UI Extension Model
+ */
+export interface HostLocation {
+ /** Current pathname, e.g. `/PAP/wiki`. */
+ pathname: string;
+ /** Current search string, e.g. `?tab=config` (includes the leading `?`). */
+ search: string;
+ /** Current hash, e.g. `#document-plan` (includes the leading `#`). */
+ hash: string;
+ /** Optional state forwarded by the host router for same-tab SPA navigation. */
+ state?: unknown;
+}
+
+/**
+ * Host-managed navigation helpers for plugin UI.
+ */
+export interface HostNavigation {
+ /**
+ * Resolve a Paperclip-internal path using the active company prefix.
+ *
+ * For example, in company `PAP`, `resolveHref("/wiki")` returns
+ * `"/PAP/wiki"`, while `resolveHref("/PAP/wiki")` stays unchanged.
+ */
+ resolveHref(to: string): string;
+ /** Navigate through the host router without reloading the document. */
+ navigate(to: string, options?: HostNavigationOptions): void;
+ /**
+ * Build anchor props for host-managed links.
+ *
+ * Plain left-clicks are routed through the host SPA router. Browser-native
+ * link gestures are left alone because the returned props include a real
+ * `href`.
+ */
+ linkProps(to: string, options?: HostNavigationLinkOptions): HostNavigationLinkProps;
+}
+
// ---------------------------------------------------------------------------
// Slot component prop interfaces
// ---------------------------------------------------------------------------
@@ -188,6 +269,19 @@ export interface PluginSidebarProps {
context: PluginHostContext;
}
+/**
+ * Props passed to a plugin route sidebar component.
+ *
+ * A route sidebar replaces the normal company sidebar while the user is on a
+ * matching plugin page route declared with the same `routePath`.
+ *
+ * @see PLUGIN_SPEC.md §19.5 — Sidebar Entries
+ */
+export interface PluginRouteSidebarProps {
+ /** The current host context. */
+ context: PluginHostContext;
+}
+
/**
* Props passed to a plugin project sidebar item component.
*
diff --git a/packages/plugins/sdk/src/worker-rpc-host.ts b/packages/plugins/sdk/src/worker-rpc-host.ts
index 80e548b5f6..7683605d3c 100644
--- a/packages/plugins/sdk/src/worker-rpc-host.ts
+++ b/packages/plugins/sdk/src/worker-rpc-host.ts
@@ -387,6 +387,51 @@ export function startWorkerRpcHost(options: WorkerRpcHostOptions): WorkerRpcHost
},
},
+ localFolders: {
+ declarations() {
+ if (!manifest) throw new Error("Plugin context accessed before initialization");
+ return manifest.localFolders ?? [];
+ },
+
+ async configure(input) {
+ return callHost("localFolders.configure", {
+ companyId: input.companyId,
+ folderKey: input.folderKey,
+ path: input.path,
+ access: input.access,
+ requiredDirectories: input.requiredDirectories,
+ requiredFiles: input.requiredFiles,
+ });
+ },
+
+ async status(companyId: string, folderKey: string) {
+ return callHost("localFolders.status", { companyId, folderKey });
+ },
+
+ async list(companyId: string, folderKey: string, options = {}) {
+ return callHost("localFolders.list", {
+ companyId,
+ folderKey,
+ relativePath: options.relativePath,
+ recursive: options.recursive,
+ maxEntries: options.maxEntries,
+ });
+ },
+
+ async readText(companyId: string, folderKey: string, relativePath: string) {
+ return callHost("localFolders.readText", { companyId, folderKey, relativePath });
+ },
+
+ async writeTextAtomic(companyId: string, folderKey: string, relativePath: string, contents: string) {
+ return callHost("localFolders.writeTextAtomic", {
+ companyId,
+ folderKey,
+ relativePath,
+ contents,
+ });
+ },
+ },
+
events: {
on(
name: string,
@@ -580,6 +625,50 @@ export function startWorkerRpcHost(options: WorkerRpcHostOptions): WorkerRpcHost
async getWorkspaceForIssue(issueId: string, companyId: string) {
return callHost("projects.getWorkspaceForIssue", { issueId, companyId });
},
+
+ managed: {
+ async get(projectKey: string, companyId: string) {
+ return callHost("projects.managed.get", { projectKey, companyId });
+ },
+ async reconcile(projectKey: string, companyId: string) {
+ return callHost("projects.managed.reconcile", { projectKey, companyId });
+ },
+ async reset(projectKey: string, companyId: string) {
+ return callHost("projects.managed.reset", { projectKey, companyId });
+ },
+ },
+ },
+
+ routines: {
+ managed: {
+ async get(routineKey: string, companyId: string) {
+ return callHost("routines.managed.get", { routineKey, companyId });
+ },
+ async reconcile(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ) {
+ return callHost("routines.managed.reconcile", { routineKey, companyId, ...overrides });
+ },
+ async reset(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ) {
+ return callHost("routines.managed.reset", { routineKey, companyId, ...overrides });
+ },
+ async update(routineKey: string, companyId: string, patch: { status?: string }) {
+ return callHost("routines.managed.update", { routineKey, companyId, ...patch });
+ },
+ async run(
+ routineKey: string,
+ companyId: string,
+ overrides?: { assigneeAgentId?: string | null; projectId?: string | null },
+ ) {
+ return callHost("routines.managed.run", { routineKey, companyId, ...overrides });
+ },
+ },
},
companies: {
@@ -602,8 +691,10 @@ export function startWorkerRpcHost(options: WorkerRpcHostOptions): WorkerRpcHost
projectId: input.projectId,
assigneeAgentId: input.assigneeAgentId,
originKind: input.originKind,
+ originKindPrefix: input.originKindPrefix,
originId: input.originId,
status: input.status,
+ includePluginOperations: input.includePluginOperations,
limit: input.limit,
offset: input.offset,
});
@@ -628,6 +719,7 @@ export function startWorkerRpcHost(options: WorkerRpcHostOptions): WorkerRpcHost
assigneeUserId: input.assigneeUserId,
requestDepth: input.requestDepth,
billingCode: input.billingCode,
+ surfaceVisibility: input.surfaceVisibility,
originKind: input.originKind,
originId: input.originId,
originRunId: input.originRunId,
@@ -863,6 +955,20 @@ export function startWorkerRpcHost(options: WorkerRpcHostOptions): WorkerRpcHost
return callHost("agents.invoke", { agentId, companyId, prompt: opts.prompt, reason: opts.reason });
},
+ managed: {
+ async get(agentKey: string, companyId: string) {
+ return callHost("agents.managed.get", { agentKey, companyId });
+ },
+
+ async reconcile(agentKey: string, companyId: string) {
+ return callHost("agents.managed.reconcile", { agentKey, companyId });
+ },
+
+ async reset(agentKey: string, companyId: string) {
+ return callHost("agents.managed.reset", { agentKey, companyId });
+ },
+ },
+
sessions: {
async create(agentId: string, companyId: string, opts?: { taskKey?: string; reason?: string }) {
return callHost("agents.sessions.create", {
diff --git a/packages/shared/src/constants.ts b/packages/shared/src/constants.ts
index 3724d42d8a..001ccee26f 100644
--- a/packages/shared/src/constants.ts
+++ b/packages/shared/src/constants.ts
@@ -190,6 +190,16 @@ export const ISSUE_ORIGIN_KINDS = [
export type BuiltInIssueOriginKind = (typeof ISSUE_ORIGIN_KINDS)[number];
export type PluginIssueOriginKind = `plugin:${string}`;
export type IssueOriginKind = BuiltInIssueOriginKind | PluginIssueOriginKind;
+export const ISSUE_SURFACE_VISIBILITIES = ["default", "plugin_operation"] as const;
+export type IssueSurfaceVisibility = (typeof ISSUE_SURFACE_VISIBILITIES)[number];
+
+export function pluginOperationIssueOriginKind(pluginKey: string): PluginIssueOriginKind {
+ return `plugin:${pluginKey}:operation`;
+}
+
+export function isPluginOperationIssueOriginKind(originKind: string | null | undefined): boolean {
+ return typeof originKind === "string" && /^plugin:[^:]+:operation(?::|$)/.test(originKind);
+}
export const ISSUE_RELATION_TYPES = ["blocks"] as const;
export type IssueRelationType = (typeof ISSUE_RELATION_TYPES)[number];
@@ -634,9 +644,12 @@ export const PLUGIN_CAPABILITIES = [
"issue.comments.create",
"issue.interactions.create",
"issue.documents.write",
+ "projects.managed",
+ "routines.managed",
"agents.pause",
"agents.resume",
"agents.invoke",
+ "agents.managed",
"agent.sessions.create",
"agent.sessions.list",
"agent.sessions.send",
@@ -658,6 +671,7 @@ export const PLUGIN_CAPABILITIES = [
"http.outbound",
"secrets.read-ref",
"environment.drivers.register",
+ "local.folders",
// Agent Tools
"agent.tools.register",
// UI
@@ -728,6 +742,7 @@ export const PLUGIN_UI_SLOT_TYPES = [
"taskDetailView",
"dashboardWidget",
"sidebar",
+ "routeSidebar",
"sidebarPanel",
"projectSidebarItem",
"globalToolbarButton",
diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts
index 87a298c77a..810ac1e6bd 100644
--- a/packages/shared/src/index.ts
+++ b/packages/shared/src/index.ts
@@ -25,6 +25,9 @@ export {
ISSUE_THREAD_INTERACTION_STATUSES,
ISSUE_THREAD_INTERACTION_CONTINUATION_POLICIES,
ISSUE_ORIGIN_KINDS,
+ ISSUE_SURFACE_VISIBILITIES,
+ pluginOperationIssueOriginKind,
+ isPluginOperationIssueOriginKind,
ISSUE_RELATION_TYPES,
ISSUE_TREE_CONTROL_MODES,
ISSUE_TREE_HOLD_RELEASE_POLICY_STRATEGIES,
@@ -133,6 +136,7 @@ export {
type BuiltInIssueOriginKind,
type PluginIssueOriginKind,
type IssueOriginKind,
+ type IssueSurfaceVisibility,
type IssueRelationType,
type IssueTreeControlMode,
type IssueTreeHoldReleasePolicyStrategy,
@@ -303,6 +307,7 @@ export type {
ProjectCodebase,
ProjectCodebaseOrigin,
ProjectGoalRef,
+ ProjectManagedByPlugin,
ProjectWorkspace,
ExecutionWorkspace,
ExecutionWorkspaceSummary,
@@ -493,6 +498,7 @@ export type {
CompanySecret,
SecretProviderDescriptor,
Routine,
+ RoutineManagedByPlugin,
RoutineVariable,
RoutineVariableDefaultValue,
RoutineTrigger,
@@ -507,6 +513,15 @@ export type {
PluginWebhookDeclaration,
PluginToolDeclaration,
PluginEnvironmentDriverDeclaration,
+ PluginManagedAgentDeclaration,
+ PluginManagedProjectDeclaration,
+ PluginManagedRoutineDeclaration,
+ PluginLocalFolderDeclaration,
+ PluginManagedAgentResolution,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineResolution,
+ PluginManagedResourceKind,
+ PluginManagedResourceRef,
PluginUiSlotDeclaration,
PluginLauncherActionDeclaration,
PluginLauncherRenderDeclaration,
@@ -523,6 +538,7 @@ export type {
PluginMigrationRecord,
PluginStateRecord,
PluginConfig,
+ PluginCompanySettings,
PluginEntityRecord,
PluginEntityQuery,
PluginJobRecord,
diff --git a/packages/shared/src/types/index.ts b/packages/shared/src/types/index.ts
index 35eb94c637..1b24f771bf 100644
--- a/packages/shared/src/types/index.ts
+++ b/packages/shared/src/types/index.ts
@@ -89,7 +89,7 @@ export type {
AdapterEnvironmentTestResult,
} from "./agent.js";
export type { AssetImage } from "./asset.js";
-export type { Project, ProjectCodebase, ProjectCodebaseOrigin, ProjectGoalRef, ProjectWorkspace } from "./project.js";
+export type { Project, ProjectCodebase, ProjectCodebaseOrigin, ProjectGoalRef, ProjectManagedByPlugin, ProjectWorkspace } from "./project.js";
export type {
ExecutionWorkspace,
ExecutionWorkspaceSummary,
@@ -221,6 +221,7 @@ export type {
} from "./secrets.js";
export type {
Routine,
+ RoutineManagedByPlugin,
RoutineVariable,
RoutineVariableDefaultValue,
RoutineTrigger,
@@ -315,6 +316,15 @@ export type {
PluginWebhookDeclaration,
PluginToolDeclaration,
PluginEnvironmentDriverDeclaration,
+ PluginManagedAgentDeclaration,
+ PluginManagedProjectDeclaration,
+ PluginManagedRoutineDeclaration,
+ PluginLocalFolderDeclaration,
+ PluginManagedAgentResolution,
+ PluginManagedProjectResolution,
+ PluginManagedRoutineResolution,
+ PluginManagedResourceKind,
+ PluginManagedResourceRef,
PluginUiSlotDeclaration,
PluginLauncherActionDeclaration,
PluginLauncherRenderDeclaration,
@@ -331,6 +341,7 @@ export type {
PluginMigrationRecord,
PluginStateRecord,
PluginConfig,
+ PluginCompanySettings,
PluginEntityRecord,
PluginEntityQuery,
PluginJobRecord,
diff --git a/packages/shared/src/types/plugin.ts b/packages/shared/src/types/plugin.ts
index 955b719fb4..d5231aadff 100644
--- a/packages/shared/src/types/plugin.ts
+++ b/packages/shared/src/types/plugin.ts
@@ -16,7 +16,19 @@ import type {
PluginDatabaseMigrationStatus,
PluginDatabaseNamespaceMode,
PluginDatabaseNamespaceStatus,
+ AgentAdapterType,
+ AgentRole,
+ AgentStatus,
+ IssuePriority,
+ ProjectStatus,
+ RoutineCatchUpPolicy,
+ RoutineConcurrencyPolicy,
+ RoutineStatus,
+ IssueSurfaceVisibility,
} from "../constants.js";
+import type { Agent } from "./agent.js";
+import type { Project } from "./project.js";
+import type { Routine, RoutineTrigger, RoutineVariable } from "./routine.js";
// ---------------------------------------------------------------------------
// JSON Schema placeholder – plugins declare config schemas as JSON Schema
@@ -113,6 +125,162 @@ export interface PluginEnvironmentDriverDeclaration {
configSchema: JsonSchema;
}
+/**
+ * Declares a normal Paperclip agent that a plugin can provision and later
+ * resolve by stable key within each company.
+ */
+export interface PluginManagedAgentDeclaration {
+ /** Stable identifier for this managed agent, unique within the plugin. */
+ agentKey: string;
+ /** Suggested visible agent name. */
+ displayName: string;
+ /** Optional suggested role. Defaults to `general`. */
+ role?: AgentRole | string;
+ /** Optional suggested title shown in agent surfaces. */
+ title?: string | null;
+ /** Optional icon for agent list/detail surfaces. */
+ icon?: string | null;
+ /** Suggested capability summary for the agent. */
+ capabilities?: string | null;
+ /** Suggested adapter type. Defaults to `process`. */
+ adapterType?: AgentAdapterType | string;
+ /**
+ * Optional ordered list of compatible adapter types. When present, the host
+ * prefers the most-used compatible adapter already configured in the company,
+ * falling back to `adapterType`.
+ */
+ adapterPreference?: Array<AgentAdapterType | string>;
+ /** Suggested adapter configuration. */
+ adapterConfig?: Record<string, unknown>;
+ /** Suggested Paperclip runtime configuration. */
+ runtimeConfig?: Record<string, unknown>;
+ /** Suggested permissions object. Normalized by the host on create/reset. */
+ permissions?: Record<string, unknown>;
+ /** Suggested starting status when no board approval is required. */
+ status?: Extract<AgentStatus, "idle" | "paused">;
+ /** Suggested monthly budget in cents. */
+ budgetMonthlyCents?: number;
+ /** Optional managed instructions content or pointer metadata for plugin UI. */
+ instructions?: {
+ entryFile?: string;
+ content?: string;
+ assetPath?: string;
+ };
+}
+
+/**
+ * Declares a company-scoped local folder a trusted plugin wants the operator
+ * to configure. The host treats this as a generic filesystem root: plugin
+ * code may request required relative folders/files, then use SDK helpers for
+ * path-safe reads and atomic writes under that root.
+ */
+export interface PluginLocalFolderDeclaration {
+ /** Stable identifier for this folder, unique within the plugin. */
+ folderKey: string;
+ /** Human-readable name shown in plugin settings. */
+ displayName: string;
+ /** Optional operator-facing description. */
+ description?: string;
+ /** Access level requested by the plugin. Defaults to `readWrite`. */
+ access?: "read" | "readWrite";
+ /** Relative directories expected to exist under the configured root. */
+ requiredDirectories?: string[];
+ /** Relative files expected to exist under the configured root. */
+ requiredFiles?: string[];
+}
+
+/**
+ * Declares a normal Paperclip project that a plugin can provision and later
+ * resolve by stable key within each company.
+ */
+export interface PluginManagedProjectDeclaration {
+ /** Stable identifier for this managed project, unique within the plugin. */
+ projectKey: string;
+ /** Suggested visible project name. */
+ displayName: string;
+ /** Suggested project description. */
+ description?: string | null;
+ /** Suggested starting status. Defaults to `in_progress`. */
+ status?: ProjectStatus;
+ /** Suggested project color. Defaults to the normal project palette. */
+ color?: string | null;
+ /** Optional plugin-specific defaults retained for reset/reconcile UI. */
+ settings?: Record<string, unknown>;
+}
+
+export type PluginManagedResourceKind = "agent" | "project" | "routine";
+
+export interface PluginManagedResourceRef {
+ pluginKey?: string;
+ resourceKind: PluginManagedResourceKind;
+ resourceKey: string;
+}
+
+export interface PluginManagedRoutineDeclaration {
+ /** Stable identifier for this managed routine, unique within the plugin. */
+ routineKey: string;
+ /** Suggested routine title template. */
+ title: string;
+ /** Suggested routine description template. */
+ description?: string | null;
+ /** Stable managed agent reference for the default assignee. */
+ assigneeRef?: PluginManagedResourceRef | null;
+ /** Stable managed project reference for routine-created issues. */
+ projectRef?: PluginManagedResourceRef | null;
+ /** Optional goal id to set on the routine in this company. */
+ goalId?: string | null;
+ /** Suggested starting status. Defaults to `paused` when no assignee is resolved, otherwise `active`. */
+ status?: RoutineStatus;
+ /** Suggested issue priority. Defaults to `medium`. */
+ priority?: IssuePriority;
+ /** Suggested concurrency behavior. Defaults to core routine default. */
+ concurrencyPolicy?: RoutineConcurrencyPolicy;
+ /** Suggested missed-trigger behavior. Defaults to core routine default. */
+ catchUpPolicy?: RoutineCatchUpPolicy;
+ /** Suggested routine variables. */
+ variables?: RoutineVariable[];
+ /** Suggested triggers created when the routine is first reconciled. */
+ triggers?: Array<Pick<RoutineTrigger, "kind" | "label" | "enabled" | "cronExpression" | "timezone" | "signingMode" | "replayWindowSec">>;
+ /** Defaults for issues created by this routine. */
+ issueTemplate?: {
+ surfaceVisibility?: IssueSurfaceVisibility;
+ originId?: string | null;
+ billingCode?: string | null;
+ };
+}
+
+export interface PluginManagedAgentResolution {
+ pluginKey: string;
+ resourceKind: "agent";
+ resourceKey: string;
+ companyId: string;
+ agentId: string | null;
+ agent: Agent | null;
+ status: "missing" | "resolved" | "created" | "relinked" | "reset";
+ approvalId?: string | null;
+}
+
+export interface PluginManagedProjectResolution {
+ pluginKey: string;
+ resourceKind: "project";
+ resourceKey: string;
+ companyId: string;
+ projectId: string | null;
+ project: Project | null;
+ status: "missing" | "resolved" | "created" | "relinked" | "reset";
+}
+
+export interface PluginManagedRoutineResolution {
+ pluginKey: string;
+ resourceKind: "routine";
+ resourceKey: string;
+ companyId: string;
+ routineId: string | null;
+ routine: Routine | null;
+ status: "missing" | "missing_refs" | "resolved" | "created" | "relinked" | "reset";
+ missingRefs?: PluginManagedResourceRef[];
+}
+
/**
* Declares a UI extension slot the plugin fills with a React component.
*
@@ -133,7 +301,7 @@ export interface PluginUiSlotDeclaration {
*/
entityTypes?: PluginUiSlotEntityType[];
/**
- * Optional company-scoped route segment for page slots.
+ * Optional company-scoped route segment for page and routeSidebar slots.
* Example: `kitchensink` becomes `/:companyPrefix/kitchensink`.
*/
routePath?: string;
@@ -322,6 +490,14 @@ export interface PaperclipPluginManifestV1 {
apiRoutes?: PluginApiRouteDeclaration[];
/** Environment drivers this plugin contributes. Requires `environment.drivers.register` capability. */
environmentDrivers?: PluginEnvironmentDriverDeclaration[];
+ /** Suggested company-scoped agents this plugin can provision and resolve by stable key. */
+ agents?: PluginManagedAgentDeclaration[];
+ /** Suggested company-scoped projects this plugin can provision and resolve by stable key. */
+ projects?: PluginManagedProjectDeclaration[];
+ /** Suggested company-scoped routines this plugin can provision and resolve by stable key. */
+ routines?: PluginManagedRoutineDeclaration[];
+ /** Trusted local folders this plugin can configure and access by stable key. */
+ localFolders?: PluginLocalFolderDeclaration[];
/**
* Legacy top-level launcher declarations.
* Prefer `ui.launchers` for new manifests.
@@ -455,6 +631,22 @@ export interface PluginConfig {
updatedAt: Date;
}
+/**
+ * Company-scoped plugin settings row. This is intentionally generic; plugin
+ * features such as local folders live inside `settingsJson` under namespaced
+ * keys instead of requiring feature-specific database columns.
+ */
+export interface PluginCompanySettings {
+ id: string;
+ companyId: string;
+ pluginId: string;
+ enabled: boolean;
+ settingsJson: Record<string, unknown>;
+ lastError: string | null;
+ createdAt: Date;
+ updatedAt: Date;
+}
+
/**
* Query filter for `ctx.entities.list`.
*/
diff --git a/packages/shared/src/types/project.ts b/packages/shared/src/types/project.ts
index 2aa5036155..302d504879 100644
--- a/packages/shared/src/types/project.ts
+++ b/packages/shared/src/types/project.ts
@@ -52,6 +52,18 @@ export interface ProjectCodebase {
origin: ProjectCodebaseOrigin;
}
+export interface ProjectManagedByPlugin {
+ id: string;
+ pluginId: string;
+ pluginKey: string;
+ pluginDisplayName: string;
+ resourceKind: "project";
+ resourceKey: string;
+ defaultsJson: Record<string, unknown>;
+ createdAt: Date;
+ updatedAt: Date;
+}
+
export interface Project {
id: string;
companyId: string;
@@ -73,6 +85,7 @@ export interface Project {
codebase: ProjectCodebase;
workspaces: ProjectWorkspace[];
primaryWorkspace: ProjectWorkspace | null;
+ managedByPlugin?: ProjectManagedByPlugin | null;
archivedAt: Date | null;
createdAt: Date;
updatedAt: Date;
diff --git a/packages/shared/src/types/routine.ts b/packages/shared/src/types/routine.ts
index aea256bea4..565c94f009 100644
--- a/packages/shared/src/types/routine.ts
+++ b/packages/shared/src/types/routine.ts
@@ -58,6 +58,19 @@ export interface Routine {
lastEnqueuedAt: Date | null;
createdAt: Date;
updatedAt: Date;
+ managedByPlugin?: RoutineManagedByPlugin | null;
+}
+
+export interface RoutineManagedByPlugin {
+ id: string;
+ pluginId: string;
+ pluginKey: string;
+ pluginDisplayName: string;
+ resourceKind: "routine";
+ resourceKey: string;
+ defaultsJson: Record<string, unknown>;
+ createdAt: Date;
+ updatedAt: Date;
}
export interface RoutineTrigger {
diff --git a/packages/shared/src/validators/plugin.test.ts b/packages/shared/src/validators/plugin.test.ts
new file mode 100644
index 0000000000..7de0c31687
--- /dev/null
+++ b/packages/shared/src/validators/plugin.test.ts
@@ -0,0 +1,72 @@
+import { describe, expect, it } from "vitest";
+import { PLUGIN_CAPABILITIES } from "../constants.js";
+import { pluginManagedRoutineDeclarationSchema, pluginUiSlotDeclarationSchema } from "./plugin.js";
+
+describe("plugin capability constants", () => {
+ it("exposes each capability once", () => {
+ expect(new Set(PLUGIN_CAPABILITIES).size).toBe(PLUGIN_CAPABILITIES.length);
+ });
+});
+
+describe("plugin managed routine validators", () => {
+ it("accepts core issue surface visibility values in routine templates", () => {
+ const parsed = pluginManagedRoutineDeclarationSchema.parse({
+ routineKey: "wiki.refresh",
+ title: "Refresh Wiki",
+ issueTemplate: { surfaceVisibility: "default" },
+ });
+
+ expect(parsed.issueTemplate?.surfaceVisibility).toBe("default");
+ });
+
+ it("rejects non-core issue surface visibility values in routine templates", () => {
+ const parsed = pluginManagedRoutineDeclarationSchema.safeParse({
+ routineKey: "wiki.refresh",
+ title: "Refresh Wiki",
+ issueTemplate: { surfaceVisibility: "normal" },
+ });
+
+ expect(parsed.success).toBe(false);
+ });
+});
+
+describe("plugin UI slot validators", () => {
+ it("accepts route-scoped sidebar slots with a routePath", () => {
+ const parsed = pluginUiSlotDeclarationSchema.parse({
+ type: "routeSidebar",
+ id: "wiki-route-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiSidebar",
+ routePath: "wiki",
+ });
+
+ expect(parsed.routePath).toBe("wiki");
+ });
+
+ it("requires route-scoped sidebar slots to declare a routePath", () => {
+ const parsed = pluginUiSlotDeclarationSchema.safeParse({
+ type: "routeSidebar",
+ id: "wiki-route-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiSidebar",
+ });
+
+ expect(parsed.success).toBe(false);
+ if (parsed.success) return;
+ expect(parsed.error.issues[0]?.message).toBe("routeSidebar slots require routePath");
+ });
+
+ it("keeps reserved company route protection for route-scoped sidebars", () => {
+ const parsed = pluginUiSlotDeclarationSchema.safeParse({
+ type: "routeSidebar",
+ id: "settings-route-sidebar",
+ displayName: "Settings Sidebar",
+ exportName: "SettingsSidebar",
+ routePath: "settings",
+ });
+
+ expect(parsed.success).toBe(false);
+ if (parsed.success) return;
+ expect(parsed.error.issues.some((issue) => issue.message.includes("reserved by the host"))).toBe(true);
+ });
+});
diff --git a/packages/shared/src/validators/plugin.ts b/packages/shared/src/validators/plugin.ts
index 3ade091245..336620a0ac 100644
--- a/packages/shared/src/validators/plugin.ts
+++ b/packages/shared/src/validators/plugin.ts
@@ -15,7 +15,15 @@ import {
PLUGIN_API_ROUTE_AUTH_MODES,
PLUGIN_API_ROUTE_CHECKOUT_POLICIES,
PLUGIN_API_ROUTE_METHODS,
+ ISSUE_PRIORITIES,
+ ROUTINE_CATCH_UP_POLICIES,
+ ROUTINE_CONCURRENCY_POLICIES,
+ ROUTINE_STATUSES,
+ ROUTINE_TRIGGER_KINDS,
+ ROUTINE_TRIGGER_SIGNING_MODES,
+ ISSUE_SURFACE_VISIBILITIES,
} from "../constants.js";
+import { routineVariableSchema } from "./routine.js";
// ---------------------------------------------------------------------------
// JSON Schema placeholder – a permissive validator for JSON Schema objects
@@ -124,6 +132,106 @@ export type PluginEnvironmentDriverDeclarationInput = z.infer<
export type PluginToolDeclarationInput = z.infer<typeof pluginToolDeclarationSchema>;
+export const pluginManagedAgentDeclarationSchema = z.object({
+ agentKey: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9._:-]*$/, {
+ message: "agentKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens",
+ }),
+ displayName: z.string().min(1).max(100),
+ role: z.string().min(1).max(100).optional(),
+ title: z.string().max(200).nullable().optional(),
+ icon: z.string().max(100).nullable().optional(),
+ capabilities: z.string().max(2000).nullable().optional(),
+ adapterType: z.string().min(1).max(100).optional(),
+ adapterPreference: z.array(z.string().min(1).max(100)).max(10).optional(),
+ adapterConfig: z.record(z.unknown()).optional(),
+ runtimeConfig: z.record(z.unknown()).optional(),
+ permissions: z.record(z.unknown()).optional(),
+ status: z.enum(["idle", "paused"]).optional(),
+ budgetMonthlyCents: z.number().int().min(0).optional(),
+ instructions: z.object({
+ entryFile: z.string().min(1).max(200).optional(),
+ content: z.string().max(200_000).optional(),
+ assetPath: z.string().min(1).max(500).optional(),
+ }).optional(),
+});
+
+export type PluginManagedAgentDeclarationInput = z.infer<typeof pluginManagedAgentDeclarationSchema>;
+
+export const pluginManagedProjectDeclarationSchema = z.object({
+ projectKey: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9._:-]*$/, {
+ message: "projectKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens",
+ }),
+ displayName: z.string().min(1).max(120),
+ description: z.string().max(2000).nullable().optional(),
+ status: z.enum(["backlog", "planned", "in_progress", "completed", "cancelled"]).optional(),
+ color: z.string().max(32).nullable().optional(),
+ settings: z.record(z.unknown()).optional(),
+});
+
+export type PluginManagedProjectDeclarationInput = z.infer<typeof pluginManagedProjectDeclarationSchema>;
+
+const pluginManagedResourceRefSchema = z.object({
+ pluginKey: z.string().min(1).max(100).optional(),
+ resourceKind: z.enum(["agent", "project", "routine"]),
+ resourceKey: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9._:-]*$/, {
+ message: "resourceKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens",
+ }),
+});
+
+export const pluginManagedRoutineDeclarationSchema = z.object({
+ routineKey: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9._:-]*$/, {
+ message: "routineKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens",
+ }),
+ title: z.string().trim().min(1).max(200),
+ description: z.string().max(10_000).nullable().optional(),
+ assigneeRef: pluginManagedResourceRefSchema.extend({ resourceKind: z.literal("agent") }).nullable().optional(),
+ projectRef: pluginManagedResourceRefSchema.extend({ resourceKind: z.literal("project") }).nullable().optional(),
+ goalId: z.string().uuid().nullable().optional(),
+ status: z.enum(ROUTINE_STATUSES).optional(),
+ priority: z.enum(ISSUE_PRIORITIES).optional(),
+ concurrencyPolicy: z.enum(ROUTINE_CONCURRENCY_POLICIES).optional(),
+ catchUpPolicy: z.enum(ROUTINE_CATCH_UP_POLICIES).optional(),
+ variables: z.array(routineVariableSchema).optional(),
+ triggers: z.array(z.object({
+ kind: z.enum(ROUTINE_TRIGGER_KINDS),
+ label: z.string().trim().max(120).nullable().optional(),
+ enabled: z.boolean().optional(),
+ cronExpression: z.string().trim().min(1).optional().nullable(),
+ timezone: z.string().trim().min(1).optional().nullable(),
+ signingMode: z.enum(ROUTINE_TRIGGER_SIGNING_MODES).optional().nullable(),
+ replayWindowSec: z.number().int().min(30).max(86_400).optional().nullable(),
+ })).max(20).optional(),
+ issueTemplate: z.object({
+ surfaceVisibility: z.enum(ISSUE_SURFACE_VISIBILITIES).optional(),
+ originId: z.string().trim().max(255).nullable().optional(),
+ billingCode: z.string().trim().max(200).nullable().optional(),
+ }).optional(),
+});
+
+export type PluginManagedRoutineDeclarationInput = z.infer<typeof pluginManagedRoutineDeclarationSchema>;
+
+const pluginLocalFolderRelativePathSchema = z.string().min(1).max(500).refine(
+ (value) =>
+ !value.startsWith("/") &&
+ !value.includes("..") &&
+ !value.includes("\\") &&
+ !value.split("/").some((segment) => segment === "" || segment === "."),
+ { message: "local folder paths must be relative paths without traversal, empty segments, or backslashes" },
+);
+
+export const pluginLocalFolderDeclarationSchema = z.object({
+ folderKey: z.string().min(1).max(100).regex(/^[a-z0-9][a-z0-9._:-]*$/, {
+ message: "folderKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens",
+ }),
+ displayName: z.string().min(1).max(100),
+ description: z.string().max(500).optional(),
+ access: z.enum(["read", "readWrite"]).optional(),
+ requiredDirectories: z.array(pluginLocalFolderRelativePathSchema).optional(),
+ requiredFiles: z.array(pluginLocalFolderRelativePathSchema).optional(),
+});
+
+export type PluginLocalFolderDeclarationInput = z.infer<typeof pluginLocalFolderDeclarationSchema>;
+
/**
* Validates a {@link PluginUiSlotDeclaration} — a UI extension slot the plugin
* fills with a React component. Includes `superRefine` checks for slot-specific
@@ -178,10 +286,17 @@ export const pluginUiSlotDeclarationSchema = z.object({
path: ["entityTypes"],
});
}
- if (value.routePath && value.type !== "page") {
+ if (value.routePath && value.type !== "page" && value.type !== "routeSidebar") {
ctx.addIssue({
code: z.ZodIssueCode.custom,
- message: "routePath is only supported for page slots",
+ message: "routePath is only supported for page and routeSidebar slots",
+ path: ["routePath"],
+ });
+ }
+ if (value.type === "routeSidebar" && !value.routePath) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: "routeSidebar slots require routePath",
path: ["routePath"],
});
}
@@ -471,6 +586,10 @@ export const pluginManifestV1Schema = z.object({
database: pluginDatabaseDeclarationSchema.optional(),
apiRoutes: z.array(pluginApiRouteDeclarationSchema).optional(),
environmentDrivers: z.array(pluginEnvironmentDriverDeclarationSchema).optional(),
+ agents: z.array(pluginManagedAgentDeclarationSchema).optional(),
+ projects: z.array(pluginManagedProjectDeclarationSchema).optional(),
+ routines: z.array(pluginManagedRoutineDeclarationSchema).optional(),
+ localFolders: z.array(pluginLocalFolderDeclarationSchema).optional(),
launchers: z.array(pluginLauncherDeclarationSchema).optional(),
ui: z.object({
slots: z.array(pluginUiSlotDeclarationSchema).min(1).optional(),
@@ -529,6 +648,46 @@ export const pluginManifestV1Schema = z.object({
}
}
+ if (manifest.agents && manifest.agents.length > 0) {
+ if (!manifest.capabilities.includes("agents.managed")) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: "Capability 'agents.managed' is required when managed agents are declared",
+ path: ["capabilities"],
+ });
+ }
+ }
+
+ if (manifest.projects && manifest.projects.length > 0) {
+ if (!manifest.capabilities.includes("projects.managed")) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: "Capability 'projects.managed' is required when managed projects are declared",
+ path: ["capabilities"],
+ });
+ }
+ }
+
+ if (manifest.routines && manifest.routines.length > 0) {
+ if (!manifest.capabilities.includes("routines.managed")) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: "Capability 'routines.managed' is required when managed routines are declared",
+ path: ["capabilities"],
+ });
+ }
+ }
+
+ if (manifest.localFolders && manifest.localFolders.length > 0) {
+ if (!manifest.capabilities.includes("local.folders")) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: "Capability 'local.folders' is required when local folders are declared",
+ path: ["capabilities"],
+ });
+ }
+ }
+
// jobs require jobs.schedule (PLUGIN_SPEC.md §17)
if (manifest.jobs && manifest.jobs.length > 0) {
if (!manifest.capabilities.includes("jobs.schedule")) {
@@ -664,6 +823,54 @@ export const pluginManifestV1Schema = z.object({
}
}
+ if (manifest.localFolders) {
+ const folderKeys = manifest.localFolders.map((folder) => folder.folderKey);
+ const duplicates = folderKeys.filter((key, i) => folderKeys.indexOf(key) !== i);
+ if (duplicates.length > 0) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: `Duplicate local folder keys: ${[...new Set(duplicates)].join(", ")}`,
+ path: ["localFolders"],
+ });
+ }
+ }
+
+ if (manifest.agents) {
+ const agentKeys = manifest.agents.map((agent) => agent.agentKey);
+ const duplicates = agentKeys.filter((key, i) => agentKeys.indexOf(key) !== i);
+ if (duplicates.length > 0) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: `Duplicate managed agent keys: ${[...new Set(duplicates)].join(", ")}`,
+ path: ["agents"],
+ });
+ }
+ }
+
+ if (manifest.projects) {
+ const projectKeys = manifest.projects.map((project) => project.projectKey);
+ const duplicates = projectKeys.filter((key, i) => projectKeys.indexOf(key) !== i);
+ if (duplicates.length > 0) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: `Duplicate managed project keys: ${[...new Set(duplicates)].join(", ")}`,
+ path: ["projects"],
+ });
+ }
+ }
+
+ if (manifest.routines) {
+ const routineKeys = manifest.routines.map((routine) => routine.routineKey);
+ const duplicates = routineKeys.filter((key, i) => routineKeys.indexOf(key) !== i);
+ if (duplicates.length > 0) {
+ ctx.addIssue({
+ code: z.ZodIssueCode.custom,
+ message: `Duplicate managed routine keys: ${[...new Set(duplicates)].join(", ")}`,
+ path: ["routines"],
+ });
+ }
+ }
+
// UI slot ids must be unique within the plugin (namespaced at runtime)
if (manifest.ui) {
if (manifest.ui.slots) {
diff --git a/server/src/__tests__/issues-service.test.ts b/server/src/__tests__/issues-service.test.ts
index eeb82316cc..2c7054951d 100644
--- a/server/src/__tests__/issues-service.test.ts
+++ b/server/src/__tests__/issues-service.test.ts
@@ -657,6 +657,143 @@ describeEmbeddedPostgres("issueService.list participantAgentId", () => {
expect(projectResult.map((issue) => issue.id).sort()).toEqual([executionLinkedIssueId, projectLinkedIssueId].sort());
});
+ it("hides plugin operation issues from default lists and inbox-style filters while preserving explicit retrieval", async () => {
+ const companyId = randomUUID();
+ const agentId = randomUUID();
+ const projectId = randomUUID();
+ const normalIssueId = randomUUID();
+ const pluginVisibleIssueId = randomUUID();
+ const operationIssueId = randomUUID();
+
+ await db.insert(companies).values({
+ id: companyId,
+ name: "Paperclip",
+ issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`,
+ requireBoardApprovalForNewAgents: false,
+ });
+ await db.insert(agents).values({
+ id: agentId,
+ companyId,
+ name: "Plugin Runner",
+ role: "engineer",
+ status: "active",
+ adapterType: "codex_local",
+ adapterConfig: {},
+ runtimeConfig: {},
+ permissions: {},
+ });
+ await db.insert(projects).values({
+ id: projectId,
+ companyId,
+ name: "Plugin operations",
+ status: "in_progress",
+ });
+ await db.insert(issues).values([
+ {
+ id: normalIssueId,
+ companyId,
+ title: "Normal issue",
+ status: "todo",
+ priority: "medium",
+ assigneeAgentId: agentId,
+ },
+ {
+ id: pluginVisibleIssueId,
+ companyId,
+ title: "Plugin-visible issue",
+ status: "todo",
+ priority: "medium",
+ assigneeAgentId: agentId,
+ originKind: "plugin:paperclip.missions:feature",
+ },
+ {
+ id: operationIssueId,
+ companyId,
+ projectId,
+ title: "Plugin operation issue",
+ status: "todo",
+ priority: "medium",
+ assigneeAgentId: agentId,
+ originKind: "plugin:paperclip.missions:operation",
+ originId: "mission-alpha:operation-1",
+ },
+ ]);
+
+ const defaultIssueIds = (await svc.list(companyId)).map((issue) => issue.id);
+ expect(defaultIssueIds).toContain(normalIssueId);
+ expect(defaultIssueIds).toContain(pluginVisibleIssueId);
+ expect(defaultIssueIds).not.toContain(operationIssueId);
+
+ const inboxIssueIds = (await svc.list(companyId, {
+ assigneeAgentId: agentId,
+ status: "todo,in_progress,blocked",
+ includeRoutineExecutions: true,
+ })).map((issue) => issue.id);
+ expect(inboxIssueIds).toContain(normalIssueId);
+ expect(inboxIssueIds).not.toContain(operationIssueId);
+
+ await expect(svc.list(companyId, { originKind: "plugin:paperclip.missions:operation" }))
+ .resolves.toEqual([expect.objectContaining({ id: operationIssueId })]);
+ await expect(svc.list(companyId, { originId: "mission-alpha:operation-1" }))
+ .resolves.toEqual([expect.objectContaining({ id: operationIssueId })]);
+
+ const projectIssueIds = (await svc.list(companyId, { projectId })).map((issue) => issue.id);
+ expect(projectIssueIds).toContain(operationIssueId);
+
+ const advancedIssueIds = (await svc.list(companyId, { includePluginOperations: true })).map((issue) => issue.id);
+ expect(advancedIssueIds).toContain(operationIssueId);
+ });
+
+ it("excludes plugin operation issues from unread inbox counts", async () => {
+ const companyId = randomUUID();
+ const userId = "board-user";
+ const otherUserId = "other-user";
+ const normalIssueId = randomUUID();
+ const operationIssueId = randomUUID();
+
+ await db.insert(companies).values({
+ id: companyId,
+ name: "Paperclip",
+ issuePrefix: `T${companyId.replace(/-/g, "").slice(0, 6).toUpperCase()}`,
+ requireBoardApprovalForNewAgents: false,
+ });
+ await db.insert(issues).values([
+ {
+ id: normalIssueId,
+ companyId,
+ title: "Normal touched issue",
+ status: "todo",
+ priority: "medium",
+ createdByUserId: userId,
+ },
+ {
+ id: operationIssueId,
+ companyId,
+ title: "Plugin operation touched issue",
+ status: "todo",
+ priority: "medium",
+ createdByUserId: userId,
+ originKind: "plugin:paperclip.missions:operation",
+ },
+ ]);
+ await db.insert(issueComments).values([
+ {
+ companyId,
+ issueId: normalIssueId,
+ authorUserId: otherUserId,
+ body: "Unread normal update.",
+ },
+ {
+ companyId,
+ issueId: operationIssueId,
+ authorUserId: otherUserId,
+ body: "Unread operation update.",
+ },
+ ]);
+
+ await expect(svc.countUnreadTouchedByUser(companyId, userId, "todo")).resolves.toBe(1);
+ });
+
it("hides archived inbox issues until new external activity arrives", async () => {
const companyId = randomUUID();
const userId = "user-1";
diff --git a/server/src/__tests__/plugin-database.test.ts b/server/src/__tests__/plugin-database.test.ts
index 9aaca2f15e..6392b78e79 100644
--- a/server/src/__tests__/plugin-database.test.ts
+++ b/server/src/__tests__/plugin-database.test.ts
@@ -3,7 +3,7 @@ import { mkdtemp, rm, mkdir, writeFile } from "node:fs/promises";
import os from "node:os";
import path from "node:path";
import { and, eq, sql } from "drizzle-orm";
-import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";
import {
companies,
createDb,
@@ -25,9 +25,11 @@ import {
validatePluginRuntimeExecute,
validatePluginRuntimeQuery,
} from "../services/plugin-database.js";
+import { pluginLoader } from "../services/plugin-loader.js";
const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+const multiMigrationPluginKey = "paperclip.dbfixture";
if (!embeddedPostgresSupport.supported) {
console.warn(
@@ -93,7 +95,7 @@ describeEmbeddedPostgres("plugin database namespaces", () => {
}, 20_000);
afterEach(async () => {
- for (const pluginKey of ["paperclip.dbtest", "paperclip.escape"]) {
+ for (const pluginKey of ["paperclip.dbtest", "paperclip.escape", "paperclip.refresh", multiMigrationPluginKey]) {
const namespace = derivePluginDatabaseNamespace(pluginKey);
await db.execute(sql.raw(`DROP SCHEMA IF EXISTS "${namespace}" CASCADE`));
}
@@ -120,6 +122,31 @@ describeEmbeddedPostgres("plugin database namespaces", () => {
return packageRoot;
}
+ async function createInstallablePluginPackage(
+ pluginManifest: PaperclipPluginManifestV1,
+ migrationSql: string,
+ ) {
+ const packageRoot = await createPluginPackage(pluginManifest, migrationSql);
+ await writeFile(
+ path.join(packageRoot, "package.json"),
+ JSON.stringify({
+ name: pluginManifest.id,
+ version: pluginManifest.version,
+ type: "module",
+ paperclipPlugin: { manifest: "./manifest.js" },
+ }),
+ "utf8",
+ );
+ await writeFile(
+ path.join(packageRoot, "manifest.js"),
+ `export default ${JSON.stringify(pluginManifest, null, 2)};\n`,
+ "utf8",
+ );
+ await mkdir(path.join(packageRoot, "dist"), { recursive: true });
+ await writeFile(path.join(packageRoot, "dist", "worker.js"), "export {};\n", "utf8");
+ return packageRoot;
+ }
+
async function installPluginRecord(manifest: PaperclipPluginManifestV1) {
const pluginId = randomUUID();
await db.insert(plugins).values({
@@ -158,6 +185,31 @@ describeEmbeddedPostgres("plugin database namespaces", () => {
};
}
+ it("applies multi-file plugin migrations through the production validator", async () => {
+ const pluginManifest = manifest(multiMigrationPluginKey);
+ const namespace = derivePluginDatabaseNamespace(pluginManifest.id);
+ const packageRoot = await createPluginPackage(
+ pluginManifest,
+ `CREATE TABLE ${namespace}.source_rows (id uuid PRIMARY KEY, label text NOT NULL);`,
+ );
+ await writeFile(
+ path.join(packageRoot, pluginManifest.database!.migrationsDir, "002_derived.sql"),
+ `CREATE TABLE ${namespace}.derived_rows (
+ id uuid PRIMARY KEY,
+ source_id uuid NOT NULL REFERENCES ${namespace}.source_rows(id)
+ );`,
+ "utf8",
+ );
+ const pluginId = await installPluginRecord(pluginManifest);
+ await pluginDatabaseService(db).applyMigrations(pluginId, pluginManifest, packageRoot);
+
+ const migrations = await db
+ .select()
+ .from(pluginMigrations)
+ .where(and(eq(pluginMigrations.pluginId, pluginId), eq(pluginMigrations.status, "applied")));
+ expect(migrations).toHaveLength(2);
+ });
+
it("applies migrations once and allows whitelisted core joins at runtime", async () => {
const pluginManifest = manifest();
const namespace = derivePluginDatabaseNamespace(pluginManifest.id);
@@ -246,6 +298,131 @@ describeEmbeddedPostgres("plugin database namespaces", () => {
expect(migration?.status).toBe("failed");
});
+ it("rolls back plugin install when migration validation fails", async () => {
+ const pluginManifest = manifest("paperclip.escape");
+ const namespace = derivePluginDatabaseNamespace(pluginManifest.id);
+ const packageRoot = await createInstallablePluginPackage(
+ pluginManifest,
+ "CREATE TABLE public.plugin_escape (id uuid PRIMARY KEY);",
+ );
+ const loader = pluginLoader(db, {
+ enableLocalFilesystem: false,
+ enableNpmDiscovery: false,
+ });
+
+ await expect(loader.installPlugin({ localPath: packageRoot }))
+ .rejects.toThrow(/public\.plugin_escape|public/i);
+
+ const installedPlugins = await db
+ .select()
+ .from(plugins)
+ .where(eq(plugins.pluginKey, pluginManifest.id));
+ const namespaces = await db
+ .select()
+ .from(pluginDatabaseNamespaces)
+ .where(eq(pluginDatabaseNamespaces.pluginKey, pluginManifest.id));
+ const migrations = await db
+ .select()
+ .from(pluginMigrations)
+ .where(eq(pluginMigrations.pluginKey, pluginManifest.id));
+ const schemaRows = Array.from(
+ await db.execute(
+ sql<{ schema_name: string }>`SELECT schema_name FROM information_schema.schemata WHERE schema_name = ${namespace}`,
+ ) as Iterable<{ schema_name: string }>,
+ );
+
+ expect(installedPlugins).toHaveLength(0);
+ expect(namespaces).toHaveLength(0);
+ expect(migrations).toHaveLength(0);
+ expect(schemaRows).toHaveLength(0);
+ });
+
+ it("refreshes persisted manifests from disk before activation", async () => {
+ const staleManifest = manifest("paperclip.refresh");
+ const refreshedManifest: PaperclipPluginManifestV1 = {
+ ...staleManifest,
+ database: {
+ ...staleManifest.database!,
+ coreReadTables: ["companies"],
+ },
+ };
+ const namespace = derivePluginDatabaseNamespace(refreshedManifest.id);
+ const packageRoot = await createInstallablePluginPackage(
+ refreshedManifest,
+ `
+ CREATE TABLE ${namespace}.company_refs (
+ id uuid PRIMARY KEY,
+ company_id uuid NOT NULL REFERENCES public.companies(id)
+ );
+ `,
+ );
+ const pluginId = await installPluginRecord(staleManifest);
+ await db
+ .update(plugins)
+ .set({
+ packagePath: packageRoot,
+ status: "ready",
+ })
+ .where(eq(plugins.id, pluginId));
+
+ const workerManager = {
+ startWorker: vi.fn().mockResolvedValue(undefined),
+ stopAll: vi.fn().mockResolvedValue(undefined),
+ };
+ const loader = pluginLoader(db, {
+ enableLocalFilesystem: false,
+ enableNpmDiscovery: false,
+ }, {
+ workerManager,
+ eventBus: {
+ forPlugin: vi.fn(() => ({})),
+ subscriptionCount: vi.fn(() => 0),
+ },
+ jobScheduler: {
+ registerPlugin: vi.fn().mockResolvedValue(undefined),
+ stop: vi.fn(),
+ },
+ jobStore: {
+ syncJobDeclarations: vi.fn().mockResolvedValue(undefined),
+ },
+ toolDispatcher: {
+ registerPluginTools: vi.fn(),
+ },
+ lifecycleManager: {
+ markError: vi.fn().mockResolvedValue(undefined),
+ },
+ buildHostHandlers: vi.fn(() => ({})),
+ instanceInfo: {
+ instanceId: "test-instance",
+ hostVersion: "1.0.0",
+ deploymentMode: "authenticated",
+ deploymentExposure: "public",
+ },
+ } as never);
+
+ const result = await loader.loadSingle(pluginId);
+
+ expect(result.success).toBe(true);
+ expect(workerManager.startWorker).toHaveBeenCalledWith(
+ pluginId,
+ expect.objectContaining({
+ databaseNamespace: namespace,
+ env: {
+ PAPERCLIP_DEPLOYMENT_MODE: "authenticated",
+ PAPERCLIP_DEPLOYMENT_EXPOSURE: "public",
+ },
+ manifest: expect.objectContaining({
+ database: expect.objectContaining({ coreReadTables: ["companies"] }),
+ }),
+ }),
+ );
+ const [plugin] = await db
+ .select()
+ .from(plugins)
+ .where(eq(plugins.id, pluginId));
+ expect(plugin?.manifestJson.database?.coreReadTables).toEqual(["companies"]);
+ });
+
it("rejects checksum changes for already applied migrations", async () => {
const pluginManifest = manifest();
const namespace = derivePluginDatabaseNamespace(pluginManifest.id);
diff --git a/server/src/__tests__/plugin-local-folders.test.ts b/server/src/__tests__/plugin-local-folders.test.ts
new file mode 100644
index 0000000000..89e00eff96
--- /dev/null
+++ b/server/src/__tests__/plugin-local-folders.test.ts
@@ -0,0 +1,263 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import os from "node:os";
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import {
+ assertConfiguredLocalFolder,
+ assertWritableConfiguredLocalFolder,
+ inspectPluginLocalFolder,
+ listPluginLocalFolderEntries,
+ preparePluginLocalFolder,
+ readPluginLocalFolderText,
+ resolvePluginLocalFolderPath,
+ writePluginLocalFolderTextAtomic,
+} from "../services/plugin-local-folders.js";
+
+describe("plugin local folders", () => {
+ const tempRoots: string[] = [];
+
+ afterEach(async () => {
+ await Promise.all(tempRoots.map((root) => fs.rm(root, { recursive: true, force: true })));
+ tempRoots.length = 0;
+ });
+
+ async function makeRoot() {
+ const root = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-plugin-folder-"));
+ tempRoots.push(root);
+ return root;
+ }
+
+ it("reports a healthy generic folder when required paths exist", async () => {
+ const root = await makeRoot();
+ await fs.mkdir(path.join(root, "sources"));
+ await fs.writeFile(path.join(root, "schema.md"), "schema", "utf8");
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredDirectories: ["sources"],
+ requiredFiles: ["schema.md"],
+ },
+ });
+
+ expect(status.healthy).toBe(true);
+ expect(status.problems).toEqual([]);
+ expect(status.requiredDirectories).toEqual(["sources"]);
+ expect(status.requiredFiles).toEqual(["schema.md"]);
+ });
+
+ it("reports missing required folders and files without using product-specific branches", async () => {
+ const root = await makeRoot();
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ requiredDirectories: ["sources"],
+ requiredFiles: ["schema.md"],
+ },
+ });
+
+ expect(status.healthy).toBe(false);
+ expect(status.missingDirectories).toEqual(["sources"]);
+ expect(status.missingFiles).toEqual(["schema.md"]);
+ expect(status.problems.map((item) => item.code)).toEqual(
+ expect.arrayContaining(["missing_directory", "missing_file"]),
+ );
+ });
+
+ it("reports all required paths as missing when the configured root does not exist", async () => {
+ const root = await makeRoot();
+ const missingRoot = path.join(root, "missing-root");
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: missingRoot,
+ requiredDirectories: ["sources"],
+ requiredFiles: ["schema.md"],
+ },
+ });
+
+ expect(status.healthy).toBe(false);
+ expect(status.configured).toBe(true);
+ expect(status.readable).toBe(false);
+ expect(status.missingDirectories).toEqual(["sources"]);
+ expect(status.missingFiles).toEqual(["schema.md"]);
+ expect(status.problems.map((item) => item.code)).toContain("missing");
+ });
+
+ it("uses manifest declaration access and required paths over stored or caller overrides", async () => {
+ const root = await makeRoot();
+ await fs.mkdir(path.join(root, "manifest-dir"));
+ await fs.writeFile(path.join(root, "manifest.md"), "schema", "utf8");
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ declaration: {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "read",
+ requiredDirectories: ["manifest-dir"],
+ requiredFiles: ["manifest.md"],
+ },
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredDirectories: ["stored-dir"],
+ requiredFiles: ["stored.md"],
+ },
+ overrideConfig: {
+ access: "readWrite",
+ requiredDirectories: ["override-dir"],
+ requiredFiles: ["override.md"],
+ },
+ });
+
+ expect(status.access).toBe("read");
+ expect(status.writable).toBe(false);
+ expect(status.requiredDirectories).toEqual(["manifest-dir"]);
+ expect(status.requiredFiles).toEqual(["manifest.md"]);
+ expect(status.healthy).toBe(true);
+ });
+
+ it("prepares required directories for a read-write folder without creating required files", async () => {
+ const root = await makeRoot();
+
+ await preparePluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredDirectories: ["sources", "wiki/concepts"],
+ requiredFiles: ["schema.md"],
+ },
+ });
+
+ await expect(fs.stat(path.join(root, "sources"))).resolves.toMatchObject({});
+ await expect(fs.stat(path.join(root, "wiki/concepts"))).resolves.toMatchObject({});
+ await expect(fs.stat(path.join(root, "schema.md"))).rejects.toMatchObject({ code: "ENOENT" });
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredDirectories: ["sources", "wiki/concepts"],
+ requiredFiles: ["schema.md"],
+ },
+ });
+ expect(status.missingDirectories).toEqual([]);
+ expect(status.missingFiles).toEqual(["schema.md"]);
+ });
+
+ it("allows write access to repair folders that are only missing required paths", async () => {
+ const root = await makeRoot();
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredFiles: ["schema.md"],
+ },
+ });
+
+ expect(status.healthy).toBe(false);
+ expect(() => assertConfiguredLocalFolder(status)).toThrow("Local folder is not healthy");
+ expect(() => assertWritableConfiguredLocalFolder(status)).not.toThrow();
+
+ await writePluginLocalFolderTextAtomic(root, "schema.md", "schema");
+ const repaired = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ access: "readWrite",
+ requiredFiles: ["schema.md"],
+ },
+ });
+ expect(repaired.healthy).toBe(true);
+ });
+
+ it("rejects traversal outside the configured folder", async () => {
+ const root = await makeRoot();
+
+ await expect(resolvePluginLocalFolderPath(root, "../outside.txt")).rejects.toMatchObject({
+ status: 403,
+ });
+ });
+
+ it("detects required symlinks that escape the configured folder", async () => {
+ const root = await makeRoot();
+ const outside = await makeRoot();
+ await fs.writeFile(path.join(outside, "secret.txt"), "nope", "utf8");
+ await fs.symlink(path.join(outside, "secret.txt"), path.join(root, "linked.txt"));
+
+ const status = await inspectPluginLocalFolder({
+ folderKey: "content-root",
+ storedConfig: {
+ path: root,
+ requiredFiles: ["linked.txt"],
+ },
+ });
+
+ expect(status.healthy).toBe(false);
+ expect(status.problems.some((item) => item.code === "symlink_escape")).toBe(true);
+ });
+
+ it("writes files atomically under the root and can read them back", async () => {
+ const root = await makeRoot();
+ await fs.mkdir(path.join(root, "nested"));
+
+ await writePluginLocalFolderTextAtomic(root, "nested/page.md", "hello");
+ await writePluginLocalFolderTextAtomic(root, "nested/page.md", "updated");
+
+ await expect(readPluginLocalFolderText(root, "nested/page.md")).resolves.toBe("updated");
+ const leftovers = await fs.readdir(path.join(root, "nested"));
+ expect(leftovers.filter((name) => name.includes(".paperclip-"))).toEqual([]);
+ });
+
+ it("lists nested local folder entries without following symlink escapes", async () => {
+ const root = await makeRoot();
+ const outside = await makeRoot();
+ await fs.mkdir(path.join(root, "wiki/concepts"), { recursive: true });
+ await fs.writeFile(path.join(root, "wiki/concepts/live.md"), "# Live\n", "utf8");
+ await fs.writeFile(path.join(outside, "secret.md"), "# Secret\n", "utf8");
+ await fs.symlink(outside, path.join(root, "wiki/outside"));
+
+ const listing = await listPluginLocalFolderEntries(root, {
+ relativePath: "wiki",
+ recursive: true,
+ maxEntries: 20,
+ });
+
+ expect(listing.entries.map((entry) => entry.path)).toContain("wiki/concepts/live.md");
+ expect(listing.entries.map((entry) => entry.path)).not.toContain("wiki/outside/secret.md");
+ expect(listing.truncated).toBe(false);
+ });
+
+ it("revalidates temp-file containment before writing atomic contents", async () => {
+ const root = await makeRoot();
+ const outside = await makeRoot();
+ const nested = path.join(root, "nested");
+ await fs.mkdir(nested);
+ const originalOpen = fs.open.bind(fs);
+ const openSpy = vi.spyOn(fs, "open");
+ openSpy.mockImplementationOnce(async (file, flags, mode) => {
+ await fs.rm(nested, { recursive: true, force: true });
+ await fs.symlink(outside, nested);
+ return originalOpen(file, flags, mode);
+ });
+
+ try {
+ await expect(writePluginLocalFolderTextAtomic(root, "nested/page.md", "secret")).rejects.toMatchObject({
+ status: 403,
+ });
+ await expect(fs.readFile(path.join(outside, "page.md"), "utf8")).rejects.toMatchObject({ code: "ENOENT" });
+ expect(await fs.readdir(outside)).toEqual([]);
+ } finally {
+ openSpy.mockRestore();
+ }
+ });
+});
diff --git a/server/src/__tests__/plugin-managed-agents.test.ts b/server/src/__tests__/plugin-managed-agents.test.ts
new file mode 100644
index 0000000000..ed512a8d65
--- /dev/null
+++ b/server/src/__tests__/plugin-managed-agents.test.ts
@@ -0,0 +1,365 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { eq } from "drizzle-orm";
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import {
+ activityLog,
+ agentConfigRevisions,
+ agents,
+ approvals,
+ companies,
+ createDb,
+ pluginEntities,
+ pluginCompanySettings,
+ pluginManagedResources,
+ plugins,
+} from "@paperclipai/db";
+import type { PaperclipPluginManifestV1 } from "@paperclipai/shared";
+import {
+ getEmbeddedPostgresTestSupport,
+ startEmbeddedPostgresTestDatabase,
+} from "./helpers/embedded-postgres.js";
+import { buildHostServices } from "../services/plugin-host-services.js";
+
+const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
+const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+
+function createEventBusStub() {
+ return {
+ forPlugin() {
+ return {
+ emit: async () => {},
+ subscribe: () => {},
+ };
+ },
+ } as any;
+}
+
+function issuePrefix(id: string) {
+ return `T${id.replace(/-/g, "").slice(0, 6).toUpperCase()}`;
+}
+
+function manifest(): PaperclipPluginManifestV1 {
+ return {
+ id: "paperclip.managed-agents-test",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "Managed Agents Test",
+ description: "Test plugin",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["agents.managed"],
+ entrypoints: { worker: "./dist/worker.js" },
+ agents: [
+ {
+ agentKey: "wiki-maintainer",
+ displayName: "Wiki Maintainer",
+ role: "engineer",
+ title: "Maintains plugin-owned knowledge",
+ capabilities: "Maintains a plugin-owned wiki.",
+ adapterType: "process",
+ adapterConfig: { command: "pnpm wiki:maintain" },
+ runtimeConfig: { modelProfiles: { cheap: { enabled: true, adapterConfig: { model: "small" } } } },
+ permissions: { canCreateAgents: false },
+ budgetMonthlyCents: 1234,
+ },
+ ],
+ };
+}
+
+if (!embeddedPostgresSupport.supported) {
+ console.warn(
+ `Skipping embedded Postgres plugin-managed agent tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`,
+ );
+}
+
+describeEmbeddedPostgres("plugin-managed agents", () => {
+ let db!: ReturnType<typeof createDb>;
+ let tempDb: Awaited<ReturnType<typeof startEmbeddedPostgresTestDatabase>> | null = null;
+
+ beforeAll(async () => {
+ tempDb = await startEmbeddedPostgresTestDatabase("paperclip-plugin-managed-agents-");
+ db = createDb(tempDb.connectionString);
+ }, 20_000);
+
+ afterEach(async () => {
+ await db.delete(agentConfigRevisions);
+ await db.delete(activityLog);
+ await db.delete(pluginEntities);
+ await db.delete(pluginManagedResources);
+ await db.delete(pluginCompanySettings);
+ await db.delete(approvals);
+ await db.delete(agents);
+ await db.delete(plugins);
+ await db.delete(companies);
+ });
+
+ afterAll(async () => {
+ await tempDb?.cleanup();
+ });
+
+ async function seedCompanyAndPlugin(options: { requireApproval?: boolean; manifest?: PaperclipPluginManifestV1 } = {}) {
+ const companyId = randomUUID();
+ const pluginId = randomUUID();
+ const pluginManifest = options.manifest ?? manifest();
+ await db.insert(companies).values({
+ id: companyId,
+ name: "Paperclip",
+ issuePrefix: issuePrefix(companyId),
+ requireBoardApprovalForNewAgents: options.requireApproval ?? false,
+ });
+ await db.insert(plugins).values({
+ id: pluginId,
+ pluginKey: pluginManifest.id,
+ packageName: "@paperclipai/plugin-managed-agents-test",
+ version: pluginManifest.version,
+ apiVersion: pluginManifest.apiVersion,
+ categories: pluginManifest.categories,
+ manifestJson: pluginManifest,
+ status: "ready",
+ installOrder: 1,
+ });
+ const services = buildHostServices(db, pluginId, pluginManifest.id, createEventBusStub(), undefined, {
+ manifest: pluginManifest,
+ });
+ return { companyId, pluginId, pluginManifest, services };
+ }
+
+ it("creates and resolves managed agents by stable resource key", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin();
+
+ const created = await services.agents.managedReconcile({
+ companyId,
+ agentKey: "wiki-maintainer",
+ });
+
+ expect(created.status).toBe("created");
+ expect(created.agentId).toBeTruthy();
+ expect(created.agent).toMatchObject({
+ name: "Wiki Maintainer",
+ role: "engineer",
+ adapterConfig: { command: "pnpm wiki:maintain" },
+ });
+
+ const resolved = await services.agents.managedGet({
+ companyId,
+ agentKey: "wiki-maintainer",
+ });
+ expect(resolved.status).toBe("resolved");
+ expect(resolved.agentId).toBe(created.agentId);
+
+ const [binding] = await db.select().from(pluginEntities);
+ expect(binding?.entityType).toBe("managed_agent");
+ expect(binding?.scopeKind).toBe("company");
+ expect(binding?.scopeId).toBe(companyId);
+ expect(binding?.data).toMatchObject({
+ resourceKind: "agent",
+ resourceKey: "wiki-maintainer",
+ agentId: created.agentId,
+ });
+ });
+
+ it("preserves user edits during reconcile and resets only on explicit reset", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin();
+ const created = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+ expect(created.agentId).toBeTruthy();
+
+ await db
+ .update(agents)
+ .set({
+ name: "Knowledge Lead",
+ adapterConfig: { command: "custom" },
+ updatedAt: new Date(),
+ })
+ .where(eq(agents.id, created.agentId!));
+
+ const reconciled = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+ expect(reconciled.status).toBe("resolved");
+ expect(reconciled.agent).toMatchObject({
+ name: "Knowledge Lead",
+ adapterConfig: { command: "custom" },
+ });
+
+ const reset = await services.agents.managedReset({ companyId, agentKey: "wiki-maintainer" });
+ expect(reset.status).toBe("reset");
+ expect(reset.agent).toMatchObject({
+ name: "Wiki Maintainer",
+ adapterConfig: { command: "pnpm wiki:maintain" },
+ });
+ });
+
+ it("creates managed agents with the most-used compatible company adapter", async () => {
+ const pluginManifest = manifest();
+ pluginManifest.agents![0] = {
+ ...pluginManifest.agents![0]!,
+ adapterType: "claude_local",
+ adapterPreference: ["claude_local", "codex_local"],
+ adapterConfig: {},
+ };
+ const { companyId, services } = await seedCompanyAndPlugin({ manifest: pluginManifest });
+ await db.insert(agents).values([
+ {
+ id: randomUUID(),
+ companyId,
+ name: "Codex One",
+ role: "engineer",
+ status: "idle",
+ adapterType: "codex_local",
+ adapterConfig: {},
+ runtimeConfig: {},
+ permissions: {},
+ },
+ {
+ id: randomUUID(),
+ companyId,
+ name: "Codex Two",
+ role: "engineer",
+ status: "idle",
+ adapterType: "codex_local",
+ adapterConfig: {},
+ runtimeConfig: {},
+ permissions: {},
+ },
+ {
+ id: randomUUID(),
+ companyId,
+ name: "Claude One",
+ role: "engineer",
+ status: "idle",
+ adapterType: "claude_local",
+ adapterConfig: {},
+ runtimeConfig: {},
+ permissions: {},
+ },
+ ]);
+
+ const created = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+
+ expect(created.status).toBe("created");
+ expect(created.agent?.adapterType).toBe("codex_local");
+ });
+
+ it("materializes declared managed agent instructions with local folder paths", async () => {
+ const previousHome = process.env.PAPERCLIP_HOME;
+ const previousInstance = process.env.PAPERCLIP_INSTANCE_ID;
+ const tempHome = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-managed-agent-home-"));
+ const wikiRoot = await fs.realpath(await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-managed-agent-wiki-")));
+ process.env.PAPERCLIP_HOME = tempHome;
+ process.env.PAPERCLIP_INSTANCE_ID = "test";
+ try {
+ const pluginManifest = manifest();
+ pluginManifest.localFolders = [
+ {
+ folderKey: "wiki-root",
+ displayName: "Wiki root",
+ access: "readWrite",
+ requiredDirectories: [],
+ requiredFiles: ["AGENTS.md"],
+ },
+ ];
+ pluginManifest.agents![0] = {
+ ...pluginManifest.agents![0]!,
+ adapterType: "claude_local",
+ adapterConfig: {},
+ instructions: {
+ entryFile: "AGENTS.md",
+ content: [
+ "# LLM Wiki Maintainer",
+ "",
+ "You are the LLM Wiki Maintainer.",
+ "Wiki root: `{{localFolders.wiki-root.path}}`",
+ "Wiki schema: `{{localFolders.wiki-root.agentsPath}}`",
+ "",
+ ].join("\n"),
+ },
+ };
+ const { companyId, pluginId, services } = await seedCompanyAndPlugin({ manifest: pluginManifest });
+ await fs.writeFile(path.join(wikiRoot, "AGENTS.md"), "# Wiki schema\n", "utf8");
+ await db.insert(pluginCompanySettings).values({
+ companyId,
+ pluginId,
+ enabled: true,
+ settingsJson: {
+ localFolders: {
+ "wiki-root": {
+ path: wikiRoot,
+ access: "readWrite",
+ requiredDirectories: [],
+ requiredFiles: ["AGENTS.md"],
+ },
+ },
+ },
+ });
+
+ const created = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+
+ const instructionsFilePath = created.agent?.adapterConfig.instructionsFilePath;
+ expect(typeof instructionsFilePath).toBe("string");
+ const content = await fs.readFile(instructionsFilePath as string, "utf8");
+ expect(content).toContain("You are the LLM Wiki Maintainer.");
+ expect(content).toContain(`Wiki root: \`${wikiRoot}\``);
+ expect(content).toContain(`Wiki schema: \`${path.join(wikiRoot, "AGENTS.md")}\``);
+ } finally {
+ if (previousHome === undefined) delete process.env.PAPERCLIP_HOME;
+ else process.env.PAPERCLIP_HOME = previousHome;
+ if (previousInstance === undefined) delete process.env.PAPERCLIP_INSTANCE_ID;
+ else process.env.PAPERCLIP_INSTANCE_ID = previousInstance;
+ await fs.rm(tempHome, { recursive: true, force: true });
+ await fs.rm(wikiRoot, { recursive: true, force: true });
+ }
+ });
+
+ it("repairs a missing binding by relinking a same-company managed agent marker", async () => {
+ const { companyId, pluginId, pluginManifest, services } = await seedCompanyAndPlugin();
+ const agentId = randomUUID();
+ await db.insert(agents).values({
+ id: agentId,
+ companyId,
+ name: "Renamed Wiki Agent",
+ role: "engineer",
+ status: "idle",
+ adapterType: "process",
+ adapterConfig: { command: "custom" },
+ runtimeConfig: {},
+ permissions: {},
+ metadata: {
+ paperclipManagedResource: {
+ pluginId,
+ pluginKey: pluginManifest.id,
+ resourceKind: "agent",
+ resourceKey: "wiki-maintainer",
+ },
+ },
+ });
+
+ const relinked = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+ expect(relinked.status).toBe("relinked");
+ expect(relinked.agentId).toBe(agentId);
+
+ const [binding] = await db.select().from(pluginEntities);
+ expect(binding?.data).toMatchObject({ agentId });
+ });
+
+ it("respects board approval policy for new managed agents", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin({ requireApproval: true });
+
+ const created = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+
+ expect(created.status).toBe("created");
+ expect(created.agent?.status).toBe("pending_approval");
+ expect(created.approvalId).toBeTruthy();
+
+ const [approval] = await db.select().from(approvals).where(eq(approvals.id, created.approvalId!));
+ expect(approval).toMatchObject({
+ type: "hire_agent",
+ status: "pending",
+ });
+ expect(approval?.payload).toMatchObject({
+ agentId: created.agentId,
+ sourcePluginKey: "paperclip.managed-agents-test",
+ managedResourceKey: "wiki-maintainer",
+ });
+ });
+});
diff --git a/server/src/__tests__/plugin-managed-routines.test.ts b/server/src/__tests__/plugin-managed-routines.test.ts
new file mode 100644
index 0000000000..6f89cac17a
--- /dev/null
+++ b/server/src/__tests__/plugin-managed-routines.test.ts
@@ -0,0 +1,249 @@
+import { randomUUID } from "node:crypto";
+import { eq } from "drizzle-orm";
+import { afterAll, afterEach, beforeAll, describe, expect, it, vi } from "vitest";
+import {
+ activityLog,
+ agentConfigRevisions,
+ agents,
+ companies,
+ createDb,
+ issues,
+ pluginManagedResources,
+ plugins,
+ projects,
+ routineRuns,
+ routineTriggers,
+ routines,
+} from "@paperclipai/db";
+import type { PaperclipPluginManifestV1 } from "@paperclipai/shared";
+import {
+ getEmbeddedPostgresTestSupport,
+ startEmbeddedPostgresTestDatabase,
+} from "./helpers/embedded-postgres.js";
+import { buildHostServices } from "../services/plugin-host-services.js";
+import { routineService } from "../services/routines.js";
+
+const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
+const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+
+function createEventBusStub() {
+ return {
+ forPlugin() {
+ return {
+ emit: async () => {},
+ subscribe: () => {},
+ };
+ },
+ } as any;
+}
+
+function issuePrefix(id: string) {
+ return `T${id.replace(/-/g, "").slice(0, 6).toUpperCase()}`;
+}
+
+function manifest(): PaperclipPluginManifestV1 {
+ return {
+ id: "paperclip.managed-routines-test",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "Managed Routines Test",
+ description: "Test plugin",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["agents.managed", "projects.managed", "routines.managed"],
+ entrypoints: { worker: "./dist/worker.js" },
+ agents: [{
+ agentKey: "wiki-maintainer",
+ displayName: "Wiki Maintainer",
+ role: "engineer",
+ adapterType: "process",
+ adapterConfig: { command: "pnpm wiki:maintain" },
+ }],
+ projects: [{
+ projectKey: "operations",
+ displayName: "Plugin Operations",
+ description: "Plugin operation inspection",
+ status: "in_progress",
+ }],
+ routines: [{
+ routineKey: "nightly-lint",
+ title: "Nightly lint",
+ description: "Lint plugin state",
+ assigneeRef: { resourceKind: "agent", resourceKey: "wiki-maintainer" },
+ projectRef: { resourceKind: "project", resourceKey: "operations" },
+ status: "active",
+ priority: "medium",
+ concurrencyPolicy: "coalesce_if_active",
+ catchUpPolicy: "skip_missed",
+ triggers: [{
+ kind: "schedule",
+ label: "Nightly",
+ cronExpression: "0 3 * * *",
+ timezone: "UTC",
+ }],
+ issueTemplate: {
+ surfaceVisibility: "plugin_operation",
+ originId: "operation:nightly-lint",
+ billingCode: "plugin-test:nightly-lint",
+ },
+ }],
+ };
+}
+
+if (!embeddedPostgresSupport.supported) {
+ console.warn(
+ `Skipping embedded Postgres plugin-managed routine tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`,
+ );
+}
+
+describeEmbeddedPostgres("plugin-managed routines", () => {
+ let db!: ReturnType<typeof createDb>;
+ let tempDb: Awaited<ReturnType<typeof startEmbeddedPostgresTestDatabase>> | null = null;
+
+ beforeAll(async () => {
+ tempDb = await startEmbeddedPostgresTestDatabase("paperclip-plugin-managed-routines-");
+ db = createDb(tempDb.connectionString);
+ }, 20_000);
+
+ afterEach(async () => {
+ await db.delete(routineRuns);
+ await db.delete(routineTriggers);
+ await db.delete(routines);
+ await db.delete(issues);
+ await db.delete(agentConfigRevisions);
+ await db.delete(activityLog);
+ await db.delete(pluginManagedResources);
+ await db.delete(agents);
+ await db.delete(projects);
+ await db.delete(plugins);
+ await db.delete(companies);
+ });
+
+ afterAll(async () => {
+ await tempDb?.cleanup();
+ });
+
+ async function seedCompanyAndPlugin(pluginManifest = manifest()) {
+ const companyId = randomUUID();
+ const pluginId = randomUUID();
+ await db.insert(companies).values({
+ id: companyId,
+ name: "Paperclip",
+ issuePrefix: issuePrefix(companyId),
+ });
+ await db.insert(plugins).values({
+ id: pluginId,
+ pluginKey: pluginManifest.id,
+ packageName: "@paperclipai/plugin-managed-routines-test",
+ version: pluginManifest.version,
+ apiVersion: pluginManifest.apiVersion,
+ categories: pluginManifest.categories,
+ manifestJson: pluginManifest,
+ status: "ready",
+ installOrder: 1,
+ });
+ const services = buildHostServices(db, pluginId, pluginManifest.id, createEventBusStub(), undefined, {
+ manifest: pluginManifest,
+ });
+ return { companyId, pluginId, pluginManifest, services };
+ }
+
+ it("resolves routine agent and project refs by stable managed keys", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin();
+ const agent = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+ const project = await services.projects.reconcileManaged({ companyId, projectKey: "operations" });
+
+ const created = await services.routines.managedReconcile({ companyId, routineKey: "nightly-lint" });
+
+ expect(created.status).toBe("created");
+ expect(created.routine).toMatchObject({
+ title: "Nightly lint",
+ assigneeAgentId: agent.agentId,
+ projectId: project.projectId,
+ managedByPlugin: expect.objectContaining({
+ pluginKey: "paperclip.managed-routines-test",
+ resourceKind: "routine",
+ resourceKey: "nightly-lint",
+ }),
+ });
+
+ const [trigger] = await db.select().from(routineTriggers).where(eq(routineTriggers.routineId, created.routineId!));
+ expect(trigger).toMatchObject({
+ kind: "schedule",
+ cronExpression: "0 3 * * *",
+ timezone: "UTC",
+ });
+ });
+
+ it("returns missing refs until the operator repairs them and preserves routine edits on reconcile", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin();
+
+ const missing = await services.routines.managedReconcile({ companyId, routineKey: "nightly-lint" });
+ expect(missing.status).toBe("missing_refs");
+ expect(missing.missingRefs).toEqual([
+ expect.objectContaining({ resourceKind: "agent", resourceKey: "wiki-maintainer" }),
+ expect.objectContaining({ resourceKind: "project", resourceKey: "operations" }),
+ ]);
+
+ const [agent] = await db.insert(agents).values({
+ companyId,
+ name: "Operator-selected maintainer",
+ role: "engineer",
+ status: "idle",
+ adapterType: "process",
+ adapterConfig: {},
+ runtimeConfig: {},
+ permissions: {},
+ }).returning();
+ const [project] = await db.insert(projects).values({
+ companyId,
+ name: "Operator-selected project",
+ status: "in_progress",
+ }).returning();
+
+ const repaired = await services.routines.managedReconcile({
+ companyId,
+ routineKey: "nightly-lint",
+ assigneeAgentId: agent.id,
+ projectId: project.id,
+ });
+ expect(repaired.status).toBe("created");
+ expect(repaired.routine).toMatchObject({
+ assigneeAgentId: agent.id,
+ projectId: project.id,
+ });
+
+ await db
+ .update(routines)
+ .set({ title: "Operator renamed lint", updatedAt: new Date() })
+ .where(eq(routines.id, repaired.routineId!));
+
+ const reconciled = await services.routines.managedReconcile({ companyId, routineKey: "nightly-lint" });
+ expect(reconciled.status).toBe("resolved");
+ expect(reconciled.routine?.title).toBe("Operator renamed lint");
+ });
+
+ it("creates routine operation issues with plugin visibility and managed project scoping", async () => {
+ const { companyId, services } = await seedCompanyAndPlugin();
+ const agent = await services.agents.managedReconcile({ companyId, agentKey: "wiki-maintainer" });
+ const project = await services.projects.reconcileManaged({ companyId, projectKey: "operations" });
+ const routine = await services.routines.managedReconcile({ companyId, routineKey: "nightly-lint" });
+ const wakeup = vi.fn(async () => ({ id: randomUUID() }));
+ const routinesSvc = routineService(db, { heartbeat: { wakeup } });
+
+ const run = await routinesSvc.runRoutine(routine.routineId!, { source: "manual" }, { userId: "board-user" });
+
+ expect(run.status).toBe("issue_created");
+ const [issue] = await db.select().from(issues).where(eq(issues.id, run.linkedIssueId!));
+ expect(issue).toMatchObject({
+ originKind: "plugin:paperclip.managed-routines-test:operation",
+ originId: "operation:nightly-lint",
+ billingCode: "plugin-test:nightly-lint",
+ projectId: project.projectId,
+ assigneeAgentId: agent.agentId,
+ });
+ expect(wakeup).toHaveBeenCalledWith(agent.agentId, expect.objectContaining({
+ reason: "issue_assigned",
+ }));
+ });
+});
diff --git a/server/src/__tests__/plugin-orchestration-apis.test.ts b/server/src/__tests__/plugin-orchestration-apis.test.ts
index b8ee02e962..402419c68b 100644
--- a/server/src/__tests__/plugin-orchestration-apis.test.ts
+++ b/server/src/__tests__/plugin-orchestration-apis.test.ts
@@ -1,4 +1,7 @@
import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
import { and, eq } from "drizzle-orm";
import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
import {
@@ -11,6 +14,9 @@ import {
heartbeatRuns,
issueRelations,
issues,
+ pluginManagedResources,
+ plugins,
+ projects,
} from "@paperclipai/db";
import {
getEmbeddedPostgresTestSupport,
@@ -45,6 +51,7 @@ if (!embeddedPostgresSupport.supported) {
describeEmbeddedPostgres("plugin orchestration APIs", () => {
let db!: ReturnType<typeof createDb>;
let tempDb: Awaited<ReturnType<typeof startEmbeddedPostgresTestDatabase>> | null = null;
+ const tempRoots: string[] = [];
beforeAll(async () => {
tempDb = await startEmbeddedPostgresTestDatabase("paperclip-plugin-orchestration-");
@@ -52,12 +59,17 @@ describeEmbeddedPostgres("plugin orchestration APIs", () => {
}, 20_000);
afterEach(async () => {
+ await Promise.all(tempRoots.map((root) => fs.rm(root, { recursive: true, force: true })));
+ tempRoots.length = 0;
await db.delete(activityLog);
await db.delete(costEvents);
await db.delete(heartbeatRuns);
await db.delete(agentWakeupRequests);
await db.delete(issueRelations);
await db.delete(issues);
+ await db.delete(pluginManagedResources);
+ await db.delete(projects);
+ await db.delete(plugins);
await db.delete(agents);
await db.delete(companies);
});
@@ -89,6 +101,12 @@ describeEmbeddedPostgres("plugin orchestration APIs", () => {
return { companyId, agentId };
}
+ async function makeLocalRoot() {
+ const root = await fs.mkdtemp(path.join(os.tmpdir(), "paperclip-plugin-host-folder-"));
+ tempRoots.push(root);
+ return root;
+ }
+
it("creates plugin-origin issues with full orchestration fields and audit activity", async () => {
const { companyId, agentId } = await seedCompanyAndAgent();
const blockerIssueId = randomUUID();
@@ -189,6 +207,293 @@ describeEmbeddedPostgres("plugin orchestration APIs", () => {
).rejects.toThrow("Plugin may only use originKind values under plugin:paperclip.missions");
});
+ it("creates plugin operation issues with the generic operation origin", async () => {
+ const { companyId } = await seedCompanyAndAgent();
+ const services = buildHostServices(db, "plugin-record-id", "paperclip.missions", createEventBusStub());
+
+ const issue = await services.issues.create({
+ companyId,
+ title: "Background operation",
+ surfaceVisibility: "plugin_operation",
+ originId: "mission-alpha:operation-1",
+ });
+
+ expect(issue.originKind).toBe("plugin:paperclip.missions:operation");
+ expect(issue.originId).toBe("mission-alpha:operation-1");
+ });
+
+ it("lets bootstrap-style actions initialize required local folders from an empty root", async () => {
+ const { companyId } = await seedCompanyAndAgent();
+ const pluginId = randomUUID();
+ await db.insert(plugins).values({
+ id: pluginId,
+ pluginKey: "paperclipai.plugin-llm-wiki",
+ packageName: "@paperclipai/plugin-llm-wiki",
+ version: "0.1.0",
+ manifestJson: {
+ id: "paperclipai.plugin-llm-wiki",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "LLM Wiki",
+ description: "Local-file LLM Wiki plugin",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["local.folders"],
+ entrypoints: { worker: "./dist/worker.js" },
+ localFolders: [
+ {
+ folderKey: "wiki-root",
+ displayName: "Wiki root",
+ access: "readWrite",
+ requiredDirectories: ["raw", "wiki", "wiki/concepts", ".paperclip"],
+ requiredFiles: ["WIKI.md", "AGENTS.md"],
+ },
+ ],
+ },
+ status: "ready",
+ });
+ const root = await makeLocalRoot();
+ const services = buildHostServices(
+ db,
+ pluginId,
+ "paperclipai.plugin-llm-wiki",
+ createEventBusStub(),
+ undefined,
+ {
+ manifest: {
+ id: "paperclipai.plugin-llm-wiki",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "LLM Wiki",
+ description: "Local-file LLM Wiki plugin",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["local.folders"],
+ entrypoints: { worker: "./dist/worker.js" },
+ localFolders: [
+ {
+ folderKey: "wiki-root",
+ displayName: "Wiki root",
+ access: "readWrite",
+ requiredDirectories: ["raw", "wiki", "wiki/concepts", ".paperclip"],
+ requiredFiles: ["WIKI.md", "AGENTS.md"],
+ },
+ ],
+ },
+ },
+ );
+
+ const configured = await services.localFolders.configure({
+ companyId,
+ folderKey: "wiki-root",
+ path: root,
+ access: "readWrite",
+ requiredDirectories: ["raw", "wiki", "wiki/concepts", ".paperclip"],
+ requiredFiles: ["WIKI.md", "AGENTS.md"],
+ });
+ expect(configured.healthy).toBe(false);
+ expect(configured.missingDirectories).toEqual([]);
+ expect(configured.missingFiles).toEqual(["WIKI.md", "AGENTS.md"]);
+
+ await fs.rm(path.join(root, "raw"), { recursive: true, force: true });
+ await fs.rm(path.join(root, "wiki"), { recursive: true, force: true });
+ await expect(services.localFolders.readText({ companyId, folderKey: "wiki-root", relativePath: "WIKI.md" }))
+ .rejects.toThrow("Local folder is not healthy");
+ await services.localFolders.writeTextAtomic({
+ companyId,
+ folderKey: "wiki-root",
+ relativePath: "WIKI.md",
+ contents: "# Wiki\n",
+ });
+ await services.localFolders.writeTextAtomic({
+ companyId,
+ folderKey: "wiki-root",
+ relativePath: "AGENTS.md",
+ contents: "# Agents\n",
+ });
+
+ const finalStatus = await services.localFolders.status({ companyId, folderKey: "wiki-root" });
+ expect(finalStatus.healthy).toBe(true);
+ await expect(fs.stat(path.join(root, "raw"))).resolves.toMatchObject({});
+ await expect(fs.stat(path.join(root, "wiki/concepts"))).resolves.toMatchObject({});
+ await expect(fs.readFile(path.join(root, "WIKI.md"), "utf8")).resolves.toBe("# Wiki\n");
+ });
+
+ it("rejects worker local-folder access for undeclared manifest keys", async () => {
+ const { companyId } = await seedCompanyAndAgent();
+ const pluginId = randomUUID();
+ await db.insert(plugins).values({
+ id: pluginId,
+ pluginKey: "paperclip.local-folders",
+ packageName: "@paperclip/plugin-local-folders",
+ version: "0.1.0",
+ manifestJson: {
+ id: "paperclip.local-folders",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "Local Folders",
+ description: "Local folder fixture",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["local.folders"],
+ entrypoints: { worker: "./dist/worker.js" },
+ localFolders: [
+ {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "readWrite",
+ },
+ ],
+ },
+ status: "ready",
+ });
+ const services = buildHostServices(
+ db,
+ pluginId,
+ "paperclip.local-folders",
+ createEventBusStub(),
+ undefined,
+ {
+ manifest: {
+ id: "paperclip.local-folders",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "Local Folders",
+ description: "Local folder fixture",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["local.folders"],
+ entrypoints: { worker: "./dist/worker.js" },
+ localFolders: [
+ {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "readWrite",
+ },
+ ],
+ },
+ },
+ );
+ await expect(services.localFolders.configure({
+ companyId,
+ folderKey: "ssh",
+ path: "/tmp",
+ access: "read",
+ })).rejects.toThrow("Local folder key is not declared");
+ await expect(services.localFolders.status({ companyId, folderKey: "ssh" }))
+ .rejects.toThrow("Local folder key is not declared");
+ await expect(services.localFolders.readText({ companyId, folderKey: "ssh", relativePath: "id_rsa" }))
+ .rejects.toThrow("Local folder key is not declared");
+ await expect(services.localFolders.writeTextAtomic({
+ companyId,
+ folderKey: "ssh",
+ relativePath: "id_rsa",
+ contents: "secret",
+ })).rejects.toThrow("Local folder key is not declared");
+ });
+
+ it("resolves plugin-managed projects by stable key without overwriting user edits", async () => {
+ const { companyId } = await seedCompanyAndAgent();
+ const pluginId = randomUUID();
+ await db.insert(plugins).values({
+ id: pluginId,
+ pluginKey: "paperclip.missions",
+ packageName: "@paperclip/plugin-missions",
+ version: "0.1.0",
+ apiVersion: 1,
+ categories: ["automation"],
+ status: "ready",
+ manifestJson: {
+ id: "paperclip.missions",
+ apiVersion: 1,
+ version: "0.1.0",
+ displayName: "Missions",
+ description: "Mission orchestration",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["projects.managed"],
+ entrypoints: { worker: "./dist/worker.js" },
+ projects: [{
+ projectKey: "operations",
+ displayName: "Mission Operations",
+ description: "Plugin operation inspection area",
+ status: "in_progress",
+ color: "#14b8a6",
+ settings: { surface: "operations" },
+ }],
+ },
+ });
+
+ const services = buildHostServices(db, pluginId, "paperclip.missions", createEventBusStub());
+ const missing = await services.projects.getManaged({ companyId, projectKey: "operations" });
+ expect(missing.status).toBe("missing");
+ expect(missing.projectId).toBeNull();
+ await expect(
+ db
+ .select()
+ .from(pluginManagedResources)
+ .where(and(
+ eq(pluginManagedResources.companyId, companyId),
+ eq(pluginManagedResources.pluginId, pluginId),
+ eq(pluginManagedResources.resourceKind, "project"),
+ eq(pluginManagedResources.resourceKey, "operations"),
+ )),
+ ).resolves.toHaveLength(0);
+
+ const created = await services.projects.reconcileManaged({ companyId, projectKey: "operations" });
+
+ expect(created.status).toBe("created");
+ expect(created.projectId).toEqual(expect.any(String));
+ expect(created.project?.managedByPlugin).toMatchObject({
+ pluginId,
+ pluginKey: "paperclip.missions",
+ pluginDisplayName: "Missions",
+ resourceKind: "project",
+ resourceKey: "operations",
+ });
+
+ await db
+ .update(projects)
+ .set({ name: "Renamed by operator", description: "User-owned text", updatedAt: new Date() })
+ .where(eq(projects.id, created.projectId!));
+ await db
+ .update(plugins)
+ .set({
+ manifestJson: {
+ id: "paperclip.missions",
+ apiVersion: 1,
+ version: "0.2.0",
+ displayName: "Missions",
+ description: "Mission orchestration",
+ author: "Paperclip",
+ categories: ["automation"],
+ capabilities: ["projects.managed"],
+ entrypoints: { worker: "./dist/worker.js" },
+ projects: [{
+ projectKey: "operations",
+ displayName: "Upgraded Default Name",
+ description: "Upgraded default description",
+ status: "planned",
+ color: "#f97316",
+ settings: { surface: "operations", upgraded: true },
+ }],
+ },
+ updatedAt: new Date(),
+ })
+ .where(eq(plugins.id, pluginId));
+
+ const resolved = await services.projects.reconcileManaged({ companyId, projectKey: "operations" });
+
+ expect(resolved.status).toBe("resolved");
+ expect(resolved.projectId).toBe(created.projectId);
+ expect(resolved.project?.name).toBe("Renamed by operator");
+ expect(resolved.project?.description).toBe("User-owned text");
+ expect(resolved.project?.managedByPlugin?.defaultsJson).toMatchObject({
+ displayName: "Upgraded Default Name",
+ settings: { upgraded: true },
+ });
+ });
+
it("asserts checkout ownership for run-scoped plugin actions", async () => {
const { companyId, agentId } = await seedCompanyAndAgent();
const issueId = randomUUID();
diff --git a/server/src/__tests__/plugin-routes-authz.test.ts b/server/src/__tests__/plugin-routes-authz.test.ts
index df41f7ff52..faf3487bf6 100644
--- a/server/src/__tests__/plugin-routes-authz.test.ts
+++ b/server/src/__tests__/plugin-routes-authz.test.ts
@@ -6,6 +6,8 @@ const mockRegistry = vi.hoisted(() => ({
getById: vi.fn(),
getByKey: vi.fn(),
upsertConfig: vi.fn(),
+ getCompanySettings: vi.fn(),
+ upsertCompanySettings: vi.fn(),
}));
const mockLifecycle = vi.hoisted(() => ({
@@ -317,6 +319,61 @@ describe.sequential("scoped plugin API routes", () => {
}, 20_000);
});
+describe.sequential("plugin local folder routes", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ mockRegistry.getCompanySettings.mockResolvedValue(null);
+ });
+
+ function readyLocalFolderPlugin() {
+ mockRegistry.getById.mockResolvedValue({
+ id: pluginId,
+ pluginKey: "paperclip.example",
+ version: "1.0.0",
+ status: "ready",
+ manifestJson: {
+ id: "paperclip.example",
+ capabilities: ["local.folders"],
+ localFolders: [
+ {
+ folderKey: "content-root",
+ displayName: "Content root",
+ access: "readWrite",
+ requiredDirectories: ["docs"],
+ requiredFiles: ["README.md"],
+ },
+ ],
+ },
+ });
+ }
+
+ it("rejects validation for undeclared local folder keys", async () => {
+ readyLocalFolderPlugin();
+ const { app } = await createApp(boardActor());
+
+ const res = await request(app)
+ .post(`/api/plugins/${pluginId}/companies/${companyA}/local-folders/ssh/validate`)
+ .send({ path: "/tmp" });
+
+ expect(res.status).toBe(400);
+ expect(res.body.error).toContain("Local folder key is not declared");
+ expect(mockRegistry.upsertCompanySettings).not.toHaveBeenCalled();
+ });
+
+ it("rejects saving undeclared local folder keys", async () => {
+ readyLocalFolderPlugin();
+ const { app } = await createApp(boardActor());
+
+ const res = await request(app)
+ .put(`/api/plugins/${pluginId}/companies/${companyA}/local-folders/ssh`)
+ .send({ path: "/tmp" });
+
+ expect(res.status).toBe(400);
+ expect(res.body.error).toContain("Local folder key is not declared");
+ expect(mockRegistry.upsertCompanySettings).not.toHaveBeenCalled();
+ });
+});
+
describe.sequential("plugin tool and bridge authz", () => {
beforeEach(() => {
vi.clearAllMocks();
diff --git a/server/src/__tests__/plugin-scoped-api-routes.test.ts b/server/src/__tests__/plugin-scoped-api-routes.test.ts
index 1dab1edfad..4e2ce297bc 100644
--- a/server/src/__tests__/plugin-scoped-api-routes.test.ts
+++ b/server/src/__tests__/plugin-scoped-api-routes.test.ts
@@ -98,6 +98,7 @@ describe.sequential("plugin scoped API routes", () => {
const pluginId = "11111111-1111-4111-8111-111111111111";
const companyId = "22222222-2222-4222-8222-222222222222";
const agentId = "33333333-3333-4333-8333-333333333333";
+ const peerAgentId = "33333333-3333-4333-8333-333333333334";
const runId = "44444444-4444-4444-8444-444444444444";
const issueId = "55555555-5555-4555-8555-555555555555";
@@ -252,6 +253,55 @@ describe.sequential("plugin scoped API routes", () => {
}));
});
+ it("allows non-assignee agents on in-progress required checkout routes without claiming checkout ownership", async () => {
+ const apiRoutes = manifest([
+ {
+ routeKey: "issue.advance",
+ method: "POST",
+ path: "/issues/:issueId/advance",
+ auth: "agent",
+ capability: "api.routes.register",
+ checkoutPolicy: "required-for-agent-in-progress",
+ companyResolution: { from: "issue", param: "issueId" },
+ },
+ ]);
+ mockIssueService.getById.mockResolvedValue({
+ id: issueId,
+ companyId,
+ status: "in_progress",
+ assigneeAgentId: agentId,
+ });
+ const { app, workerManager } = await createApp({
+ actor: {
+ type: "agent",
+ agentId: peerAgentId,
+ companyId,
+ runId,
+ source: "agent_key",
+ },
+ plugin: {
+ id: pluginId,
+ pluginKey: apiRoutes.id,
+ status: "ready",
+ manifestJson: apiRoutes,
+ },
+ });
+
+ const res = await request(app)
+ .post(`/api/plugins/${pluginId}/api/issues/${issueId}/advance`)
+ .send({ step: "next" });
+
+ expect(res.status).toBe(200);
+ expect(mockIssueService.assertCheckoutOwner).not.toHaveBeenCalled();
+ expect(workerManager.call).toHaveBeenCalledWith(pluginId, "handleApiRequest", expect.objectContaining({
+ routeKey: "issue.advance",
+ params: { issueId },
+ body: { step: "next" },
+ actor: expect.objectContaining({ actorType: "agent", agentId: peerAgentId, runId }),
+ companyId,
+ }));
+ });
+
it("rejects checkout-protected agent routes without a run id before worker dispatch", async () => {
const apiRoutes = manifest([
{
diff --git a/server/src/__tests__/plugin-sdk-orchestration-contract.test.ts b/server/src/__tests__/plugin-sdk-orchestration-contract.test.ts
index d68cb60a53..957262d8fe 100644
--- a/server/src/__tests__/plugin-sdk-orchestration-contract.test.ts
+++ b/server/src/__tests__/plugin-sdk-orchestration-contract.test.ts
@@ -150,6 +150,23 @@ describe("plugin SDK orchestration contract", () => {
).rejects.toThrow("Plugin may only use originKind values under plugin:paperclip.test-orchestration");
});
+ it("supports generic plugin operation issue visibility in the test harness", async () => {
+ const companyId = randomUUID();
+ const harness = createTestHarness({
+ manifest: manifest(["issues.create"]),
+ });
+
+ const created = await harness.ctx.issues.create({
+ companyId,
+ title: "Background operation",
+ surfaceVisibility: "plugin_operation",
+ originId: "operation-1",
+ });
+
+ expect(created.originKind).toBe("plugin:paperclip.test-orchestration:operation");
+ expect(created.originId).toBe("operation-1");
+ });
+
it("enforces checkout and wakeup capabilities in the test harness", async () => {
const companyId = randomUUID();
const agentId = randomUUID();
diff --git a/server/src/app.ts b/server/src/app.ts
index 6b27357301..d94475afea 100644
--- a/server/src/app.ts
+++ b/server/src/app.ts
@@ -253,6 +253,8 @@ export async function createApp(
instanceInfo: {
instanceId: opts.instanceId ?? "default",
hostVersion: opts.hostVersion ?? "0.0.0",
+ deploymentMode: opts.deploymentMode,
+ deploymentExposure: opts.deploymentExposure,
},
buildHostHandlers: (pluginId, manifest) => {
const notifyWorker = (method: string, params: unknown) => {
@@ -261,6 +263,7 @@ export async function createApp(
};
const services = buildHostServices(db, pluginId, manifest.id, eventBus, notifyWorker, {
pluginWorkerManager: workerManager,
+ manifest,
});
hostServicesDisposers.set(pluginId, () => services.dispose());
return createHostClientHandlers({
diff --git a/server/src/routes/issues.ts b/server/src/routes/issues.ts
index f37fbaa83b..5887df79e0 100644
--- a/server/src/routes/issues.ts
+++ b/server/src/routes/issues.ts
@@ -1020,11 +1020,14 @@ export function issueRoutes(
descendantOf: req.query.descendantOf as string | undefined,
labelId: req.query.labelId as string | undefined,
originKind: req.query.originKind as string | undefined,
+ originKindPrefix: req.query.originKindPrefix as string | undefined,
originId: req.query.originId as string | undefined,
includeRoutineExecutions:
req.query.includeRoutineExecutions === "true" || req.query.includeRoutineExecutions === "1",
excludeRoutineExecutions:
req.query.excludeRoutineExecutions === "true" || req.query.excludeRoutineExecutions === "1",
+ includePluginOperations:
+ req.query.includePluginOperations === "true" || req.query.includePluginOperations === "1",
includeBlockedBy: req.query.includeBlockedBy === "true" || req.query.includeBlockedBy === "1",
q: req.query.q as string | undefined,
limit,
diff --git a/server/src/routes/plugins.ts b/server/src/routes/plugins.ts
index 43a6e7dd25..35b6081260 100644
--- a/server/src/routes/plugins.ts
+++ b/server/src/routes/plugins.ts
@@ -66,6 +66,13 @@ import {
getActorInfo,
} from "./authz.js";
import { validateInstanceConfig } from "../services/plugin-config-validator.js";
+import {
+ findLocalFolderDeclaration,
+ getStoredLocalFolders,
+ inspectPluginLocalFolder,
+ requireLocalFolderDeclaration,
+ setStoredLocalFolder,
+} from "../services/plugin-local-folders.js";
import { badRequest, forbidden, notFound, unauthorized, unprocessable } from "../errors.js";
/** UI slot declaration extracted from plugin manifest */
@@ -2379,6 +2386,152 @@ export function pluginRoutes(
}
});
+ // ===========================================================================
+ // Company-scoped trusted local folders
+ // ===========================================================================
+
+ router.get("/plugins/:pluginId/companies/:companyId/local-folders", async (req, res) => {
+ assertBoardOrgAccess(req);
+ const { pluginId, companyId } = req.params;
+ assertCompanyAccess(req, companyId);
+
+ const plugin = await resolvePlugin(registry, pluginId);
+ if (!plugin) {
+ res.status(404).json({ error: "Plugin not found" });
+ return;
+ }
+
+ const settings = await registry.getCompanySettings(plugin.id, companyId);
+ const storedFolders = getStoredLocalFolders(settings?.settingsJson);
+ const declarations = plugin.manifestJson.localFolders ?? [];
+ const folderKeys = declarations.map((declaration) => declaration.folderKey);
+
+ const statuses = await Promise.all(folderKeys.map((folderKey) =>
+ inspectPluginLocalFolder({
+ folderKey,
+ declaration: findLocalFolderDeclaration(declarations, folderKey),
+ storedConfig: storedFolders[folderKey] ?? null,
+ })));
+
+ res.json({
+ pluginId: plugin.id,
+ companyId,
+ declarations,
+ folders: statuses,
+ });
+ });
+
+ router.get("/plugins/:pluginId/companies/:companyId/local-folders/:folderKey/status", async (req, res) => {
+ assertBoardOrgAccess(req);
+ const { pluginId, companyId, folderKey } = req.params;
+ assertCompanyAccess(req, companyId);
+
+ const plugin = await resolvePlugin(registry, pluginId);
+ if (!plugin) {
+ res.status(404).json({ error: "Plugin not found" });
+ return;
+ }
+
+ const settings = await registry.getCompanySettings(plugin.id, companyId);
+ const storedFolders = getStoredLocalFolders(settings?.settingsJson);
+ const declarations = plugin.manifestJson.localFolders ?? [];
+ const declaration = requireLocalFolderDeclaration(declarations, folderKey);
+ const status = await inspectPluginLocalFolder({
+ folderKey,
+ declaration,
+ storedConfig: storedFolders[folderKey] ?? null,
+ });
+ res.json(status);
+ });
+
+ router.post("/plugins/:pluginId/companies/:companyId/local-folders/:folderKey/validate", async (req, res) => {
+ assertBoardOrgAccess(req);
+ const { pluginId, companyId, folderKey } = req.params;
+ assertCompanyAccess(req, companyId);
+
+ const plugin = await resolvePlugin(registry, pluginId);
+ if (!plugin) {
+ res.status(404).json({ error: "Plugin not found" });
+ return;
+ }
+
+ const body = req.body as {
+ path?: unknown;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+ } | undefined;
+ if (typeof body?.path !== "string" || body.path.trim().length === 0) {
+ res.status(400).json({ error: '"path" is required and must be a non-empty string' });
+ return;
+ }
+
+ const declaration = requireLocalFolderDeclaration(plugin.manifestJson.localFolders ?? [], folderKey);
+ const status = await inspectPluginLocalFolder({
+ folderKey,
+ declaration,
+ overrideConfig: {
+ path: body.path,
+ },
+ });
+ res.json(status);
+ });
+
+ router.put("/plugins/:pluginId/companies/:companyId/local-folders/:folderKey", async (req, res) => {
+ assertBoardOrgAccess(req);
+ const { pluginId, companyId, folderKey } = req.params;
+ assertCompanyAccess(req, companyId);
+
+ const plugin = await resolvePlugin(registry, pluginId);
+ if (!plugin) {
+ res.status(404).json({ error: "Plugin not found" });
+ return;
+ }
+
+ const body = req.body as {
+ path?: unknown;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+ } | undefined;
+ if (typeof body?.path !== "string" || body.path.trim().length === 0) {
+ res.status(400).json({ error: '"path" is required and must be a non-empty string' });
+ return;
+ }
+
+ const existing = await registry.getCompanySettings(plugin.id, companyId);
+ const declaration = requireLocalFolderDeclaration(plugin.manifestJson.localFolders ?? [], folderKey);
+ const status = await inspectPluginLocalFolder({
+ folderKey,
+ declaration,
+ storedConfig: getStoredLocalFolders(existing?.settingsJson)[folderKey] ?? null,
+ overrideConfig: {
+ path: body.path,
+ },
+ });
+
+ const nextSettings = setStoredLocalFolder(existing?.settingsJson, folderKey, {
+ path: body.path,
+ access: status.access,
+ requiredDirectories: status.requiredDirectories,
+ requiredFiles: status.requiredFiles,
+ });
+ await registry.upsertCompanySettings(plugin.id, companyId, {
+ enabled: existing?.enabled ?? true,
+ settingsJson: nextSettings,
+ lastError: status.healthy ? null : status.problems.map((item: { message: string }) => item.message).join("; "),
+ });
+ await logPluginMutationActivity(req, "plugin.local_folder.configured", plugin.id, {
+ pluginId: plugin.id,
+ pluginKey: plugin.pluginKey,
+ companyId,
+ folderKey,
+ healthy: status.healthy,
+ });
+
+ res.json(status);
+ });
+
// ===========================================================================
// Plugin health dashboard — aggregated diagnostics for the settings page
// ===========================================================================
diff --git a/server/src/services/issues.ts b/server/src/services/issues.ts
index 66c83389ac..adb49b33ad 100644
--- a/server/src/services/issues.ts
+++ b/server/src/services/issues.ts
@@ -1,5 +1,5 @@
import { Buffer } from "node:buffer";
-import { and, asc, desc, eq, gt, inArray, isNull, lt, ne, notInArray, or, sql } from "drizzle-orm";
+import { and, asc, desc, eq, gt, inArray, isNull, like, lt, ne, notInArray, or, sql } from "drizzle-orm";
import type { Db } from "@paperclipai/db";
import {
activityLog,
@@ -127,9 +127,11 @@ export interface IssueFilters {
descendantOf?: string;
labelId?: string;
originKind?: string;
+ originKindPrefix?: string;
originId?: string;
includeRoutineExecutions?: boolean;
excludeRoutineExecutions?: boolean;
+ includePluginOperations?: boolean;
includeBlockedBy?: boolean;
q?: string;
limit?: number;
@@ -563,6 +565,19 @@ function inboxVisibleForUserCondition(companyId: string, userId: string) {
`;
}
+function nonPluginOperationIssueCondition() {
+ return sql<boolean>`NOT (${issues.originKind} LIKE 'plugin:%:operation' OR ${issues.originKind} LIKE 'plugin:%:operation:%')`;
+}
+
+function shouldIncludePluginOperationIssues(filters: IssueFilters | undefined) {
+ return Boolean(
+ filters?.includePluginOperations ||
+ filters?.originKind ||
+ filters?.originId ||
+ filters?.projectId,
+ );
+}
+
/** Named entities commonly emitted in saved issue bodies; unknown `&name;` sequences are left unchanged. */
const WELL_KNOWN_NAMED_HTML_ENTITIES: Readonly<Record<string, string>> = {
amp: "&",
@@ -2201,7 +2216,11 @@ export function issueService(db: Db) {
}
if (filters?.parentId) conditions.push(eq(issues.parentId, filters.parentId));
if (filters?.originKind) conditions.push(eq(issues.originKind, filters.originKind));
+ if (filters?.originKindPrefix) conditions.push(like(issues.originKind, `${filters.originKindPrefix}%`));
if (filters?.originId) conditions.push(eq(issues.originId, filters.originId));
+ if (!shouldIncludePluginOperationIssues(filters)) {
+ conditions.push(nonPluginOperationIssueCondition());
+ }
if (filters?.labelId) {
const labeledIssueIds = await db
.select({ issueId: issueLabels.issueId })
@@ -2333,6 +2352,7 @@ export function issueService(db: Db) {
const conditions = [
eq(issues.companyId, companyId),
isNull(issues.hiddenAt),
+ nonPluginOperationIssueCondition(),
unreadForUserCondition(companyId, userId),
];
if (status) {
diff --git a/server/src/services/plugin-capability-validator.ts b/server/src/services/plugin-capability-validator.ts
index e69332ca56..ef54d61d2a 100644
--- a/server/src/services/plugin-capability-validator.ts
+++ b/server/src/services/plugin-capability-validator.ts
@@ -47,6 +47,12 @@ const OPERATION_CAPABILITIES: Record<string, readonly PluginCapability[]> = {
"companies.get": ["companies.read"],
"projects.list": ["projects.read"],
"projects.get": ["projects.read"],
+ "projects.managed.get": ["projects.managed"],
+ "projects.managed.reconcile": ["projects.managed"],
+ "projects.managed.reset": ["projects.managed"],
+ "routines.managed.get": ["routines.managed"],
+ "routines.managed.reconcile": ["routines.managed"],
+ "routines.managed.reset": ["routines.managed"],
"project.workspaces.list": ["project.workspaces.read"],
"project.workspaces.get": ["project.workspaces.read"],
"issues.list": ["issues.read"],
@@ -56,6 +62,9 @@ const OPERATION_CAPABILITIES: Record<string, readonly PluginCapability[]> = {
"issue.comments.get": ["issue.comments.read"],
"agents.list": ["agents.read"],
"agents.get": ["agents.read"],
+ "agents.managed.get": ["agents.managed"],
+ "agents.managed.reconcile": ["agents.managed"],
+ "agents.managed.reset": ["agents.managed"],
"goals.list": ["goals.read"],
"goals.get": ["goals.read"],
"activity.list": ["activity.read"],
@@ -65,6 +74,12 @@ const OPERATION_CAPABILITIES: Record<string, readonly PluginCapability[]> = {
"issues.summaries.getOrchestration": ["issues.orchestration.read"],
"db.namespace": ["database.namespace.read"],
"db.query": ["database.namespace.read"],
+ "localFolders.declarations": [],
+ "localFolders.configure": ["local.folders"],
+ "localFolders.status": ["local.folders"],
+ "localFolders.list": ["local.folders"],
+ "localFolders.readText": ["local.folders"],
+ "localFolders.writeTextAtomic": ["local.folders"],
// Data write operations
"issues.create": ["issues.create"],
@@ -133,6 +148,7 @@ const UI_SLOT_CAPABILITIES: Record<PluginUiSlotType, PluginCapability> = {
commentAnnotation: "ui.commentAnnotation.register",
commentContextMenuItem: "ui.action.register",
settingsPage: "instance.settings.register",
+ routeSidebar: "ui.sidebar.register",
};
/**
@@ -167,6 +183,9 @@ const FEATURE_CAPABILITIES: Record<string, PluginCapability> = {
webhooks: "webhooks.receive",
database: "database.namespace.migrate",
environmentDrivers: "environment.drivers.register",
+ agents: "agents.managed",
+ projects: "projects.managed",
+ routines: "routines.managed",
};
// ---------------------------------------------------------------------------
diff --git a/server/src/services/plugin-database.ts b/server/src/services/plugin-database.ts
index e1822e45cd..e6811702be 100644
--- a/server/src/services/plugin-database.ts
+++ b/server/src/services/plugin-database.ts
@@ -303,7 +303,19 @@ function resolveMigrationsDir(packageRoot: string, migrationsDir: string): strin
return resolvedDir;
}
-export function pluginDatabaseService(db: Db) {
+type PluginDatabaseClient = Pick<Db, "select" | "insert" | "update" | "execute">;
+type PluginDatabaseRootClient = PluginDatabaseClient & Partial<Pick<Db, "transaction">>;
+
+export interface ApplyPluginMigrationsOptions {
+ /**
+ * Persist failed migration ledger rows. Fresh install uses false because the
+ * caller owns a larger transaction and must roll back the plugin row and
+ * namespace together.
+ */
+ persistFailure?: boolean;
+}
+
+export function pluginDatabaseService(db: PluginDatabaseRootClient) {
async function getPluginRecord(pluginId: string) {
const rows = await db.select().from(plugins).where(eq(plugins.id, pluginId)).limit(1);
const plugin = rows[0];
@@ -311,14 +323,18 @@ export function pluginDatabaseService(db: Db) {
return plugin;
}
- async function ensureNamespace(pluginId: string, manifest: PaperclipPluginManifestV1) {
+ async function ensureNamespaceWithClient(
+ client: PluginDatabaseClient,
+ pluginId: string,
+ manifest: PaperclipPluginManifestV1,
+ ) {
if (!manifest.database) return null;
const namespaceName = derivePluginDatabaseNamespace(
manifest.id,
manifest.database.namespaceSlug,
);
- await db.execute(sql.raw(`CREATE SCHEMA IF NOT EXISTS ${quoteIdentifier(namespaceName)}`));
- const rows = await db
+ await client.execute(sql.raw(`CREATE SCHEMA IF NOT EXISTS ${quoteIdentifier(namespaceName)}`));
+ const rows = await client
.insert(pluginDatabaseNamespaces)
.values({
pluginId,
@@ -341,6 +357,10 @@ export function pluginDatabaseService(db: Db) {
return rows[0] ?? null;
}
+ async function ensureNamespace(pluginId: string, manifest: PaperclipPluginManifestV1) {
+ return ensureNamespaceWithClient(db, pluginId, manifest);
+ }
+
async function getNamespace(pluginId: string) {
const rows = await db
.select()
@@ -358,7 +378,7 @@ export function pluginDatabaseService(db: Db) {
return namespace.namespaceName;
}
- async function recordMigrationFailure(input: {
+ async function recordMigrationFailure(client: PluginDatabaseClient, input: {
pluginId: string;
pluginKey: string;
namespaceName: string;
@@ -368,7 +388,7 @@ export function pluginDatabaseService(db: Db) {
error: unknown;
}): Promise<void> {
const message = input.error instanceof Error ? input.error.message : String(input.error);
- await db
+ await client
.insert(pluginMigrations)
.values({
pluginId: input.pluginId,
@@ -391,7 +411,7 @@ export function pluginDatabaseService(db: Db) {
appliedAt: null,
},
});
- await db
+ await client
.update(pluginDatabaseNamespaces)
.set({ status: "migration_failed", updatedAt: new Date() })
.where(eq(pluginDatabaseNamespaces.pluginId, input.pluginId));
@@ -400,7 +420,12 @@ export function pluginDatabaseService(db: Db) {
return {
ensureNamespace,
- async applyMigrations(pluginId: string, manifest: PaperclipPluginManifestV1, packageRoot: string) {
+ async applyMigrations(
+ pluginId: string,
+ manifest: PaperclipPluginManifestV1,
+ packageRoot: string,
+ options: ApplyPluginMigrationsOptions = {},
+ ) {
if (!manifest.database) return null;
const namespace = await ensureNamespace(pluginId, manifest);
if (!namespace) return null;
@@ -409,13 +434,14 @@ export function pluginDatabaseService(db: Db) {
const migrationFiles = await listSqlMigrationFiles(migrationDir);
const coreReadTables = manifest.database.coreReadTables ?? [];
const lockKey = Number.parseInt(createHash("sha256").update(pluginId).digest("hex").slice(0, 12), 16);
+ const persistFailure = options.persistFailure ?? true;
- await db.transaction(async (tx) => {
- await tx.execute(sql`SELECT pg_advisory_xact_lock(${lockKey})`);
+ const applyWithClient = async (client: PluginDatabaseClient) => {
+ await client.execute(sql`SELECT pg_advisory_xact_lock(${lockKey})`);
for (const migrationKey of migrationFiles) {
const content = await readFile(path.join(migrationDir, migrationKey), "utf8");
const checksum = createHash("sha256").update(content).digest("hex");
- const existingRows = await tx
+ const existingRows = await client
.select()
.from(pluginMigrations)
.where(and(eq(pluginMigrations.pluginId, pluginId), eq(pluginMigrations.migrationKey, migrationKey)))
@@ -435,9 +461,9 @@ export function pluginDatabaseService(db: Db) {
}
for (const statement of statements) {
validatePluginMigrationStatement(statement, namespace.namespaceName, coreReadTables);
- await tx.execute(sql.raw(statement));
+ await client.execute(sql.raw(statement));
}
- await tx
+ await client
.insert(pluginMigrations)
.values({
pluginId,
@@ -461,19 +487,27 @@ export function pluginDatabaseService(db: Db) {
},
});
} catch (error) {
- await recordMigrationFailure({
- pluginId,
- pluginKey: manifest.id,
- namespaceName: namespace.namespaceName,
- migrationKey,
- checksum,
- pluginVersion: manifest.version,
- error,
- });
+ if (persistFailure) {
+ await recordMigrationFailure(db, {
+ pluginId,
+ pluginKey: manifest.id,
+ namespaceName: namespace.namespaceName,
+ migrationKey,
+ checksum,
+ pluginVersion: manifest.version,
+ error,
+ });
+ }
throw error;
}
}
- });
+ };
+
+ if (typeof db.transaction === "function") {
+ await db.transaction(async (tx) => applyWithClient(tx as PluginDatabaseClient));
+ } else {
+ await applyWithClient(db);
+ }
return namespace;
},
diff --git a/server/src/services/plugin-host-services.ts b/server/src/services/plugin-host-services.ts
index fbb2dc0590..e97ab8d0a8 100644
--- a/server/src/services/plugin-host-services.ts
+++ b/server/src/services/plugin-host-services.ts
@@ -22,6 +22,7 @@ import type {
PluginIssueOrchestrationSummary,
} from "@paperclipai/plugin-sdk";
import type { CreateIssueThreadInteraction, IssueDocumentSummary } from "@paperclipai/shared";
+import { pluginOperationIssueOriginKind } from "@paperclipai/shared";
import { companyService } from "./companies.js";
import { agentService } from "./agents.js";
import { projectService } from "./projects.js";
@@ -34,12 +35,27 @@ import { budgetService } from "./budgets.js";
import { issueApprovalService } from "./issue-approvals.js";
import { subscribeCompanyLiveEvents } from "./live-events.js";
import { randomUUID } from "node:crypto";
+import path from "node:path";
import { activityService } from "./activity.js";
import { costService } from "./costs.js";
import { assetService } from "./assets.js";
import { pluginRegistryService } from "./plugin-registry.js";
import { pluginStateStore } from "./plugin-state-store.js";
import { pluginDatabaseService } from "./plugin-database.js";
+import { pluginManagedAgentService } from "./plugin-managed-agents.js";
+import { pluginManagedRoutineService } from "./plugin-managed-routines.js";
+import {
+ assertConfiguredLocalFolder,
+ assertWritableConfiguredLocalFolder,
+ getStoredLocalFolders,
+ inspectPluginLocalFolder,
+ listPluginLocalFolderEntries,
+ preparePluginLocalFolder,
+ readPluginLocalFolderText,
+ requireLocalFolderDeclaration,
+ setStoredLocalFolder,
+ writePluginLocalFolderTextAtomic,
+} from "./plugin-local-folders.js";
import { createPluginSecretsHandler } from "./plugin-secrets-handler.js";
import { logActivity } from "./activity-log.js";
import type { PluginEventBus } from "./plugin-event-bus.js";
@@ -460,7 +476,7 @@ export function buildHostServices(
pluginKey: string,
eventBus: PluginEventBus,
notifyWorker?: (method: string, params: unknown) => void,
- options: { pluginWorkerManager?: PluginWorkerManager } = {},
+ options: { pluginWorkerManager?: PluginWorkerManager; manifest?: import("@paperclipai/shared").PaperclipPluginManifestV1 } = {},
): HostServices & { dispose(): void } {
const registry = pluginRegistryService(db);
const stateStore = pluginStateStore(db);
@@ -468,6 +484,31 @@ export function buildHostServices(
const secretsHandler = createPluginSecretsHandler({ db, pluginId });
const companies = companyService(db);
const agents = agentService(db);
+ const managedAgents = pluginManagedAgentService(db, {
+ pluginId,
+ pluginKey,
+ manifest: options.manifest,
+ instructionTemplateVariables: async (companyId) => {
+ const variables: Record<string, string | null | undefined> = {};
+ for (const declaration of options.manifest?.localFolders ?? []) {
+ const status = await inspectPluginLocalFolder({
+ folderKey: declaration.folderKey,
+ declaration,
+ storedConfig: await getStoredLocalFolderConfig(companyId, declaration.folderKey),
+ });
+ const prefix = `localFolders.${declaration.folderKey}`;
+ variables[`${prefix}.path`] = status.realPath ?? status.path ?? null;
+ variables[`${prefix}.agentsPath`] = status.realPath ? path.join(status.realPath, "AGENTS.md") : null;
+ }
+ return variables;
+ },
+ });
+ const managedRoutines = pluginManagedRoutineService(db, {
+ pluginId,
+ pluginKey,
+ manifest: options.manifest,
+ pluginWorkerManager: options.pluginWorkerManager,
+ });
const heartbeat = heartbeatService(db, {
pluginWorkerManager: options.pluginWorkerManager,
});
@@ -518,6 +559,23 @@ export function buildHostServices(
*/
const ensurePluginAvailableForCompany = async (_companyId: string) => {};
+ const getLocalFolderDeclaration = (folderKey: string) =>
+ requireLocalFolderDeclaration(options.manifest?.localFolders, folderKey);
+
+ const getStoredLocalFolderConfig = async (companyId: string, folderKey: string) => {
+ ensureCompanyId(companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ const settings = await registry.getCompanySettings(pluginId, companyId);
+ return getStoredLocalFolders(settings?.settingsJson)[folderKey] ?? null;
+ };
+
+ const inspectStoredLocalFolder = async (companyId: string, folderKey: string) =>
+ inspectPluginLocalFolder({
+ folderKey,
+ declaration: getLocalFolderDeclaration(folderKey),
+ storedConfig: await getStoredLocalFolderConfig(companyId, folderKey),
+ });
+
const inCompany = <T extends { companyId: string | null | undefined }>(
record: T | null | undefined,
companyId: string,
@@ -752,6 +810,86 @@ export function buildHostServices(
},
},
+ localFolders: {
+ async declarations() {
+ return options.manifest?.localFolders ?? [];
+ },
+
+ async configure(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ const declaration = getLocalFolderDeclaration(params.folderKey);
+ const existing = await registry.getCompanySettings(pluginId, companyId);
+ const existingConfig = getStoredLocalFolders(existing?.settingsJson)[params.folderKey] ?? null;
+ await preparePluginLocalFolder({
+ folderKey: params.folderKey,
+ declaration,
+ storedConfig: existingConfig,
+ overrideConfig: {
+ path: params.path,
+ },
+ });
+ const status = await inspectPluginLocalFolder({
+ folderKey: params.folderKey,
+ declaration,
+ storedConfig: existingConfig,
+ overrideConfig: {
+ path: params.path,
+ },
+ });
+
+ const nextSettings = setStoredLocalFolder(existing?.settingsJson, params.folderKey, {
+ path: params.path,
+ access: status.access,
+ requiredDirectories: status.requiredDirectories,
+ requiredFiles: status.requiredFiles,
+ });
+ await registry.upsertCompanySettings(pluginId, companyId, {
+ enabled: existing?.enabled ?? true,
+ settingsJson: nextSettings,
+ lastError: status.healthy ? null : status.problems.map((item: { message: string }) => item.message).join("; "),
+ });
+ return status;
+ },
+
+ async status(params) {
+ return inspectStoredLocalFolder(params.companyId, params.folderKey);
+ },
+
+ async list(params) {
+ const status = await inspectStoredLocalFolder(params.companyId, params.folderKey);
+ assertConfiguredLocalFolder(status);
+ const listing = await listPluginLocalFolderEntries(status.realPath!, {
+ relativePath: params.relativePath,
+ recursive: params.recursive,
+ maxEntries: params.maxEntries,
+ });
+ return { ...listing, folderKey: params.folderKey };
+ },
+
+ async readText(params) {
+ const status = await inspectStoredLocalFolder(params.companyId, params.folderKey);
+ assertConfiguredLocalFolder(status);
+ return readPluginLocalFolderText(status.realPath!, params.relativePath);
+ },
+
+ async writeTextAtomic(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await preparePluginLocalFolder({
+ folderKey: params.folderKey,
+ declaration: getLocalFolderDeclaration(params.folderKey),
+ storedConfig: await getStoredLocalFolderConfig(companyId, params.folderKey),
+ });
+ const status = await inspectStoredLocalFolder(companyId, params.folderKey);
+ assertWritableConfiguredLocalFolder(status);
+ if (status.access !== "readWrite" || !status.writable) {
+ throw new Error("Local folder is not configured for writes");
+ }
+ await writePluginLocalFolderTextAtomic(status.realPath!, params.relativePath, params.contents);
+ return inspectStoredLocalFolder(companyId, params.folderKey);
+ },
+ },
+
state: {
async get(params) {
return stateStore.get(pluginId, params.scopeKind as any, params.stateKey, {
@@ -1013,6 +1151,77 @@ export function buildHostServices(
updatedAt: (row?.updatedAt ?? project.updatedAt).toISOString(),
};
},
+ async getManaged(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return projects.resolveManagedProject({
+ companyId,
+ pluginId,
+ pluginKey,
+ projectKey: params.projectKey,
+ createIfMissing: false,
+ });
+ },
+ async reconcileManaged(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return projects.resolveManagedProject({
+ companyId,
+ pluginId,
+ pluginKey,
+ projectKey: params.projectKey,
+ });
+ },
+ async resetManaged(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return projects.resolveManagedProject({
+ companyId,
+ pluginId,
+ pluginKey,
+ projectKey: params.projectKey,
+ reset: true,
+ });
+ },
+ },
+
+ routines: {
+ async managedGet(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedRoutines.get(params.routineKey, companyId);
+ },
+ async managedReconcile(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedRoutines.reconcile(params.routineKey, companyId, {
+ assigneeAgentId: params.assigneeAgentId,
+ projectId: params.projectId,
+ });
+ },
+ async managedReset(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedRoutines.reset(params.routineKey, companyId, {
+ assigneeAgentId: params.assigneeAgentId,
+ projectId: params.projectId,
+ });
+ },
+ async managedUpdate(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedRoutines.update(params.routineKey, companyId, {
+ status: params.status,
+ });
+ },
+ async managedRun(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedRoutines.run(params.routineKey, companyId, {
+ assigneeAgentId: params.assigneeAgentId,
+ projectId: params.projectId,
+ });
+ },
},
issues: {
@@ -1031,8 +1240,12 @@ export function buildHostServices(
async create(params) {
const companyId = ensureCompanyId(params.companyId);
await ensurePluginAvailableForCompany(companyId);
- const { actorAgentId, actorUserId, actorRunId, originKind, ...issueInput } = params;
- const normalizedOriginKind = normalizePluginOriginKind(originKind);
+ const { actorAgentId, actorUserId, actorRunId, originKind, surfaceVisibility, ...issueInput } = params;
+ const normalizedOriginKind = normalizePluginOriginKind(
+ surfaceVisibility === "plugin_operation" && !originKind
+ ? pluginOperationIssueOriginKind(pluginKey)
+ : originKind,
+ );
const issue = (await issues.create(companyId, {
...(issueInput as any),
originKind: normalizedOriginKind,
@@ -1641,6 +1854,21 @@ export function buildHostServices(
if (!run) throw new Error("Agent wakeup was skipped by heartbeat policy");
return { runId: run.id };
},
+ async managedGet(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedAgents.get(params.agentKey, companyId);
+ },
+ async managedReconcile(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedAgents.reconcile(params.agentKey, companyId);
+ },
+ async managedReset(params) {
+ const companyId = ensureCompanyId(params.companyId);
+ await ensurePluginAvailableForCompany(companyId);
+ return managedAgents.reset(params.agentKey, companyId);
+ },
},
goals: {
diff --git a/server/src/services/plugin-loader.ts b/server/src/services/plugin-loader.ts
index 9580118015..073620b429 100644
--- a/server/src/services/plugin-loader.ts
+++ b/server/src/services/plugin-loader.ts
@@ -29,7 +29,7 @@ import { readdir, readFile, rm, stat } from "node:fs/promises";
import { execFile } from "node:child_process";
import os from "node:os";
import path from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
import { promisify } from "node:util";
import type { Db } from "@paperclipai/db";
import type {
@@ -248,6 +248,8 @@ export interface PluginRuntimeServices {
instanceInfo: {
instanceId: string;
hostVersion: string;
+ deploymentMode?: "local_trusted" | "authenticated";
+ deploymentExposure?: "private" | "public";
};
}
@@ -932,7 +934,10 @@ export function pluginLoader(
try {
// Dynamic import works for both .js (ESM) and .cjs (CJS) manifests
- const mod = await import(manifestPath) as Record<string, unknown>;
+ const manifestUrl = pathToFileURL(manifestPath);
+ const manifestStat = await stat(manifestPath);
+ manifestUrl.searchParams.set("mtime", String(Math.trunc(manifestStat.mtimeMs)));
+ const mod = await import(manifestUrl.href) as Record<string, unknown>;
// The manifest may be the default export or the module itself
raw = mod["default"] ?? mod;
} catch (err) {
@@ -944,6 +949,51 @@ export function pluginLoader(
return manifestValidator.parseOrThrow(raw);
}
+ async function loadManifestFromPackageRoot(
+ packageRoot: string,
+ ): Promise<PaperclipPluginManifestV1 | null> {
+ const pkgJson = await readPackageJson(packageRoot);
+ if (!pkgJson) return null;
+
+ const manifestPath = resolveManifestPath(packageRoot, pkgJson);
+ if (!manifestPath || !existsSync(manifestPath)) return null;
+
+ return loadManifestFromPath(manifestPath);
+ }
+
+ async function refreshPluginManifestFromPackage(
+ plugin: PluginRecord,
+ packageRoot: string,
+ ): Promise<PluginRecord> {
+ const manifest = await loadManifestFromPackageRoot(packageRoot);
+ if (!manifest) {
+ throw new Error(`Plugin package ${plugin.packageName} no longer exposes a Paperclip manifest`);
+ }
+ if (manifest.id !== plugin.pluginKey) {
+ throw new Error(
+ `Plugin manifest ID '${manifest.id}' does not match installed plugin '${plugin.pluginKey}'`,
+ );
+ }
+
+ if (JSON.stringify(manifest) === JSON.stringify(plugin.manifestJson)) {
+ return plugin;
+ }
+
+ await registry.update(plugin.id, {
+ packageName: plugin.packageName,
+ version: manifest.version,
+ manifest,
+ });
+
+ return {
+ ...plugin,
+ version: manifest.version,
+ apiVersion: manifest.apiVersion,
+ categories: manifest.categories,
+ manifestJson: manifest,
+ };
+ }
+
/**
* Build a DiscoveredPlugin from a resolved package directory, or null
* if the package is not a Paperclip plugin.
@@ -1256,22 +1306,43 @@ export function pluginLoader(
async installPlugin(installOptions: PluginInstallOptions): Promise<DiscoveredPlugin> {
const discovered = await fetchAndValidate(installOptions);
+ const manifest = discovered.manifest!;
+
+ // Step 6: Persist install record and apply plugin-owned schema migrations
+ // in one database transaction. If migration validation fails, the plugin
+ // row, namespace record, migration ledger, and created schema all roll back.
+ const installDb = manifest.database ? migrationDb : db;
+ await installDb.transaction(async (tx) => {
+ const txDb = tx as unknown as Db;
+ const txRegistry = pluginRegistryService(txDb);
+ const installed = await txRegistry.install(
+ {
+ packageName: discovered.packageName,
+ packagePath: discovered.source === "local-filesystem" ? discovered.packagePath : undefined,
+ },
+ manifest,
+ );
- // Step 6: Persist install record in Postgres (include packagePath for local installs so the worker can be resolved)
- await registry.install(
- {
- packageName: discovered.packageName,
- packagePath: discovered.source === "local-filesystem" ? discovered.packagePath : undefined,
- },
- discovered.manifest!,
- );
+ if (!installed) {
+ throw new Error(`Plugin install did not return a registry row: ${manifest.id}`);
+ }
+
+ if (manifest.database) {
+ await pluginDatabaseService(txDb).applyMigrations(
+ installed.id,
+ manifest,
+ discovered.packagePath,
+ { persistFailure: false },
+ );
+ }
+ });
log.info(
{
- pluginId: discovered.manifest!.id,
+ pluginId: manifest.id,
packageName: discovered.packageName,
version: discovered.version,
- capabilities: discovered.manifest!.capabilities,
+ capabilities: manifest.capabilities,
},
"plugin-loader: plugin installed successfully",
);
@@ -1663,9 +1734,10 @@ export function pluginLoader(
* `error` in the database when activation fails.
*/
async function activatePlugin(plugin: PluginRecord): Promise<PluginLoadResult> {
- const manifest = plugin.manifestJson;
const pluginId = plugin.id;
const pluginKey = plugin.pluginKey;
+ let activePlugin = plugin;
+ let manifest = activePlugin.manifestJson;
const registered: PluginLoadResult["registered"] = {
worker: false,
@@ -1705,8 +1777,10 @@ export function pluginLoader(
// ------------------------------------------------------------------
// 1. Resolve worker entrypoint
// ------------------------------------------------------------------
- const workerEntrypoint = resolveWorkerEntrypoint(plugin, localPluginDir);
- const packageRoot = resolvePluginPackageRoot(plugin, localPluginDir);
+ const packageRoot = resolvePluginPackageRoot(activePlugin, localPluginDir);
+ activePlugin = await refreshPluginManifestFromPackage(activePlugin, packageRoot);
+ manifest = activePlugin.manifestJson;
+ const workerEntrypoint = resolveWorkerEntrypoint(activePlugin, localPluginDir);
// ------------------------------------------------------------------
// 2. Apply restricted database migrations before worker startup
@@ -1746,12 +1820,16 @@ export function pluginLoader(
databaseNamespace,
hostHandlers,
autoRestart: true,
+ env: {
+ PAPERCLIP_DEPLOYMENT_MODE: instanceInfo.deploymentMode ?? "",
+ PAPERCLIP_DEPLOYMENT_EXPOSURE: instanceInfo.deploymentExposure ?? "",
+ },
};
// Repo-local plugin installs can resolve workspace TS sources at runtime
// (for example @paperclipai/shared exports). Run those workers through
// the tsx loader so first-party example plugins work in development.
- if (plugin.packagePath && existsSync(DEV_TSX_LOADER_PATH)) {
+ if (activePlugin.packagePath && existsSync(DEV_TSX_LOADER_PATH)) {
workerOptions.execArgv = ["--import", DEV_TSX_LOADER_PATH];
}
@@ -1842,13 +1920,13 @@ export function pluginLoader(
{
pluginId,
pluginKey,
- version: plugin.version,
+ version: activePlugin.version,
registered,
},
"plugin-loader: plugin activated successfully",
);
- return { plugin, success: true, registered };
+ return { plugin: activePlugin, success: true, registered };
} catch (err) {
const errorMessage = err instanceof Error ? err.message : String(err);
@@ -1872,7 +1950,7 @@ export function pluginLoader(
}
return {
- plugin,
+ plugin: activePlugin,
success: false,
error: errorMessage,
registered,
diff --git a/server/src/services/plugin-local-folders.ts b/server/src/services/plugin-local-folders.ts
new file mode 100644
index 0000000000..8aa590d7bb
--- /dev/null
+++ b/server/src/services/plugin-local-folders.ts
@@ -0,0 +1,564 @@
+import { constants as fsConstants, promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import type {
+ PluginLocalFolderDeclaration,
+ PluginLocalFolderEntry,
+ PluginLocalFolderListing,
+ PluginLocalFolderProblem,
+ PluginLocalFolderStatus,
+} from "@paperclipai/plugin-sdk";
+import { badRequest, forbidden, notFound } from "../errors.js";
+
+export interface StoredPluginLocalFolderConfig {
+ path: string;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+ updatedAt?: string;
+}
+
+export interface PluginLocalFolderSettingsJson {
+ localFolders?: Record<string, StoredPluginLocalFolderConfig>;
+ [key: string]: unknown;
+}
+
+const LOCAL_FOLDER_KEY_PATTERN = /^[a-z0-9][a-z0-9._:-]*$/;
+
+function problem(
+ code: PluginLocalFolderProblem["code"],
+ message: string,
+ problemPath?: string,
+): PluginLocalFolderProblem {
+ return { code, message, path: problemPath };
+}
+
+export function assertPluginLocalFolderKey(folderKey: string) {
+ if (!LOCAL_FOLDER_KEY_PATTERN.test(folderKey)) {
+ throw badRequest("folderKey must start with a lowercase alphanumeric and contain only lowercase letters, digits, dots, colons, underscores, or hyphens");
+ }
+}
+
+export function findLocalFolderDeclaration(
+ declarations: PluginLocalFolderDeclaration[] | undefined,
+ folderKey: string,
+) {
+ return declarations?.find((declaration) => declaration.folderKey === folderKey) ?? null;
+}
+
+export function requireLocalFolderDeclaration(
+ declarations: PluginLocalFolderDeclaration[] | undefined,
+ folderKey: string,
+) {
+ assertPluginLocalFolderKey(folderKey);
+ const declaration = findLocalFolderDeclaration(declarations, folderKey);
+ if (!declaration) {
+ throw badRequest("Local folder key is not declared by this plugin manifest");
+ }
+ return declaration;
+}
+
+function normalizeRelativePath(relativePath: string): string {
+ if (
+ !relativePath ||
+ path.isAbsolute(relativePath) ||
+ relativePath.includes("\\") ||
+ relativePath.split("/").some((segment) => segment === "" || segment === "." || segment === "..")
+ ) {
+ throw forbidden("Local folder relative paths must stay inside the configured root");
+ }
+ return relativePath;
+}
+
+function validateRequiredPath(pathValue: string, label: string): string {
+ try {
+ return normalizeRelativePath(pathValue);
+ } catch {
+ throw badRequest(`${label} must contain only relative paths without traversal, empty segments, or backslashes`);
+ }
+}
+
+function normalizeListRelativePath(relativePath: string | null | undefined): string | null {
+ const trimmed = relativePath?.trim();
+ if (!trimmed) return null;
+ return normalizeRelativePath(trimmed);
+}
+
+function normalizeMaxEntries(value: number | undefined): number {
+ if (typeof value !== "number" || !Number.isFinite(value)) return 1000;
+ return Math.max(1, Math.min(5000, Math.floor(value)));
+}
+
+function mergeFolderConfig(
+ declaration: PluginLocalFolderDeclaration | null,
+ stored: StoredPluginLocalFolderConfig | null,
+ override?: Partial<StoredPluginLocalFolderConfig>,
+): StoredPluginLocalFolderConfig | null {
+ const pathValue = override?.path ?? stored?.path;
+ if (!pathValue) return null;
+ return {
+ path: pathValue,
+ access: declaration?.access ?? override?.access ?? stored?.access ?? "readWrite",
+ requiredDirectories:
+ declaration?.requiredDirectories ?? override?.requiredDirectories ?? stored?.requiredDirectories ?? [],
+ requiredFiles:
+ declaration?.requiredFiles ?? override?.requiredFiles ?? stored?.requiredFiles ?? [],
+ updatedAt: stored?.updatedAt,
+ };
+}
+
+export function getStoredLocalFolders(settingsJson: Record<string, unknown> | null | undefined) {
+ const folders = (settingsJson as PluginLocalFolderSettingsJson | undefined)?.localFolders;
+ if (!folders || typeof folders !== "object") return {};
+ return folders;
+}
+
+export function setStoredLocalFolder(
+ settingsJson: Record<string, unknown> | null | undefined,
+ folderKey: string,
+ config: StoredPluginLocalFolderConfig,
+): PluginLocalFolderSettingsJson {
+ return {
+ ...(settingsJson ?? {}),
+ localFolders: {
+ ...getStoredLocalFolders(settingsJson),
+ [folderKey]: {
+ ...config,
+ updatedAt: new Date().toISOString(),
+ },
+ },
+ };
+}
+
+export async function inspectPluginLocalFolder(input: {
+ folderKey: string;
+ declaration?: PluginLocalFolderDeclaration | null;
+ storedConfig?: StoredPluginLocalFolderConfig | null;
+ overrideConfig?: Partial<StoredPluginLocalFolderConfig>;
+}): Promise<PluginLocalFolderStatus> {
+ assertPluginLocalFolderKey(input.folderKey);
+ const config = mergeFolderConfig(
+ input.declaration ?? null,
+ input.storedConfig ?? null,
+ input.overrideConfig,
+ );
+ const access = config?.access ?? input.declaration?.access ?? "readWrite";
+ const requiredDirectories = (config?.requiredDirectories ?? []).map((item) =>
+ validateRequiredPath(item, "requiredDirectories"),
+ );
+ const requiredFiles = (config?.requiredFiles ?? []).map((item) =>
+ validateRequiredPath(item, "requiredFiles"),
+ );
+ const checkedAt = new Date().toISOString();
+
+ if (!config?.path) {
+ return {
+ folderKey: input.folderKey,
+ configured: false,
+ path: null,
+ realPath: null,
+ access,
+ readable: false,
+ writable: false,
+ requiredDirectories,
+ requiredFiles,
+ missingDirectories: requiredDirectories,
+ missingFiles: requiredFiles,
+ healthy: false,
+ problems: [problem("not_configured", "No local folder path is configured.")],
+ checkedAt,
+ };
+ }
+
+ const configuredPath = path.resolve(config.path);
+ const problems: PluginLocalFolderProblem[] = [];
+ const missingDirectories: string[] = [];
+ const missingFiles: string[] = [];
+ const markRequiredPathsMissing = () => {
+ missingDirectories.push(...requiredDirectories);
+ missingFiles.push(...requiredFiles);
+ };
+ let realPath: string | null = null;
+ let readable = false;
+ let writable = false;
+
+ if (!path.isAbsolute(config.path)) {
+ problems.push(problem("not_absolute", "Local folder path must be absolute.", config.path));
+ }
+
+ try {
+ const stat = await fs.stat(configuredPath);
+ if (!stat.isDirectory()) {
+ problems.push(problem("not_directory", "Configured local folder path is not a directory.", configuredPath));
+ markRequiredPathsMissing();
+ } else {
+ realPath = await fs.realpath(configuredPath);
+ try {
+ await fs.access(realPath, fsConstants.R_OK);
+ readable = true;
+ } catch {
+ problems.push(problem("not_readable", "Configured local folder is not readable.", configuredPath));
+ }
+
+ if (access === "readWrite") {
+ try {
+ await fs.access(realPath, fsConstants.W_OK);
+ const probePath = path.join(realPath, `.paperclip-local-folder-probe-${process.pid}-${Date.now()}`);
+ await fs.writeFile(probePath, "");
+ await fs.rm(probePath, { force: true });
+ writable = true;
+ } catch {
+ problems.push(problem("not_writable", "Configured local folder is not writable.", configuredPath));
+ }
+ }
+
+ for (const requiredDir of requiredDirectories) {
+ const requiredStatus = await inspectChildPath(realPath, requiredDir, "directory");
+ if (!requiredStatus.exists) {
+ missingDirectories.push(requiredDir);
+ problems.push(problem("missing_directory", "Required directory is missing.", requiredDir));
+ } else if (!requiredStatus.contained) {
+ problems.push(problem("symlink_escape", "Required directory escapes the configured root.", requiredDir));
+ } else if (!requiredStatus.matchesKind) {
+ missingDirectories.push(requiredDir);
+ problems.push(problem("missing_directory", "Required path is not a directory.", requiredDir));
+ }
+ }
+
+ for (const requiredFile of requiredFiles) {
+ const requiredStatus = await inspectChildPath(realPath, requiredFile, "file");
+ if (!requiredStatus.exists) {
+ missingFiles.push(requiredFile);
+ problems.push(problem("missing_file", "Required file is missing.", requiredFile));
+ } else if (!requiredStatus.contained) {
+ problems.push(problem("symlink_escape", "Required file escapes the configured root.", requiredFile));
+ } else if (!requiredStatus.matchesKind) {
+ missingFiles.push(requiredFile);
+ problems.push(problem("missing_file", "Required path is not a file.", requiredFile));
+ }
+ }
+ }
+ } catch (error) {
+ const code = typeof error === "object" && error && "code" in error ? String((error as { code?: unknown }).code) : "";
+ problems.push(problem(code === "ENOENT" ? "missing" : "not_readable", "Configured local folder cannot be inspected.", configuredPath));
+ if (code === "ENOENT") {
+ markRequiredPathsMissing();
+ }
+ }
+
+ return {
+ folderKey: input.folderKey,
+ configured: true,
+ path: configuredPath,
+ realPath,
+ access,
+ readable,
+ writable: access === "read" ? false : writable,
+ requiredDirectories,
+ requiredFiles,
+ missingDirectories,
+ missingFiles,
+ healthy:
+ problems.length === 0 &&
+ readable &&
+ (access === "read" || writable),
+ problems,
+ checkedAt,
+ };
+}
+
+function isInsideRoot(rootRealPath: string, candidateRealPath: string) {
+ const relative = path.relative(rootRealPath, candidateRealPath);
+ return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+
+async function assertPathInsideRoot(rootRealPath: string, candidatePath: string) {
+ const candidateRealPath = await fs.realpath(candidatePath);
+ if (!isInsideRoot(rootRealPath, candidateRealPath)) {
+ throw forbidden("Local folder symlink escape is not allowed");
+ }
+ return candidateRealPath;
+}
+
+async function ensureDirectoryInsideRoot(rootRealPath: string, relativePath: string) {
+ const normalized = normalizeRelativePath(relativePath);
+ const segments = normalized.split("/");
+ let currentRealPath = rootRealPath;
+
+ for (const segment of segments) {
+ const nextPath = path.join(currentRealPath, segment);
+ try {
+ const stat = await fs.stat(nextPath);
+ if (!stat.isDirectory()) {
+ throw badRequest("Required directory path exists but is not a directory");
+ }
+ } catch (error) {
+ const code = typeof error === "object" && error && "code" in error ? String((error as { code?: unknown }).code) : "";
+ if (code !== "ENOENT") throw error;
+ await fs.mkdir(nextPath);
+ }
+
+ const nextRealPath = await fs.realpath(nextPath);
+ if (!isInsideRoot(rootRealPath, nextRealPath)) {
+ throw forbidden("Local folder symlink escape is not allowed");
+ }
+ currentRealPath = nextRealPath;
+ }
+}
+
+export async function preparePluginLocalFolder(input: {
+ folderKey: string;
+ declaration?: PluginLocalFolderDeclaration | null;
+ storedConfig?: StoredPluginLocalFolderConfig | null;
+ overrideConfig?: Partial<StoredPluginLocalFolderConfig>;
+}) {
+ assertPluginLocalFolderKey(input.folderKey);
+ const config = mergeFolderConfig(
+ input.declaration ?? null,
+ input.storedConfig ?? null,
+ input.overrideConfig,
+ );
+ const access = config?.access ?? input.declaration?.access ?? "readWrite";
+ if (!config?.path || access !== "readWrite" || !path.isAbsolute(config.path)) return;
+
+ const configuredPath = path.resolve(config.path);
+ try {
+ const stat = await fs.stat(configuredPath);
+ if (!stat.isDirectory()) return;
+ } catch (error) {
+ const code = typeof error === "object" && error && "code" in error ? String((error as { code?: unknown }).code) : "";
+ if (code !== "ENOENT") return;
+ try {
+ await fs.mkdir(configuredPath, { recursive: true });
+ } catch {
+ return;
+ }
+ }
+ const rootRealPath = await fs.realpath(configuredPath);
+
+ for (const requiredDir of config.requiredDirectories ?? []) {
+ await ensureDirectoryInsideRoot(rootRealPath, validateRequiredPath(requiredDir, "requiredDirectories"));
+ }
+}
+
+async function inspectChildPath(
+ rootRealPath: string,
+ relativePath: string,
+ kind: "directory" | "file",
+) {
+ let resolvedPath: Awaited<ReturnType<typeof resolvePluginLocalFolderPath>>;
+ try {
+ resolvedPath = await resolvePluginLocalFolderPath(rootRealPath, relativePath, {
+ mustExist: true,
+ allowMissingLeaf: true,
+ });
+ } catch {
+ return { exists: true, contained: false, matchesKind: false };
+ }
+ if (!resolvedPath.exists) {
+ return { exists: false, contained: true, matchesKind: false };
+ }
+ const stat = await fs.stat(resolvedPath.realPath);
+ return {
+ exists: true,
+ contained: true,
+ matchesKind: kind === "directory" ? stat.isDirectory() : stat.isFile(),
+ };
+}
+
+export async function resolvePluginLocalFolderPath(
+ rootPath: string,
+ relativePath: string,
+ options?: { mustExist?: boolean; allowMissingLeaf?: boolean },
+) {
+ const normalized = normalizeRelativePath(relativePath);
+ const rootRealPath = await fs.realpath(rootPath);
+ const absolutePath = path.resolve(rootRealPath, normalized);
+ const relativeFromRoot = path.relative(rootRealPath, absolutePath);
+ if (relativeFromRoot.startsWith("..") || path.isAbsolute(relativeFromRoot)) {
+ throw forbidden("Local folder path traversal is not allowed");
+ }
+
+ try {
+ const realPath = await fs.realpath(absolutePath);
+ const realRelative = path.relative(rootRealPath, realPath);
+ if (realRelative.startsWith("..") || path.isAbsolute(realRelative)) {
+ throw forbidden("Local folder symlink escape is not allowed");
+ }
+ return { absolutePath, realPath, exists: true };
+ } catch (error) {
+ const code = typeof error === "object" && error && "code" in error ? String((error as { code?: unknown }).code) : "";
+ if (code !== "ENOENT" || options?.mustExist) {
+ if (options?.allowMissingLeaf && code === "ENOENT") {
+ return { absolutePath, realPath: absolutePath, exists: false };
+ }
+ throw error;
+ }
+
+ const parentRealPath = await fs.realpath(path.dirname(absolutePath));
+ const parentRelative = path.relative(rootRealPath, parentRealPath);
+ if (parentRelative.startsWith("..") || path.isAbsolute(parentRelative)) {
+ throw forbidden("Local folder symlink escape is not allowed");
+ }
+ return { absolutePath, realPath: absolutePath, exists: false };
+ }
+}
+
+export async function readPluginLocalFolderText(rootPath: string, relativePath: string) {
+ const resolved = await resolvePluginLocalFolderPath(rootPath, relativePath, { mustExist: true });
+ const stat = await fs.stat(resolved.realPath);
+ if (!stat.isFile()) {
+ throw badRequest("Local folder read target must be a file");
+ }
+ return fs.readFile(resolved.realPath, "utf8");
+}
+
+export async function listPluginLocalFolderEntries(
+ rootPath: string,
+ options: { relativePath?: string | null; recursive?: boolean; maxEntries?: number } = {},
+): Promise<PluginLocalFolderListing> {
+ const rootRealPath = await fs.realpath(rootPath);
+ const relativePath = normalizeListRelativePath(options.relativePath);
+ const target = relativePath
+ ? await resolvePluginLocalFolderPath(rootRealPath, relativePath, { mustExist: true })
+ : { absolutePath: rootRealPath, realPath: rootRealPath, exists: true };
+ const targetStat = await fs.stat(target.realPath);
+ if (!targetStat.isDirectory()) {
+ throw badRequest("Local folder list target must be a directory");
+ }
+
+ const maxEntries = normalizeMaxEntries(options.maxEntries);
+ const entries: PluginLocalFolderEntry[] = [];
+ let truncated = false;
+
+ const visit = async (directoryRealPath: string, directoryRelativePath: string | null) => {
+ if (truncated) return;
+ const dirents = await fs.readdir(directoryRealPath, { withFileTypes: true });
+ dirents.sort((a, b) => a.name.localeCompare(b.name));
+
+ for (const dirent of dirents) {
+ if (entries.length >= maxEntries) {
+ truncated = true;
+ return;
+ }
+
+ const childRelativePath = directoryRelativePath ? `${directoryRelativePath}/${dirent.name}` : dirent.name;
+ let resolvedChild: Awaited<ReturnType<typeof resolvePluginLocalFolderPath>>;
+ try {
+ resolvedChild = await resolvePluginLocalFolderPath(rootRealPath, childRelativePath, { mustExist: true });
+ } catch {
+ continue;
+ }
+
+ const stat = await fs.stat(resolvedChild.realPath).catch(() => null);
+ if (!stat) continue;
+ const kind = stat.isDirectory() ? "directory" : stat.isFile() ? "file" : null;
+ if (!kind) continue;
+
+ entries.push({
+ path: childRelativePath,
+ name: dirent.name,
+ kind,
+ size: kind === "file" ? stat.size : null,
+ modifiedAt: stat.mtime.toISOString(),
+ });
+
+ if (options.recursive && kind === "directory") {
+ await visit(resolvedChild.realPath, childRelativePath);
+ if (truncated) return;
+ }
+ }
+ };
+
+ await visit(target.realPath, relativePath);
+ return {
+ folderKey: "list-result",
+ relativePath,
+ entries,
+ truncated,
+ };
+}
+
+export async function writePluginLocalFolderTextAtomic(
+ rootPath: string,
+ relativePath: string,
+ contents: string,
+) {
+ const rootRealPath = await fs.realpath(rootPath);
+ const resolved = await resolvePluginLocalFolderPath(rootPath, relativePath);
+ await fs.mkdir(path.dirname(resolved.absolutePath), { recursive: true });
+ await assertPathInsideRoot(rootRealPath, path.dirname(resolved.absolutePath));
+ const tempPath = path.join(
+ path.dirname(resolved.absolutePath),
+ `.paperclip-${path.basename(resolved.absolutePath)}-${process.pid}-${randomUUID()}.tmp`,
+ );
+ let tempCreated = false;
+ try {
+ const handle = await fs.open(tempPath, "wx");
+ tempCreated = true;
+ try {
+ await assertPathInsideRoot(rootRealPath, tempPath);
+ await handle.writeFile(contents, "utf8");
+ await handle.sync();
+ } finally {
+ await handle.close();
+ }
+ } catch (error) {
+ if (tempCreated) {
+ await fs.rm(tempPath, { force: true });
+ }
+ throw error;
+ }
+
+ try {
+ await resolvePluginLocalFolderPath(rootRealPath, relativePath);
+ await fs.rename(tempPath, resolved.absolutePath);
+ await resolvePluginLocalFolderPath(rootRealPath, relativePath, { mustExist: true });
+ } catch (error) {
+ await fs.rm(tempPath, { force: true });
+ throw error;
+ }
+
+ if (process.platform !== "win32") {
+ const dirHandle = await fs.open(path.dirname(resolved.absolutePath), "r");
+ try {
+ await dirHandle.sync();
+ } finally {
+ await dirHandle.close();
+ }
+ }
+
+ return inspectPluginLocalFolder({
+ folderKey: "write-result",
+ storedConfig: {
+ path: rootPath,
+ access: "readWrite",
+ },
+ });
+}
+
+export function defaultLocalFolderBasePath(pluginKey: string, companyId: string) {
+ return path.join(os.homedir(), ".paperclip", "plugin-data", companyId, pluginKey);
+}
+
+export function assertConfiguredLocalFolder(status: PluginLocalFolderStatus) {
+ if (!status.configured || !status.realPath || !status.readable) {
+ throw notFound("Local folder is not configured or readable");
+ }
+ if (!status.healthy) {
+ throw badRequest("Local folder is not healthy");
+ }
+}
+
+export function assertWritableConfiguredLocalFolder(status: PluginLocalFolderStatus) {
+ if (!status.configured || !status.realPath || !status.readable) {
+ throw notFound("Local folder is not configured or readable");
+ }
+ const onlyMissingRequiredPaths = status.problems.every((item) =>
+ item.code === "missing_directory" || item.code === "missing_file"
+ );
+ if (!status.healthy && !onlyMissingRequiredPaths) {
+ throw badRequest("Local folder is not healthy");
+ }
+}
diff --git a/server/src/services/plugin-managed-agents.ts b/server/src/services/plugin-managed-agents.ts
new file mode 100644
index 0000000000..84a55c3a31
--- /dev/null
+++ b/server/src/services/plugin-managed-agents.ts
@@ -0,0 +1,508 @@
+import { and, eq, ne } from "drizzle-orm";
+import type { Db } from "@paperclipai/db";
+import {
+ agents,
+ companies,
+ pluginEntities,
+ pluginManagedResources,
+} from "@paperclipai/db";
+import type {
+ Agent,
+ PaperclipPluginManifestV1,
+ PluginManagedAgentDeclaration,
+ PluginManagedAgentResolution,
+} from "@paperclipai/shared";
+import { notFound } from "../errors.js";
+import { agentService } from "./agents.js";
+import { approvalService } from "./approvals.js";
+import { logActivity } from "./activity-log.js";
+import { agentInstructionsService } from "./agent-instructions.js";
+
+const MANAGED_AGENT_ENTITY_TYPE = "managed_agent";
+const DEFAULT_MANAGED_AGENT_ADAPTER_TYPE = "process";
+
+interface PluginManagedAgentServiceOptions {
+ pluginId: string;
+ pluginKey: string;
+ manifest?: PaperclipPluginManifestV1 | null;
+ instructionTemplateVariables?: (companyId: string) => Promise<Record<string, string | null | undefined>>;
+}
+
+function bindingExternalId(companyId: string, agentKey: string) {
+ return `managed:agent:${companyId}:${agentKey}`;
+}
+
+function managedMetadata(
+ pluginId: string,
+ pluginKey: string,
+ declaration: PluginManagedAgentDeclaration,
+ existing?: Record<string, unknown> | null,
+) {
+ return {
+ ...(existing ?? {}),
+ paperclipManagedResource: {
+ pluginId,
+ pluginKey,
+ resourceKind: "agent",
+ resourceKey: declaration.agentKey,
+ },
+ pluginManagedAgent: {
+ pluginId,
+ pluginKey,
+ agentKey: declaration.agentKey,
+ displayName: declaration.displayName,
+ instructions: declaration.instructions ?? null,
+ },
+ };
+}
+
+function normalizeAdapterType(value: unknown) {
+ return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+
+function fallbackAdapterType(declaration: PluginManagedAgentDeclaration) {
+ return normalizeAdapterType(declaration.adapterType) ?? DEFAULT_MANAGED_AGENT_ADAPTER_TYPE;
+}
+
+function adapterPreference(declaration: PluginManagedAgentDeclaration) {
+ const seen = new Set<string>();
+ const preference: string[] = [];
+ for (const value of declaration.adapterPreference ?? []) {
+ const adapterType = normalizeAdapterType(value);
+ if (!adapterType || seen.has(adapterType)) continue;
+ seen.add(adapterType);
+ preference.push(adapterType);
+ }
+ return preference;
+}
+
+function selectPreferredAdapterType(
+ declaration: PluginManagedAgentDeclaration,
+ usage: Array<{ adapterType: string; count: number }>,
+) {
+ const fallback = fallbackAdapterType(declaration);
+ const preference = adapterPreference(declaration);
+ if (preference.length === 0) return fallback;
+
+ const rank = new Map(preference.map((adapterType, index) => [adapterType, index]));
+ let selected: { adapterType: string; count: number; rank: number } | null = null;
+ for (const entry of usage) {
+ const adapterRank = rank.get(entry.adapterType);
+ if (adapterRank === undefined) continue;
+ if (
+ !selected ||
+ entry.count > selected.count ||
+ (entry.count === selected.count && adapterRank < selected.rank)
+ ) {
+ selected = { ...entry, rank: adapterRank };
+ }
+ }
+ return selected?.adapterType ?? fallback;
+}
+
+function declarationPatch(declaration: PluginManagedAgentDeclaration, input: { adapterType?: string } = {}) {
+ return {
+ name: declaration.displayName,
+ role: declaration.role ?? "general",
+ title: declaration.title ?? null,
+ icon: declaration.icon ?? null,
+ capabilities: declaration.capabilities ?? null,
+ adapterType: input.adapterType ?? fallbackAdapterType(declaration),
+ adapterConfig: declaration.adapterConfig ?? {},
+ runtimeConfig: declaration.runtimeConfig ?? {},
+ permissions: declaration.permissions ?? {},
+ budgetMonthlyCents: declaration.budgetMonthlyCents ?? 0,
+ };
+}
+
+function applyInstructionTemplateVariables(
+ content: string,
+ variables: Record<string, string | null | undefined>,
+) {
+ let next = content;
+ for (const [key, value] of Object.entries(variables)) {
+ next = next.replaceAll(`{{${key}}}`, value?.trim() || "(not configured)");
+ }
+ return next;
+}
+
+function rowIsManagedAgent(
+ row: typeof agents.$inferSelect,
+ pluginKey: string,
+ agentKey: string,
+) {
+ const metadata = row.metadata;
+ if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) return false;
+ const marker = (metadata as Record<string, unknown>).paperclipManagedResource;
+ if (!marker || typeof marker !== "object" || Array.isArray(marker)) return false;
+ const record = marker as Record<string, unknown>;
+ return (
+ record.pluginKey === pluginKey
+ && record.resourceKind === "agent"
+ && record.resourceKey === agentKey
+ );
+}
+
+export function pluginManagedAgentService(
+ db: Db,
+ options: PluginManagedAgentServiceOptions,
+) {
+ const agentSvc = agentService(db);
+ const approvalSvc = approvalService(db);
+ const instructions = agentInstructionsService();
+
+ function declarationFor(agentKey: string) {
+ const declaration = options.manifest?.agents?.find((agent) => agent.agentKey === agentKey);
+ if (!declaration) {
+ throw notFound(`Managed agent declaration not found: ${agentKey}`);
+ }
+ return declaration;
+ }
+
+ async function getBinding(companyId: string, agentKey: string) {
+ return db
+ .select()
+ .from(pluginEntities)
+ .where(
+ and(
+ eq(pluginEntities.pluginId, options.pluginId),
+ eq(pluginEntities.entityType, MANAGED_AGENT_ENTITY_TYPE),
+ eq(pluginEntities.externalId, bindingExternalId(companyId, agentKey)),
+ ),
+ )
+ .then((rows) => rows[0] ?? null);
+ }
+
+ async function upsertBinding(
+ companyId: string,
+ declaration: PluginManagedAgentDeclaration,
+ agentId: string,
+ extraData: Record<string, unknown> = {},
+ effectiveAdapterType?: string,
+ ) {
+ const adapterType = effectiveAdapterType ?? (await resolveManagedAdapterType(companyId, declaration));
+ const defaultsJson = {
+ agentKey: declaration.agentKey,
+ displayName: declaration.displayName,
+ role: declaration.role ?? "general",
+ title: declaration.title ?? null,
+ icon: declaration.icon ?? null,
+ capabilities: declaration.capabilities ?? null,
+ adapterType,
+ adapterPreference: declaration.adapterPreference ?? null,
+ adapterConfig: declaration.adapterConfig ?? {},
+ runtimeConfig: declaration.runtimeConfig ?? {},
+ permissions: declaration.permissions ?? {},
+ budgetMonthlyCents: declaration.budgetMonthlyCents ?? 0,
+ instructions: declaration.instructions ?? null,
+ };
+ const managedResource = await db
+ .select({ id: pluginManagedResources.id })
+ .from(pluginManagedResources)
+ .where(and(
+ eq(pluginManagedResources.companyId, companyId),
+ eq(pluginManagedResources.pluginId, options.pluginId),
+ eq(pluginManagedResources.resourceKind, "agent"),
+ eq(pluginManagedResources.resourceKey, declaration.agentKey),
+ ))
+ .then((rows) => rows[0] ?? null);
+ if (managedResource) {
+ await db
+ .update(pluginManagedResources)
+ .set({ resourceId: agentId, defaultsJson, updatedAt: new Date() })
+ .where(eq(pluginManagedResources.id, managedResource.id));
+ } else {
+ await db.insert(pluginManagedResources).values({
+ companyId,
+ pluginId: options.pluginId,
+ pluginKey: options.pluginKey,
+ resourceKind: "agent",
+ resourceKey: declaration.agentKey,
+ resourceId: agentId,
+ defaultsJson,
+ });
+ }
+
+ const externalId = bindingExternalId(companyId, declaration.agentKey);
+ const data = {
+ pluginKey: options.pluginKey,
+ resourceKind: "agent",
+ resourceKey: declaration.agentKey,
+ agentId,
+ adapterType,
+ declarationSnapshot: declaration,
+ lastReconciledAt: new Date().toISOString(),
+ ...extraData,
+ };
+ const existing = await getBinding(companyId, declaration.agentKey);
+ if (existing) {
+ return db
+ .update(pluginEntities)
+ .set({
+ scopeKind: "company",
+ scopeId: companyId,
+ title: declaration.displayName,
+ status: "resolved",
+ data,
+ updatedAt: new Date(),
+ })
+ .where(eq(pluginEntities.id, existing.id))
+ .returning()
+ .then((rows) => rows[0]);
+ }
+ return db
+ .insert(pluginEntities)
+ .values({
+ pluginId: options.pluginId,
+ entityType: MANAGED_AGENT_ENTITY_TYPE,
+ scopeKind: "company",
+ scopeId: companyId,
+ externalId,
+ title: declaration.displayName,
+ status: "resolved",
+ data,
+ })
+ .returning()
+ .then((rows) => rows[0]);
+ }
+
+ async function findRelinkCandidate(companyId: string, declaration: PluginManagedAgentDeclaration) {
+ const rows = await db
+ .select()
+ .from(agents)
+ .where(and(eq(agents.companyId, companyId), ne(agents.status, "terminated")));
+ return rows.find((row) => rowIsManagedAgent(row, options.pluginKey, declaration.agentKey)) ?? null;
+ }
+
+ async function companyAdapterUsage(companyId: string) {
+ const rows = await db
+ .select({ adapterType: agents.adapterType })
+ .from(agents)
+ .where(and(eq(agents.companyId, companyId), ne(agents.status, "terminated")));
+ const counts = new Map<string, number>();
+ for (const row of rows) {
+ const adapterType = normalizeAdapterType(row.adapterType);
+ if (!adapterType) continue;
+ counts.set(adapterType, (counts.get(adapterType) ?? 0) + 1);
+ }
+ return [...counts.entries()]
+ .map(([adapterType, count]) => ({ adapterType, count }))
+ .sort((a, b) => b.count - a.count || a.adapterType.localeCompare(b.adapterType))
+ .slice(0, 10);
+ }
+
+ async function resolveManagedAdapterType(companyId: string, declaration: PluginManagedAgentDeclaration) {
+ return selectPreferredAdapterType(declaration, await companyAdapterUsage(companyId));
+ }
+
+ async function materializeDeclaredInstructions(
+ companyId: string,
+ agent: Agent,
+ declaration: PluginManagedAgentDeclaration,
+ options: { replaceExisting: boolean },
+ ): Promise<Agent> {
+ const instructionDeclaration = declaration.instructions;
+ if (!instructionDeclaration?.content) return agent;
+
+ const entryFile = instructionDeclaration.entryFile ?? "AGENTS.md";
+ const variables = await optionsForInstructionVariables(companyId);
+ const materialized = await instructions.materializeManagedBundle(
+ agent,
+ { [entryFile]: applyInstructionTemplateVariables(instructionDeclaration.content, variables) },
+ {
+ entryFile,
+ replaceExisting: options.replaceExisting,
+ clearLegacyPromptTemplate: true,
+ },
+ );
+ const updated = await agentSvc.update(agent.id, {
+ adapterConfig: materialized.adapterConfig,
+ }, {
+ recordRevision: {
+ source: `plugin:${optionsForRevisionSource()}:managed-agent-instructions`,
+ },
+ });
+ return (updated as Agent | null) ?? { ...agent, adapterConfig: materialized.adapterConfig };
+ }
+
+ async function optionsForInstructionVariables(companyId: string) {
+ return options.instructionTemplateVariables ? options.instructionTemplateVariables(companyId) : {};
+ }
+
+ function optionsForRevisionSource() {
+ return options.pluginKey;
+ }
+
+ function resolution(
+ companyId: string,
+ declaration: PluginManagedAgentDeclaration,
+ agent: Agent | null,
+ status: PluginManagedAgentResolution["status"],
+ approvalId?: string | null,
+ ): PluginManagedAgentResolution {
+ return {
+ pluginKey: options.pluginKey,
+ resourceKind: "agent",
+ resourceKey: declaration.agentKey,
+ companyId,
+ agentId: agent?.id ?? null,
+ agent,
+ status,
+ approvalId: approvalId ?? null,
+ };
+ }
+
+ async function createManagedAgent(companyId: string, declaration: PluginManagedAgentDeclaration) {
+ const company = await db
+ .select()
+ .from(companies)
+ .where(eq(companies.id, companyId))
+ .then((rows) => rows[0] ?? null);
+ if (!company) throw notFound("Company not found");
+
+ const requiresApproval = company.requireBoardApprovalForNewAgents;
+ const adapterType = await resolveManagedAdapterType(companyId, declaration);
+ let created = await agentSvc.create(companyId, {
+ ...declarationPatch(declaration, { adapterType }),
+ status: requiresApproval ? "pending_approval" : declaration.status ?? "idle",
+ metadata: managedMetadata(options.pluginId, options.pluginKey, declaration),
+ spentMonthlyCents: 0,
+ lastHeartbeatAt: null,
+ }) as Agent;
+ created = await materializeDeclaredInstructions(companyId, created, declaration, { replaceExisting: true });
+
+ let approvalId: string | null = null;
+ if (requiresApproval) {
+ const approval = await approvalSvc.create(companyId, {
+ type: "hire_agent",
+ requestedByAgentId: null,
+ requestedByUserId: null,
+ status: "pending",
+ payload: {
+ name: created.name,
+ role: created.role,
+ title: created.title,
+ icon: created.icon,
+ reportsTo: created.reportsTo,
+ capabilities: created.capabilities,
+ adapterType: created.adapterType,
+ adapterConfig: created.adapterConfig,
+ runtimeConfig: created.runtimeConfig,
+ budgetMonthlyCents: created.budgetMonthlyCents,
+ metadata: created.metadata,
+ agentId: created.id,
+ sourcePluginId: options.pluginId,
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.agentKey,
+ },
+ decisionNote: null,
+ decidedByUserId: null,
+ decidedAt: null,
+ updatedAt: new Date(),
+ });
+ approvalId = approval.id;
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "approval.created",
+ entityType: "approval",
+ entityId: approval.id,
+ details: {
+ type: "hire_agent",
+ linkedAgentId: created.id,
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.agentKey,
+ },
+ });
+ }
+
+ await upsertBinding(companyId, declaration, created.id, { approvalId }, adapterType);
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_agent.created",
+ entityType: "agent",
+ entityId: created.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.agentKey,
+ adapterType,
+ requiresApproval,
+ approvalId,
+ },
+ });
+ return resolution(companyId, declaration, created as Agent, "created", approvalId);
+ }
+
+ async function get(agentKey: string, companyId: string) {
+ const declaration = declarationFor(agentKey);
+ const binding = await getBinding(companyId, agentKey);
+ const boundAgentId = typeof binding?.data?.agentId === "string" ? binding.data.agentId : null;
+ if (!boundAgentId) return resolution(companyId, declaration, null, "missing");
+ const agent = await agentSvc.getById(boundAgentId);
+ if (!agent || agent.companyId !== companyId || agent.status === "terminated") {
+ return resolution(companyId, declaration, null, "missing");
+ }
+ return resolution(companyId, declaration, agent as Agent, "resolved");
+ }
+
+ async function reconcile(agentKey: string, companyId: string) {
+ const declaration = declarationFor(agentKey);
+ const current = await get(agentKey, companyId);
+ if (current.agent) {
+ await upsertBinding(companyId, declaration, current.agent.id);
+ return current;
+ }
+
+ const relinkCandidate = await findRelinkCandidate(companyId, declaration);
+ if (relinkCandidate) {
+ await upsertBinding(companyId, declaration, relinkCandidate.id);
+ const agent = await agentSvc.getById(relinkCandidate.id);
+ return resolution(companyId, declaration, agent as Agent, "relinked");
+ }
+
+ return createManagedAgent(companyId, declaration);
+ }
+
+ async function reset(agentKey: string, companyId: string) {
+ const declaration = declarationFor(agentKey);
+ const reconciled = await reconcile(agentKey, companyId);
+ if (!reconciled.agent) return reconciled;
+ const currentMetadata = reconciled.agent.metadata && typeof reconciled.agent.metadata === "object"
+ ? reconciled.agent.metadata
+ : {};
+ const adapterType = await resolveManagedAdapterType(companyId, declaration);
+ const updated = await agentSvc.update(reconciled.agent.id, {
+ ...declarationPatch(declaration, { adapterType }),
+ metadata: managedMetadata(options.pluginId, options.pluginKey, declaration, currentMetadata),
+ }, {
+ recordRevision: {
+ source: `plugin:${options.pluginKey}:managed-agent-reset`,
+ },
+ });
+ if (!updated) throw notFound("Managed agent not found");
+ const updatedAgent = await materializeDeclaredInstructions(companyId, updated as Agent, declaration, { replaceExisting: true });
+ await upsertBinding(companyId, declaration, updatedAgent.id, {}, adapterType);
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_agent.reset",
+ entityType: "agent",
+ entityId: updatedAgent.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.agentKey,
+ },
+ });
+ return resolution(companyId, declaration, updatedAgent, "reset");
+ }
+
+ return {
+ get,
+ reconcile,
+ reset,
+ };
+}
diff --git a/server/src/services/plugin-managed-routines.ts b/server/src/services/plugin-managed-routines.ts
new file mode 100644
index 0000000000..94027dd323
--- /dev/null
+++ b/server/src/services/plugin-managed-routines.ts
@@ -0,0 +1,523 @@
+import { and, eq } from "drizzle-orm";
+import type { Db } from "@paperclipai/db";
+import {
+ agents,
+ pluginManagedResources,
+ plugins,
+ projects,
+ routines,
+ routineTriggers,
+} from "@paperclipai/db";
+import type {
+ CreateRoutineTrigger,
+ PluginManagedResourceRef,
+ PluginManagedRoutineDeclaration,
+ PluginManagedRoutineResolution,
+ Routine,
+ RoutineManagedByPlugin,
+ RoutineStatus,
+} from "@paperclipai/shared";
+import { ROUTINE_STATUSES } from "@paperclipai/shared";
+import { notFound, unprocessable } from "../errors.js";
+import { logActivity } from "./activity-log.js";
+import { routineService } from "./routines.js";
+import type { PluginWorkerManager } from "./plugin-worker-manager.js";
+
+const MANAGED_ROUTINE_RESOURCE_KIND = "routine";
+
+interface PluginManagedRoutineServiceOptions {
+ pluginId: string;
+ pluginKey: string;
+ manifest?: import("@paperclipai/shared").PaperclipPluginManifestV1 | null;
+ pluginWorkerManager?: PluginWorkerManager;
+}
+
+interface RoutineOverrides {
+ assigneeAgentId?: string | null;
+ projectId?: string | null;
+}
+
+function buildRoutineDefaults(declaration: PluginManagedRoutineDeclaration) {
+ return {
+ routineKey: declaration.routineKey,
+ title: declaration.title,
+ description: declaration.description ?? null,
+ assigneeRef: declaration.assigneeRef ?? null,
+ projectRef: declaration.projectRef ?? null,
+ goalId: declaration.goalId ?? null,
+ status: declaration.status ?? null,
+ priority: declaration.priority ?? "medium",
+ concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+ catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+ variables: declaration.variables ?? [],
+ triggers: declaration.triggers ?? [],
+ issueTemplate: declaration.issueTemplate ?? null,
+ };
+}
+
+function normalizeRef(
+ pluginKey: string,
+ ref: PluginManagedResourceRef | null | undefined,
+ resourceKind: "agent" | "project",
+) {
+ if (!ref) return null;
+ if (ref.resourceKind !== resourceKind) {
+ throw unprocessable(`Managed routine ${resourceKind} ref must target ${resourceKind}`);
+ }
+ if (ref.pluginKey && ref.pluginKey !== pluginKey) {
+ throw unprocessable("Managed routine refs must target the declaring plugin");
+ }
+ return { ...ref, pluginKey };
+}
+
+function managedByPlugin(row: {
+ id: string;
+ pluginId: string;
+ pluginKey: string;
+ manifestJson: { displayName?: string } | null;
+ resourceKey: string;
+ defaultsJson: Record<string, unknown>;
+ createdAt: Date;
+ updatedAt: Date;
+}): RoutineManagedByPlugin {
+ return {
+ id: row.id,
+ pluginId: row.pluginId,
+ pluginKey: row.pluginKey,
+ pluginDisplayName: row.manifestJson?.displayName ?? row.pluginKey,
+ resourceKind: "routine",
+ resourceKey: row.resourceKey,
+ defaultsJson: row.defaultsJson,
+ createdAt: row.createdAt,
+ updatedAt: row.updatedAt,
+ };
+}
+
+function triggerInput(trigger: NonNullable<PluginManagedRoutineDeclaration["triggers"]>[number]): CreateRoutineTrigger {
+ if (trigger.kind === "schedule") {
+ if (!trigger.cronExpression) {
+ throw unprocessable("Managed schedule routine triggers require cronExpression");
+ }
+ return {
+ kind: "schedule",
+ label: trigger.label ?? null,
+ enabled: trigger.enabled ?? true,
+ cronExpression: trigger.cronExpression,
+ timezone: trigger.timezone ?? "UTC",
+ };
+ }
+ if (trigger.kind === "webhook") {
+ return {
+ kind: "webhook",
+ label: trigger.label ?? null,
+ enabled: trigger.enabled ?? true,
+ signingMode: (trigger.signingMode ?? "bearer") as Extract<CreateRoutineTrigger, { kind: "webhook" }>["signingMode"],
+ replayWindowSec: trigger.replayWindowSec ?? 300,
+ };
+ }
+ return {
+ kind: "api",
+ label: trigger.label ?? null,
+ enabled: trigger.enabled ?? true,
+ };
+}
+
+export function pluginManagedRoutineService(
+ db: Db,
+ options: PluginManagedRoutineServiceOptions,
+) {
+ const routinesSvc = routineService(db, {
+ pluginWorkerManager: options.pluginWorkerManager,
+ });
+
+ function declarationFor(routineKey: string) {
+ const declaration = options.manifest?.routines?.find((routine) => routine.routineKey === routineKey);
+ if (!declaration) {
+ throw notFound(`Managed routine declaration not found: ${routineKey}`);
+ }
+ return declaration;
+ }
+
+ async function getBinding(companyId: string, routineKey: string) {
+ return db
+ .select({
+ id: pluginManagedResources.id,
+ companyId: pluginManagedResources.companyId,
+ pluginId: pluginManagedResources.pluginId,
+ pluginKey: pluginManagedResources.pluginKey,
+ resourceKind: pluginManagedResources.resourceKind,
+ resourceKey: pluginManagedResources.resourceKey,
+ resourceId: pluginManagedResources.resourceId,
+ defaultsJson: pluginManagedResources.defaultsJson,
+ manifestJson: plugins.manifestJson,
+ createdAt: pluginManagedResources.createdAt,
+ updatedAt: pluginManagedResources.updatedAt,
+ })
+ .from(pluginManagedResources)
+ .innerJoin(plugins, eq(pluginManagedResources.pluginId, plugins.id))
+ .where(
+ and(
+ eq(pluginManagedResources.companyId, companyId),
+ eq(pluginManagedResources.pluginId, options.pluginId),
+ eq(pluginManagedResources.resourceKind, MANAGED_ROUTINE_RESOURCE_KIND),
+ eq(pluginManagedResources.resourceKey, routineKey),
+ ),
+ )
+ .then((rows) => rows[0] ?? null);
+ }
+
+ async function upsertBinding(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ routineId: string,
+ ) {
+ const defaultsJson = buildRoutineDefaults(declaration);
+ const existing = await getBinding(companyId, declaration.routineKey);
+ if (existing) {
+ return db
+ .update(pluginManagedResources)
+ .set({
+ resourceId: routineId,
+ defaultsJson,
+ updatedAt: new Date(),
+ })
+ .where(eq(pluginManagedResources.id, existing.id))
+ .returning()
+ .then((rows) => rows[0]);
+ }
+ return db
+ .insert(pluginManagedResources)
+ .values({
+ companyId,
+ pluginId: options.pluginId,
+ pluginKey: options.pluginKey,
+ resourceKind: MANAGED_ROUTINE_RESOURCE_KIND,
+ resourceKey: declaration.routineKey,
+ resourceId: routineId,
+ defaultsJson,
+ })
+ .returning()
+ .then((rows) => rows[0]);
+ }
+
+ async function getRoutineWithManagedBy(companyId: string, declaration: PluginManagedRoutineDeclaration) {
+ const binding = await getBinding(companyId, declaration.routineKey);
+ if (!binding) return null;
+ const routine = await db
+ .select()
+ .from(routines)
+ .where(and(eq(routines.companyId, companyId), eq(routines.id, binding.resourceId)))
+ .then((rows) => rows[0] ?? null);
+ if (!routine) return null;
+ return {
+ ...routine,
+ managedByPlugin: managedByPlugin(binding),
+ } as Routine;
+ }
+
+ async function resolveAgentId(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ overrides?: RoutineOverrides,
+ ) {
+ if (overrides?.assigneeAgentId !== undefined) {
+ if (!overrides.assigneeAgentId) return { agentId: null, missingRef: null };
+ const row = await db
+ .select({ id: agents.id })
+ .from(agents)
+ .where(and(eq(agents.companyId, companyId), eq(agents.id, overrides.assigneeAgentId)))
+ .then((rows) => rows[0] ?? null);
+ if (!row) throw notFound("Assignee agent not found");
+ return { agentId: row.id, missingRef: null };
+ }
+
+ const ref = normalizeRef(options.pluginKey, declaration.assigneeRef, "agent");
+ if (!ref) return { agentId: null, missingRef: null };
+ const binding = await db
+ .select({ resourceId: pluginManagedResources.resourceId })
+ .from(pluginManagedResources)
+ .where(
+ and(
+ eq(pluginManagedResources.companyId, companyId),
+ eq(pluginManagedResources.pluginId, options.pluginId),
+ eq(pluginManagedResources.resourceKind, "agent"),
+ eq(pluginManagedResources.resourceKey, ref.resourceKey),
+ ),
+ )
+ .then((rows) => rows[0] ?? null);
+ if (!binding) return { agentId: null, missingRef: ref };
+ const row = await db
+ .select({ id: agents.id })
+ .from(agents)
+ .where(and(eq(agents.companyId, companyId), eq(agents.id, binding.resourceId)))
+ .then((rows) => rows[0] ?? null);
+ return row ? { agentId: row.id, missingRef: null } : { agentId: null, missingRef: ref };
+ }
+
+ async function resolveProjectId(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ overrides?: RoutineOverrides,
+ ) {
+ if (overrides?.projectId !== undefined) {
+ if (!overrides.projectId) return { projectId: null, missingRef: null };
+ const row = await db
+ .select({ id: projects.id })
+ .from(projects)
+ .where(and(eq(projects.companyId, companyId), eq(projects.id, overrides.projectId)))
+ .then((rows) => rows[0] ?? null);
+ if (!row) throw notFound("Project not found");
+ return { projectId: row.id, missingRef: null };
+ }
+
+ const ref = normalizeRef(options.pluginKey, declaration.projectRef, "project");
+ if (!ref) return { projectId: null, missingRef: null };
+ const binding = await db
+ .select({ resourceId: pluginManagedResources.resourceId })
+ .from(pluginManagedResources)
+ .where(
+ and(
+ eq(pluginManagedResources.companyId, companyId),
+ eq(pluginManagedResources.pluginId, options.pluginId),
+ eq(pluginManagedResources.resourceKind, "project"),
+ eq(pluginManagedResources.resourceKey, ref.resourceKey),
+ ),
+ )
+ .then((rows) => rows[0] ?? null);
+ if (!binding) return { projectId: null, missingRef: ref };
+ const row = await db
+ .select({ id: projects.id })
+ .from(projects)
+ .where(and(eq(projects.companyId, companyId), eq(projects.id, binding.resourceId)))
+ .then((rows) => rows[0] ?? null);
+ return row ? { projectId: row.id, missingRef: null } : { projectId: null, missingRef: ref };
+ }
+
+ async function resolveRefs(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ overrides?: RoutineOverrides,
+ ) {
+ const [agent, project] = await Promise.all([
+ resolveAgentId(companyId, declaration, overrides),
+ resolveProjectId(companyId, declaration, overrides),
+ ]);
+ const missingRefs: PluginManagedResourceRef[] = [];
+ if (agent.missingRef) missingRefs.push(agent.missingRef);
+ if (project.missingRef) missingRefs.push(project.missingRef);
+ return {
+ assigneeAgentId: agent.agentId,
+ projectId: project.projectId,
+ missingRefs,
+ };
+ }
+
+ function resolution(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ routine: Routine | null,
+ status: PluginManagedRoutineResolution["status"],
+ missingRefs: PluginManagedResourceRef[] = [],
+ ): PluginManagedRoutineResolution {
+ return {
+ pluginKey: options.pluginKey,
+ resourceKind: "routine",
+ resourceKey: declaration.routineKey,
+ companyId,
+ routineId: routine?.id ?? null,
+ routine,
+ status,
+ missingRefs,
+ };
+ }
+
+ async function ensureDefaultTriggers(
+ routineId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ ) {
+ const triggers = declaration.triggers ?? [];
+ if (triggers.length === 0) return;
+ const existingCount = await db
+ .select({ id: routineTriggers.id })
+ .from(routineTriggers)
+ .where(eq(routineTriggers.routineId, routineId))
+ .limit(1)
+ .then((rows) => rows.length);
+ if (existingCount > 0) return;
+
+ for (const trigger of triggers) {
+ await routinesSvc.createTrigger(routineId, triggerInput(trigger), { agentId: null, userId: null });
+ }
+ }
+
+ async function createManagedRoutine(
+ companyId: string,
+ declaration: PluginManagedRoutineDeclaration,
+ overrides?: RoutineOverrides,
+ ) {
+ const refs = await resolveRefs(companyId, declaration, overrides);
+ if (refs.missingRefs.length > 0) {
+ return resolution(companyId, declaration, null, "missing_refs", refs.missingRefs);
+ }
+
+ const created = await routinesSvc.create(companyId, {
+ projectId: refs.projectId,
+ goalId: declaration.goalId ?? null,
+ title: declaration.title,
+ description: declaration.description ?? null,
+ assigneeAgentId: refs.assigneeAgentId,
+ priority: declaration.priority ?? "medium",
+ status: declaration.status ?? (refs.assigneeAgentId ? "active" : "paused"),
+ concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+ catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+ variables: declaration.variables ?? [],
+ }, { agentId: null, userId: null });
+ await upsertBinding(companyId, declaration, created.id);
+ await ensureDefaultTriggers(created.id, declaration);
+ const routine = await getRoutineWithManagedBy(companyId, declaration);
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_routine.created",
+ entityType: "routine",
+ entityId: created.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.routineKey,
+ assigneeAgentId: refs.assigneeAgentId,
+ projectId: refs.projectId,
+ },
+ });
+ return resolution(companyId, declaration, routine, "created");
+ }
+
+ async function get(routineKey: string, companyId: string) {
+ const declaration = declarationFor(routineKey);
+ const routine = await getRoutineWithManagedBy(companyId, declaration);
+ return resolution(companyId, declaration, routine, routine ? "resolved" : "missing");
+ }
+
+ async function reconcile(routineKey: string, companyId: string, overrides?: RoutineOverrides) {
+ const declaration = declarationFor(routineKey);
+ const current = await get(routineKey, companyId);
+ if (current.routine) {
+ await upsertBinding(companyId, declaration, current.routine.id);
+ await ensureDefaultTriggers(current.routine.id, declaration);
+ return current;
+ }
+ return createManagedRoutine(companyId, declaration, overrides);
+ }
+
+ async function reset(routineKey: string, companyId: string, overrides?: RoutineOverrides) {
+ const declaration = declarationFor(routineKey);
+ const current = await get(routineKey, companyId);
+ if (!current.routine) {
+ return createManagedRoutine(companyId, declaration, overrides);
+ }
+
+ const refs = await resolveRefs(companyId, declaration, overrides);
+ if (refs.missingRefs.length > 0) {
+ return resolution(companyId, declaration, current.routine, "missing_refs", refs.missingRefs);
+ }
+ const updated = await routinesSvc.update(current.routine.id, {
+ projectId: refs.projectId,
+ goalId: declaration.goalId ?? null,
+ title: declaration.title,
+ description: declaration.description ?? null,
+ assigneeAgentId: refs.assigneeAgentId,
+ priority: declaration.priority ?? "medium",
+ status: declaration.status ?? (refs.assigneeAgentId ? "active" : "paused"),
+ concurrencyPolicy: declaration.concurrencyPolicy ?? "coalesce_if_active",
+ catchUpPolicy: declaration.catchUpPolicy ?? "skip_missed",
+ variables: declaration.variables ?? [],
+ }, { agentId: null, userId: null });
+ if (!updated) throw notFound("Managed routine not found");
+ await upsertBinding(companyId, declaration, updated.id);
+ await ensureDefaultTriggers(updated.id, declaration);
+ const routine = await getRoutineWithManagedBy(companyId, declaration);
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_routine.reset",
+ entityType: "routine",
+ entityId: updated.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.routineKey,
+ assigneeAgentId: refs.assigneeAgentId,
+ projectId: refs.projectId,
+ },
+ });
+ return resolution(companyId, declaration, routine, "reset");
+ }
+
+ async function update(
+ routineKey: string,
+ companyId: string,
+ patch: { status?: string },
+ ) {
+ const declaration = declarationFor(routineKey);
+ const current = await get(routineKey, companyId);
+ if (!current.routine) throw notFound("Managed routine not found");
+ const updatePatch: { status?: RoutineStatus } = {};
+ if (patch.status !== undefined) {
+ if (!ROUTINE_STATUSES.includes(patch.status as RoutineStatus)) {
+ throw unprocessable("Invalid routine status");
+ }
+ updatePatch.status = patch.status as RoutineStatus;
+ }
+ const updated = await routinesSvc.update(current.routine.id, updatePatch, { agentId: null, userId: null });
+ if (!updated) throw notFound("Managed routine not found");
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_routine.updated",
+ entityType: "routine",
+ entityId: updated.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.routineKey,
+ status: updated.status,
+ },
+ });
+ const routine = await getRoutineWithManagedBy(companyId, declaration);
+ return routine ?? updated;
+ }
+
+ async function run(routineKey: string, companyId: string, overrides?: RoutineOverrides) {
+ const declaration = declarationFor(routineKey);
+ const current = await get(routineKey, companyId);
+ if (!current.routine) throw notFound("Managed routine not found");
+ const run = await routinesSvc.runRoutine(current.routine.id, {
+ source: "manual",
+ assigneeAgentId: overrides?.assigneeAgentId,
+ projectId: overrides?.projectId,
+ }, { agentId: null, userId: null });
+ await logActivity(db, {
+ companyId,
+ actorType: "plugin",
+ actorId: options.pluginId,
+ action: "plugin.managed_routine.run_triggered",
+ entityType: "routine_run",
+ entityId: run.id,
+ details: {
+ sourcePluginKey: options.pluginKey,
+ managedResourceKey: declaration.routineKey,
+ routineId: current.routine.id,
+ status: run.status,
+ },
+ });
+ return run;
+ }
+
+ return {
+ get,
+ reconcile,
+ reset,
+ update,
+ run,
+ };
+}
diff --git a/server/src/services/plugin-registry.ts b/server/src/services/plugin-registry.ts
index 79859a4e94..ce544a9cfb 100644
--- a/server/src/services/plugin-registry.ts
+++ b/server/src/services/plugin-registry.ts
@@ -3,6 +3,7 @@ import type { Db } from "@paperclipai/db";
import {
plugins,
pluginConfig,
+ pluginCompanySettings,
pluginEntities,
pluginJobs,
pluginJobRuns,
@@ -15,6 +16,7 @@ import type {
UpdatePluginStatus,
UpsertPluginConfig,
PatchPluginConfig,
+ PluginCompanySettings,
PluginEntityRecord,
PluginEntityQuery,
PluginJobRecord,
@@ -387,6 +389,64 @@ export function pluginRegistryService(db: Db) {
return rows[0] ?? null;
},
+ // ----- Company settings ----------------------------------------------
+
+ /** Retrieve company-scoped plugin settings. */
+ getCompanySettings: (pluginId: string, companyId: string): Promise<PluginCompanySettings | null> =>
+ db
+ .select()
+ .from(pluginCompanySettings)
+ .where(and(
+ eq(pluginCompanySettings.pluginId, pluginId),
+ eq(pluginCompanySettings.companyId, companyId),
+ ))
+ .then((rows) => rows[0] ?? null) as Promise<PluginCompanySettings | null>,
+
+ /** Create or replace company-scoped plugin settings. */
+ upsertCompanySettings: async (
+ pluginId: string,
+ companyId: string,
+ input: { enabled?: boolean; settingsJson: Record<string, unknown>; lastError?: string | null },
+ ): Promise<PluginCompanySettings> => {
+ const plugin = await getById(pluginId);
+ if (!plugin) throw notFound("Plugin not found");
+
+ const existing = await db
+ .select()
+ .from(pluginCompanySettings)
+ .where(and(
+ eq(pluginCompanySettings.pluginId, pluginId),
+ eq(pluginCompanySettings.companyId, companyId),
+ ))
+ .then((rows) => rows[0] ?? null);
+
+ if (existing) {
+ return db
+ .update(pluginCompanySettings)
+ .set({
+ enabled: input.enabled ?? existing.enabled,
+ settingsJson: input.settingsJson,
+ lastError: input.lastError ?? null,
+ updatedAt: new Date(),
+ })
+ .where(eq(pluginCompanySettings.id, existing.id))
+ .returning()
+ .then((rows) => rows[0]) as Promise<PluginCompanySettings>;
+ }
+
+ return db
+ .insert(pluginCompanySettings)
+ .values({
+ pluginId,
+ companyId,
+ enabled: input.enabled ?? true,
+ settingsJson: input.settingsJson,
+ lastError: input.lastError ?? null,
+ })
+ .returning()
+ .then((rows) => rows[0]) as Promise<PluginCompanySettings>;
+ },
+
// ----- Entities -------------------------------------------------------
/**
diff --git a/server/src/services/projects.ts b/server/src/services/projects.ts
index 2bcf7affe3..4d568c6870 100644
--- a/server/src/services/projects.ts
+++ b/server/src/services/projects.ts
@@ -1,6 +1,14 @@
import { and, asc, desc, eq, inArray } from "drizzle-orm";
import type { Db } from "@paperclipai/db";
-import { projects, projectGoals, goals, projectWorkspaces, workspaceRuntimeServices } from "@paperclipai/db";
+import {
+ projects,
+ projectGoals,
+ goals,
+ pluginManagedResources,
+ plugins,
+ projectWorkspaces,
+ workspaceRuntimeServices,
+} from "@paperclipai/db";
import {
PROJECT_COLORS,
deriveProjectUrlKey,
@@ -10,9 +18,12 @@ import {
type ProjectCodebase,
type ProjectExecutionWorkspacePolicy,
type ProjectGoalRef,
+ type ProjectManagedByPlugin,
type ProjectWorkspaceRuntimeConfig,
type ProjectWorkspace,
type WorkspaceRuntimeService,
+ type PluginManagedProjectDeclaration,
+ type PluginManagedProjectResolution,
} from "@paperclipai/shared";
import { listCurrentRuntimeServicesForProjectWorkspaces } from "./workspace-runtime-read-model.js";
import { parseProjectExecutionWorkspacePolicy } from "./execution-workspace-policy.js";
@@ -50,6 +61,7 @@ interface ProjectWithGoals extends Omit<ProjectRow, "executionWorkspacePolicy">
codebase: ProjectCodebase;
workspaces: ProjectWorkspace[];
primaryWorkspace: ProjectWorkspace | null;
+ managedByPlugin: ProjectManagedByPlugin | null;
}
interface ProjectShortnameRow {
@@ -245,6 +257,40 @@ async function attachWorkspaces(db: Db, rows: ProjectWithGoals[]): Promise<Proje
arr.push(row);
}
+ const managedRows = await db
+ .select({
+ id: pluginManagedResources.id,
+ pluginId: pluginManagedResources.pluginId,
+ pluginKey: pluginManagedResources.pluginKey,
+ manifestJson: plugins.manifestJson,
+ resourceKind: pluginManagedResources.resourceKind,
+ resourceKey: pluginManagedResources.resourceKey,
+ resourceId: pluginManagedResources.resourceId,
+ defaultsJson: pluginManagedResources.defaultsJson,
+ createdAt: pluginManagedResources.createdAt,
+ updatedAt: pluginManagedResources.updatedAt,
+ })
+ .from(pluginManagedResources)
+ .innerJoin(plugins, eq(pluginManagedResources.pluginId, plugins.id))
+ .where(and(
+ eq(pluginManagedResources.resourceKind, "project"),
+ inArray(pluginManagedResources.resourceId, projectIds),
+ ));
+ const managedByProjectId = new Map<string, ProjectManagedByPlugin>();
+ for (const row of managedRows) {
+ managedByProjectId.set(row.resourceId, {
+ id: row.id,
+ pluginId: row.pluginId,
+ pluginKey: row.pluginKey,
+ pluginDisplayName: row.manifestJson.displayName ?? row.pluginKey,
+ resourceKind: "project",
+ resourceKey: row.resourceKey,
+ defaultsJson: row.defaultsJson,
+ createdAt: row.createdAt,
+ updatedAt: row.updatedAt,
+ });
+ }
+
return rows.map((row) => {
const projectWorkspaceRows = map.get(row.id) ?? [];
const workspaces = projectWorkspaceRows.map((workspace) =>
@@ -264,6 +310,7 @@ async function attachWorkspaces(db: Db, rows: ProjectWithGoals[]): Promise<Proje
}),
workspaces,
primaryWorkspace,
+ managedByPlugin: managedByProjectId.get(row.id) ?? null,
};
});
}
@@ -337,6 +384,17 @@ function deriveWorkspaceName(input: {
return "Workspace";
}
+function buildManagedProjectDefaults(declaration: PluginManagedProjectDeclaration) {
+ return {
+ projectKey: declaration.projectKey,
+ displayName: declaration.displayName,
+ description: declaration.description ?? null,
+ status: declaration.status ?? "in_progress",
+ color: declaration.color ?? null,
+ settings: declaration.settings ?? {},
+ };
+}
+
export function resolveProjectNameForUniqueShortname(
requestedName: string,
existingProjects: ProjectShortnameRow[],
@@ -398,6 +456,58 @@ async function ensureSinglePrimaryWorkspace(
}
export function projectService(db: Db) {
+ const createProject = async (
+ companyId: string,
+ data: Omit<typeof projects.$inferInsert, "companyId"> & { goalIds?: string[] },
+ ): Promise<ProjectWithGoals> => {
+ const { goalIds: inputGoalIds, ...projectData } = data;
+ const ids = resolveGoalIds({ goalIds: inputGoalIds, goalId: projectData.goalId });
+
+ // Auto-assign a color from the palette if none provided
+ if (!projectData.color) {
+ const existing = await db.select({ color: projects.color }).from(projects).where(eq(projects.companyId, companyId));
+ const usedColors = new Set(existing.map((r) => r.color).filter(Boolean));
+ const nextColor = PROJECT_COLORS.find((c) => !usedColors.has(c)) ?? PROJECT_COLORS[existing.length % PROJECT_COLORS.length];
+ projectData.color = nextColor;
+ }
+
+ const existingProjects = await db
+ .select({ id: projects.id, name: projects.name })
+ .from(projects)
+ .where(eq(projects.companyId, companyId));
+ projectData.name = resolveProjectNameForUniqueShortname(projectData.name, existingProjects);
+
+ // Also write goalId to the legacy column (first goal or null)
+ const legacyGoalId = ids && ids.length > 0 ? ids[0] : projectData.goalId ?? null;
+
+ const row = await db
+ .insert(projects)
+ .values({ ...projectData, goalId: legacyGoalId, companyId })
+ .returning()
+ .then((rows) => rows[0]);
+
+ if (ids && ids.length > 0) {
+ await syncGoalLinks(db, row.id, companyId, ids);
+ }
+
+ const [withGoals] = await attachGoals(db, [row]);
+ const [enriched] = withGoals ? await attachWorkspaces(db, [withGoals]) : [];
+ return enriched!;
+ };
+
+ const getProjectById = async (id: string): Promise<ProjectWithGoals | null> => {
+ const row = await db
+ .select()
+ .from(projects)
+ .where(eq(projects.id, id))
+ .then((rows) => rows[0] ?? null);
+ if (!row) return null;
+ const [withGoals] = await attachGoals(db, [row]);
+ if (!withGoals) return null;
+ const [enriched] = await attachWorkspaces(db, [withGoals]);
+ return enriched ?? null;
+ };
+
return {
list: async (companyId: string): Promise<ProjectWithGoals[]> => {
const rows = await db.select().from(projects).where(eq(projects.companyId, companyId));
@@ -418,58 +528,170 @@ export function projectService(db: Db) {
return dedupedIds.map((id) => byId.get(id)).filter((project): project is ProjectWithGoals => Boolean(project));
},
- getById: async (id: string): Promise<ProjectWithGoals | null> => {
- const row = await db
- .select()
- .from(projects)
- .where(eq(projects.id, id))
+ getById: getProjectById,
+
+ resolveManagedProject: async (input: {
+ companyId: string;
+ pluginId: string;
+ pluginKey: string;
+ projectKey: string;
+ reset?: boolean;
+ createIfMissing?: boolean;
+ }): Promise<PluginManagedProjectResolution> => {
+ const plugin = await db
+ .select({ id: plugins.id, pluginKey: plugins.pluginKey, manifestJson: plugins.manifestJson })
+ .from(plugins)
+ .where(eq(plugins.id, input.pluginId))
.then((rows) => rows[0] ?? null);
- if (!row) return null;
- const [withGoals] = await attachGoals(db, [row]);
- if (!withGoals) return null;
- const [enriched] = await attachWorkspaces(db, [withGoals]);
- return enriched ?? null;
- },
-
- create: async (
- companyId: string,
- data: Omit<typeof projects.$inferInsert, "companyId"> & { goalIds?: string[] },
- ): Promise<ProjectWithGoals> => {
- const { goalIds: inputGoalIds, ...projectData } = data;
- const ids = resolveGoalIds({ goalIds: inputGoalIds, goalId: projectData.goalId });
+ if (!plugin || plugin.pluginKey !== input.pluginKey) {
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: null,
+ project: null,
+ status: "missing",
+ };
+ }
- // Auto-assign a color from the palette if none provided
- if (!projectData.color) {
- const existing = await db.select({ color: projects.color }).from(projects).where(eq(projects.companyId, companyId));
- const usedColors = new Set(existing.map((r) => r.color).filter(Boolean));
- const nextColor = PROJECT_COLORS.find((c) => !usedColors.has(c)) ?? PROJECT_COLORS[existing.length % PROJECT_COLORS.length];
- projectData.color = nextColor;
+ const declaration = plugin.manifestJson.projects?.find((project) => project.projectKey === input.projectKey);
+ if (!declaration) {
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: null,
+ project: null,
+ status: "missing",
+ };
}
- const existingProjects = await db
- .select({ id: projects.id, name: projects.name })
- .from(projects)
- .where(eq(projects.companyId, companyId));
- projectData.name = resolveProjectNameForUniqueShortname(projectData.name, existingProjects);
+ const defaults = buildManagedProjectDefaults(declaration);
+ const existingBinding = await db
+ .select()
+ .from(pluginManagedResources)
+ .where(and(
+ eq(pluginManagedResources.companyId, input.companyId),
+ eq(pluginManagedResources.pluginId, input.pluginId),
+ eq(pluginManagedResources.resourceKind, "project"),
+ eq(pluginManagedResources.resourceKey, input.projectKey),
+ ))
+ .then((rows) => rows[0] ?? null);
- // Also write goalId to the legacy column (first goal or null)
- const legacyGoalId = ids && ids.length > 0 ? ids[0] : projectData.goalId ?? null;
+ if (existingBinding) {
+ const existingProject = await db
+ .select({ id: projects.id })
+ .from(projects)
+ .where(and(eq(projects.companyId, input.companyId), eq(projects.id, existingBinding.resourceId)))
+ .then((rows) => rows[0] ?? null);
+ if (existingProject) {
+ if (input.reset) {
+ await db
+ .update(projects)
+ .set({
+ name: declaration.displayName,
+ description: declaration.description ?? null,
+ status: declaration.status ?? "in_progress",
+ color: declaration.color ?? null,
+ updatedAt: new Date(),
+ })
+ .where(and(eq(projects.companyId, input.companyId), eq(projects.id, existingBinding.resourceId)));
+ }
+ if (input.createIfMissing !== false) {
+ await db
+ .update(pluginManagedResources)
+ .set({ defaultsJson: defaults, updatedAt: new Date() })
+ .where(eq(pluginManagedResources.id, existingBinding.id));
+ }
+ const project = await getProjectById(existingBinding.resourceId);
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: project?.id ?? existingBinding.resourceId,
+ project: project as import("@paperclipai/shared").Project | null,
+ status: input.reset ? "reset" : "resolved",
+ };
+ }
- const row = await db
- .insert(projects)
- .values({ ...projectData, goalId: legacyGoalId, companyId })
- .returning()
- .then((rows) => rows[0]);
+ if (input.createIfMissing === false) {
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: null,
+ project: null,
+ status: "missing",
+ };
+ }
- if (ids && ids.length > 0) {
- await syncGoalLinks(db, row.id, companyId, ids);
+ const project = await createProject(input.companyId, {
+ name: declaration.displayName,
+ description: declaration.description ?? null,
+ status: declaration.status ?? "in_progress",
+ color: declaration.color ?? undefined,
+ });
+ await db
+ .update(pluginManagedResources)
+ .set({ resourceId: project.id, defaultsJson: defaults, updatedAt: new Date() })
+ .where(eq(pluginManagedResources.id, existingBinding.id));
+ const hydrated = await getProjectById(project.id);
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: hydrated?.id ?? project.id,
+ project: hydrated as import("@paperclipai/shared").Project | null,
+ status: "relinked",
+ };
}
- const [withGoals] = await attachGoals(db, [row]);
- const [enriched] = withGoals ? await attachWorkspaces(db, [withGoals]) : [];
- return enriched!;
+ if (input.createIfMissing === false) {
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: null,
+ project: null,
+ status: "missing",
+ };
+ }
+
+ const project = await createProject(input.companyId, {
+ name: declaration.displayName,
+ description: declaration.description ?? null,
+ status: declaration.status ?? "in_progress",
+ color: declaration.color ?? undefined,
+ });
+ await db.insert(pluginManagedResources).values({
+ companyId: input.companyId,
+ pluginId: input.pluginId,
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ resourceId: project.id,
+ defaultsJson: defaults,
+ });
+ const hydrated = await getProjectById(project.id);
+ return {
+ pluginKey: input.pluginKey,
+ resourceKind: "project",
+ resourceKey: input.projectKey,
+ companyId: input.companyId,
+ projectId: hydrated?.id ?? project.id,
+ project: hydrated as import("@paperclipai/shared").Project | null,
+ status: "created",
+ };
},
+ create: createProject,
+
update: async (
id: string,
data: Partial<typeof projects.$inferInsert> & { goalIds?: string[] },
diff --git a/server/src/services/routines.ts b/server/src/services/routines.ts
index a632f7760e..b1242624f9 100644
--- a/server/src/services/routines.ts
+++ b/server/src/services/routines.ts
@@ -10,6 +10,8 @@ import {
issueInboxArchives,
issueReadStates,
issues,
+ pluginManagedResources,
+ plugins,
projects,
routineRuns,
routines,
@@ -21,6 +23,7 @@ import type {
Routine,
RoutineDetail,
RoutineListItem,
+ RoutineManagedByPlugin,
RoutineRunSummary,
RoutineTrigger,
RoutineTriggerSecretMaterial,
@@ -34,6 +37,7 @@ import {
getBuiltinRoutineVariableValues,
extractRoutineVariableNames,
interpolateRoutineTemplate,
+ pluginOperationIssueOriginKind,
stringifyRoutineVariableValue,
syncRoutineVariablesWithTemplate,
} from "@paperclipai/shared";
@@ -354,6 +358,16 @@ function createRoutineDispatchFingerprint(input: {
return crypto.createHash("sha256").update(canonical).digest("hex");
}
+function readManagedRoutineIssueTemplate(defaultsJson: Record<string, unknown> | null | undefined) {
+ const value = defaultsJson?.issueTemplate;
+ if (!isPlainRecord(value)) return null;
+ return {
+ surfaceVisibility: typeof value.surfaceVisibility === "string" ? value.surfaceVisibility : null,
+ originId: typeof value.originId === "string" && value.originId.trim() ? value.originId.trim() : null,
+ billingCode: typeof value.billingCode === "string" && value.billingCode.trim() ? value.billingCode.trim() : null,
+ };
+}
+
function routineUsesWorkspaceBranch(routine: typeof routines.$inferSelect) {
return (routine.variables ?? []).some((variable) => variable.name === WORKSPACE_BRANCH_ROUTINE_VARIABLE)
|| extractRoutineVariableNames([routine.title, routine.description]).includes(WORKSPACE_BRANCH_ROUTINE_VARIABLE);
@@ -380,6 +394,63 @@ export function routineService(
.then((rows) => rows[0] ?? null);
}
+ async function getManagedRoutineBinding(routine: typeof routines.$inferSelect) {
+ return db
+ .select({
+ pluginKey: pluginManagedResources.pluginKey,
+ defaultsJson: pluginManagedResources.defaultsJson,
+ manifestJson: plugins.manifestJson,
+ })
+ .from(pluginManagedResources)
+ .innerJoin(plugins, eq(pluginManagedResources.pluginId, plugins.id))
+ .where(
+ and(
+ eq(pluginManagedResources.companyId, routine.companyId),
+ eq(pluginManagedResources.resourceKind, "routine"),
+ eq(pluginManagedResources.resourceId, routine.id),
+ ),
+ )
+ .then((rows) => rows[0] ?? null);
+ }
+
+ async function listManagedRoutineMetadata(routineIds: string[]) {
+ if (routineIds.length === 0) return new Map<string, RoutineManagedByPlugin>();
+ const rows = await db
+ .select({
+ id: pluginManagedResources.id,
+ pluginId: pluginManagedResources.pluginId,
+ pluginKey: pluginManagedResources.pluginKey,
+ manifestJson: plugins.manifestJson,
+ resourceKey: pluginManagedResources.resourceKey,
+ resourceId: pluginManagedResources.resourceId,
+ defaultsJson: pluginManagedResources.defaultsJson,
+ createdAt: pluginManagedResources.createdAt,
+ updatedAt: pluginManagedResources.updatedAt,
+ })
+ .from(pluginManagedResources)
+ .innerJoin(plugins, eq(pluginManagedResources.pluginId, plugins.id))
+ .where(
+ and(
+ eq(pluginManagedResources.resourceKind, "routine"),
+ inArray(pluginManagedResources.resourceId, routineIds),
+ ),
+ );
+ return new Map(rows.map((row) => [
+ row.resourceId,
+ {
+ id: row.id,
+ pluginId: row.pluginId,
+ pluginKey: row.pluginKey,
+ pluginDisplayName: row.manifestJson.displayName ?? row.pluginKey,
+ resourceKind: "routine",
+ resourceKey: row.resourceKey,
+ defaultsJson: row.defaultsJson,
+ createdAt: row.createdAt,
+ updatedAt: row.updatedAt,
+ } satisfies RoutineManagedByPlugin,
+ ]));
+ }
+
async function getTriggerById(id: string) {
return db
.select()
@@ -664,8 +735,11 @@ export function routineService(
routine: typeof routines.$inferSelect,
executor: Db = db,
dispatchFingerprint?: string | null,
+ origin?: { kind: string; id: string | null },
) {
const fingerprintCondition = routineExecutionFingerprintCondition(dispatchFingerprint);
+ const originKind = origin?.kind ?? "routine_execution";
+ const originId = origin?.id ?? routine.id;
const executionBoundIssue = await executor
.select()
.from(issues)
@@ -679,8 +753,8 @@ export function routineService(
.where(
and(
eq(issues.companyId, routine.companyId),
- eq(issues.originKind, "routine_execution"),
- eq(issues.originId, routine.id),
+ eq(issues.originKind, originKind),
+ eq(issues.originId, originId),
inArray(issues.status, OPEN_ISSUE_STATUSES),
isNull(issues.hiddenAt),
...(fingerprintCondition ? [fingerprintCondition] : []),
@@ -705,8 +779,8 @@ export function routineService(
.where(
and(
eq(issues.companyId, routine.companyId),
- eq(issues.originKind, "routine_execution"),
- eq(issues.originId, routine.id),
+ eq(issues.originKind, originKind),
+ eq(issues.originId, originId),
inArray(issues.status, OPEN_ISSUE_STATUSES),
isNull(issues.hiddenAt),
...(fingerprintCondition ? [fingerprintCondition] : []),
@@ -844,6 +918,13 @@ export function routineService(
const title = interpolateRoutineTemplate(input.routine.title, allVariables) ?? input.routine.title;
const description = interpolateRoutineTemplate(input.routine.description, allVariables);
const triggerPayload = mergeRoutineRunPayload(input.payload, { ...automaticVariables, ...resolvedVariables });
+ const managedRoutineBinding = await getManagedRoutineBinding(input.routine);
+ const managedIssueTemplate = readManagedRoutineIssueTemplate(managedRoutineBinding?.defaultsJson);
+ const issueOriginKind = managedIssueTemplate?.surfaceVisibility === "plugin_operation" && managedRoutineBinding
+ ? pluginOperationIssueOriginKind(managedRoutineBinding.pluginKey)
+ : "routine_execution";
+ const issueOriginId = managedIssueTemplate?.originId ?? input.routine.id;
+ const issueBillingCode = managedIssueTemplate?.billingCode ?? null;
const dispatchFingerprint = createRoutineDispatchFingerprint({
payload: triggerPayload,
projectId,
@@ -902,7 +983,10 @@ export function routineService(
let createdIssue: Awaited<ReturnType<typeof issueSvc.create>> | null = null;
try {
- const activeIssue = await findLiveExecutionIssue(input.routine, txDb, dispatchFingerprint);
+ const activeIssue = await findLiveExecutionIssue(input.routine, txDb, dispatchFingerprint, {
+ kind: issueOriginKind,
+ id: issueOriginId,
+ });
if (activeIssue && input.routine.concurrencyPolicy !== "always_enqueue") {
const status = input.routine.concurrencyPolicy === "skip_if_active" ? "skipped" : "coalesced";
if (manualRunnerUserId) {
@@ -942,10 +1026,11 @@ export function routineService(
assigneeAgentId,
createdByAgentId: input.source === "manual" ? input.actor?.agentId ?? null : null,
createdByUserId: manualRunnerUserId,
- originKind: "routine_execution",
- originId: input.routine.id,
+ originKind: issueOriginKind,
+ originId: issueOriginId,
originRunId: createdRun.id,
originFingerprint: dispatchFingerprint,
+ billingCode: issueBillingCode,
executionWorkspaceId: input.executionWorkspaceId ?? null,
executionWorkspacePreference: input.executionWorkspacePreference ?? null,
executionWorkspaceSettings: input.executionWorkspaceSettings ?? null,
@@ -962,7 +1047,10 @@ export function routineService(
throw error;
}
- const existingIssue = await findLiveExecutionIssue(input.routine, txDb, dispatchFingerprint);
+ const existingIssue = await findLiveExecutionIssue(input.routine, txDb, dispatchFingerprint, {
+ kind: issueOriginKind,
+ id: issueOriginId,
+ });
if (!existingIssue) throw error;
const status = input.routine.concurrencyPolicy === "skip_if_active" ? "skipped" : "coalesced";
if (manualRunnerUserId) {
@@ -1084,13 +1172,15 @@ export function routineService(
.where(and(...conditions))
.orderBy(desc(routines.updatedAt), asc(routines.title));
const routineIds = rows.map((row) => row.id);
- const [triggersByRoutine, latestRunByRoutine, activeIssueByRoutine] = await Promise.all([
+ const [triggersByRoutine, latestRunByRoutine, activeIssueByRoutine, managedByRoutine] = await Promise.all([
listTriggersForRoutineIds(companyId, routineIds),
listLatestRunByRoutineIds(companyId, routineIds),
listLiveIssueByRoutineIds(companyId, routineIds),
+ listManagedRoutineMetadata(routineIds),
]);
return rows.map((row) => ({
...row,
+ managedByPlugin: managedByRoutine.get(row.id) ?? null,
triggers: (triggersByRoutine.get(row.id) ?? []).map((trigger) => ({
id: trigger.id,
kind: trigger.kind as RoutineListItem["triggers"][number]["kind"],
@@ -1110,7 +1200,7 @@ export function routineService(
getDetail: async (id: string): Promise<RoutineDetail | null> => {
const row = await getRoutineById(id);
if (!row) return null;
- const [project, assignee, parentIssue, triggers, recentRuns, activeIssue] = await Promise.all([
+ const [project, assignee, parentIssue, triggers, recentRuns, activeIssue, managedByRoutine] = await Promise.all([
row.projectId
? db.select().from(projects).where(eq(projects.id, row.projectId)).then((rows) => rows[0] ?? null)
: null,
@@ -1189,10 +1279,12 @@ export function routineService(
})),
),
findLiveExecutionIssue(row),
+ listManagedRoutineMetadata([row.id]),
]);
return {
...row,
+ managedByPlugin: managedByRoutine.get(row.id) ?? null,
project,
assignee,
parentIssue,
diff --git a/ui/src/App.tsx b/ui/src/App.tsx
index e29e6efe5c..c9637a9c5d 100644
--- a/ui/src/App.tsx
+++ b/ui/src/App.tsx
@@ -129,7 +129,7 @@ function boardRoutes() {
<Route path="u/:userSlug" element={<UserProfile />} />
<Route path="design-guide" element={<DesignGuide />} />
<Route path="instance/settings/adapters" element={<AdapterManager />} />
- <Route path=":pluginRoutePath" element={<PluginPage />} />
+ <Route path=":pluginRoutePath/*" element={<PluginPage />} />
<Route path="*" element={<NotFoundPage scope="board" />} />
</>
);
diff --git a/ui/src/api/issues.ts b/ui/src/api/issues.ts
index acae3a71ce..4bf9622264 100644
--- a/ui/src/api/issues.ts
+++ b/ui/src/api/issues.ts
@@ -43,6 +43,7 @@ export const issuesApi = {
workspaceId?: string;
executionWorkspaceId?: string;
originKind?: string;
+ originKindPrefix?: string;
originId?: string;
descendantOf?: string;
includeRoutineExecutions?: boolean;
@@ -66,6 +67,7 @@ export const issuesApi = {
if (filters?.workspaceId) params.set("workspaceId", filters.workspaceId);
if (filters?.executionWorkspaceId) params.set("executionWorkspaceId", filters.executionWorkspaceId);
if (filters?.originKind) params.set("originKind", filters.originKind);
+ if (filters?.originKindPrefix) params.set("originKindPrefix", filters.originKindPrefix);
if (filters?.originId) params.set("originId", filters.originId);
if (filters?.descendantOf) params.set("descendantOf", filters.descendantOf);
if (filters?.includeRoutineExecutions) params.set("includeRoutineExecutions", "true");
diff --git a/ui/src/api/plugins.test.ts b/ui/src/api/plugins.test.ts
new file mode 100644
index 0000000000..20d1153b89
--- /dev/null
+++ b/ui/src/api/plugins.test.ts
@@ -0,0 +1,64 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const mockApi = vi.hoisted(() => ({
+ get: vi.fn(),
+ post: vi.fn(),
+ put: vi.fn(),
+}));
+
+vi.mock("./client", () => ({
+ api: mockApi,
+}));
+
+import { pluginsApi } from "./plugins";
+
+describe("pluginsApi local folders", () => {
+ beforeEach(() => {
+ mockApi.get.mockReset();
+ mockApi.post.mockReset();
+ mockApi.put.mockReset();
+ mockApi.get.mockResolvedValue({});
+ mockApi.post.mockResolvedValue({});
+ mockApi.put.mockResolvedValue({});
+ });
+
+ it("lists company-scoped local folders for a plugin", async () => {
+ await pluginsApi.listLocalFolders("plugin-1", "company-1");
+
+ expect(mockApi.get).toHaveBeenCalledWith(
+ "/plugins/plugin-1/companies/company-1/local-folders",
+ );
+ });
+
+ it("validates a candidate folder path without saving", async () => {
+ await pluginsApi.validateLocalFolder("plugin-1", "company-1", "wiki-root", {
+ path: "/tmp/wiki",
+ access: "readWrite",
+ requiredFiles: ["WIKI.md"],
+ });
+
+ expect(mockApi.post).toHaveBeenCalledWith(
+ "/plugins/plugin-1/companies/company-1/local-folders/wiki-root/validate",
+ {
+ path: "/tmp/wiki",
+ access: "readWrite",
+ requiredFiles: ["WIKI.md"],
+ },
+ );
+ });
+
+ it("saves through the local-folder PUT endpoint", async () => {
+ await pluginsApi.configureLocalFolder("plugin-1", "company-1", "wiki-root", {
+ path: "/tmp/wiki",
+ requiredDirectories: ["wiki"],
+ });
+
+ expect(mockApi.put).toHaveBeenCalledWith(
+ "/plugins/plugin-1/companies/company-1/local-folders/wiki-root",
+ {
+ path: "/tmp/wiki",
+ requiredDirectories: ["wiki"],
+ },
+ );
+ });
+});
diff --git a/ui/src/api/plugins.ts b/ui/src/api/plugins.ts
index 0edc580f5f..2e4c981af3 100644
--- a/ui/src/api/plugins.ts
+++ b/ui/src/api/plugins.ts
@@ -14,6 +14,7 @@ import type {
PluginLauncherDeclaration,
PluginLauncherRenderContextSnapshot,
PluginUiSlotDeclaration,
+ PluginLocalFolderDeclaration,
PluginRecord,
PluginConfig,
PluginStatus,
@@ -140,6 +141,54 @@ export interface AvailablePluginExample {
tag: "example";
}
+export interface PluginLocalFolderProblem {
+ code:
+ | "not_configured"
+ | "not_absolute"
+ | "missing"
+ | "not_directory"
+ | "not_readable"
+ | "not_writable"
+ | "missing_directory"
+ | "missing_file"
+ | "path_traversal"
+ | "symlink_escape"
+ | "atomic_write_failed";
+ message: string;
+ path?: string;
+}
+
+export interface PluginLocalFolderStatus {
+ folderKey: string;
+ configured: boolean;
+ path: string | null;
+ realPath: string | null;
+ access: "read" | "readWrite";
+ readable: boolean;
+ writable: boolean;
+ requiredDirectories: string[];
+ requiredFiles: string[];
+ missingDirectories: string[];
+ missingFiles: string[];
+ healthy: boolean;
+ problems: PluginLocalFolderProblem[];
+ checkedAt: string;
+}
+
+export interface PluginLocalFoldersResponse {
+ pluginId: string;
+ companyId: string;
+ declarations: PluginLocalFolderDeclaration[];
+ folders: PluginLocalFolderStatus[];
+}
+
+export interface PluginLocalFolderSaveInput {
+ path: string;
+ access?: "read" | "readWrite";
+ requiredDirectories?: string[];
+ requiredFiles?: string[];
+}
+
/**
* Plugin management API client.
*
@@ -337,6 +386,48 @@ export const pluginsApi = {
testConfig: (pluginId: string, configJson: Record<string, unknown>) =>
api.post<{ valid: boolean; message?: string }>(`/plugins/${pluginId}/config/test`, { configJson }),
+ /**
+ * List manifest-declared and stored company-scoped local folders for a plugin.
+ */
+ listLocalFolders: (pluginId: string, companyId: string) =>
+ api.get<PluginLocalFoldersResponse>(`/plugins/${pluginId}/companies/${companyId}/local-folders`),
+
+ /**
+ * Inspect a configured local folder without changing persisted settings.
+ */
+ localFolderStatus: (pluginId: string, companyId: string, folderKey: string) =>
+ api.get<PluginLocalFolderStatus>(
+ `/plugins/${pluginId}/companies/${companyId}/local-folders/${encodeURIComponent(folderKey)}/status`,
+ ),
+
+ /**
+ * Validate a candidate local folder path without saving it.
+ */
+ validateLocalFolder: (
+ pluginId: string,
+ companyId: string,
+ folderKey: string,
+ input: PluginLocalFolderSaveInput,
+ ) =>
+ api.post<PluginLocalFolderStatus>(
+ `/plugins/${pluginId}/companies/${companyId}/local-folders/${encodeURIComponent(folderKey)}/validate`,
+ input,
+ ),
+
+ /**
+ * Persist a company-scoped local folder path and return its inspected status.
+ */
+ configureLocalFolder: (
+ pluginId: string,
+ companyId: string,
+ folderKey: string,
+ input: PluginLocalFolderSaveInput,
+ ) =>
+ api.put<PluginLocalFolderStatus>(
+ `/plugins/${pluginId}/companies/${companyId}/local-folders/${encodeURIComponent(folderKey)}`,
+ input,
+ ),
+
// ===========================================================================
// Bridge proxy endpoints — used by the plugin UI bridge runtime
// ===========================================================================
diff --git a/ui/src/components/CompanySettingsSidebar.tsx b/ui/src/components/CompanySettingsSidebar.tsx
index 4acebfec3a..9515820113 100644
--- a/ui/src/components/CompanySettingsSidebar.tsx
+++ b/ui/src/components/CompanySettingsSidebar.tsx
@@ -7,7 +7,6 @@ import { queryKeys } from "@/lib/queryKeys";
import { useCompany } from "@/context/CompanyContext";
import { useSidebar } from "@/context/SidebarContext";
import { SidebarNavItem } from "./SidebarNavItem";
-import { SidebarCompanyMenu } from "./SidebarCompanyMenu";
export function CompanySettingsSidebar() {
const { selectedCompany, selectedCompanyId } = useCompany();
@@ -32,11 +31,8 @@ export function CompanySettingsSidebar() {
});
return (
- <aside className="w-60 h-full min-h-0 border-r border-border bg-background flex flex-col">
- <div className="flex items-center gap-1 px-3 h-12 shrink-0">
- <SidebarCompanyMenu />
- </div>
- <div className="flex flex-col gap-1 px-3 pb-3 shrink-0">
+ <aside className="w-full h-full min-h-0 border-r border-border bg-background flex flex-col">
+ <div className="flex flex-col gap-1 px-3 py-3 shrink-0">
<Link
to="/dashboard"
onClick={() => {
diff --git a/ui/src/components/FileTree.test.tsx b/ui/src/components/FileTree.test.tsx
new file mode 100644
index 0000000000..2c07ec53cf
--- /dev/null
+++ b/ui/src/components/FileTree.test.tsx
@@ -0,0 +1,190 @@
+// @vitest-environment jsdom
+
+import { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { FileTree, buildFileTree } from "./FileTree";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+(globalThis as any).IS_REACT_ACT_ENVIRONMENT = true;
+
+describe("FileTree", () => {
+ let container: HTMLDivElement;
+ let root: Root;
+
+ beforeEach(() => {
+ container = document.createElement("div");
+ document.body.appendChild(container);
+ root = createRoot(container);
+ });
+
+ afterEach(() => {
+ act(() => {
+ root.unmount();
+ });
+ container.remove();
+ });
+
+ function row(path: string) {
+ return container.querySelector(`[data-file-tree-path="${path}"]`) as HTMLDivElement | null;
+ }
+
+ it("selects file rows and expands directory rows", () => {
+ const onSelectFile = vi.fn();
+ const onToggleDir = vi.fn();
+ const nodes = buildFileTree({
+ "README.md": "",
+ "docs/guide.md": "",
+ });
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile="README.md"
+ expandedDirs={new Set(["docs"])}
+ onSelectFile={onSelectFile}
+ onToggleDir={onToggleDir}
+ />,
+ );
+ });
+
+ expect(row("README.md")?.getAttribute("aria-selected")).toBe("true");
+
+ act(() => {
+ row("docs/guide.md")?.click();
+ });
+ expect(onSelectFile).toHaveBeenCalledWith("docs/guide.md");
+
+ act(() => {
+ row("docs")?.click();
+ });
+ expect(onToggleDir).toHaveBeenCalledWith("docs");
+ });
+
+ it("marks partially selected directories as indeterminate", () => {
+ const nodes = buildFileTree({
+ "docs/a.md": "",
+ "docs/b.md": "",
+ });
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile={null}
+ expandedDirs={new Set(["docs"])}
+ checkedFiles={new Set(["docs/a.md"])}
+ onSelectFile={() => {}}
+ onToggleDir={() => {}}
+ onToggleCheck={() => {}}
+ />,
+ );
+ });
+
+ const input = row("docs")?.querySelector("input[type='checkbox']") as HTMLInputElement | null;
+ expect(input?.checked).toBe(false);
+ expect(input?.indeterminate).toBe(true);
+ expect(row("docs")?.getAttribute("aria-checked")).toBe("mixed");
+ });
+
+ it("renders file badges and host-only file extras", () => {
+ const nodes = buildFileTree({
+ "wiki/very-long-page-slug.md": "",
+ });
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile={null}
+ expandedDirs={new Set(["wiki"])}
+ onSelectFile={() => {}}
+ onToggleDir={() => {}}
+ fileBadges={{
+ "wiki/very-long-page-slug.md": {
+ label: "fresh",
+ status: "ok",
+ tooltip: "Synced",
+ },
+ }}
+ renderFileExtra={(node) => (
+ node.kind === "file" ? <span data-testid="file-extra">{node.name.length} chars</span> : null
+ )}
+ />,
+ );
+ });
+
+ expect(container.textContent).toContain("fresh");
+ expect(container.querySelector("[title='Synced']")).not.toBeNull();
+ expect(container.querySelector("[data-testid='file-extra']")?.textContent).toBe("22 chars");
+ });
+
+ it("wraps long labels by default and can opt back into truncation", () => {
+ const nodes = buildFileTree({
+ "wiki/extremely-long-page-slug-that-wraps-on-mobile.md": "",
+ });
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile={null}
+ expandedDirs={new Set(["wiki"])}
+ onSelectFile={() => {}}
+ onToggleDir={() => {}}
+ />,
+ );
+ });
+
+ expect(row("wiki/extremely-long-page-slug-that-wraps-on-mobile.md")?.innerHTML).toContain("break-all");
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile={null}
+ expandedDirs={new Set(["wiki"])}
+ onSelectFile={() => {}}
+ onToggleDir={() => {}}
+ wrapLabels={false}
+ />,
+ );
+ });
+
+ expect(row("wiki/extremely-long-page-slug-that-wraps-on-mobile.md")?.innerHTML).toContain("truncate");
+ });
+
+ it("supports tree keyboard expansion and checkbox toggling", () => {
+ const onToggleDir = vi.fn();
+ const onToggleCheck = vi.fn();
+ const nodes = buildFileTree({
+ "docs/a.md": "",
+ });
+
+ act(() => {
+ root.render(
+ <FileTree
+ nodes={nodes}
+ selectedFile={null}
+ expandedDirs={new Set()}
+ onSelectFile={() => {}}
+ onToggleDir={onToggleDir}
+ onToggleCheck={onToggleCheck}
+ />,
+ );
+ });
+
+ const docsRow = row("docs");
+ act(() => {
+ docsRow?.focus();
+ docsRow?.dispatchEvent(new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }));
+ });
+ expect(onToggleDir).toHaveBeenCalledWith("docs");
+
+ act(() => {
+ docsRow?.dispatchEvent(new KeyboardEvent("keydown", { key: " ", bubbles: true }));
+ });
+ expect(onToggleCheck).toHaveBeenCalledWith("docs", "dir");
+ });
+});
diff --git a/ui/src/components/FileTree.tsx b/ui/src/components/FileTree.tsx
new file mode 100644
index 0000000000..201c79030c
--- /dev/null
+++ b/ui/src/components/FileTree.tsx
@@ -0,0 +1,500 @@
+import type { KeyboardEvent, ReactNode } from "react";
+import { useMemo, useRef, useState } from "react";
+import { cn } from "../lib/utils";
+import {
+ ChevronDown,
+ ChevronRight,
+ FileCode2,
+ FileText,
+ Folder,
+ FolderOpen,
+} from "lucide-react";
+import { statusBadge, statusBadgeDefault } from "../lib/status-colors";
+import { Button } from "./ui/button";
+import { Skeleton } from "./ui/skeleton";
+
+// -- Tree types --------------------------------------------------------------
+
+export type FileTreeNode = {
+ name: string;
+ path: string;
+ kind: "dir" | "file";
+ children: FileTreeNode[];
+ /** Optional per-node metadata (e.g. import action) */
+ action?: string | null;
+};
+
+export type FileTreeBadgeVariant = "ok" | "warning" | "error" | "info" | "pending";
+
+export type FileTreeBadge = {
+ label: string;
+ status: FileTreeBadgeVariant;
+ tooltip?: string;
+};
+
+export type FileTreeTone = "default" | "warning" | "error" | "muted";
+
+export type FileTreeEmptyState = {
+ title?: string;
+ description?: string;
+};
+
+export type FileTreeErrorState = {
+ message: string;
+ retry?: () => void;
+};
+
+type VisibleFileTreeNode = {
+ node: FileTreeNode;
+ depth: number;
+};
+
+const TREE_BASE_INDENT = 16;
+const TREE_STEP_INDENT = 24;
+const TREE_ROW_HEIGHT_CLASS = "min-h-9";
+
+const fileTreeToneClass: Record<FileTreeTone, string | undefined> = {
+ default: undefined,
+ warning: "bg-amber-500/5 text-amber-700 dark:text-amber-300",
+ error: "bg-destructive/5 text-destructive",
+ muted: "opacity-50",
+};
+
+// -- Helpers -----------------------------------------------------------------
+
+export function buildFileTree(
+ files: Record<string, unknown>,
+ actionMap?: Map<string, string>,
+): FileTreeNode[] {
+ const root: FileTreeNode = { name: "", path: "", kind: "dir", children: [] };
+
+ for (const filePath of Object.keys(files)) {
+ const segments = filePath.split("/").filter(Boolean);
+ let current = root;
+ let currentPath = "";
+ for (let i = 0; i < segments.length; i++) {
+ const segment = segments[i];
+ currentPath = currentPath ? `${currentPath}/${segment}` : segment;
+ const isLeaf = i === segments.length - 1;
+ let next = current.children.find((c) => c.name === segment);
+ if (!next) {
+ next = {
+ name: segment,
+ path: currentPath,
+ kind: isLeaf ? "file" : "dir",
+ children: [],
+ action: isLeaf ? (actionMap?.get(filePath) ?? null) : null,
+ };
+ current.children.push(next);
+ }
+ current = next;
+ }
+ }
+
+ function sortNode(node: FileTreeNode) {
+ node.children.sort((a, b) => {
+ // Files before directories so PROJECT.md appears above tasks/
+ if (a.kind !== b.kind) return a.kind === "file" ? -1 : 1;
+ return a.name.localeCompare(b.name);
+ });
+ node.children.forEach(sortNode);
+ }
+
+ sortNode(root);
+ return root.children;
+}
+
+export function countFiles(nodes: FileTreeNode[]): number {
+ let count = 0;
+ for (const node of nodes) {
+ if (node.kind === "file") count++;
+ else count += countFiles(node.children);
+ }
+ return count;
+}
+
+export function collectAllPaths(
+ nodes: FileTreeNode[],
+ type: "file" | "dir" | "all" = "all",
+): Set<string> {
+ const paths = new Set<string>();
+ for (const node of nodes) {
+ if (type === "all" || node.kind === type) paths.add(node.path);
+ for (const p of collectAllPaths(node.children, type)) paths.add(p);
+ }
+ return paths;
+}
+
+function fileIcon(name: string) {
+ if (name.endsWith(".yaml") || name.endsWith(".yml")) return FileCode2;
+ return FileText;
+}
+
+function flattenVisibleNodes(
+ nodes: FileTreeNode[],
+ expandedDirs: Set<string>,
+ depth = 0,
+): VisibleFileTreeNode[] {
+ const flattened: VisibleFileTreeNode[] = [];
+ for (const node of nodes) {
+ flattened.push({ node, depth });
+ if (node.kind === "dir" && expandedDirs.has(node.path)) {
+ flattened.push(...flattenVisibleNodes(node.children, expandedDirs, depth + 1));
+ }
+ }
+ return flattened;
+}
+
+function checkboxState(node: FileTreeNode, checkedFiles: Set<string>) {
+ if (node.kind === "file") {
+ return {
+ allChecked: checkedFiles.has(node.path),
+ someChecked: false,
+ };
+ }
+
+ const childFiles = collectAllPaths(node.children, "file");
+ const childFilePaths = [...childFiles];
+ const allChecked = childFilePaths.length > 0 && childFilePaths.every((p) => checkedFiles.has(p));
+ const someChecked = childFilePaths.some((p) => checkedFiles.has(p));
+ return { allChecked, someChecked: someChecked && !allChecked };
+}
+
+// -- Frontmatter helpers -----------------------------------------------------
+
+export type FrontmatterData = Record<string, string | string[]>;
+
+export function parseFrontmatter(content: string): { data: FrontmatterData; body: string } | null {
+ const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+ if (!match) return null;
+
+ const data: FrontmatterData = {};
+ const rawYaml = match[1];
+ const body = match[2];
+
+ let currentKey: string | null = null;
+ let currentList: string[] | null = null;
+
+ for (const line of rawYaml.split("\n")) {
+ const trimmed = line.trim();
+ if (!trimmed || trimmed.startsWith("#")) continue;
+
+ if (trimmed.startsWith("- ") && currentKey) {
+ if (!currentList) currentList = [];
+ currentList.push(trimmed.slice(2).trim().replace(/^["']|["']$/g, ""));
+ continue;
+ }
+
+ if (currentKey && currentList) {
+ data[currentKey] = currentList;
+ currentList = null;
+ currentKey = null;
+ }
+
+ const kvMatch = trimmed.match(/^([a-zA-Z_][\w-]*)\s*:\s*(.*)$/);
+ if (kvMatch) {
+ const key = kvMatch[1];
+ const val = kvMatch[2].trim().replace(/^["']|["']$/g, "");
+ if (val === "null") {
+ currentKey = null;
+ continue;
+ }
+ if (val) {
+ data[key] = val;
+ currentKey = null;
+ } else {
+ currentKey = key;
+ }
+ }
+ }
+
+ if (currentKey && currentList) {
+ data[currentKey] = currentList;
+ }
+
+ return Object.keys(data).length > 0 ? { data, body } : null;
+}
+
+export const FRONTMATTER_FIELD_LABELS: Record<string, string> = {
+ name: "Name",
+ title: "Title",
+ kind: "Kind",
+ reportsTo: "Reports to",
+ skills: "Skills",
+ status: "Status",
+ description: "Description",
+ priority: "Priority",
+ assignee: "Assignee",
+ project: "Project",
+ recurring: "Recurring",
+ targetDate: "Target date",
+};
+
+// -- File tree component -----------------------------------------------------
+
+export type FileTreeProps = {
+ nodes: FileTreeNode[];
+ selectedFile: string | null;
+ expandedDirs: Set<string>;
+ checkedFiles?: Set<string>;
+ onToggleDir: (path: string) => void;
+ onSelectFile: (path: string) => void;
+ onToggleCheck?: (path: string, kind: "file" | "dir") => void;
+ /** Serializable badge metadata keyed by path. This is safe to expose through plugin UI contracts. */
+ fileBadges?: Record<string, FileTreeBadge | undefined>;
+ /** Closed row tone metadata keyed by path. This avoids raw host class names in public contracts. */
+ fileTones?: Record<string, FileTreeTone | undefined>;
+ /** Internal-only escape hatch for current host call sites that need richer row content. */
+ renderFileExtra?: (node: FileTreeNode, checked: boolean) => ReactNode;
+ /** @deprecated Use fileTones for public surfaces. Kept for compatibility with host-only callers. */
+ fileRowClassName?: (node: FileTreeNode, checked: boolean) => string | undefined;
+ showCheckboxes?: boolean;
+ /** Allow long file and directory names to wrap instead of forcing horizontal overflow. */
+ wrapLabels?: boolean;
+ loading?: boolean;
+ error?: FileTreeErrorState | null;
+ empty?: FileTreeEmptyState;
+ ariaLabel?: string;
+};
+
+export function FileTree({
+ nodes,
+ selectedFile,
+ expandedDirs,
+ checkedFiles,
+ onToggleDir,
+ onSelectFile,
+ onToggleCheck,
+ fileBadges,
+ fileTones,
+ renderFileExtra,
+ fileRowClassName,
+ showCheckboxes = true,
+ wrapLabels = true,
+ loading = false,
+ error,
+ empty,
+ ariaLabel = "Files",
+}: FileTreeProps) {
+ const effectiveCheckedFiles = checkedFiles ?? new Set<string>();
+ const visibleNodes = useMemo(
+ () => flattenVisibleNodes(nodes, expandedDirs),
+ [expandedDirs, nodes],
+ );
+ const [focusedPath, setFocusedPath] = useState<string | null>(null);
+ const rowRefs = useRef(new Map<string, HTMLDivElement>());
+
+ function focusPath(path: string) {
+ setFocusedPath(path);
+ window.requestAnimationFrame(() => {
+ rowRefs.current.get(path)?.focus();
+ });
+ }
+
+ function toggleNode(node: FileTreeNode) {
+ if (node.kind === "dir") onToggleDir(node.path);
+ else onSelectFile(node.path);
+ }
+
+ function handleRowKeyDown(event: KeyboardEvent<HTMLDivElement>, index: number, node: FileTreeNode) {
+ switch (event.key) {
+ case "ArrowDown": {
+ event.preventDefault();
+ const next = visibleNodes[Math.min(index + 1, visibleNodes.length - 1)];
+ if (next) focusPath(next.node.path);
+ break;
+ }
+ case "ArrowUp": {
+ event.preventDefault();
+ const previous = visibleNodes[Math.max(index - 1, 0)];
+ if (previous) focusPath(previous.node.path);
+ break;
+ }
+ case "ArrowRight":
+ if (node.kind === "dir" && !expandedDirs.has(node.path)) {
+ event.preventDefault();
+ onToggleDir(node.path);
+ }
+ break;
+ case "ArrowLeft":
+ if (node.kind === "dir" && expandedDirs.has(node.path)) {
+ event.preventDefault();
+ onToggleDir(node.path);
+ }
+ break;
+ case "Enter":
+ event.preventDefault();
+ toggleNode(node);
+ break;
+ case " ":
+ if (showCheckboxes && onToggleCheck) {
+ event.preventDefault();
+ onToggleCheck(node.path, node.kind);
+ }
+ break;
+ }
+ }
+
+ if (loading) {
+ return (
+ <div aria-busy="true" aria-label={ariaLabel} role="tree" className="py-1">
+ {[0, 1, 2, 3].map((row) => (
+ <div key={row} className={cn("flex items-center gap-2 px-4", TREE_ROW_HEIGHT_CLASS)}>
+ <Skeleton className="h-4 w-4 shrink-0 rounded-sm" />
+ <Skeleton className={cn("h-3.5", row === 1 ? "w-3/5" : "w-4/5")} />
+ </div>
+ ))}
+ </div>
+ );
+ }
+
+ if (error) {
+ return (
+ <div aria-label={ariaLabel} role="tree" className="p-3">
+ <div
+ role="treeitem"
+ aria-level={1}
+ className="flex min-h-9 items-center justify-between gap-3 rounded-md border border-destructive/30 bg-destructive/5 px-3 py-2 text-sm"
+ >
+ <div className="flex min-w-0 items-center gap-2">
+ <span
+ className={cn(
+ "inline-flex shrink-0 items-center rounded-full px-2.5 py-0.5 text-xs font-medium whitespace-nowrap",
+ statusBadge.error ?? statusBadgeDefault,
+ )}
+ >
+ error
+ </span>
+ <span className="min-w-0 text-destructive">{error.message}</span>
+ </div>
+ {error.retry && (
+ <Button type="button" size="xs" variant="outline" onClick={error.retry}>
+ Retry
+ </Button>
+ )}
+ </div>
+ </div>
+ );
+ }
+
+ if (nodes.length === 0) {
+ return (
+ <div aria-label={ariaLabel} role="tree" className="p-3">
+ <div className="rounded-md border border-dashed border-border px-4 py-8 text-center">
+ <div className="text-sm font-medium">{empty?.title ?? "No files"}</div>
+ <div className="mt-1 text-xs text-muted-foreground">
+ {empty?.description ?? "Files will appear here when they are available."}
+ </div>
+ </div>
+ </div>
+ );
+ }
+
+ return (
+ <div aria-label={ariaLabel} role="tree">
+ {visibleNodes.map(({ node, depth }, index) => {
+ const expanded = node.kind === "dir" && expandedDirs.has(node.path);
+ const { allChecked, someChecked } = checkboxState(node, effectiveCheckedFiles);
+ const badge = fileBadges?.[node.path];
+ const tone = fileTones?.[node.path] ?? "default";
+ const extraClassName = node.kind === "file" ? fileRowClassName?.(node, allChecked) : undefined;
+ const FileIcon = node.kind === "file" ? fileIcon(node.name) : null;
+ const isSelected = node.kind === "file" && node.path === selectedFile;
+
+ return (
+ <div
+ key={node.path}
+ ref={(element) => {
+ if (element) rowRefs.current.set(node.path, element);
+ else rowRefs.current.delete(node.path);
+ }}
+ role="treeitem"
+ aria-level={depth + 1}
+ aria-expanded={node.kind === "dir" ? expanded : undefined}
+ aria-selected={node.kind === "file" ? isSelected : undefined}
+ aria-checked={showCheckboxes ? (someChecked ? "mixed" : allChecked) : undefined}
+ tabIndex={(focusedPath ?? visibleNodes[0]?.node.path) === node.path ? 0 : -1}
+ className={cn(
+ node.kind === "dir"
+ ? showCheckboxes
+ ? "group grid w-full grid-cols-[auto_minmax(0,1fr)_2.25rem] items-center gap-x-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground"
+ : "group grid w-full grid-cols-[minmax(0,1fr)_2.25rem] items-center gap-x-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground max-[480px]:grid-cols-[minmax(0,1fr)]"
+ : "group flex w-full items-center gap-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground cursor-pointer",
+ TREE_ROW_HEIGHT_CLASS,
+ isSelected && "text-foreground bg-accent/20",
+ fileTreeToneClass[tone],
+ extraClassName,
+ "outline-none focus-visible:ring-2 focus-visible:ring-ring/50 focus-visible:ring-inset",
+ )}
+ style={{
+ paddingInlineStart: `${TREE_BASE_INDENT + depth * TREE_STEP_INDENT - 8}px`,
+ }}
+ onFocus={() => setFocusedPath(node.path)}
+ onClick={() => toggleNode(node)}
+ onKeyDown={(event) => handleRowKeyDown(event, index, node)}
+ data-file-tree-path={node.path}
+ >
+ {showCheckboxes && (
+ <label className="flex items-center pl-2" onClick={(event) => event.stopPropagation()}>
+ <input
+ type="checkbox"
+ checked={allChecked}
+ ref={(element) => {
+ if (element) element.indeterminate = someChecked;
+ }}
+ onChange={() => onToggleCheck?.(node.path, node.kind)}
+ className="mr-2 accent-foreground"
+ />
+ </label>
+ )}
+ <span className="flex min-w-0 flex-1 items-center gap-2 py-1 text-left">
+ <span className="flex h-4 w-4 shrink-0 items-center justify-center">
+ {node.kind === "dir" ? (
+ expanded ? (
+ <FolderOpen className="h-3.5 w-3.5" />
+ ) : (
+ <Folder className="h-3.5 w-3.5" />
+ )
+ ) : FileIcon ? (
+ <FileIcon className="h-3.5 w-3.5" />
+ ) : null}
+ </span>
+ <span className={cn("min-w-0", wrapLabels ? "break-all leading-4" : "truncate")}>
+ {node.name}
+ </span>
+ </span>
+ {badge && (
+ <span
+ className={cn(
+ "ml-3 shrink-0 rounded-full px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide",
+ statusBadge[badge.status] ?? statusBadgeDefault,
+ )}
+ title={badge.tooltip}
+ >
+ {badge.label}
+ </span>
+ )}
+ {node.kind === "file" && renderFileExtra?.(node, allChecked)}
+ {node.kind === "dir" && (
+ <button
+ type="button"
+ className="flex h-9 w-9 items-center justify-center self-center rounded-sm text-muted-foreground opacity-70 transition-[background-color,color,opacity] hover:bg-accent hover:text-foreground group-hover:opacity-100 focus-visible:ring-2 focus-visible:ring-ring/50 max-[480px]:hidden"
+ onClick={(event) => {
+ event.stopPropagation();
+ onToggleDir(node.path);
+ }}
+ aria-label={expanded ? `Collapse ${node.name}` : `Expand ${node.name}`}
+ >
+ {expanded ? (
+ <ChevronDown className="h-3.5 w-3.5" />
+ ) : (
+ <ChevronRight className="h-3.5 w-3.5" />
+ )}
+ </button>
+ )}
+ </div>
+ );
+ })}
+ </div>
+ );
+}
diff --git a/ui/src/components/InstanceSidebar.tsx b/ui/src/components/InstanceSidebar.tsx
index f797c0eb86..e54edceb55 100644
--- a/ui/src/components/InstanceSidebar.tsx
+++ b/ui/src/components/InstanceSidebar.tsx
@@ -5,7 +5,6 @@ import { pluginsApi } from "@/api/plugins";
import { queryKeys } from "@/lib/queryKeys";
import { SIDEBAR_SCROLL_RESET_STATE } from "@/lib/navigation-scroll";
import { SidebarNavItem } from "./SidebarNavItem";
-import { SidebarCompanyMenu } from "./SidebarCompanyMenu";
export function InstanceSidebar() {
const { data: plugins } = useQuery({
@@ -14,13 +13,12 @@ export function InstanceSidebar() {
});
return (
- <aside className="w-60 h-full min-h-0 border-r border-border bg-background flex flex-col">
- <div className="flex items-center gap-1 px-3 h-12 shrink-0">
- <SidebarCompanyMenu />
- </div>
- <div className="flex items-center gap-2 px-5 pb-3 shrink-0">
- <Settings className="h-4 w-4 text-muted-foreground shrink-0" />
- <span className="flex-1 truncate text-sm font-bold text-foreground">Instance Settings</span>
+ <aside className="w-full h-full min-h-0 border-r border-border bg-background flex flex-col">
+ <div className="flex items-center gap-2 px-3 h-12 shrink-0">
+ <Settings className="h-4 w-4 text-muted-foreground shrink-0 ml-1" />
+ <span className="flex-1 text-sm font-bold text-foreground truncate">
+ Instance Settings
+ </span>
</div>
<nav className="flex-1 min-h-0 overflow-y-auto scrollbar-auto-hide flex flex-col gap-4 px-3 py-2">
diff --git a/ui/src/components/Layout.test.tsx b/ui/src/components/Layout.test.tsx
index 2dfd1a9f08..63901e5f6b 100644
--- a/ui/src/components/Layout.test.tsx
+++ b/ui/src/components/Layout.test.tsx
@@ -17,6 +17,16 @@ const mockInstanceSettingsApi = vi.hoisted(() => ({
const mockNavigate = vi.hoisted(() => vi.fn());
const mockSetSelectedCompanyId = vi.hoisted(() => vi.fn());
const mockSetSidebarOpen = vi.hoisted(() => vi.fn());
+const mockCompanyState = vi.hoisted(() => ({
+ companies: [{ id: "company-1", issuePrefix: "PAP", name: "Paperclip" }],
+ selectedCompany: { id: "company-1", issuePrefix: "PAP", name: "Paperclip" },
+ selectedCompanyId: "company-1",
+}));
+const mockPluginSlots = vi.hoisted(() => ({
+ slots: [] as Array<Record<string, unknown>>,
+}));
+const mockUsePluginSlots = vi.hoisted(() => vi.fn());
+const mockPluginSlotContexts = vi.hoisted(() => [] as Array<Record<string, unknown>>);
let currentPathname = "/PAP/dashboard";
vi.mock("@/lib/router", () => ({
@@ -24,7 +34,10 @@ vi.mock("@/lib/router", () => ({
useLocation: () => ({ pathname: currentPathname, search: "", hash: "", state: null }),
useNavigate: () => mockNavigate,
useNavigationType: () => "PUSH",
- useParams: () => ({ companyPrefix: "PAP" }),
+ useParams: () => {
+ const firstSegment = currentPathname.split("/").filter(Boolean)[0];
+ return { companyPrefix: firstSegment === "instance" ? undefined : firstSegment ?? "PAP" };
+ },
}));
vi.mock("./CompanyRail", () => ({
@@ -95,6 +108,33 @@ vi.mock("./SidebarAccountMenu", () => ({
SidebarAccountMenu: () => <div>Account menu</div>,
}));
+vi.mock("../plugins/slots", async () => {
+ const actual = await vi.importActual<typeof import("../plugins/slots")>("../plugins/slots");
+ return {
+ resolveRouteSidebarSlot: actual.resolveRouteSidebarSlot,
+ usePluginSlots: (params: Record<string, unknown>) => {
+ mockUsePluginSlots(params);
+ return {
+ slots: mockPluginSlots.slots,
+ isLoading: false,
+ errorMessage: null,
+ };
+ },
+ PluginSlotMount: ({
+ slot,
+ context,
+ className,
+ }: {
+ slot: { displayName: string };
+ context: Record<string, unknown>;
+ className?: string;
+ }) => {
+ mockPluginSlotContexts.push(context);
+ return <div data-plugin-slot-class={className}>Plugin route sidebar: {slot.displayName}</div>;
+ },
+ };
+});
+
vi.mock("../context/DialogContext", () => ({
useDialog: () => ({
openNewIssue: vi.fn(),
@@ -114,10 +154,10 @@ vi.mock("../context/PanelContext", () => ({
vi.mock("../context/CompanyContext", () => ({
useCompany: () => ({
- companies: [{ id: "company-1", issuePrefix: "PAP", name: "Paperclip" }],
+ companies: mockCompanyState.companies,
loading: false,
- selectedCompany: { id: "company-1", issuePrefix: "PAP", name: "Paperclip" },
- selectedCompanyId: "company-1",
+ selectedCompany: mockCompanyState.selectedCompany,
+ selectedCompanyId: mockCompanyState.selectedCompanyId,
selectionSource: "manual",
setSelectedCompanyId: mockSetSelectedCompanyId,
}),
@@ -179,6 +219,9 @@ describe("Layout", () => {
container = document.createElement("div");
document.body.appendChild(container);
currentPathname = "/PAP/dashboard";
+ mockCompanyState.companies = [{ id: "company-1", issuePrefix: "PAP", name: "Paperclip" }];
+ mockCompanyState.selectedCompany = { id: "company-1", issuePrefix: "PAP", name: "Paperclip" };
+ mockCompanyState.selectedCompanyId = "company-1";
mockHealthApi.get.mockResolvedValue({
status: "ok",
deploymentMode: "authenticated",
@@ -188,6 +231,8 @@ describe("Layout", () => {
mockInstanceSettingsApi.getGeneral.mockResolvedValue({
keyboardShortcuts: false,
});
+ mockPluginSlots.slots = [];
+ mockPluginSlotContexts.length = 0;
});
afterEach(() => {
@@ -227,6 +272,30 @@ describe("Layout", () => {
it("renders the company settings sidebar on company settings routes", async () => {
currentPathname = "/PAP/company/settings/access";
+ mockPluginSlots.slots = [
+ {
+ type: "page",
+ id: "company-page",
+ displayName: "Company Page",
+ exportName: "CompanyPage",
+ routePath: "company",
+ pluginId: "plugin-1",
+ pluginKey: "fake-plugin",
+ pluginDisplayName: "Fake Plugin",
+ pluginVersion: "1.0.0",
+ },
+ {
+ type: "routeSidebar",
+ id: "company-sidebar",
+ displayName: "Company Route Sidebar",
+ exportName: "CompanySidebar",
+ routePath: "company",
+ pluginId: "plugin-1",
+ pluginKey: "fake-plugin",
+ pluginDisplayName: "Fake Plugin",
+ pluginVersion: "1.0.0",
+ },
+ ];
const root = createRoot(container);
const queryClient = new QueryClient({
defaultOptions: { queries: { retry: false } },
@@ -245,6 +314,213 @@ describe("Layout", () => {
expect(container.textContent).toContain("Company settings sidebar");
expect(container.textContent).not.toContain("Instance sidebar");
expect(container.textContent).not.toContain("Main company nav");
+ expect(container.textContent).not.toContain("Plugin route sidebar");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("renders the instance settings sidebar on instance settings routes", async () => {
+ currentPathname = "/instance/settings/general";
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <Layout />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+
+ expect(container.textContent).toContain("Instance sidebar");
+ expect(container.textContent).not.toContain("Company settings sidebar");
+ expect(container.textContent).not.toContain("Main company nav");
+ expect(container.textContent).not.toContain("Plugin route sidebar");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("renders a route-scoped plugin sidebar for a matching plugin page route", async () => {
+ currentPathname = "/PAP/wiki";
+ mockPluginSlots.slots = [
+ {
+ type: "page",
+ id: "wiki-page",
+ displayName: "Wiki Page",
+ exportName: "WikiPage",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin",
+ pluginDisplayName: "Wiki Plugin",
+ pluginVersion: "1.0.0",
+ },
+ {
+ type: "routeSidebar",
+ id: "wiki-route-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiSidebar",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin",
+ pluginDisplayName: "Wiki Plugin",
+ pluginVersion: "1.0.0",
+ },
+ ];
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <Layout />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+
+ expect(container.textContent).toContain("Plugin route sidebar: Wiki Sidebar");
+ expect(container.querySelector("[data-plugin-slot-class='h-full w-full']")).not.toBeNull();
+ expect(container.textContent).not.toContain("Main company nav");
+ expect(container.textContent).not.toContain("Company settings sidebar");
+ expect(container.textContent).not.toContain("Instance sidebar");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("uses the route company context for plugin route sidebars on the first render", async () => {
+ currentPathname = "/ALT/wiki";
+ mockCompanyState.companies = [
+ { id: "company-1", issuePrefix: "PAP", name: "Paperclip" },
+ { id: "company-2", issuePrefix: "ALT", name: "Alternate" },
+ ];
+ mockCompanyState.selectedCompany = { id: "company-1", issuePrefix: "PAP", name: "Paperclip" };
+ mockCompanyState.selectedCompanyId = "company-1";
+ mockPluginSlots.slots = [
+ {
+ type: "page",
+ id: "wiki-page",
+ displayName: "Wiki Page",
+ exportName: "WikiPage",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin",
+ pluginDisplayName: "Wiki Plugin",
+ pluginVersion: "1.0.0",
+ },
+ {
+ type: "routeSidebar",
+ id: "wiki-route-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiSidebar",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin",
+ pluginDisplayName: "Wiki Plugin",
+ pluginVersion: "1.0.0",
+ },
+ ];
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <Layout />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+
+ expect(mockUsePluginSlots).toHaveBeenCalledWith(
+ expect.objectContaining({
+ companyId: "company-2",
+ enabled: true,
+ }),
+ );
+ expect(mockPluginSlotContexts).toContainEqual({
+ companyId: "company-2",
+ companyPrefix: "ALT",
+ });
+ expect(mockPluginSlotContexts).not.toContainEqual({
+ companyId: "company-1",
+ companyPrefix: "PAP",
+ });
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("keeps the normal company sidebar when a plugin page route is ambiguous", async () => {
+ currentPathname = "/PAP/wiki";
+ mockPluginSlots.slots = [
+ {
+ type: "page",
+ id: "wiki-page-a",
+ displayName: "Wiki Page A",
+ exportName: "WikiPageA",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin-a",
+ pluginDisplayName: "Wiki Plugin A",
+ pluginVersion: "1.0.0",
+ },
+ {
+ type: "page",
+ id: "wiki-page-b",
+ displayName: "Wiki Page B",
+ exportName: "WikiPageB",
+ routePath: "wiki",
+ pluginId: "plugin-2",
+ pluginKey: "wiki-plugin-b",
+ pluginDisplayName: "Wiki Plugin B",
+ pluginVersion: "1.0.0",
+ },
+ {
+ type: "routeSidebar",
+ id: "wiki-route-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiSidebar",
+ routePath: "wiki",
+ pluginId: "plugin-1",
+ pluginKey: "wiki-plugin-a",
+ pluginDisplayName: "Wiki Plugin A",
+ pluginVersion: "1.0.0",
+ },
+ ];
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <Layout />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+
+ expect(container.textContent).toContain("Main company nav");
+ expect(container.textContent).not.toContain("Plugin route sidebar");
await act(async () => {
root.unmount();
diff --git a/ui/src/components/Layout.tsx b/ui/src/components/Layout.tsx
index 9c260f6a3e..e256a9907e 100644
--- a/ui/src/components/Layout.tsx
+++ b/ui/src/components/Layout.tsx
@@ -1,6 +1,7 @@
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useQuery } from "@tanstack/react-query";
import { Outlet, useLocation, useNavigate, useNavigationType, useParams } from "@/lib/router";
+import { CompanyRail } from "./CompanyRail";
import { Sidebar } from "./Sidebar";
import { InstanceSidebar } from "./InstanceSidebar";
import { CompanySettingsSidebar } from "./CompanySettingsSidebar";
@@ -16,6 +17,7 @@ import { ToastViewport } from "./ToastViewport";
import { MobileBottomNav } from "./MobileBottomNav";
import { WorktreeBanner } from "./WorktreeBanner";
import { DevRestartBanner } from "./DevRestartBanner";
+import { ResizableSidebarPane } from "./ResizableSidebarPane";
import { SidebarAccountMenu } from "./SidebarAccountMenu";
import { useDialogActions } from "../context/DialogContext";
import { GeneralSettingsProvider } from "../context/GeneralSettingsContext";
@@ -39,9 +41,18 @@ import { queryKeys } from "../lib/queryKeys";
import { scheduleMainContentFocus } from "../lib/main-content-focus";
import { cn } from "../lib/utils";
import { NotFoundPage } from "../pages/NotFound";
+import { PluginSlotMount, resolveRouteSidebarSlot, usePluginSlots } from "../plugins/slots";
const INSTANCE_SETTINGS_MEMORY_KEY = "paperclip.lastInstanceSettingsPath";
+function getCompanyRouteSegment(pathname: string, companyPrefix: string | undefined): string | null {
+ if (!companyPrefix) return null;
+ const segments = pathname.split("/").filter(Boolean);
+ if (segments.length < 2) return null;
+ if (segments[0]?.toUpperCase() !== companyPrefix.toUpperCase()) return null;
+ return segments[1]?.toLowerCase() ?? null;
+}
+
function readRememberedInstanceSettingsPath(): string {
if (typeof window === "undefined") return DEFAULT_INSTANCE_SETTINGS_PATH;
try {
@@ -83,6 +94,38 @@ export function Layout() {
}, [companies, companyPrefix]);
const hasUnknownCompanyPrefix =
Boolean(companyPrefix) && !companiesLoading && companies.length > 0 && !matchedCompany;
+ const pluginRoutePath = useMemo(
+ () => getCompanyRouteSegment(location.pathname, companyPrefix),
+ [companyPrefix, location.pathname],
+ );
+ const routeSidebarCompanyId = matchedCompany?.id ?? null;
+ const routeSidebarCompanyPrefix = matchedCompany?.issuePrefix ?? null;
+ const { slots: routeSidebarSlots } = usePluginSlots({
+ slotTypes: ["page", "routeSidebar"],
+ companyId: routeSidebarCompanyId,
+ enabled: Boolean(routeSidebarCompanyId && pluginRoutePath),
+ });
+ const routeSidebarSlot = useMemo(
+ () => resolveRouteSidebarSlot(routeSidebarSlots, pluginRoutePath),
+ [pluginRoutePath, routeSidebarSlots],
+ );
+ const sidebarContext = useMemo(
+ () => ({
+ companyId: routeSidebarCompanyId,
+ companyPrefix: routeSidebarCompanyPrefix,
+ }),
+ [routeSidebarCompanyId, routeSidebarCompanyPrefix],
+ );
+ const companySidebar = routeSidebarSlot ? (
+ <PluginSlotMount
+ slot={routeSidebarSlot}
+ context={sidebarContext}
+ className="h-full w-full"
+ missingBehavior="placeholder"
+ />
+ ) : (
+ <Sidebar />
+ );
const { data: health } = useQuery({
queryKey: queryKeys.health,
queryFn: () => healthApi.get(),
@@ -335,13 +378,16 @@ export function Layout() {
)}
>
<div className="flex flex-1 min-h-0 overflow-hidden">
- {isInstanceSettingsRoute ? (
- <InstanceSidebar />
- ) : isCompanySettingsRoute ? (
- <CompanySettingsSidebar />
- ) : (
- <Sidebar />
- )}
+ <CompanyRail />
+ <div className="w-60 shrink-0 overflow-hidden">
+ {isInstanceSettingsRoute ? (
+ <InstanceSidebar />
+ ) : isCompanySettingsRoute ? (
+ <CompanySettingsSidebar />
+ ) : (
+ companySidebar
+ )}
+ </div>
</div>
<SidebarAccountMenu
deploymentMode={health?.deploymentMode}
@@ -352,20 +398,16 @@ export function Layout() {
) : (
<div className="flex h-full flex-col shrink-0">
<div className="flex flex-1 min-h-0">
- <div
- className={cn(
- "overflow-hidden transition-[width] duration-100 ease-out",
- sidebarOpen ? "w-60" : "w-0"
- )}
- >
+ <CompanyRail />
+ <ResizableSidebarPane open={sidebarOpen} resizable className="h-full shrink-0">
{isInstanceSettingsRoute ? (
<InstanceSidebar />
) : isCompanySettingsRoute ? (
<CompanySettingsSidebar />
) : (
- <Sidebar />
+ companySidebar
)}
- </div>
+ </ResizableSidebarPane>
</div>
<SidebarAccountMenu
deploymentMode={health?.deploymentMode}
diff --git a/ui/src/components/ManagedRoutinesList.tsx b/ui/src/components/ManagedRoutinesList.tsx
new file mode 100644
index 0000000000..4b62b3dee6
--- /dev/null
+++ b/ui/src/components/ManagedRoutinesList.tsx
@@ -0,0 +1,180 @@
+import { Button } from "@/components/ui/button";
+import {
+ RoutineListRow,
+ type RoutineListAgentSummary,
+ type RoutineListProjectSummary,
+ type RoutineListRowItem,
+} from "@/components/RoutineList";
+
+export type ManagedRoutinesListAgent = {
+ id: string;
+ name: string;
+ icon?: string | null;
+};
+
+export type ManagedRoutinesListProject = {
+ id: string;
+ name: string;
+ color?: string | null;
+};
+
+export type ManagedRoutineMissingRef = {
+ resourceKind: string;
+ resourceKey: string;
+};
+
+export type ManagedRoutinesListItem = {
+ key: string;
+ title: string;
+ status: string;
+ routineId?: string | null;
+ href?: string | null;
+ resourceKey?: string | null;
+ projectId?: string | null;
+ assigneeAgentId?: string | null;
+ cronExpression?: string | null;
+ lastRunAt?: Date | string | null;
+ lastRunStatus?: string | null;
+ managedByPluginDisplayName?: string | null;
+ missingRefs?: ManagedRoutineMissingRef[];
+};
+
+export type ManagedRoutinesListProps = {
+ routines: ManagedRoutinesListItem[];
+ agents?: ManagedRoutinesListAgent[];
+ projects?: ManagedRoutinesListProject[];
+ pluginDisplayName?: string | null;
+ emptyMessage?: string;
+ runningRoutineKey?: string | null;
+ statusMutationRoutineKey?: string | null;
+ reconcilingRoutineKey?: string | null;
+ resettingRoutineKey?: string | null;
+ onRunNow?: (routine: ManagedRoutinesListItem) => void;
+ onToggleEnabled?: (routine: ManagedRoutinesListItem, enabled: boolean) => void;
+ onReconcile?: (routine: ManagedRoutinesListItem) => void;
+ onReset?: (routine: ManagedRoutinesListItem) => void;
+};
+
+function managedRoutineToRow(routine: ManagedRoutinesListItem): RoutineListRowItem {
+ return {
+ id: routine.key,
+ title: routine.title,
+ status: routine.status,
+ projectId: routine.projectId ?? null,
+ assigneeAgentId: routine.assigneeAgentId ?? null,
+ lastRun: routine.lastRunAt || routine.lastRunStatus
+ ? {
+ triggeredAt: routine.lastRunAt ?? null,
+ status: routine.lastRunStatus ?? null,
+ }
+ : null,
+ };
+}
+
+export function ManagedRoutinesList({
+ routines,
+ agents = [],
+ projects = [],
+ pluginDisplayName = null,
+ emptyMessage = "No managed routines.",
+ runningRoutineKey = null,
+ statusMutationRoutineKey = null,
+ reconcilingRoutineKey = null,
+ resettingRoutineKey = null,
+ onRunNow,
+ onToggleEnabled,
+ onReconcile,
+ onReset,
+}: ManagedRoutinesListProps) {
+ const agentById = new Map<string, RoutineListAgentSummary>(
+ agents.map((agent) => [agent.id, { name: agent.name, icon: agent.icon }]),
+ );
+ const projectById = new Map<string, RoutineListProjectSummary>(
+ projects.map((project) => [project.id, { name: project.name, color: project.color }]),
+ );
+
+ if (routines.length === 0) {
+ return (
+ <div className="rounded-lg border border-border px-3 py-8 text-center text-sm text-muted-foreground">
+ {emptyMessage}
+ </div>
+ );
+ }
+
+ return (
+ <div className="rounded-lg border border-border">
+ {routines.map((routine) => {
+ const row = managedRoutineToRow(routine);
+ const href = routine.href ?? (routine.routineId ? `/routines/${routine.routineId}` : "/routines");
+ const missingRefs = routine.missingRefs ?? [];
+ const canUseRoutine = Boolean(routine.routineId && routine.resourceKey && missingRefs.length === 0);
+ const managedBy = routine.managedByPluginDisplayName ?? pluginDisplayName;
+ const hasRepairActions = Boolean(onReconcile || onReset);
+
+ return (
+ <div key={routine.key} className="last:[&_a]:border-b-0">
+ <RoutineListRow
+ routine={row}
+ projectById={projectById}
+ agentById={agentById}
+ runningRoutineId={runningRoutineKey}
+ statusMutationRoutineId={statusMutationRoutineKey}
+ href={href}
+ configureLabel="Configure"
+ managedByLabel={managedBy ? `Managed by ${managedBy}` : null}
+ runNowButton
+ hideArchiveAction
+ disableRunNow={!canUseRoutine}
+ disableToggle={!canUseRoutine}
+ secondaryDetails={
+ <span className="flex flex-wrap items-center gap-x-3 gap-y-1">
+ {routine.resourceKey ? <span>{routine.resourceKey}</span> : null}
+ {routine.cronExpression ? <span>Schedule {routine.cronExpression}</span> : null}
+ </span>
+ }
+ onRunNow={() => onRunNow?.(routine)}
+ onToggleEnabled={() => onToggleEnabled?.(routine, row.status === "active")}
+ />
+ {hasRepairActions ? (
+ <div
+ className="flex flex-wrap items-center justify-between gap-2 border-b border-border px-3 pb-3 text-xs text-muted-foreground last:border-b-0"
+ onClick={(event) => {
+ event.preventDefault();
+ event.stopPropagation();
+ }}
+ >
+ <span>
+ {missingRefs.length
+ ? `Missing ${missingRefs.map((ref) => `${ref.resourceKind}:${ref.resourceKey}`).join(", ")}`
+ : "Routine defaults can be repaired."}
+ </span>
+ <span className="flex items-center gap-2">
+ {onReconcile ? (
+ <Button
+ size="sm"
+ variant="ghost"
+ disabled={reconcilingRoutineKey === routine.key}
+ onClick={() => onReconcile(routine)}
+ >
+ {reconcilingRoutineKey === routine.key ? "Reconciling..." : "Reconcile"}
+ </Button>
+ ) : null}
+ {onReset ? (
+ <Button
+ size="sm"
+ variant="ghost"
+ disabled={resettingRoutineKey === routine.key}
+ onClick={() => onReset(routine)}
+ >
+ {resettingRoutineKey === routine.key ? "Resetting..." : "Reset"}
+ </Button>
+ ) : null}
+ </span>
+ </div>
+ ) : null}
+ </div>
+ );
+ })}
+ </div>
+ );
+}
diff --git a/ui/src/components/MarkdownBody.test.tsx b/ui/src/components/MarkdownBody.test.tsx
index 66811fe99a..9171fddd29 100644
--- a/ui/src/components/MarkdownBody.test.tsx
+++ b/ui/src/components/MarkdownBody.test.tsx
@@ -1,6 +1,6 @@
// @vitest-environment node
-import type { ReactNode } from "react";
+import type { ComponentProps, ReactNode } from "react";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import { describe, expect, it, vi } from "vitest";
import { renderToStaticMarkup } from "react-dom/server";
@@ -33,7 +33,11 @@ vi.mock("../api/issues", () => ({
issuesApi: mockIssuesApi,
}));
-function renderMarkdown(children: string, seededIssues: Array<{ identifier: string; status: string; title?: string }> = []) {
+function renderMarkdown(
+ children: string,
+ seededIssues: Array<{ identifier: string; status: string; title?: string }> = [],
+ props: Partial<ComponentProps<typeof MarkdownBody>> = {},
+) {
const queryClient = new QueryClient({
defaultOptions: {
queries: {
@@ -54,7 +58,7 @@ function renderMarkdown(children: string, seededIssues: Array<{ identifier: stri
return renderToStaticMarkup(
<QueryClientProvider client={queryClient}>
<ThemeProvider>
- <MarkdownBody>{children}</MarkdownBody>
+ <MarkdownBody {...props}>{children}</MarkdownBody>
</ThemeProvider>
</QueryClientProvider>,
);
@@ -279,6 +283,64 @@ describe("MarkdownBody", () => {
expect(html).toContain('href="PAP-1271"');
});
+ it("leaves wiki links as text unless explicitly enabled", () => {
+ const html = renderMarkdown("See [[wiki/entities/paperclip]].");
+
+ expect(html).toContain("[[wiki/entities/paperclip]]");
+ expect(html).not.toContain('href="/wiki/page/wiki/entities/paperclip.md"');
+ });
+
+ it("renders wiki links with a custom resolver when enabled", () => {
+ const html = renderMarkdown(
+ "See [[wiki/entities/paperclip|Paperclip]] and [[wiki/entities/dotta-b]].",
+ [],
+ {
+ enableWikiLinks: true,
+ resolveWikiLinkHref: (target) => `/wiki/page/${target.endsWith(".md") ? target : `${target}.md`}`,
+ },
+ );
+
+ expect(html).toContain('href="/wiki/page/wiki/entities/paperclip.md"');
+ expect(html).toContain('data-paperclip-wiki-link="true"');
+ expect(html).toContain('data-paperclip-wiki-target="wiki/entities/paperclip"');
+ expect(html).toContain(">Paperclip</a>");
+ expect(html).toContain('href="/wiki/page/wiki/entities/dotta-b.md"');
+ expect(html).toContain(">wiki/entities/dotta-b</a>");
+ expect(html).not.toContain("[[wiki/entities/paperclip");
+ });
+
+ it("keeps wiki links as text when the custom resolver rejects them", () => {
+ const html = renderMarkdown(
+ "See [[wiki/entities/paperclip]].",
+ [],
+ {
+ enableWikiLinks: true,
+ wikiLinkRoot: "/wiki/page",
+ resolveWikiLinkHref: () => null,
+ },
+ );
+
+ expect(html).toContain("[[wiki/entities/paperclip]]");
+ expect(html).not.toContain('data-paperclip-wiki-link="true"');
+ expect(html).not.toContain('href="/wiki/page/wiki/entities/paperclip"');
+ });
+
+ it("does not render wiki links inside code spans or code blocks", () => {
+ const html = renderMarkdown(
+ "Inline `[[wiki/entities/paperclip]]`.\n\n```md\n[[wiki/entities/dotta-b]]\n```",
+ [],
+ {
+ enableWikiLinks: true,
+ wikiLinkRoot: "/wiki/page",
+ },
+ );
+
+ expect(html).toContain("[[wiki/entities/paperclip]]");
+ expect(html).toContain("[[wiki/entities/dotta-b]]");
+ expect(html).not.toContain('href="/wiki/page/wiki/entities/paperclip"');
+ expect(html).not.toContain('href="/wiki/page/wiki/entities/dotta-b"');
+ });
+
it("applies wrap-friendly styles to long inline content", () => {
const html = renderMarkdown("averyveryveryveryveryveryveryveryveryverylongtoken");
diff --git a/ui/src/components/MarkdownBody.tsx b/ui/src/components/MarkdownBody.tsx
index f741cf5bfd..d02d8a357b 100644
--- a/ui/src/components/MarkdownBody.tsx
+++ b/ui/src/components/MarkdownBody.tsx
@@ -19,6 +19,12 @@ interface MarkdownBodyProps {
style?: React.CSSProperties;
softBreaks?: boolean;
linkIssueReferences?: boolean;
+ /** Opt into Obsidian-style [[target]] / [[target|label]] wikilinks. */
+ enableWikiLinks?: boolean;
+ /** Base href used for wikilinks when no resolver is supplied. */
+ wikiLinkRoot?: string;
+ /** Optional href resolver for wikilinks. Return null to leave a token as plain text. */
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
/** Optional resolver for relative image paths (e.g. within export packages) */
resolveImageSrc?: (src: string) => string | null;
/** Called when a user clicks an inline image */
@@ -111,6 +117,160 @@ function safeMarkdownUrlTransform(url: string): string {
return parseMentionChipHref(url) ? url : defaultUrlTransform(url);
}
+type MarkdownAstNode = {
+ type?: string;
+ value?: string;
+ children?: MarkdownAstNode[];
+ url?: string;
+ title?: string | null;
+ data?: {
+ hProperties?: Record<string, string>;
+ };
+};
+
+type ParsedWikiLink = {
+ target: string;
+ label: string;
+};
+
+const WIKI_LINK_PATTERN = /\[\[([^\]\r\n]+)\]\]/g;
+const WIKI_LINK_SKIP_PARENT_TYPES = new Set([
+ "definition",
+ "image",
+ "imageReference",
+ "link",
+ "linkReference",
+]);
+
+function parseWikiLinkBody(body: string): ParsedWikiLink | null {
+ const [rawTarget, ...rawLabelParts] = body.split("|");
+ const target = rawTarget?.trim() ?? "";
+ const label = rawLabelParts.length > 0 ? rawLabelParts.join("|").trim() : target;
+ if (!target || target.includes("[") || target.includes("]")) return null;
+ return {
+ target,
+ label: label || target,
+ };
+}
+
+function encodeWikiLinkTarget(target: string): string | null {
+ const trimmed = target.trim();
+ if (!trimmed || /^[a-z][a-z\d+.-]*:/i.test(trimmed) || trimmed.startsWith("//")) return null;
+
+ const hashIndex = trimmed.indexOf("#");
+ const rawPath = (hashIndex >= 0 ? trimmed.slice(0, hashIndex) : trimmed)
+ .trim()
+ .replace(/^\/+/, "");
+ if (
+ !rawPath ||
+ rawPath.includes("\\") ||
+ rawPath.split("/").some((segment) => !segment || segment === "." || segment === "..")
+ ) {
+ return null;
+ }
+
+ const encodedPath = rawPath.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+ const rawHash = hashIndex >= 0 ? trimmed.slice(hashIndex + 1).trim() : "";
+ return rawHash ? `${encodedPath}#${encodeURIComponent(rawHash)}` : encodedPath;
+}
+
+function defaultWikiLinkHref(target: string, wikiLinkRoot?: string): string | null {
+ const encodedTarget = encodeWikiLinkTarget(target);
+ if (!encodedTarget) return null;
+ const root = wikiLinkRoot?.trim().replace(/\/+$/, "") ?? "";
+ return root ? `${root}/${encodedTarget}` : encodedTarget;
+}
+
+function createWikiLinkNode(href: string, wikiLink: ParsedWikiLink): MarkdownAstNode {
+ return {
+ type: "link",
+ url: href,
+ title: null,
+ data: {
+ hProperties: {
+ "data-paperclip-wiki-link": "true",
+ "data-paperclip-wiki-target": wikiLink.target,
+ },
+ },
+ children: [{ type: "text", value: wikiLink.label }],
+ };
+}
+
+function splitTextByWikiLinks(
+ value: string,
+ options: {
+ wikiLinkRoot?: string;
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
+ },
+): MarkdownAstNode[] {
+ const nodes: MarkdownAstNode[] = [];
+ let lastIndex = 0;
+
+ for (const match of value.matchAll(WIKI_LINK_PATTERN)) {
+ const raw = match[0] ?? "";
+ const body = match[1] ?? "";
+ const start = match.index ?? 0;
+ if (start > lastIndex) {
+ nodes.push({ type: "text", value: value.slice(lastIndex, start) });
+ }
+
+ const wikiLink = parseWikiLinkBody(body);
+ let resolvedHref: string | null = null;
+ if (wikiLink) {
+ if (options.resolveWikiLinkHref) {
+ const customHref = options.resolveWikiLinkHref(wikiLink.target, wikiLink.label);
+ resolvedHref = customHref === undefined
+ ? defaultWikiLinkHref(wikiLink.target, options.wikiLinkRoot)
+ : customHref;
+ } else {
+ resolvedHref = defaultWikiLinkHref(wikiLink.target, options.wikiLinkRoot);
+ }
+ }
+
+ if (wikiLink && resolvedHref) {
+ nodes.push(createWikiLinkNode(resolvedHref, wikiLink));
+ } else {
+ nodes.push({ type: "text", value: raw });
+ }
+ lastIndex = start + raw.length;
+ }
+
+ if (lastIndex < value.length) {
+ nodes.push({ type: "text", value: value.slice(lastIndex) });
+ }
+
+ return nodes;
+}
+
+function transformWikiLinkChildren(
+ node: MarkdownAstNode,
+ options: {
+ wikiLinkRoot?: string;
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
+ },
+) {
+ if (!node.children || WIKI_LINK_SKIP_PARENT_TYPES.has(node.type ?? "")) return;
+
+ node.children = node.children.flatMap((child) => {
+ if (child.type === "text" && typeof child.value === "string" && child.value.includes("[[")) {
+ return splitTextByWikiLinks(child.value, options);
+ }
+ transformWikiLinkChildren(child, options);
+ return child;
+ });
+}
+
+function createRemarkWikiLinks(options: {
+ wikiLinkRoot?: string;
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
+}) {
+ return function remarkWikiLinks() {
+ return (tree: MarkdownAstNode) => {
+ transformWikiLinkChildren(tree, options);
+ };
+ };
+}
+
function isGitHubUrl(href: string | null | undefined): boolean {
if (!href) return false;
try {
@@ -321,11 +481,17 @@ export function MarkdownBody({
style,
softBreaks = true,
linkIssueReferences = true,
+ enableWikiLinks = false,
+ wikiLinkRoot,
+ resolveWikiLinkHref,
resolveImageSrc,
onImageClick,
}: MarkdownBodyProps) {
const { theme } = useTheme();
const remarkPlugins: NonNullable<Options["remarkPlugins"]> = [remarkGfm];
+ if (enableWikiLinks) {
+ remarkPlugins.push(createRemarkWikiLinks({ wikiLinkRoot, resolveWikiLinkHref }));
+ }
if (linkIssueReferences) {
remarkPlugins.push(remarkLinkIssueReferences);
}
@@ -370,7 +536,22 @@ export function MarkdownBody({
{codeChildren}
</code>
),
- a: ({ href, style: linkStyle, children: linkChildren }) => {
+ a: ({ node: _node, href, style: linkStyle, children: linkChildren, ...anchorProps }) => {
+ const dataProps = anchorProps as Record<string, unknown>;
+ const isWikiLink = dataProps["data-paperclip-wiki-link"] === "true";
+ if (isWikiLink && href && !/^[a-z][a-z\d+.-]*:/i.test(href) && !href.startsWith("//")) {
+ return (
+ <Link
+ to={href}
+ {...anchorProps}
+ rel="noreferrer"
+ style={mergeWrapStyle(linkStyle as React.CSSProperties | undefined)}
+ >
+ {linkChildren}
+ </Link>
+ );
+ }
+
const issueRef = linkIssueReferences ? parseIssueReferenceFromHref(href) : null;
if (issueRef) {
return (
diff --git a/ui/src/components/PackageFileTree.tsx b/ui/src/components/PackageFileTree.tsx
index 82d3d0360e..c4c75ee694 100644
--- a/ui/src/components/PackageFileTree.tsx
+++ b/ui/src/components/PackageFileTree.tsx
@@ -1,326 +1,24 @@
-import type { ReactNode } from "react";
-import { cn } from "../lib/utils";
-import {
- ChevronDown,
- ChevronRight,
- FileCode2,
- FileText,
- Folder,
- FolderOpen,
-} from "lucide-react";
+import { FileTree } from "./FileTree";
+import type { FileTreeProps } from "./FileTree";
-// ── Tree types ────────────────────────────────────────────────────────
-
-export type FileTreeNode = {
- name: string;
- path: string;
- kind: "dir" | "file";
- children: FileTreeNode[];
- /** Optional per-node metadata (e.g. import action) */
- action?: string | null;
-};
-
-const TREE_BASE_INDENT = 16;
-const TREE_STEP_INDENT = 24;
-const TREE_ROW_HEIGHT_CLASS = "min-h-9";
-
-// ── Helpers ───────────────────────────────────────────────────────────
-
-export function buildFileTree(
- files: Record<string, unknown>,
- actionMap?: Map<string, string>,
-): FileTreeNode[] {
- const root: FileTreeNode = { name: "", path: "", kind: "dir", children: [] };
-
- for (const filePath of Object.keys(files)) {
- const segments = filePath.split("/").filter(Boolean);
- let current = root;
- let currentPath = "";
- for (let i = 0; i < segments.length; i++) {
- const segment = segments[i];
- currentPath = currentPath ? `${currentPath}/${segment}` : segment;
- const isLeaf = i === segments.length - 1;
- let next = current.children.find((c) => c.name === segment);
- if (!next) {
- next = {
- name: segment,
- path: currentPath,
- kind: isLeaf ? "file" : "dir",
- children: [],
- action: isLeaf ? (actionMap?.get(filePath) ?? null) : null,
- };
- current.children.push(next);
- }
- current = next;
- }
- }
-
- function sortNode(node: FileTreeNode) {
- node.children.sort((a, b) => {
- // Files before directories so PROJECT.md appears above tasks/
- if (a.kind !== b.kind) return a.kind === "file" ? -1 : 1;
- return a.name.localeCompare(b.name);
- });
- node.children.forEach(sortNode);
- }
-
- sortNode(root);
- return root.children;
-}
-
-export function countFiles(nodes: FileTreeNode[]): number {
- let count = 0;
- for (const node of nodes) {
- if (node.kind === "file") count++;
- else count += countFiles(node.children);
- }
- return count;
-}
-
-export function collectAllPaths(
- nodes: FileTreeNode[],
- type: "file" | "dir" | "all" = "all",
-): Set<string> {
- const paths = new Set<string>();
- for (const node of nodes) {
- if (type === "all" || node.kind === type) paths.add(node.path);
- for (const p of collectAllPaths(node.children, type)) paths.add(p);
- }
- return paths;
-}
-
-function fileIcon(name: string) {
- if (name.endsWith(".yaml") || name.endsWith(".yml")) return FileCode2;
- return FileText;
-}
-
-// ── Frontmatter helpers ───────────────────────────────────────────────
-
-export type FrontmatterData = Record<string, string | string[]>;
-
-export function parseFrontmatter(content: string): { data: FrontmatterData; body: string } | null {
- const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
- if (!match) return null;
-
- const data: FrontmatterData = {};
- const rawYaml = match[1];
- const body = match[2];
-
- let currentKey: string | null = null;
- let currentList: string[] | null = null;
-
- for (const line of rawYaml.split("\n")) {
- const trimmed = line.trim();
- if (!trimmed || trimmed.startsWith("#")) continue;
-
- if (trimmed.startsWith("- ") && currentKey) {
- if (!currentList) currentList = [];
- currentList.push(trimmed.slice(2).trim().replace(/^["']|["']$/g, ""));
- continue;
- }
-
- if (currentKey && currentList) {
- data[currentKey] = currentList;
- currentList = null;
- currentKey = null;
- }
-
- const kvMatch = trimmed.match(/^([a-zA-Z_][\w-]*)\s*:\s*(.*)$/);
- if (kvMatch) {
- const key = kvMatch[1];
- const val = kvMatch[2].trim().replace(/^["']|["']$/g, "");
- if (val === "null") {
- currentKey = null;
- continue;
- }
- if (val) {
- data[key] = val;
- currentKey = null;
- } else {
- currentKey = key;
- }
- }
- }
-
- if (currentKey && currentList) {
- data[currentKey] = currentList;
- }
-
- return Object.keys(data).length > 0 ? { data, body } : null;
+export function PackageFileTree({ wrapLabels = false, ...props }: FileTreeProps) {
+ return <FileTree {...props} wrapLabels={wrapLabels} />;
}
-export const FRONTMATTER_FIELD_LABELS: Record<string, string> = {
- name: "Name",
- title: "Title",
- kind: "Kind",
- reportsTo: "Reports to",
- skills: "Skills",
- status: "Status",
- description: "Description",
- priority: "Priority",
- assignee: "Assignee",
- project: "Project",
- recurring: "Recurring",
- targetDate: "Target date",
-};
-
-// ── File tree component ───────────────────────────────────────────────
-
-export function PackageFileTree({
- nodes,
- selectedFile,
- expandedDirs,
- checkedFiles,
- onToggleDir,
- onSelectFile,
- onToggleCheck,
- renderFileExtra,
- fileRowClassName,
- showCheckboxes = true,
- wrapLabels = false,
- depth = 0,
-}: {
- nodes: FileTreeNode[];
- selectedFile: string | null;
- expandedDirs: Set<string>;
- checkedFiles?: Set<string>;
- onToggleDir: (path: string) => void;
- onSelectFile: (path: string) => void;
- onToggleCheck?: (path: string, kind: "file" | "dir") => void;
- /** Optional extra content rendered at the end of each file row (e.g. action badge) */
- renderFileExtra?: (node: FileTreeNode, checked: boolean) => ReactNode;
- /** Optional additional className for file rows */
- fileRowClassName?: (node: FileTreeNode, checked: boolean) => string | undefined;
- showCheckboxes?: boolean;
- /** Allow long file and directory names to wrap instead of forcing horizontal overflow. */
- wrapLabels?: boolean;
- depth?: number;
-}) {
- const effectiveCheckedFiles = checkedFiles ?? new Set<string>();
-
- return (
- <div>
- {nodes.map((node) => {
- const expanded = node.kind === "dir" && expandedDirs.has(node.path);
- if (node.kind === "dir") {
- const childFiles = collectAllPaths(node.children, "file");
- const allChecked = [...childFiles].every((p) => effectiveCheckedFiles.has(p));
- const someChecked = [...childFiles].some((p) => effectiveCheckedFiles.has(p));
- return (
- <div key={node.path}>
- <div
- className={cn(
- showCheckboxes
- ? "group grid w-full grid-cols-[auto_minmax(0,1fr)_2.25rem] items-center gap-x-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground"
- : "group grid w-full grid-cols-[minmax(0,1fr)_2.25rem] items-center gap-x-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground",
- TREE_ROW_HEIGHT_CLASS,
- )}
- style={{
- paddingInlineStart: `${TREE_BASE_INDENT + depth * TREE_STEP_INDENT - 8}px`,
- }}
- >
- {showCheckboxes && (
- <label className="flex items-center pl-2">
- <input
- type="checkbox"
- checked={allChecked}
- ref={(el) => { if (el) el.indeterminate = someChecked && !allChecked; }}
- onChange={() => onToggleCheck?.(node.path, "dir")}
- className="mr-2 accent-foreground"
- />
- </label>
- )}
- <button
- type="button"
- className="flex min-w-0 items-center gap-2 py-1 text-left"
- onClick={() => onToggleDir(node.path)}
- >
- <span className="flex h-4 w-4 shrink-0 items-center justify-center">
- {expanded ? (
- <FolderOpen className="h-3.5 w-3.5" />
- ) : (
- <Folder className="h-3.5 w-3.5" />
- )}
- </span>
- <span className={cn("min-w-0", wrapLabels ? "break-all leading-4" : "truncate")}>
- {node.name}
- </span>
- </button>
- <button
- type="button"
- className="flex h-9 w-9 items-center justify-center self-center rounded-sm text-muted-foreground opacity-70 transition-[background-color,color,opacity] hover:bg-accent hover:text-foreground group-hover:opacity-100"
- onClick={() => onToggleDir(node.path)}
- >
- {expanded ? (
- <ChevronDown className="h-3.5 w-3.5" />
- ) : (
- <ChevronRight className="h-3.5 w-3.5" />
- )}
- </button>
- </div>
- {expanded && (
- <PackageFileTree
- nodes={node.children}
- selectedFile={selectedFile}
- expandedDirs={expandedDirs}
- checkedFiles={effectiveCheckedFiles}
- onToggleDir={onToggleDir}
- onSelectFile={onSelectFile}
- onToggleCheck={onToggleCheck}
- renderFileExtra={renderFileExtra}
- fileRowClassName={fileRowClassName}
- showCheckboxes={showCheckboxes}
- wrapLabels={wrapLabels}
- depth={depth + 1}
- />
- )}
- </div>
- );
- }
-
- const FileIcon = fileIcon(node.name);
- const checked = effectiveCheckedFiles.has(node.path);
- const extraClassName = fileRowClassName?.(node, checked);
- return (
- <div
- key={node.path}
- className={cn(
- "flex w-full items-center gap-1 pr-3 text-left text-sm text-muted-foreground hover:bg-accent/30 hover:text-foreground cursor-pointer",
- TREE_ROW_HEIGHT_CLASS,
- node.path === selectedFile && "text-foreground bg-accent/20",
- extraClassName,
- )}
- style={{
- paddingInlineStart: `${TREE_BASE_INDENT + depth * TREE_STEP_INDENT - 8}px`,
- }}
- onClick={() => onSelectFile(node.path)}
- >
- {showCheckboxes && (
- <label className="flex items-center pl-2">
- <input
- type="checkbox"
- checked={checked}
- onChange={() => onToggleCheck?.(node.path, "file")}
- className="mr-2 accent-foreground"
- />
- </label>
- )}
- <button
- type="button"
- className="flex min-w-0 flex-1 items-center gap-2 py-1 text-left"
- onClick={() => onSelectFile(node.path)}
- >
- <span className="flex h-4 w-4 shrink-0 items-center justify-center">
- <FileIcon className="h-3.5 w-3.5" />
- </span>
- <span className={cn("min-w-0", wrapLabels ? "break-all leading-4" : "truncate")}>
- {node.name}
- </span>
- </button>
- {renderFileExtra?.(node, checked)}
- </div>
- );
- })}
- </div>
- );
-}
+export {
+ FRONTMATTER_FIELD_LABELS,
+ buildFileTree,
+ collectAllPaths,
+ countFiles,
+ parseFrontmatter,
+} from "./FileTree";
+export type {
+ FileTreeBadge,
+ FileTreeBadgeVariant,
+ FileTreeEmptyState,
+ FileTreeErrorState,
+ FileTreeNode,
+ FileTreeProps,
+ FileTreeTone,
+ FrontmatterData,
+} from "./FileTree";
diff --git a/ui/src/components/ResizableSidebarPane.test.tsx b/ui/src/components/ResizableSidebarPane.test.tsx
new file mode 100644
index 0000000000..cb635d8103
--- /dev/null
+++ b/ui/src/components/ResizableSidebarPane.test.tsx
@@ -0,0 +1,121 @@
+// @vitest-environment jsdom
+
+import { act } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ResizableSidebarPane } from "./ResizableSidebarPane";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+(globalThis as any).IS_REACT_ACT_ENVIRONMENT = true;
+
+function pointerEvent(type: string, clientX: number) {
+ const event = new MouseEvent(type, { bubbles: true, clientX });
+ Object.defineProperty(event, "pointerId", { value: 1 });
+ return event;
+}
+
+describe("ResizableSidebarPane", () => {
+ let container: HTMLDivElement;
+ let root: Root;
+
+ beforeEach(() => {
+ window.localStorage.clear();
+ container = document.createElement("div");
+ document.body.appendChild(container);
+ root = createRoot(container);
+ });
+
+ afterEach(() => {
+ act(() => {
+ root.unmount();
+ });
+ container.remove();
+ window.localStorage.clear();
+ });
+
+ function pane() {
+ return container.firstElementChild as HTMLDivElement;
+ }
+
+ function handle() {
+ return container.querySelector('[role="separator"]') as HTMLDivElement | null;
+ }
+
+ it("uses a persisted width when open", () => {
+ window.localStorage.setItem("test.sidebar.width", "320");
+
+ act(() => {
+ root.render(
+ <ResizableSidebarPane open resizable storageKey="test.sidebar.width">
+ <div>Sidebar</div>
+ </ResizableSidebarPane>,
+ );
+ });
+
+ expect(pane().style.width).toBe("320px");
+ expect(handle()?.getAttribute("aria-valuenow")).toBe("320");
+ });
+
+ it("resizes by dragging and persists the new width", () => {
+ act(() => {
+ root.render(
+ <ResizableSidebarPane open resizable storageKey="test.sidebar.width">
+ <div>Sidebar</div>
+ </ResizableSidebarPane>,
+ );
+ });
+
+ const separator = handle();
+ expect(separator).not.toBeNull();
+ separator!.setPointerCapture = vi.fn();
+
+ act(() => {
+ separator!.dispatchEvent(pointerEvent("pointerdown", 240));
+ separator!.dispatchEvent(pointerEvent("pointermove", 320));
+ separator!.dispatchEvent(pointerEvent("pointerup", 320));
+ });
+
+ expect(pane().style.width).toBe("320px");
+ expect(window.localStorage.getItem("test.sidebar.width")).toBe("320");
+ });
+
+ it("supports keyboard resizing and clamps to the configured bounds", () => {
+ act(() => {
+ root.render(
+ <ResizableSidebarPane open resizable storageKey="test.sidebar.width">
+ <div>Sidebar</div>
+ </ResizableSidebarPane>,
+ );
+ });
+
+ const separator = handle();
+ act(() => {
+ separator?.dispatchEvent(new KeyboardEvent("keydown", { key: "ArrowRight", bubbles: true }));
+ });
+ expect(pane().style.width).toBe("256px");
+ expect(window.localStorage.getItem("test.sidebar.width")).toBe("256");
+
+ act(() => {
+ separator?.dispatchEvent(new KeyboardEvent("keydown", { key: "Home", bubbles: true }));
+ });
+ expect(pane().style.width).toBe("208px");
+
+ act(() => {
+ separator?.dispatchEvent(new KeyboardEvent("keydown", { key: "End", bubbles: true }));
+ });
+ expect(pane().style.width).toBe("420px");
+ });
+
+ it("can render without a resize handle", () => {
+ act(() => {
+ root.render(
+ <ResizableSidebarPane open resizable={false}>
+ <div>Sidebar</div>
+ </ResizableSidebarPane>,
+ );
+ });
+
+ expect(handle()).toBeNull();
+ expect(pane().style.width).toBe("240px");
+ });
+});
diff --git a/ui/src/components/ResizableSidebarPane.tsx b/ui/src/components/ResizableSidebarPane.tsx
new file mode 100644
index 0000000000..09f9c70a1f
--- /dev/null
+++ b/ui/src/components/ResizableSidebarPane.tsx
@@ -0,0 +1,176 @@
+import {
+ useCallback,
+ useEffect,
+ useMemo,
+ useRef,
+ useState,
+ type KeyboardEvent,
+ type PointerEvent,
+ type ReactNode,
+} from "react";
+import { cn } from "@/lib/utils";
+
+const DEFAULT_SIDEBAR_WIDTH = 240;
+const MIN_SIDEBAR_WIDTH = 208;
+const MAX_SIDEBAR_WIDTH = 420;
+const SIDEBAR_WIDTH_STEP = 16;
+
+function clampSidebarWidth(width: number) {
+ return Math.min(MAX_SIDEBAR_WIDTH, Math.max(MIN_SIDEBAR_WIDTH, width));
+}
+
+function readStoredSidebarWidth(storageKey: string) {
+ if (typeof window === "undefined") return DEFAULT_SIDEBAR_WIDTH;
+
+ try {
+ const stored = window.localStorage.getItem(storageKey);
+ if (!stored) return DEFAULT_SIDEBAR_WIDTH;
+ const parsed = Number.parseInt(stored, 10);
+ if (!Number.isFinite(parsed)) return DEFAULT_SIDEBAR_WIDTH;
+ return clampSidebarWidth(parsed);
+ } catch {
+ return DEFAULT_SIDEBAR_WIDTH;
+ }
+}
+
+function writeStoredSidebarWidth(storageKey: string, width: number) {
+ if (typeof window === "undefined") return;
+
+ try {
+ window.localStorage.setItem(storageKey, String(clampSidebarWidth(width)));
+ } catch {
+ // Storage can be unavailable in private contexts; resizing should still work.
+ }
+}
+
+type ResizableSidebarPaneProps = {
+ children: ReactNode;
+ open: boolean;
+ resizable?: boolean;
+ storageKey?: string;
+ className?: string;
+};
+
+export function ResizableSidebarPane({
+ children,
+ open,
+ resizable = false,
+ storageKey = "paperclip.sidebar.width",
+ className,
+}: ResizableSidebarPaneProps) {
+ const [width, setWidth] = useState(() => readStoredSidebarWidth(storageKey));
+ const [isResizing, setIsResizing] = useState(false);
+ const widthRef = useRef(width);
+ const dragState = useRef<{ startX: number; startWidth: number } | null>(null);
+
+ useEffect(() => {
+ const storedWidth = readStoredSidebarWidth(storageKey);
+ widthRef.current = storedWidth;
+ setWidth(storedWidth);
+ }, [storageKey]);
+
+ const visibleWidth = open ? width : 0;
+ const paneStyle = useMemo(
+ () => ({ width: `${visibleWidth}px` }),
+ [visibleWidth],
+ );
+
+ const commitWidth = useCallback(
+ (nextWidth: number) => {
+ const clamped = clampSidebarWidth(nextWidth);
+ widthRef.current = clamped;
+ setWidth(clamped);
+ writeStoredSidebarWidth(storageKey, clamped);
+ },
+ [storageKey],
+ );
+
+ const handlePointerDown = useCallback(
+ (event: PointerEvent<HTMLDivElement>) => {
+ if (!open || !resizable) return;
+
+ event.preventDefault();
+ event.currentTarget.setPointerCapture(event.pointerId);
+ dragState.current = { startX: event.clientX, startWidth: widthRef.current };
+ setIsResizing(true);
+ },
+ [open, resizable],
+ );
+
+ const handlePointerMove = useCallback(
+ (event: PointerEvent<HTMLDivElement>) => {
+ if (!dragState.current) return;
+
+ const nextWidth = dragState.current.startWidth + event.clientX - dragState.current.startX;
+ const clamped = clampSidebarWidth(nextWidth);
+ widthRef.current = clamped;
+ setWidth(clamped);
+ },
+ [],
+ );
+
+ const endResize = useCallback(() => {
+ if (!dragState.current) return;
+
+ dragState.current = null;
+ setIsResizing(false);
+ writeStoredSidebarWidth(storageKey, widthRef.current);
+ }, [storageKey]);
+
+ const handleKeyDown = useCallback(
+ (event: KeyboardEvent<HTMLDivElement>) => {
+ if (!open || !resizable) return;
+
+ if (event.key === "ArrowLeft") {
+ event.preventDefault();
+ commitWidth(width - SIDEBAR_WIDTH_STEP);
+ } else if (event.key === "ArrowRight") {
+ event.preventDefault();
+ commitWidth(width + SIDEBAR_WIDTH_STEP);
+ } else if (event.key === "Home") {
+ event.preventDefault();
+ commitWidth(MIN_SIDEBAR_WIDTH);
+ } else if (event.key === "End") {
+ event.preventDefault();
+ commitWidth(MAX_SIDEBAR_WIDTH);
+ }
+ },
+ [commitWidth, open, resizable, width],
+ );
+
+ return (
+ <div
+ className={cn(
+ "relative overflow-hidden",
+ !isResizing && "transition-[width] duration-100 ease-out",
+ className,
+ )}
+ style={paneStyle}
+ >
+ {children}
+ {resizable && open ? (
+ <div
+ role="separator"
+ aria-label="Resize sidebar"
+ aria-orientation="vertical"
+ aria-valuemin={MIN_SIDEBAR_WIDTH}
+ aria-valuemax={MAX_SIDEBAR_WIDTH}
+ aria-valuenow={width}
+ tabIndex={0}
+ className={cn(
+ "absolute inset-y-0 right-0 z-20 w-3 cursor-col-resize touch-none outline-none",
+ "before:absolute before:inset-y-0 before:left-1/2 before:w-px before:-translate-x-1/2 before:bg-transparent before:transition-colors",
+ "hover:before:bg-border focus-visible:before:bg-ring",
+ isResizing && "before:bg-ring",
+ )}
+ onPointerDown={handlePointerDown}
+ onPointerMove={handlePointerMove}
+ onPointerUp={endResize}
+ onPointerCancel={endResize}
+ onLostPointerCapture={endResize}
+ onKeyDown={handleKeyDown}
+ />
+ ) : null}
+ </div>
+ );
+}
diff --git a/ui/src/components/RoutineList.tsx b/ui/src/components/RoutineList.tsx
new file mode 100644
index 0000000000..4fabb4f040
--- /dev/null
+++ b/ui/src/components/RoutineList.tsx
@@ -0,0 +1,196 @@
+import type { ReactNode } from "react";
+import { MoreHorizontal, Play } from "lucide-react";
+import { Link } from "@/lib/router";
+import { AgentIcon } from "@/components/AgentIconPicker";
+import { Button } from "@/components/ui/button";
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuSeparator,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import { ToggleSwitch } from "@/components/ui/toggle-switch";
+
+export type RoutineListProjectSummary = {
+ name: string;
+ color?: string | null;
+};
+
+export type RoutineListAgentSummary = {
+ name: string;
+ icon?: string | null;
+};
+
+export type RoutineListRowItem = {
+ id: string;
+ title: string;
+ status: string;
+ projectId: string | null;
+ assigneeAgentId: string | null;
+ lastRun?: {
+ triggeredAt?: Date | string | null;
+ status?: string | null;
+ } | null;
+};
+
+export function formatLastRunTimestamp(value: Date | string | null | undefined) {
+ if (!value) return "Never";
+ return new Date(value).toLocaleString();
+}
+
+export function formatRoutineRunStatus(value: string | null | undefined) {
+ if (!value) return null;
+ return value.replaceAll("_", " ");
+}
+
+export function nextRoutineStatus(currentStatus: string, enabled: boolean) {
+ if (currentStatus === "archived" && enabled) return "active";
+ return enabled ? "active" : "paused";
+}
+
+export function RoutineListRow<TRoutine extends RoutineListRowItem>({
+ routine,
+ projectById,
+ agentById,
+ runningRoutineId,
+ statusMutationRoutineId,
+ href,
+ configureLabel = "Edit",
+ managedByLabel,
+ secondaryDetails,
+ runNowButton = false,
+ disableRunNow = false,
+ disableToggle = false,
+ hideArchiveAction = false,
+ onRunNow,
+ onToggleEnabled,
+ onToggleArchived,
+}: {
+ routine: TRoutine;
+ projectById: Map<string, RoutineListProjectSummary>;
+ agentById: Map<string, RoutineListAgentSummary>;
+ runningRoutineId: string | null;
+ statusMutationRoutineId: string | null;
+ href: string;
+ configureLabel?: string;
+ managedByLabel?: string | null;
+ secondaryDetails?: ReactNode;
+ runNowButton?: boolean;
+ disableRunNow?: boolean;
+ disableToggle?: boolean;
+ hideArchiveAction?: boolean;
+ onRunNow: (routine: TRoutine) => void;
+ onToggleEnabled: (routine: TRoutine, enabled: boolean) => void;
+ onToggleArchived?: (routine: TRoutine) => void;
+}) {
+ const enabled = routine.status === "active";
+ const isArchived = routine.status === "archived";
+ const isStatusPending = statusMutationRoutineId === routine.id;
+ const project = routine.projectId ? projectById.get(routine.projectId) ?? null : null;
+ const agent = routine.assigneeAgentId ? agentById.get(routine.assigneeAgentId) ?? null : null;
+ const isDraft = !isArchived && !routine.assigneeAgentId;
+ const runDisabled = runningRoutineId === routine.id || isArchived || disableRunNow;
+
+ return (
+ <Link
+ to={href}
+ className="group flex flex-col gap-3 border-b border-border px-3 py-3 transition-colors hover:bg-accent/50 last:border-b-0 sm:flex-row sm:items-center no-underline text-inherit"
+ >
+ <div className="min-w-0 flex-1 space-y-1.5">
+ <div className="flex flex-wrap items-center gap-2">
+ <span className="truncate text-sm font-medium">{routine.title}</span>
+ {(isArchived || routine.status === "paused" || isDraft) ? (
+ <span className="text-xs text-muted-foreground">
+ {isArchived ? "archived" : isDraft ? "draft" : "paused"}
+ </span>
+ ) : null}
+ {managedByLabel ? (
+ <span className="text-xs text-muted-foreground">{managedByLabel}</span>
+ ) : null}
+ </div>
+ <div className="flex flex-wrap items-center gap-x-4 gap-y-1 text-xs text-muted-foreground">
+ <span className="flex items-center gap-2">
+ <span
+ className="h-2.5 w-2.5 shrink-0 rounded-sm"
+ style={{ backgroundColor: project?.color ?? "#64748b" }}
+ />
+ <span>{routine.projectId ? (project?.name ?? "Unknown project") : "No project"}</span>
+ </span>
+ <span className="flex items-center gap-2">
+ {agent?.icon ? <AgentIcon icon={agent.icon} className="h-3.5 w-3.5 shrink-0" /> : null}
+ <span>{routine.assigneeAgentId ? (agent?.name ?? "Unknown agent") : "No default agent"}</span>
+ </span>
+ <span>
+ {formatLastRunTimestamp(routine.lastRun?.triggeredAt)}
+ {routine.lastRun ? ` · ${formatRoutineRunStatus(routine.lastRun.status)}` : ""}
+ </span>
+ </div>
+ {secondaryDetails ? (
+ <div className="text-xs text-muted-foreground">{secondaryDetails}</div>
+ ) : null}
+ </div>
+
+ <div className="flex items-center gap-3" onClick={(event) => { event.preventDefault(); event.stopPropagation(); }}>
+ {runNowButton ? (
+ <Button
+ variant="ghost"
+ size="sm"
+ disabled={runDisabled}
+ onClick={() => onRunNow(routine)}
+ >
+ <Play className="h-3.5 w-3.5" />
+ {runningRoutineId === routine.id ? "Running..." : "Run now"}
+ </Button>
+ ) : null}
+
+ <div className="flex items-center gap-3">
+ <ToggleSwitch
+ size="lg"
+ checked={enabled}
+ onCheckedChange={() => onToggleEnabled(routine, enabled)}
+ disabled={isStatusPending || isArchived || disableToggle}
+ aria-label={enabled ? `Disable ${routine.title}` : `Enable ${routine.title}`}
+ />
+ <span className="w-12 text-xs text-muted-foreground">
+ {isArchived ? "Archived" : isDraft ? "Draft" : enabled ? "On" : "Off"}
+ </span>
+ </div>
+
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button variant="ghost" size="icon-sm" aria-label={`More actions for ${routine.title}`}>
+ <MoreHorizontal className="h-4 w-4" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end">
+ <DropdownMenuItem asChild>
+ <Link to={href}>{configureLabel}</Link>
+ </DropdownMenuItem>
+ <DropdownMenuItem
+ disabled={runDisabled}
+ onClick={() => onRunNow(routine)}
+ >
+ {runningRoutineId === routine.id ? "Running..." : "Run now"}
+ </DropdownMenuItem>
+ <DropdownMenuSeparator />
+ <DropdownMenuItem
+ onClick={() => onToggleEnabled(routine, enabled)}
+ disabled={isStatusPending || isArchived || disableToggle}
+ >
+ {enabled ? "Pause" : "Enable"}
+ </DropdownMenuItem>
+ {!hideArchiveAction && onToggleArchived ? (
+ <DropdownMenuItem
+ onClick={() => onToggleArchived(routine)}
+ disabled={isStatusPending}
+ >
+ {routine.status === "archived" ? "Restore" : "Archive"}
+ </DropdownMenuItem>
+ ) : null}
+ </DropdownMenuContent>
+ </DropdownMenu>
+ </div>
+ </Link>
+ );
+}
diff --git a/ui/src/components/Sidebar.tsx b/ui/src/components/Sidebar.tsx
index 6828014a72..c2f0d630b3 100644
--- a/ui/src/components/Sidebar.tsx
+++ b/ui/src/components/Sidebar.tsx
@@ -55,7 +55,7 @@ export function Sidebar() {
};
return (
- <aside className="w-60 h-full min-h-0 border-r border-border bg-background flex flex-col">
+ <aside className="w-full h-full min-h-0 border-r border-border bg-background flex flex-col">
{/* Top bar: Company name (bold) + Search — aligned with top sections (no visible border) */}
<div className="flex items-center gap-1 px-3 h-12 shrink-0">
<SidebarCompanyMenu />
diff --git a/ui/src/lib/queryKeys.ts b/ui/src/lib/queryKeys.ts
index 0756d7b5d1..ac76438cff 100644
--- a/ui/src/lib/queryKeys.ts
+++ b/ui/src/lib/queryKeys.ts
@@ -41,6 +41,8 @@ export const queryKeys = {
labels: (companyId: string) => ["issues", companyId, "labels"] as const,
listByProject: (companyId: string, projectId: string) =>
["issues", companyId, "project", projectId] as const,
+ listPluginOperationsByProject: (companyId: string, projectId: string, originKindPrefix: string) =>
+ ["issues", companyId, "project", projectId, "plugin-operations", originKindPrefix] as const,
listByParent: (companyId: string, parentId: string) =>
["issues", companyId, "parent", parentId] as const,
listByDescendantRoot: (companyId: string, rootIssueId: string) =>
@@ -171,6 +173,8 @@ export const queryKeys = {
health: (pluginId: string) => ["plugins", pluginId, "health"] as const,
uiContributions: ["plugins", "ui-contributions"] as const,
config: (pluginId: string) => ["plugins", pluginId, "config"] as const,
+ localFolders: (pluginId: string, companyId: string) =>
+ ["plugins", pluginId, "companies", companyId, "local-folders"] as const,
dashboard: (pluginId: string) => ["plugins", pluginId, "dashboard"] as const,
logs: (pluginId: string) => ["plugins", pluginId, "logs"] as const,
},
diff --git a/ui/src/lib/status-colors.ts b/ui/src/lib/status-colors.ts
index 9115c044df..c1f673f83a 100644
--- a/ui/src/lib/status-colors.ts
+++ b/ui/src/lib/status-colors.ts
@@ -57,7 +57,10 @@ export const statusBadge: Record<string, string> = {
failed: "bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300",
timed_out: "bg-orange-100 text-orange-700 dark:bg-orange-900/50 dark:text-orange-300",
succeeded: "bg-green-100 text-green-700 dark:bg-green-900/50 dark:text-green-300",
+ ok: "bg-green-100 text-green-700 dark:bg-green-900/50 dark:text-green-300",
+ warning: "bg-amber-100 text-amber-700 dark:bg-amber-900/50 dark:text-amber-300",
error: "bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300",
+ info: "bg-sky-100 text-sky-700 dark:bg-sky-900/50 dark:text-sky-300",
terminated: "bg-red-100 text-red-700 dark:bg-red-900/50 dark:text-red-300",
pending: "bg-yellow-100 text-yellow-700 dark:bg-yellow-900/50 dark:text-yellow-300",
diff --git a/ui/src/pages/AgentDetail.tsx b/ui/src/pages/AgentDetail.tsx
index d1dddfedd3..004a0a78fd 100644
--- a/ui/src/pages/AgentDetail.tsx
+++ b/ui/src/pages/AgentDetail.tsx
@@ -40,7 +40,7 @@ import { Identity } from "../components/Identity";
import { PageSkeleton } from "../components/PageSkeleton";
import { RunButton, PauseResumeButton } from "../components/AgentActionButtons";
import { BudgetPolicyCard } from "../components/BudgetPolicyCard";
-import { PackageFileTree, buildFileTree } from "../components/PackageFileTree";
+import { FileTree, buildFileTree } from "../components/FileTree";
import { ScrollToBottom } from "../components/ScrollToBottom";
import { formatCents, formatDate, relativeTime, formatTokens, visibleRunCostUsd } from "../lib/utils";
import { cn } from "../lib/utils";
@@ -2276,7 +2276,7 @@ function PromptsTab({
</div>
</div>
)}
- <PackageFileTree
+ <FileTree
nodes={fileTree}
selectedFile={selectedOrEntryFile}
expandedDirs={expandedDirs}
diff --git a/ui/src/pages/CompanyExport.tsx b/ui/src/pages/CompanyExport.tsx
index 0b910e7c8c..a190afbc68 100644
--- a/ui/src/pages/CompanyExport.tsx
+++ b/ui/src/pages/CompanyExport.tsx
@@ -41,8 +41,8 @@ import {
collectAllPaths,
parseFrontmatter,
FRONTMATTER_FIELD_LABELS,
- PackageFileTree,
-} from "../components/PackageFileTree";
+ FileTree,
+} from "../components/FileTree";
/**
* Extract the set of agent/project/task slugs that are "checked" based on
@@ -988,7 +988,7 @@ export function CompanyExport() {
</div>
</div>
<div className="flex-1 overflow-y-auto">
- <PackageFileTree
+ <FileTree
nodes={displayTree}
selectedFile={selectedFile}
expandedDirs={expandedDirs}
@@ -996,6 +996,7 @@ export function CompanyExport() {
onToggleDir={handleToggleDir}
onSelectFile={selectFile}
onToggleCheck={handleToggleCheck}
+ wrapLabels={false}
/>
{totalTaskChildren > visibleTaskChildren && !treeSearch && (
<div className="px-4 py-2">
diff --git a/ui/src/pages/CompanyImport.tsx b/ui/src/pages/CompanyImport.tsx
index 90fad9d406..c1be7a28a6 100644
--- a/ui/src/pages/CompanyImport.tsx
+++ b/ui/src/pages/CompanyImport.tsx
@@ -43,8 +43,8 @@ import {
collectAllPaths,
parseFrontmatter,
FRONTMATTER_FIELD_LABELS,
- PackageFileTree,
-} from "../components/PackageFileTree";
+ FileTree,
+} from "../components/FileTree";
import { readZipArchive } from "../lib/zip";
import { getPortableFileDataUrl, getPortableFileText, isPortableImageFile } from "../lib/portable-files";
@@ -1325,7 +1325,7 @@ export function CompanyImport() {
<h2 className="text-base font-semibold">Package files</h2>
</div>
<div className="flex-1 overflow-y-auto">
- <PackageFileTree
+ <FileTree
nodes={tree}
selectedFile={selectedFile}
expandedDirs={expandedDirs}
@@ -1335,6 +1335,7 @@ export function CompanyImport() {
onToggleCheck={handleToggleCheck}
renderFileExtra={(node, checked) => renderImportFileExtra(node, checked, renameMap)}
fileRowClassName={importFileRowClassName}
+ wrapLabels={false}
/>
</div>
</aside>
diff --git a/ui/src/pages/PluginPage.test.tsx b/ui/src/pages/PluginPage.test.tsx
new file mode 100644
index 0000000000..11d6bf2553
--- /dev/null
+++ b/ui/src/pages/PluginPage.test.tsx
@@ -0,0 +1,207 @@
+// @vitest-environment jsdom
+
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { PluginPage } from "./PluginPage";
+
+const mockPluginsApi = vi.hoisted(() => ({
+ listUiContributions: vi.fn(),
+}));
+
+const mockSetBreadcrumbs = vi.hoisted(() => vi.fn());
+const mockParams = vi.hoisted(() => ({
+ companyPrefix: "PAP" as string | undefined,
+ pluginId: undefined as string | undefined,
+ pluginRoutePath: undefined as string | undefined,
+ "*": undefined as string | undefined,
+}));
+
+vi.mock("@/api/plugins", () => ({
+ pluginsApi: mockPluginsApi,
+}));
+
+vi.mock("@/context/BreadcrumbContext", () => ({
+ useBreadcrumbs: () => ({
+ setBreadcrumbs: mockSetBreadcrumbs,
+ }),
+}));
+
+vi.mock("@/context/CompanyContext", () => ({
+ useCompany: () => ({
+ companies: [{ id: "company-1", name: "Paperclip", issuePrefix: "PAP" }],
+ selectedCompanyId: "company-1",
+ }),
+}));
+
+vi.mock("@/lib/router", () => ({
+ Link: ({ to, children }: { to: string; children: React.ReactNode }) => <a href={to}>{children}</a>,
+ Navigate: () => null,
+ useParams: () => mockParams,
+}));
+
+vi.mock("@/plugins/slots", async () => {
+ const actual = await vi.importActual<typeof import("@/plugins/slots")>("@/plugins/slots");
+ return {
+ resolveRouteSidebarSlot: actual.resolveRouteSidebarSlot,
+ PluginSlotMount: ({ slot }: { slot: { displayName: string } }) => (
+ <div data-testid="plugin-slot-mount">{slot.displayName}</div>
+ ),
+ };
+});
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+(globalThis as any).IS_REACT_ACT_ENVIRONMENT = true;
+
+async function flushReact() {
+ await act(async () => {
+ await Promise.resolve();
+ await new Promise((resolve) => window.setTimeout(resolve, 0));
+ });
+}
+
+function pageContribution(overrides: Partial<{ slots: unknown[] }> = {}) {
+ return {
+ pluginId: "plugin-wiki",
+ pluginKey: "paperclipai.plugin-llm-wiki",
+ displayName: "LLM Wiki",
+ version: "0.1.0",
+ uiEntryFile: "ui.js",
+ slots: [
+ {
+ type: "page",
+ id: "wiki-page",
+ displayName: "Wiki",
+ exportName: "WikiPage",
+ routePath: "wiki",
+ },
+ ],
+ launchers: [],
+ ...overrides,
+ };
+}
+
+async function renderPage(container: HTMLDivElement) {
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <PluginPage />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+ return root;
+}
+
+describe("PluginPage", () => {
+ let container: HTMLDivElement;
+
+ beforeEach(() => {
+ container = document.createElement("div");
+ document.body.appendChild(container);
+ mockParams.companyPrefix = "PAP";
+ mockParams.pluginId = undefined;
+ mockParams.pluginRoutePath = undefined;
+ mockParams["*"] = undefined;
+ });
+
+ afterEach(() => {
+ container.remove();
+ document.body.innerHTML = "";
+ vi.clearAllMocks();
+ });
+
+ it("renders the breadcrumb and Back button on a legacy plugin route (no routeSidebar)", async () => {
+ mockParams.pluginRoutePath = "wiki";
+ mockPluginsApi.listUiContributions.mockResolvedValue([pageContribution()]);
+
+ const root = await renderPage(container);
+
+ expect(mockSetBreadcrumbs).toHaveBeenCalledWith([
+ { label: "Plugins", href: "/instance/settings/plugins" },
+ { label: "LLM Wiki" },
+ ]);
+ expect(container.textContent).toContain("Back");
+ expect(container.querySelector('a[href="/PAP/dashboard"]')).not.toBeNull();
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("uses a route title and hides the Back button when a routeSidebar matches the active route", async () => {
+ mockParams.pluginRoutePath = "wiki";
+ mockPluginsApi.listUiContributions.mockResolvedValue([
+ pageContribution({
+ slots: [
+ {
+ type: "page",
+ id: "wiki-page",
+ displayName: "Wiki",
+ exportName: "WikiPage",
+ routePath: "wiki",
+ },
+ {
+ type: "routeSidebar",
+ id: "wiki-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiRouteSidebar",
+ routePath: "wiki",
+ },
+ ],
+ }),
+ ]);
+
+ const root = await renderPage(container);
+
+ expect(mockSetBreadcrumbs).toHaveBeenCalledWith([{ label: "Wiki" }]);
+ expect(container.textContent).not.toContain("Back");
+ expect(container.querySelector('a[href="/PAP/dashboard"]')).toBeNull();
+ // Page slot itself still renders.
+ expect(container.querySelector('[data-testid="plugin-slot-mount"]')?.textContent).toBe("Wiki");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("uses the selected plugin page path as the route-sidebar title", async () => {
+ mockParams.pluginRoutePath = "wiki";
+ mockParams["*"] = "page/templates%3A%3Aindex.md";
+ mockPluginsApi.listUiContributions.mockResolvedValue([
+ pageContribution({
+ slots: [
+ {
+ type: "page",
+ id: "wiki-page",
+ displayName: "Wiki",
+ exportName: "WikiPage",
+ routePath: "wiki",
+ },
+ {
+ type: "routeSidebar",
+ id: "wiki-sidebar",
+ displayName: "Wiki Sidebar",
+ exportName: "WikiRouteSidebar",
+ routePath: "wiki",
+ },
+ ],
+ }),
+ ]);
+
+ const root = await renderPage(container);
+
+ expect(mockSetBreadcrumbs).toHaveBeenCalledWith([{ label: "index" }]);
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+});
diff --git a/ui/src/pages/PluginPage.tsx b/ui/src/pages/PluginPage.tsx
index 687e081442..104f3f9055 100644
--- a/ui/src/pages/PluginPage.tsx
+++ b/ui/src/pages/PluginPage.tsx
@@ -5,7 +5,11 @@ import { useCompany } from "@/context/CompanyContext";
import { useBreadcrumbs } from "@/context/BreadcrumbContext";
import { pluginsApi } from "@/api/plugins";
import { queryKeys } from "@/lib/queryKeys";
-import { PluginSlotMount } from "@/plugins/slots";
+import {
+ PluginSlotMount,
+ resolveRouteSidebarSlot,
+ type ResolvedPluginSlot,
+} from "@/plugins/slots";
import { Button } from "@/components/ui/button";
import { ArrowLeft } from "lucide-react";
import { NotFoundPage } from "./NotFound";
@@ -19,11 +23,14 @@ import { NotFoundPage } from "./NotFound";
* @see doc/plugins/PLUGIN_SPEC.md §24.4 — Company-Context Plugin Page
*/
export function PluginPage() {
- const { companyPrefix: routeCompanyPrefix, pluginId, pluginRoutePath } = useParams<{
+ const params = useParams<{
companyPrefix?: string;
pluginId?: string;
pluginRoutePath?: string;
+ "*": string | undefined;
}>();
+ const { companyPrefix: routeCompanyPrefix, pluginId, pluginRoutePath } = params;
+ const pluginRouteSplat = params["*"];
const { companies, selectedCompanyId } = useCompany();
const { setBreadcrumbs } = useBreadcrumbs();
const routeCompany = useMemo(() => {
@@ -89,14 +96,33 @@ export function PluginPage() {
[resolvedCompanyId, companyPrefix],
);
+ // When the active route has a routeSidebar slot, the sidebar provides the
+ // back affordance, but the top bar still needs a route-specific title.
+ const routeSidebarActive = useMemo(() => {
+ if (!pluginRoutePath || !contributions) return false;
+ const flattened: ResolvedPluginSlot[] = contributions.flatMap((contribution) =>
+ contribution.slots.map((slot) => ({
+ ...slot,
+ pluginId: contribution.pluginId,
+ pluginKey: contribution.pluginKey,
+ pluginDisplayName: contribution.displayName,
+ pluginVersion: contribution.version,
+ })),
+ );
+ return resolveRouteSidebarSlot(flattened, pluginRoutePath) !== null;
+ }, [contributions, pluginRoutePath]);
+
useEffect(() => {
- if (pageSlot) {
- setBreadcrumbs([
- { label: "Plugins", href: "/instance/settings/plugins" },
- { label: pageSlot.pluginDisplayName },
- ]);
+ if (!pageSlot) return;
+ if (routeSidebarActive) {
+ setBreadcrumbs([{ label: resolveRouteSidebarPageTitle(pageSlot, pluginRouteSplat) }]);
+ return;
}
- }, [pageSlot, companyPrefix, setBreadcrumbs]);
+ setBreadcrumbs([
+ { label: "Plugins", href: "/instance/settings/plugins" },
+ { label: pageSlot.pluginDisplayName },
+ ]);
+ }, [pageSlot, pluginRouteSplat, setBreadcrumbs, routeSidebarActive]);
if (!resolvedCompanyId) {
if (hasInvalidCompanyPrefix) {
@@ -137,14 +163,16 @@ export function PluginPage() {
return (
<div className="space-y-4">
- <div className="flex items-center gap-2">
- <Button variant="ghost" size="sm" asChild>
- <Link to={companyPrefix ? `/${companyPrefix}/dashboard` : "/dashboard"}>
- <ArrowLeft className="h-4 w-4 mr-1" />
- Back
- </Link>
- </Button>
- </div>
+ {!routeSidebarActive && (
+ <div className="flex items-center gap-2">
+ <Button variant="ghost" size="sm" asChild>
+ <Link to={companyPrefix ? `/${companyPrefix}/dashboard` : "/dashboard"}>
+ <ArrowLeft className="h-4 w-4 mr-1" />
+ Back
+ </Link>
+ </Button>
+ </div>
+ )}
<PluginSlotMount
slot={pageSlot}
context={context}
@@ -154,3 +182,42 @@ export function PluginPage() {
</div>
);
}
+
+function resolveRouteSidebarPageTitle(pageSlot: ResolvedPluginSlot, routeSplat: string | undefined): string {
+ const title = titleFromRouteSplat(routeSplat);
+ return title ?? pageSlot.displayName ?? pageSlot.pluginDisplayName;
+}
+
+function titleFromRouteSplat(routeSplat: string | undefined): string | null {
+ const segments = (routeSplat ?? "")
+ .split("/")
+ .filter(Boolean)
+ .map(decodeRouteSegment);
+ if (segments.length === 0) return null;
+
+ if (segments[0] === "page" && segments.length > 1) {
+ return titleFromPath(segments.slice(1).join("/"), { preserveCase: true });
+ }
+
+ return titleFromPath(segments[0] ?? null);
+}
+
+function titleFromPath(path: string | null | undefined, options: { preserveCase?: boolean } = {}): string | null {
+ const trimmed = path?.trim();
+ if (!trimmed) return null;
+ const basename = trimmed.split("/").filter(Boolean).at(-1) ?? trimmed;
+ const withoutNamespace = basename.split("::").at(-1) ?? basename;
+ const withoutExtension = withoutNamespace.replace(/\.[^.]+$/, "");
+ const normalized = withoutExtension.replace(/[-_]+/g, " ").trim();
+ if (!normalized) return null;
+ if (options.preserveCase) return normalized;
+ return normalized.replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+function decodeRouteSegment(segment: string): string {
+ try {
+ return decodeURIComponent(segment);
+ } catch {
+ return segment;
+ }
+}
diff --git a/ui/src/pages/PluginSettings.test.tsx b/ui/src/pages/PluginSettings.test.tsx
index 3aa99028ad..1e9247d780 100644
--- a/ui/src/pages/PluginSettings.test.tsx
+++ b/ui/src/pages/PluginSettings.test.tsx
@@ -12,6 +12,8 @@ const mockPluginsApi = vi.hoisted(() => ({
dashboard: vi.fn(),
logs: vi.fn(),
getConfig: vi.fn(),
+ listLocalFolders: vi.fn(),
+ configureLocalFolder: vi.fn(),
}));
const mockSetBreadcrumbs = vi.hoisted(() => vi.fn());
@@ -58,6 +60,82 @@ async function flushReact() {
});
}
+function basePlugin(overrides: Record<string, unknown> = {}) {
+ return {
+ id: "plugin-1",
+ pluginKey: "paperclip.e2b-sandbox-provider",
+ packageName: "@paperclipai/plugin-e2b",
+ version: "0.1.0",
+ status: "error",
+ categories: ["automation"],
+ manifestJson: {
+ displayName: "E2B Sandbox Provider",
+ version: "0.1.0",
+ description: "E2B environments for Paperclip.",
+ author: "Paperclip",
+ capabilities: ["environment.drivers.register"],
+ environmentDrivers: [
+ {
+ driverKey: "e2b",
+ kind: "sandbox_provider",
+ displayName: "E2B Cloud Sandbox",
+ },
+ ],
+ },
+ lastError: null,
+ ...overrides,
+ };
+}
+
+function wikiFolderDeclaration() {
+ return {
+ folderKey: "wiki-root",
+ displayName: "Wiki root",
+ description: "Company-scoped local folder that stores wiki files.",
+ access: "readWrite" as const,
+ requiredDirectories: ["raw", "wiki"],
+ requiredFiles: ["WIKI.md", "index.md"],
+ };
+}
+
+function folderStatus(overrides: Record<string, unknown> = {}) {
+ return {
+ folderKey: "wiki-root",
+ configured: false,
+ path: null,
+ realPath: null,
+ access: "readWrite",
+ readable: false,
+ writable: false,
+ requiredDirectories: ["raw", "wiki"],
+ requiredFiles: ["WIKI.md", "index.md"],
+ missingDirectories: ["raw", "wiki"],
+ missingFiles: ["WIKI.md", "index.md"],
+ healthy: false,
+ problems: [{ code: "not_configured", message: "No local folder path is configured." }],
+ checkedAt: "2026-05-02T16:00:00.000Z",
+ ...overrides,
+ };
+}
+
+async function renderSettings(container: HTMLDivElement) {
+ const root = createRoot(container);
+ const queryClient = new QueryClient({
+ defaultOptions: { queries: { retry: false } },
+ });
+
+ await act(async () => {
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <PluginSettings />
+ </QueryClientProvider>,
+ );
+ });
+ await flushReact();
+ await flushReact();
+ return root;
+}
+
describe("PluginSettings", () => {
let container: HTMLDivElement;
@@ -65,30 +143,16 @@ describe("PluginSettings", () => {
container = document.createElement("div");
document.body.appendChild(container);
- mockPluginsApi.get.mockResolvedValue({
- id: "plugin-1",
- pluginKey: "paperclip.e2b-sandbox-provider",
- packageName: "@paperclipai/plugin-e2b",
- version: "0.1.0",
- status: "error",
- categories: ["automation"],
- manifestJson: {
- displayName: "E2B Sandbox Provider",
- version: "0.1.0",
- description: "E2B environments for Paperclip.",
- author: "Paperclip",
- capabilities: ["environment.drivers.register"],
- environmentDrivers: [
- {
- driverKey: "e2b",
- kind: "sandbox_provider",
- displayName: "E2B Cloud Sandbox",
- },
- ],
- },
- lastError: null,
- });
+ mockPluginsApi.get.mockResolvedValue(basePlugin());
mockPluginsApi.dashboard.mockResolvedValue(null);
+ mockPluginsApi.health.mockResolvedValue({ pluginId: "plugin-1", status: "ready", healthy: true, checks: [] });
+ mockPluginsApi.logs.mockResolvedValue([]);
+ mockPluginsApi.listLocalFolders.mockResolvedValue({
+ pluginId: "plugin-1",
+ companyId: "company-1",
+ declarations: [],
+ folders: [],
+ });
});
afterEach(() => {
@@ -98,20 +162,7 @@ describe("PluginSettings", () => {
});
it("routes environment-provider plugins to company environments when they have no instance config", async () => {
- const root = createRoot(container);
- const queryClient = new QueryClient({
- defaultOptions: { queries: { retry: false } },
- });
-
- await act(async () => {
- root.render(
- <QueryClientProvider client={queryClient}>
- <PluginSettings />
- </QueryClientProvider>,
- );
- });
- await flushReact();
- await flushReact();
+ const root = await renderSettings(container);
expect(container.textContent).toContain("Configure this plugin from Company Environments.");
expect(container.textContent).toContain("company-scoped instead of instance-global");
@@ -122,4 +173,165 @@ describe("PluginSettings", () => {
root.unmount();
});
});
+
+ it("renders unconfigured manifest local folders with required paths", async () => {
+ const declaration = wikiFolderDeclaration();
+ mockPluginsApi.get.mockResolvedValue(basePlugin({
+ pluginKey: "paperclipai.plugin-llm-wiki",
+ packageName: "@paperclipai/plugin-llm-wiki",
+ status: "ready",
+ manifestJson: {
+ displayName: "LLM Wiki",
+ version: "0.1.0",
+ description: "Local-file LLM Wiki plugin.",
+ author: "Paperclip",
+ capabilities: ["local.folders"],
+ localFolders: [declaration],
+ },
+ }));
+ mockPluginsApi.listLocalFolders.mockResolvedValue({
+ pluginId: "plugin-1",
+ companyId: "company-1",
+ declarations: [declaration],
+ folders: [folderStatus()],
+ });
+
+ const root = await renderSettings(container);
+
+ expect(container.textContent).toContain("Local folders");
+ expect(container.textContent).toContain("Wiki root");
+ expect(container.textContent).toContain("Needs attention");
+ expect(container.textContent).toContain("No local folder path is configured.");
+ expect(container.textContent).toContain("Missing directories: raw, wiki");
+ expect(container.textContent).toContain("Missing files: WIKI.md, index.md");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("renders invalid configured folders with validation problems", async () => {
+ const declaration = wikiFolderDeclaration();
+ mockPluginsApi.get.mockResolvedValue(basePlugin({
+ manifestJson: {
+ displayName: "LLM Wiki",
+ version: "0.1.0",
+ description: "Local-file LLM Wiki plugin.",
+ author: "Paperclip",
+ capabilities: ["local.folders"],
+ localFolders: [declaration],
+ },
+ }));
+ mockPluginsApi.listLocalFolders.mockResolvedValue({
+ pluginId: "plugin-1",
+ companyId: "company-1",
+ declarations: [declaration],
+ folders: [folderStatus({
+ configured: true,
+ path: "/tmp/wiki",
+ realPath: "/tmp/wiki",
+ readable: true,
+ writable: true,
+ missingDirectories: [],
+ missingFiles: ["WIKI.md"],
+ problems: [{ code: "missing_file", message: "Required file is missing.", path: "WIKI.md" }],
+ })],
+ });
+
+ const root = await renderSettings(container);
+
+ expect(container.textContent).toContain("/tmp/wiki");
+ expect(container.textContent).toContain("ReadableYes");
+ expect(container.textContent).toContain("WritableYes");
+ expect(container.textContent).toContain("Validation problems");
+ expect(container.textContent).toContain("Required file is missing.");
+ expect(container.textContent).toContain("Missing files: WIKI.md");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("does not render required paths as present when the configured root cannot be inspected", async () => {
+ const declaration = wikiFolderDeclaration();
+ mockPluginsApi.get.mockResolvedValue(basePlugin({
+ manifestJson: {
+ displayName: "LLM Wiki",
+ version: "0.1.0",
+ description: "Local-file LLM Wiki plugin.",
+ author: "Paperclip",
+ capabilities: ["local.folders"],
+ localFolders: [declaration],
+ },
+ }));
+ mockPluginsApi.listLocalFolders.mockResolvedValue({
+ pluginId: "plugin-1",
+ companyId: "company-1",
+ declarations: [declaration],
+ folders: [folderStatus({
+ configured: true,
+ path: "/tmp/wiki-missing",
+ readable: false,
+ writable: false,
+ missingDirectories: [],
+ missingFiles: [],
+ problems: [{ code: "missing", message: "Configured local folder cannot be inspected.", path: "/tmp/wiki-missing" }],
+ })],
+ });
+
+ const root = await renderSettings(container);
+
+ expect(container.textContent).toContain("Configured local folder cannot be inspected.");
+ expect(container.textContent).toContain("Not inspected");
+ expect(container.textContent).toContain("Configured root was not inspected.");
+ expect(container.textContent).not.toContain("Present");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
+
+ it("renders healthy folders without validation problems", async () => {
+ const declaration = wikiFolderDeclaration();
+ mockPluginsApi.get.mockResolvedValue(basePlugin({
+ manifestJson: {
+ displayName: "LLM Wiki",
+ version: "0.1.0",
+ description: "Local-file LLM Wiki plugin.",
+ author: "Paperclip",
+ capabilities: ["local.folders"],
+ localFolders: [declaration],
+ },
+ }));
+ mockPluginsApi.listLocalFolders.mockResolvedValue({
+ pluginId: "plugin-1",
+ companyId: "company-1",
+ declarations: [declaration],
+ folders: [folderStatus({
+ configured: true,
+ path: "/tmp/wiki",
+ realPath: "/private/tmp/wiki",
+ readable: true,
+ writable: true,
+ missingDirectories: [],
+ missingFiles: [],
+ healthy: true,
+ problems: [],
+ })],
+ });
+
+ const root = await renderSettings(container);
+
+ expect(container.textContent).toContain("Healthy");
+ expect(container.textContent).toContain("Configured path");
+ expect(container.textContent).toContain("/tmp/wiki");
+ expect(container.textContent).toContain("ReadableYes");
+ expect(container.textContent).toContain("WritableYes");
+ expect(container.textContent).toContain("Present");
+ expect(container.textContent).not.toContain("Validation problems");
+
+ await act(async () => {
+ root.unmount();
+ });
+ });
});
diff --git a/ui/src/pages/PluginSettings.tsx b/ui/src/pages/PluginSettings.tsx
index 955bb62971..996b8f8f6c 100644
--- a/ui/src/pages/PluginSettings.tsx
+++ b/ui/src/pages/PluginSettings.tsx
@@ -1,14 +1,16 @@
import { useCallback, useEffect, useRef, useState } from "react";
import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
-import { Puzzle, ArrowLeft, ShieldAlert, ActivitySquare, CheckCircle, XCircle, Loader2, Clock, Cpu, Webhook, CalendarClock, AlertTriangle } from "lucide-react";
+import { Puzzle, ArrowLeft, ShieldAlert, ActivitySquare, CheckCircle, XCircle, Loader2, Clock, Cpu, Webhook, CalendarClock, AlertTriangle, FolderOpen, Save } from "lucide-react";
+import type { PluginLocalFolderDeclaration } from "@paperclipai/shared";
import { useCompany } from "@/context/CompanyContext";
import { useBreadcrumbs } from "@/context/BreadcrumbContext";
import { Link, Navigate, useParams } from "@/lib/router";
import { PluginSlotMount, usePluginSlots } from "@/plugins/slots";
-import { pluginsApi } from "@/api/plugins";
+import { pluginsApi, type PluginLocalFolderStatus } from "@/api/plugins";
import { queryKeys } from "@/lib/queryKeys";
import { Button } from "@/components/ui/button";
import { Badge } from "@/components/ui/badge";
+import { ChoosePathButton } from "@/components/PathInstructionsModal";
import {
Card,
CardContent,
@@ -143,6 +145,8 @@ export function PluginSettings() {
const pluginDescription = plugin.manifestJson.description || "No description provided.";
const pluginCapabilities = plugin.manifestJson.capabilities ?? [];
const environmentDrivers = plugin.manifestJson.environmentDrivers ?? [];
+ const localFolderDeclarations = plugin.manifestJson.localFolders ?? [];
+ const hasLocalFolders = localFolderDeclarations.length > 0;
const environmentDriverNames = environmentDrivers
.map((driver) => driver.displayName?.trim() || driver.driverKey)
.filter((name, index, values) => values.indexOf(name) === index);
@@ -217,6 +221,13 @@ export function PluginSettings() {
<div className="space-y-1">
<h2 className="text-base font-semibold">Settings</h2>
</div>
+ {hasLocalFolders ? (
+ <PluginLocalFoldersSettings
+ pluginId={pluginId!}
+ companyId={selectedCompanyId}
+ declarations={localFolderDeclarations}
+ />
+ ) : null}
{hasCustomSettingsPage ? (
<div className="space-y-3">
{pluginSlots.map((slot) => (
@@ -253,11 +264,11 @@ export function PluginSettings() {
</Link>
</div>
</div>
- ) : (
+ ) : !hasLocalFolders ? (
<p className="text-sm text-muted-foreground">
This plugin does not require any settings.
</p>
- )}
+ ) : null}
</section>
</div>
</TabsContent>
@@ -558,6 +569,350 @@ export function PluginSettings() {
);
}
+// ---------------------------------------------------------------------------
+// PluginLocalFoldersSettings — host-managed company-scoped folders
+// ---------------------------------------------------------------------------
+
+interface PluginLocalFoldersSettingsProps {
+ pluginId: string;
+ companyId: string | null;
+ declarations: PluginLocalFolderDeclaration[];
+}
+
+function PluginLocalFoldersSettings({ pluginId, companyId, declarations }: PluginLocalFoldersSettingsProps) {
+ const { data, isLoading, error } = useQuery({
+ queryKey: companyId
+ ? queryKeys.plugins.localFolders(pluginId, companyId)
+ : ["plugins", pluginId, "companies", "none", "local-folders"],
+ queryFn: () => pluginsApi.listLocalFolders(pluginId, companyId!),
+ enabled: !!companyId,
+ });
+
+ const statusByKey = new Map((data?.folders ?? []).map((folder) => [folder.folderKey, folder]));
+
+ if (!companyId) {
+ return (
+ <div className="rounded-md border border-border/60 bg-muted/20 px-4 py-3 text-sm text-muted-foreground">
+ Select a company to configure this plugin's local folders.
+ </div>
+ );
+ }
+
+ return (
+ <div className="space-y-3">
+ <div className="flex items-center gap-2">
+ <FolderOpen className="h-4 w-4 text-muted-foreground" />
+ <h3 className="text-sm font-medium">Local folders</h3>
+ </div>
+ {error ? (
+ <div className="rounded-md border border-destructive/20 bg-destructive/10 px-3 py-2 text-sm text-destructive">
+ {(error as Error).message || "Failed to load local folder settings."}
+ </div>
+ ) : null}
+ {isLoading ? (
+ <div className="flex items-center gap-2 py-3 text-sm text-muted-foreground">
+ <Loader2 className="h-4 w-4 animate-spin" />
+ Loading local folders...
+ </div>
+ ) : (
+ <div className="space-y-3">
+ {declarations.map((declaration) => (
+ <PluginLocalFolderRow
+ key={declaration.folderKey}
+ pluginId={pluginId}
+ companyId={companyId}
+ declaration={declaration}
+ status={statusByKey.get(declaration.folderKey)}
+ />
+ ))}
+ </div>
+ )}
+ </div>
+ );
+}
+
+interface PluginLocalFolderRowProps {
+ pluginId: string;
+ companyId: string;
+ declaration: PluginLocalFolderDeclaration;
+ status?: PluginLocalFolderStatus;
+}
+
+function PluginLocalFolderRow({ pluginId, companyId, declaration, status }: PluginLocalFolderRowProps) {
+ const queryClient = useQueryClient();
+ const serverPath = status?.path ?? "";
+ const [pathValue, setPathValue] = useState(serverPath);
+ const [message, setMessage] = useState<{ type: "success" | "error"; text: string } | null>(null);
+
+ useEffect(() => {
+ setPathValue(serverPath);
+ setMessage(null);
+ }, [serverPath, declaration.folderKey]);
+
+ const saveMutation = useMutation({
+ mutationFn: (path: string) =>
+ pluginsApi.configureLocalFolder(pluginId, companyId, declaration.folderKey, {
+ path,
+ access: declaration.access,
+ requiredDirectories: declaration.requiredDirectories,
+ requiredFiles: declaration.requiredFiles,
+ }),
+ onSuccess: (nextStatus) => {
+ setMessage({
+ type: nextStatus.healthy ? "success" : "error",
+ text: nextStatus.healthy
+ ? "Local folder saved."
+ : "Local folder saved, but validation still needs attention.",
+ });
+ queryClient.invalidateQueries({ queryKey: queryKeys.plugins.localFolders(pluginId, companyId) });
+ },
+ onError: (err: Error) => {
+ setMessage({ type: "error", text: err.message || "Failed to save local folder." });
+ },
+ });
+
+ const trimmedPath = pathValue.trim();
+ const isDirty = trimmedPath !== serverPath;
+ const access = status?.access ?? declaration.access ?? "readWrite";
+
+ const handleSave = useCallback(() => {
+ if (!trimmedPath) {
+ setMessage({ type: "error", text: "Local folder path is required." });
+ return;
+ }
+ if (!isLikelyAbsolutePath(trimmedPath)) {
+ setMessage({ type: "error", text: "Local folder must be a full absolute path." });
+ return;
+ }
+ setMessage(null);
+ saveMutation.mutate(trimmedPath);
+ }, [saveMutation, trimmedPath]);
+
+ return (
+ <div className="space-y-4 rounded-md border border-border/70 bg-background px-4 py-4">
+ <div className="flex flex-wrap items-start justify-between gap-3">
+ <div className="min-w-0 space-y-1">
+ <div className="flex flex-wrap items-center gap-2">
+ <h4 className="text-sm font-medium">{declaration.displayName}</h4>
+ <Badge variant="outline" className="font-mono text-[10px]">
+ {declaration.folderKey}
+ </Badge>
+ <Badge variant={status?.healthy ? "default" : "secondary"}>
+ {status?.healthy ? "Healthy" : "Needs attention"}
+ </Badge>
+ </div>
+ {declaration.description ? (
+ <p className="max-w-3xl text-sm leading-5 text-muted-foreground">
+ {declaration.description}
+ </p>
+ ) : null}
+ </div>
+ <Badge variant={access === "readWrite" ? "default" : "outline"}>
+ {access === "readWrite" ? "Read/write" : "Read only"}
+ </Badge>
+ </div>
+
+ <div className="grid gap-3 text-sm sm:grid-cols-3">
+ <FolderStatusMetric label="Configured" value={status?.configured ? "Yes" : "No"} ok={!!status?.configured} />
+ <FolderStatusMetric label="Readable" value={status?.readable ? "Yes" : "No"} ok={!!status?.readable} />
+ <FolderStatusMetric
+ label="Writable"
+ value={access === "read" ? "Not requested" : status?.writable ? "Yes" : "No"}
+ ok={access === "read" || !!status?.writable}
+ />
+ </div>
+
+ {status?.path ? (
+ <div className="space-y-1 text-sm">
+ <div className="text-xs font-medium text-muted-foreground">Configured path</div>
+ <div className="break-all rounded-md bg-muted/60 px-2 py-1.5 font-mono text-xs text-foreground">
+ {status.path}
+ </div>
+ </div>
+ ) : null}
+
+ <div className="space-y-1.5">
+ <label className="text-xs font-medium text-muted-foreground" htmlFor={`local-folder-${declaration.folderKey}`}>
+ Local folder path
+ </label>
+ <div className="flex items-center gap-2">
+ <input
+ id={`local-folder-${declaration.folderKey}`}
+ className="min-w-0 flex-1 rounded-md border border-border bg-background px-2.5 py-1.5 font-mono text-sm outline-none focus:border-foreground/40 focus:ring-2 focus:ring-ring/20"
+ value={pathValue}
+ onChange={(event) => {
+ setPathValue(event.target.value);
+ setMessage(null);
+ }}
+ placeholder="/absolute/path/to/folder"
+ />
+ <ChoosePathButton className="h-8" />
+ <Button
+ size="sm"
+ onClick={handleSave}
+ disabled={saveMutation.isPending || !isDirty}
+ >
+ {saveMutation.isPending ? (
+ <Loader2 className="h-3.5 w-3.5 animate-spin" />
+ ) : (
+ <Save className="h-3.5 w-3.5" />
+ )}
+ Save
+ </Button>
+ </div>
+ </div>
+
+ <FolderRequirements status={status} declaration={declaration} />
+
+ {status?.problems?.length ? (
+ <div className="space-y-2 rounded-md border border-destructive/20 bg-destructive/10 px-3 py-2 text-sm text-destructive">
+ <div className="font-medium">Validation problems</div>
+ <ul className="space-y-1">
+ {status.problems.map((problem, index) => (
+ <li key={`${problem.code}:${problem.path ?? ""}:${index}`}>
+ {problem.message}
+ {problem.path ? <span className="font-mono"> {problem.path}</span> : null}
+ </li>
+ ))}
+ </ul>
+ </div>
+ ) : null}
+
+ {message ? (
+ <div
+ className={`rounded-md border px-3 py-2 text-sm ${
+ message.type === "success"
+ ? "border-green-200 bg-green-50 text-green-700 dark:border-green-900 dark:bg-green-950/30 dark:text-green-400"
+ : "border-destructive/20 bg-destructive/10 text-destructive"
+ }`}
+ >
+ {message.text}
+ </div>
+ ) : null}
+ </div>
+ );
+}
+
+function FolderStatusMetric({ label, value, ok }: { label: string; value: string; ok: boolean }) {
+ return (
+ <div className="flex items-center justify-between rounded-md border border-border/60 px-2.5 py-2">
+ <span className="text-muted-foreground">{label}</span>
+ <Badge variant={ok ? "default" : "secondary"}>{value}</Badge>
+ </div>
+ );
+}
+
+function FolderRequirements({
+ status,
+ declaration,
+}: {
+ status?: PluginLocalFolderStatus;
+ declaration: PluginLocalFolderDeclaration;
+}) {
+ const requiredDirectories = status?.requiredDirectories ?? declaration.requiredDirectories ?? [];
+ const requiredFiles = status?.requiredFiles ?? declaration.requiredFiles ?? [];
+ const missingDirectories = status?.missingDirectories ?? requiredDirectories;
+ const missingFiles = status?.missingFiles ?? requiredFiles;
+ const rootNotInspected = isRootNotInspected(status);
+
+ if (requiredDirectories.length === 0 && requiredFiles.length === 0) return null;
+
+ return (
+ <div className="grid gap-3 text-sm md:grid-cols-2">
+ <RequirementList
+ title="Required directories"
+ items={requiredDirectories}
+ missingItems={missingDirectories}
+ missingLabel="Missing directories"
+ inspectionUnavailable={rootNotInspected}
+ />
+ <RequirementList
+ title="Required files"
+ items={requiredFiles}
+ missingItems={missingFiles}
+ missingLabel="Missing files"
+ inspectionUnavailable={rootNotInspected}
+ />
+ </div>
+ );
+}
+
+function isRootNotInspected(status?: PluginLocalFolderStatus) {
+ if (!status?.configured || status.readable) return false;
+ return status.problems.some((problem) =>
+ problem.code === "missing" || problem.code === "not_readable" || problem.code === "not_directory"
+ );
+}
+
+function RequirementList({
+ title,
+ items,
+ missingItems,
+ missingLabel,
+ inspectionUnavailable,
+}: {
+ title: string;
+ items: string[];
+ missingItems: string[];
+ missingLabel: string;
+ inspectionUnavailable?: boolean;
+}) {
+ return (
+ <div className="space-y-2 rounded-md border border-border/60 px-3 py-2">
+ <div className="flex items-center justify-between gap-2">
+ <span className="text-xs font-medium text-muted-foreground">{title}</span>
+ {inspectionUnavailable ? (
+ <Badge variant="secondary" className="text-[10px]">
+ Not inspected
+ </Badge>
+ ) : missingItems.length > 0 ? (
+ <Badge variant="destructive" className="text-[10px]">
+ {missingItems.length} missing
+ </Badge>
+ ) : (
+ <Badge variant="outline" className="text-[10px]">Present</Badge>
+ )}
+ </div>
+ {items.length > 0 ? (
+ <div className="flex flex-wrap gap-1.5">
+ {items.map((item) => {
+ const missing = missingItems.includes(item);
+ return (
+ <span
+ key={item}
+ className={`rounded border px-1.5 py-0.5 font-mono text-[11px] ${
+ inspectionUnavailable
+ ? "border-amber-300/60 bg-amber-50 text-amber-700 dark:border-amber-800/70 dark:bg-amber-950/30 dark:text-amber-300"
+ : missing
+ ? "border-destructive/30 bg-destructive/10 text-destructive"
+ : "border-border bg-muted/50 text-foreground/80"
+ }`}
+ >
+ {item}
+ </span>
+ );
+ })}
+ </div>
+ ) : (
+ <p className="text-xs text-muted-foreground">None declared.</p>
+ )}
+ {inspectionUnavailable ? (
+ <p className="text-xs text-amber-700 dark:text-amber-300">Configured root was not inspected.</p>
+ ) : missingItems.length > 0 ? (
+ <p className="text-xs text-destructive">{missingLabel}: {missingItems.join(", ")}</p>
+ ) : null}
+ </div>
+ );
+}
+
+function isLikelyAbsolutePath(pathValue: string) {
+ return (
+ pathValue.startsWith("/") ||
+ /^[A-Za-z]:[\\/]/.test(pathValue) ||
+ pathValue.startsWith("\\\\")
+ );
+}
+
// ---------------------------------------------------------------------------
// PluginConfigForm — auto-generated form for instanceConfigSchema
// ---------------------------------------------------------------------------
diff --git a/ui/src/pages/ProjectDetail.test.tsx b/ui/src/pages/ProjectDetail.test.tsx
new file mode 100644
index 0000000000..fce062c2cd
--- /dev/null
+++ b/ui/src/pages/ProjectDetail.test.tsx
@@ -0,0 +1,187 @@
+// @vitest-environment jsdom
+
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import type { Project } from "@paperclipai/shared";
+import { act, type ReactNode } from "react";
+import { createRoot, type Root } from "react-dom/client";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ProjectDetail } from "./ProjectDetail";
+
+(globalThis as typeof globalThis & { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+const mockProjectsApi = vi.hoisted(() => ({
+ get: vi.fn(),
+ list: vi.fn(),
+ update: vi.fn(),
+}));
+const mockIssuesApi = vi.hoisted(() => ({
+ list: vi.fn(),
+ update: vi.fn(),
+}));
+const mockAgentsApi = vi.hoisted(() => ({ list: vi.fn() }));
+const mockHeartbeatsApi = vi.hoisted(() => ({ liveRunsForCompany: vi.fn() }));
+const mockBudgetsApi = vi.hoisted(() => ({ overview: vi.fn(), upsertPolicy: vi.fn() }));
+const mockExecutionWorkspacesApi = vi.hoisted(() => ({ list: vi.fn() }));
+const mockInstanceSettingsApi = vi.hoisted(() => ({ getExperimental: vi.fn() }));
+const mockAssetsApi = vi.hoisted(() => ({ uploadImage: vi.fn() }));
+const mockNavigate = vi.hoisted(() => vi.fn());
+const mockSetBreadcrumbs = vi.hoisted(() => vi.fn());
+const mockIssuesList = vi.hoisted(() => vi.fn());
+
+vi.mock("../api/projects", () => ({ projectsApi: mockProjectsApi }));
+vi.mock("../api/issues", () => ({ issuesApi: mockIssuesApi }));
+vi.mock("../api/agents", () => ({ agentsApi: mockAgentsApi }));
+vi.mock("../api/heartbeats", () => ({ heartbeatsApi: mockHeartbeatsApi }));
+vi.mock("../api/budgets", () => ({ budgetsApi: mockBudgetsApi }));
+vi.mock("../api/execution-workspaces", () => ({ executionWorkspacesApi: mockExecutionWorkspacesApi }));
+vi.mock("../api/instanceSettings", () => ({ instanceSettingsApi: mockInstanceSettingsApi }));
+vi.mock("../api/assets", () => ({ assetsApi: mockAssetsApi }));
+
+vi.mock("@/lib/router", () => ({
+ Link: ({ children, to }: { children?: ReactNode; to: string }) => <a href={to}>{children}</a>,
+ Navigate: ({ to }: { to: string }) => <div data-testid="navigate">{to}</div>,
+ useLocation: () => ({ pathname: "/projects/project-1/plugin-operations", search: "", hash: "", state: null }),
+ useNavigate: () => mockNavigate,
+ useParams: () => ({ projectId: "project-1" }),
+}));
+
+vi.mock("../context/CompanyContext", () => ({
+ useCompany: () => ({
+ companies: [{ id: "company-1", issuePrefix: "PAP" }],
+ selectedCompanyId: "company-1",
+ setSelectedCompanyId: vi.fn(),
+ }),
+}));
+vi.mock("../context/PanelContext", () => ({ usePanel: () => ({ closePanel: vi.fn() }) }));
+vi.mock("../context/ToastContext", () => ({ useToastActions: () => ({ pushToast: vi.fn() }) }));
+vi.mock("../context/BreadcrumbContext", () => ({ useBreadcrumbs: () => ({ setBreadcrumbs: mockSetBreadcrumbs }) }));
+vi.mock("@/plugins/slots", () => ({
+ PluginSlotMount: () => null,
+ PluginSlotOutlet: () => null,
+ usePluginSlots: () => ({ slots: [], isLoading: false }),
+}));
+vi.mock("@/plugins/launchers", () => ({ PluginLauncherOutlet: () => null }));
+vi.mock("../components/ProjectProperties", () => ({
+ ProjectProperties: () => <div data-testid="project-properties" />,
+}));
+vi.mock("../components/BudgetPolicyCard", () => ({
+ BudgetPolicyCard: () => <div data-testid="budget-policy-card" />,
+}));
+vi.mock("../components/InlineEditor", () => ({
+ InlineEditor: ({ value, placeholder }: { value?: string; placeholder?: string }) => (
+ <span>{value || placeholder || null}</span>
+ ),
+}));
+vi.mock("../components/ProjectWorkspacesContent", () => ({
+ ProjectWorkspacesContent: () => <div data-testid="project-workspaces" />,
+}));
+vi.mock("../components/PageTabBar", () => ({
+ PageTabBar: ({ items }: { items: Array<{ value: string; label: string }> }) => (
+ <div>{items.map((item) => <button key={item.value}>{item.label}</button>)}</div>
+ ),
+}));
+vi.mock("../components/IssuesList", () => ({
+ IssuesList: (props: unknown) => {
+ mockIssuesList(props);
+ return <div data-testid="issues-list" />;
+ },
+}));
+
+function project(overrides: Partial<Project> = {}): Project {
+ const now = new Date("2026-05-01T00:00:00Z");
+ return {
+ id: "project-1",
+ companyId: "company-1",
+ urlKey: "project-1",
+ goalId: null,
+ goalIds: [],
+ goals: [],
+ name: "Managed Project",
+ description: null,
+ status: "in_progress",
+ leadAgentId: null,
+ targetDate: null,
+ color: "#14b8a6",
+ env: null,
+ pauseReason: null,
+ pausedAt: null,
+ executionWorkspacePolicy: null,
+ codebase: {
+ workspaceId: null,
+ repoUrl: null,
+ repoRef: null,
+ defaultRef: null,
+ repoName: null,
+ localFolder: null,
+ managedFolder: "/tmp/project-1",
+ effectiveLocalFolder: "/tmp/project-1",
+ origin: "managed_checkout",
+ },
+ workspaces: [],
+ primaryWorkspace: null,
+ managedByPlugin: {
+ id: "managed-1",
+ pluginId: "plugin-1",
+ pluginKey: "paperclip.missions",
+ pluginDisplayName: "Missions",
+ resourceKind: "project",
+ resourceKey: "operations",
+ defaultsJson: {},
+ createdAt: now,
+ updatedAt: now,
+ },
+ archivedAt: null,
+ createdAt: now,
+ updatedAt: now,
+ ...overrides,
+ };
+}
+
+describe("ProjectDetail", () => {
+ let root: Root | null = null;
+ let container: HTMLDivElement;
+
+ beforeEach(() => {
+ container = document.createElement("div");
+ document.body.appendChild(container);
+ mockProjectsApi.get.mockResolvedValue(project());
+ mockProjectsApi.list.mockResolvedValue([project()]);
+ mockIssuesApi.list.mockResolvedValue([]);
+ mockAgentsApi.list.mockResolvedValue([]);
+ mockHeartbeatsApi.liveRunsForCompany.mockResolvedValue([]);
+ mockBudgetsApi.overview.mockResolvedValue({ policies: [] });
+ mockInstanceSettingsApi.getExperimental.mockResolvedValue({ enableIsolatedWorkspaces: false });
+ mockExecutionWorkspacesApi.list.mockResolvedValue([]);
+ });
+
+ afterEach(() => {
+ act(() => root?.unmount());
+ root = null;
+ container.remove();
+ vi.clearAllMocks();
+ });
+
+ it("shows managed plugin affordances and filters the operations tab by plugin origin", async () => {
+ const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } });
+
+ await act(async () => {
+ root = createRoot(container);
+ root.render(
+ <QueryClientProvider client={queryClient}>
+ <ProjectDetail />
+ </QueryClientProvider>,
+ );
+ });
+ await act(async () => {
+ await new Promise((resolve) => setTimeout(resolve, 0));
+ await new Promise((resolve) => setTimeout(resolve, 0));
+ });
+
+ expect(container.textContent).toContain("Managed by Missions");
+ expect(container.textContent).toContain("Plugin operations");
+ expect(mockIssuesApi.list).toHaveBeenCalledWith("company-1", {
+ projectId: "project-1",
+ originKindPrefix: "plugin:paperclip.missions",
+ });
+ });
+});
diff --git a/ui/src/pages/ProjectDetail.tsx b/ui/src/pages/ProjectDetail.tsx
index e49f066839..fb0f053bb4 100644
--- a/ui/src/pages/ProjectDetail.tsx
+++ b/ui/src/pages/ProjectDetail.tsx
@@ -33,7 +33,7 @@ import { PluginSlotMount, PluginSlotOutlet, usePluginSlots } from "@/plugins/slo
/* ── Top-level tab types ── */
-type ProjectBaseTab = "overview" | "list" | "workspaces" | "configuration" | "budget";
+type ProjectBaseTab = "overview" | "list" | "plugin-operations" | "workspaces" | "configuration" | "budget";
type ProjectPluginTab = `plugin:${string}`;
type ProjectTab = ProjectBaseTab | ProjectPluginTab;
@@ -50,6 +50,7 @@ function resolveProjectTab(pathname: string, projectId: string): ProjectTab | nu
if (tab === "configuration") return "configuration";
if (tab === "budget") return "budget";
if (tab === "issues") return "list";
+ if (tab === "plugin-operations") return "plugin-operations";
if (tab === "workspaces") return "workspaces";
return null;
}
@@ -208,6 +209,67 @@ function ProjectIssuesList({ projectId, companyId }: { projectId: string; compan
);
}
+function ProjectPluginOperationsList({
+ projectId,
+ companyId,
+ pluginKey,
+}: {
+ projectId: string;
+ companyId: string;
+ pluginKey: string;
+}) {
+ const queryClient = useQueryClient();
+ const originKindPrefix = `plugin:${pluginKey}`;
+
+ const { data: agents } = useQuery({
+ queryKey: queryKeys.agents.list(companyId),
+ queryFn: () => agentsApi.list(companyId),
+ enabled: !!companyId,
+ });
+ const { data: projects } = useQuery({
+ queryKey: queryKeys.projects.list(companyId),
+ queryFn: () => projectsApi.list(companyId),
+ enabled: !!companyId,
+ });
+ const { data: liveRuns } = useQuery({
+ queryKey: queryKeys.liveRuns(companyId),
+ queryFn: () => heartbeatsApi.liveRunsForCompany(companyId),
+ enabled: !!companyId,
+ refetchInterval: 5000,
+ });
+ const liveIssueIds = useMemo(() => collectLiveIssueIds(liveRuns), [liveRuns]);
+
+ const { data: issues, isLoading, error } = useQuery({
+ queryKey: queryKeys.issues.listPluginOperationsByProject(companyId, projectId, originKindPrefix),
+ queryFn: () => issuesApi.list(companyId, { projectId, originKindPrefix }),
+ enabled: !!companyId && !!projectId,
+ });
+
+ const updateIssue = useMutation({
+ mutationFn: ({ id, data }: { id: string; data: Record<string, unknown> }) =>
+ issuesApi.update(id, data),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: queryKeys.issues.listPluginOperationsByProject(companyId, projectId, originKindPrefix) });
+ queryClient.invalidateQueries({ queryKey: queryKeys.issues.listByProject(companyId, projectId) });
+ queryClient.invalidateQueries({ queryKey: queryKeys.issues.list(companyId) });
+ },
+ });
+
+ return (
+ <IssuesList
+ issues={issues ?? []}
+ isLoading={isLoading}
+ error={error as Error | null}
+ agents={agents}
+ projects={projects}
+ liveIssueIds={liveIssueIds}
+ projectId={projectId}
+ viewStateKey={`paperclip:project-plugin-operations-view:${pluginKey}`}
+ onUpdateIssue={(id, data) => updateIssue.mutate({ id, data })}
+ />
+ );
+}
+
/* ── Main project page ── */
export function ProjectDetail() {
@@ -390,6 +452,10 @@ export function ProjectDetail() {
navigate(`/projects/${canonicalProjectRef}/budget`, { replace: true });
return;
}
+ if (activeTab === "plugin-operations") {
+ navigate(`/projects/${canonicalProjectRef}/plugin-operations`, { replace: true });
+ return;
+ }
if (activeTab === "workspaces") {
navigate(`/projects/${canonicalProjectRef}/workspaces`, { replace: true });
return;
@@ -523,6 +589,9 @@ export function ProjectDetail() {
if (cachedTab === "budget") {
return <Navigate to={`/projects/${canonicalProjectRef}/budget`} replace />;
}
+ if (cachedTab === "plugin-operations" && project?.managedByPlugin) {
+ return <Navigate to={`/projects/${canonicalProjectRef}/plugin-operations`} replace />;
+ }
if (cachedTab === "workspaces" && workspaceTabDecisionLoaded && showWorkspacesTab) {
return <Navigate to={`/projects/${canonicalProjectRef}/workspaces`} replace />;
}
@@ -554,6 +623,8 @@ export function ProjectDetail() {
navigate(`/projects/${canonicalProjectRef}/workspaces`);
} else if (tab === "budget") {
navigate(`/projects/${canonicalProjectRef}/budget`);
+ } else if (tab === "plugin-operations") {
+ navigate(`/projects/${canonicalProjectRef}/plugin-operations`);
} else if (tab === "configuration") {
navigate(`/projects/${canonicalProjectRef}/configuration`);
} else {
@@ -583,6 +654,12 @@ export function ProjectDetail() {
Paused by budget hard stop
</div>
) : null}
+ {project.managedByPlugin ? (
+ <div className="inline-flex items-center gap-2 rounded-full border border-border bg-muted px-3 py-1 text-[11px] font-medium text-muted-foreground">
+ <span className="h-2 w-2 rounded-full" style={{ backgroundColor: project.color ?? "#6366f1" }} />
+ Managed by {project.managedByPlugin.pluginDisplayName}
+ </div>
+ ) : null}
</div>
</div>
@@ -622,6 +699,7 @@ export function ProjectDetail() {
items={[
{ value: "list", label: "Issues" },
{ value: "overview", label: "Overview" },
+ ...(project.managedByPlugin ? [{ value: "plugin-operations", label: "Plugin operations" }] : []),
...(showWorkspacesTab ? [{ value: "workspaces", label: "Workspaces" }] : []),
{ value: "configuration", label: "Configuration" },
{ value: "budget", label: "Budget" },
@@ -651,6 +729,14 @@ export function ProjectDetail() {
<ProjectIssuesList projectId={project.id} companyId={resolvedCompanyId} />
)}
+ {activeTab === "plugin-operations" && project?.id && resolvedCompanyId && project.managedByPlugin && (
+ <ProjectPluginOperationsList
+ projectId={project.id}
+ companyId={resolvedCompanyId}
+ pluginKey={project.managedByPlugin.pluginKey}
+ />
+ )}
+
{activeTab === "workspaces" ? (
workspaceTabDecisionLoaded ? (
workspaceTabError ? (
diff --git a/ui/src/pages/RoutineDetail.tsx b/ui/src/pages/RoutineDetail.tsx
index bb36f1d48e..a2af906ff2 100644
--- a/ui/src/pages/RoutineDetail.tsx
+++ b/ui/src/pages/RoutineDetail.tsx
@@ -702,36 +702,44 @@ export function RoutineDetail() {
<div className="max-w-2xl space-y-6">
{/* Header: editable title + actions */}
<div className="flex items-start gap-4">
- <textarea
- ref={titleInputRef}
- className="flex-1 min-w-0 resize-none overflow-hidden bg-transparent text-xl font-bold outline-none placeholder:text-muted-foreground/50"
- placeholder="Routine title"
- rows={1}
- value={editDraft.title}
- onChange={(event) => {
- setEditDraft((current) => ({ ...current, title: event.target.value }));
- autoResizeTextarea(event.target);
- }}
- onKeyDown={(event) => {
- if (event.key === "Enter" && !event.metaKey && !event.ctrlKey && !event.nativeEvent.isComposing) {
- event.preventDefault();
- descriptionEditorRef.current?.focus();
- return;
- }
- if (event.key === "Tab" && !event.shiftKey) {
- event.preventDefault();
- if (editDraft.assigneeAgentId) {
- if (editDraft.projectId) {
- descriptionEditorRef.current?.focus();
+ <div className="min-w-0 flex-1 space-y-2">
+ <textarea
+ ref={titleInputRef}
+ className="w-full resize-none overflow-hidden bg-transparent text-xl font-bold outline-none placeholder:text-muted-foreground/50"
+ placeholder="Routine title"
+ rows={1}
+ value={editDraft.title}
+ onChange={(event) => {
+ setEditDraft((current) => ({ ...current, title: event.target.value }));
+ autoResizeTextarea(event.target);
+ }}
+ onKeyDown={(event) => {
+ if (event.key === "Enter" && !event.metaKey && !event.ctrlKey && !event.nativeEvent.isComposing) {
+ event.preventDefault();
+ descriptionEditorRef.current?.focus();
+ return;
+ }
+ if (event.key === "Tab" && !event.shiftKey) {
+ event.preventDefault();
+ if (editDraft.assigneeAgentId) {
+ if (editDraft.projectId) {
+ descriptionEditorRef.current?.focus();
+ } else {
+ projectSelectorRef.current?.focus();
+ }
} else {
- projectSelectorRef.current?.focus();
+ assigneeSelectorRef.current?.focus();
}
- } else {
- assigneeSelectorRef.current?.focus();
}
- }
- }}
- />
+ }}
+ />
+ {routine.managedByPlugin ? (
+ <Badge variant="outline" className="gap-1 text-xs text-muted-foreground">
+ Managed by {routine.managedByPlugin.pluginDisplayName}
+ <span className="font-mono text-[10px]">{routine.managedByPlugin.resourceKey}</span>
+ </Badge>
+ ) : null}
+ </div>
<div className="flex shrink-0 items-center gap-3 pt-1">
<RunButton
onClick={() => {
diff --git a/ui/src/pages/Routines.tsx b/ui/src/pages/Routines.tsx
index 72b15b9f8a..a947658fc2 100644
--- a/ui/src/pages/Routines.tsx
+++ b/ui/src/pages/Routines.tsx
@@ -1,7 +1,7 @@
import { startTransition, useEffect, useMemo, useRef, useState } from "react";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { Link, useNavigate, useSearchParams } from "@/lib/router";
-import { ArrowUpDown, Check, ChevronDown, ChevronRight, Layers, MoreHorizontal, Plus, Repeat } from "lucide-react";
+import { ArrowUpDown, Check, ChevronDown, ChevronRight, Layers, Plus, Repeat } from "lucide-react";
import { routinesApi } from "../api/routines";
import { agentsApi } from "../api/agents";
import { projectsApi } from "../api/projects";
@@ -18,7 +18,6 @@ import { createIssueDetailLocationState } from "../lib/issueDetailBreadcrumb";
import { collectLiveIssueIds } from "../lib/liveIssueIds";
import { getRecentAssigneeIds, sortAgentsByRecency, trackRecentAssignee } from "../lib/recent-assignees";
import { getRecentProjectIds, trackRecentProject } from "../lib/recent-projects";
-import { ToggleSwitch } from "@/components/ui/toggle-switch";
import { EmptyState } from "../components/EmptyState";
import { IssuesList } from "../components/IssuesList";
import { PageSkeleton } from "../components/PageSkeleton";
@@ -26,6 +25,7 @@ import { PageTabBar } from "../components/PageTabBar";
import { AgentIcon } from "../components/AgentIconPicker";
import { InlineEntitySelector, type InlineEntityOption } from "../components/InlineEntitySelector";
import { MarkdownEditor, type MarkdownEditorRef, type MentionOption } from "../components/MarkdownEditor";
+import { RoutineListRow, nextRoutineStatus } from "../components/RoutineList";
import {
RoutineRunVariablesDialog,
type RoutineRunDialogSubmitData,
@@ -35,13 +35,6 @@ import { Button } from "@/components/ui/button";
import { Card, CardContent } from "@/components/ui/card";
import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@/components/ui/collapsible";
import { Dialog, DialogContent } from "@/components/ui/dialog";
-import {
- DropdownMenu,
- DropdownMenuContent,
- DropdownMenuItem,
- DropdownMenuSeparator,
- DropdownMenuTrigger,
-} from "@/components/ui/dropdown-menu";
import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover";
import {
Select,
@@ -71,16 +64,6 @@ function autoResizeTextarea(element: HTMLTextAreaElement | null) {
element.style.height = `${element.scrollHeight}px`;
}
-function formatLastRunTimestamp(value: Date | string | null | undefined) {
- if (!value) return "Never";
- return new Date(value).toLocaleString();
-}
-
-function nextRoutineStatus(currentStatus: string, enabled: boolean) {
- if (currentStatus === "archived" && enabled) return "active";
- return enabled ? "active" : "paused";
-}
-
type RoutinesTab = "routines" | "runs";
type RoutineGroupBy = "none" | "project" | "assignee";
type RoutineSortField = "updated" | "created" | "title" | "lastRun";
@@ -130,11 +113,6 @@ function compareNullableText(left: string | null | undefined, right: string | nu
return (left ?? "").localeCompare(right ?? "", undefined, { sensitivity: "base" });
}
-function formatRoutineRunStatus(value: string | null | undefined) {
- if (!value) return null;
- return value.replaceAll("_", " ");
-}
-
function buildRoutineMutationPayload(input: {
title: string;
description: string;
@@ -221,117 +199,6 @@ function buildRoutinesTabHref(tab: RoutinesTab) {
return tab === "runs" ? "/routines?tab=runs" : "/routines";
}
-function RoutineListRow({
- routine,
- projectById,
- agentById,
- runningRoutineId,
- statusMutationRoutineId,
- href,
- onRunNow,
- onToggleEnabled,
- onToggleArchived,
-}: {
- routine: RoutineListItem;
- projectById: Map<string, { name: string; color?: string | null }>;
- agentById: Map<string, { name: string; icon?: string | null }>;
- runningRoutineId: string | null;
- statusMutationRoutineId: string | null;
- href: string;
- onRunNow: (routine: RoutineListItem) => void;
- onToggleEnabled: (routine: RoutineListItem, enabled: boolean) => void;
- onToggleArchived: (routine: RoutineListItem) => void;
-}) {
- const enabled = routine.status === "active";
- const isArchived = routine.status === "archived";
- const isStatusPending = statusMutationRoutineId === routine.id;
- const project = routine.projectId ? projectById.get(routine.projectId) ?? null : null;
- const agent = routine.assigneeAgentId ? agentById.get(routine.assigneeAgentId) ?? null : null;
- const isDraft = !isArchived && !routine.assigneeAgentId;
-
- return (
- <Link
- to={href}
- className="group flex flex-col gap-3 border-b border-border px-3 py-3 transition-colors hover:bg-accent/50 last:border-b-0 sm:flex-row sm:items-center no-underline text-inherit"
- >
- <div className="min-w-0 flex-1 space-y-1.5">
- <div className="flex flex-wrap items-center gap-2">
- <span className="truncate text-sm font-medium">{routine.title}</span>
- {(isArchived || routine.status === "paused" || isDraft) ? (
- <span className="text-xs text-muted-foreground">
- {isArchived ? "archived" : isDraft ? "draft" : "paused"}
- </span>
- ) : null}
- </div>
- <div className="flex flex-wrap items-center gap-x-4 gap-y-1 text-xs text-muted-foreground">
- <span className="flex items-center gap-2">
- <span
- className="h-2.5 w-2.5 shrink-0 rounded-sm"
- style={{ backgroundColor: project?.color ?? "#64748b" }}
- />
- <span>{routine.projectId ? (project?.name ?? "Unknown project") : "No project"}</span>
- </span>
- <span className="flex items-center gap-2">
- {agent?.icon ? <AgentIcon icon={agent.icon} className="h-3.5 w-3.5 shrink-0" /> : null}
- <span>{routine.assigneeAgentId ? (agent?.name ?? "Unknown agent") : "No default agent"}</span>
- </span>
- <span>
- {formatLastRunTimestamp(routine.lastRun?.triggeredAt)}
- {routine.lastRun ? ` · ${formatRoutineRunStatus(routine.lastRun.status)}` : ""}
- </span>
- </div>
- </div>
-
- <div className="flex items-center gap-3" onClick={(event) => { event.preventDefault(); event.stopPropagation(); }}>
- <div className="flex items-center gap-3">
- <ToggleSwitch
- size="lg"
- checked={enabled}
- onCheckedChange={() => onToggleEnabled(routine, enabled)}
- disabled={isStatusPending || isArchived}
- aria-label={enabled ? `Disable ${routine.title}` : `Enable ${routine.title}`}
- />
- <span className="w-12 text-xs text-muted-foreground">
- {isArchived ? "Archived" : isDraft ? "Draft" : enabled ? "On" : "Off"}
- </span>
- </div>
-
- <DropdownMenu>
- <DropdownMenuTrigger asChild>
- <Button variant="ghost" size="icon-sm" aria-label={`More actions for ${routine.title}`}>
- <MoreHorizontal className="h-4 w-4" />
- </Button>
- </DropdownMenuTrigger>
- <DropdownMenuContent align="end">
- <DropdownMenuItem asChild>
- <Link to={href}>Edit</Link>
- </DropdownMenuItem>
- <DropdownMenuItem
- disabled={runningRoutineId === routine.id || isArchived}
- onClick={() => onRunNow(routine)}
- >
- {runningRoutineId === routine.id ? "Running..." : "Run now"}
- </DropdownMenuItem>
- <DropdownMenuSeparator />
- <DropdownMenuItem
- onClick={() => onToggleEnabled(routine, enabled)}
- disabled={isStatusPending || isArchived}
- >
- {enabled ? "Pause" : "Enable"}
- </DropdownMenuItem>
- <DropdownMenuItem
- onClick={() => onToggleArchived(routine)}
- disabled={isStatusPending}
- >
- {routine.status === "archived" ? "Restore" : "Archive"}
- </DropdownMenuItem>
- </DropdownMenuContent>
- </DropdownMenu>
- </div>
- </Link>
- );
-}
-
export function Routines() {
const { selectedCompanyId } = useCompany();
const { setBreadcrumbs } = useBreadcrumbs();
diff --git a/ui/src/plugins/bridge-init.ts b/ui/src/plugins/bridge-init.ts
index 4623f88db2..2019830b70 100644
--- a/ui/src/plugins/bridge-init.ts
+++ b/ui/src/plugins/bridge-init.ts
@@ -16,9 +16,47 @@ import {
usePluginData,
usePluginAction,
useHostContext,
+ useHostLocation,
+ useHostNavigation,
usePluginStream,
usePluginToast,
} from "./bridge.js";
+import { createElement, useEffect, useMemo, useState, type ComponentType, type ReactNode } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { User } from "lucide-react";
+import {
+ FileTree,
+ type FileTreeProps as HostFileTreeProps,
+} from "@/components/FileTree";
+import { AgentIcon } from "@/components/AgentIconPicker";
+import { InlineEntitySelector, type InlineEntityOption } from "@/components/InlineEntitySelector";
+import { IssuesList as HostIssuesList } from "@/components/IssuesList";
+import { ManagedRoutinesList as HostManagedRoutinesList } from "@/components/ManagedRoutinesList";
+import { MarkdownBody } from "@/components/MarkdownBody";
+import { accessApi } from "@/api/access";
+import { agentsApi } from "@/api/agents";
+import { authApi } from "@/api/auth";
+import { heartbeatsApi } from "@/api/heartbeats";
+import { issuesApi } from "@/api/issues";
+import { projectsApi } from "@/api/projects";
+import {
+ buildCompanyUserInlineOptions,
+} from "@/lib/company-members";
+import { collectLiveIssueIds } from "@/lib/liveIssueIds";
+import { useProjectOrder } from "@/hooks/useProjectOrder";
+import {
+ assigneeValueFromSelection,
+ currentUserAssigneeOption,
+ parseAssigneeValue,
+} from "@/lib/assignees";
+import { queryKeys } from "@/lib/queryKeys";
+import {
+ getRecentAssigneeSelectionIds,
+ sortAgentsByRecency,
+ trackRecentAssignee,
+ trackRecentAssigneeUser,
+} from "@/lib/recent-assignees";
+import { getRecentProjectIds, trackRecentProject } from "@/lib/recent-projects";
// ---------------------------------------------------------------------------
// Global bridge registry
@@ -41,6 +79,451 @@ declare global {
var __paperclipPluginBridge__: PluginBridgeRegistry | undefined;
}
+type PluginFileTreePathCollection = ReadonlySet<string> | readonly string[];
+
+type PluginFileTreeProps = Omit<
+ HostFileTreeProps,
+ | "expandedDirs"
+ | "checkedFiles"
+ | "renderFileExtra"
+ | "fileRowClassName"
+ | "selectedFile"
+ | "showCheckboxes"
+ | "onToggleDir"
+ | "onSelectFile"
+> & {
+ selectedFile?: string | null;
+ expandedPaths?: PluginFileTreePathCollection;
+ checkedPaths?: PluginFileTreePathCollection;
+ showCheckboxes?: boolean;
+ onToggleDir?: (path: string) => void;
+ onSelectFile?: (path: string) => void;
+};
+
+function toPathSet(paths?: PluginFileTreePathCollection | null): Set<string> {
+ return new Set(paths ?? []);
+}
+
+function PluginSdkFileTree({
+ expandedPaths,
+ checkedPaths,
+ selectedFile = null,
+ showCheckboxes = false,
+ onToggleDir,
+ onSelectFile,
+ ...props
+}: PluginFileTreeProps) {
+ return createElement(FileTree, {
+ ...props,
+ selectedFile,
+ expandedDirs: toPathSet(expandedPaths),
+ checkedFiles: checkedPaths ? toPathSet(checkedPaths) : undefined,
+ showCheckboxes,
+ onToggleDir: onToggleDir ?? (() => undefined),
+ onSelectFile: onSelectFile ?? (() => undefined),
+ });
+}
+
+type PluginMarkdownBlockProps = {
+ content: string;
+ className?: string;
+ enableWikiLinks?: boolean;
+ wikiLinkRoot?: string;
+ resolveWikiLinkHref?: (target: string, label: string) => string | null | undefined;
+};
+
+type PluginMarkdownEditorProps = {
+ value: string;
+ onChange: (value: string) => void;
+ placeholder?: string;
+ className?: string;
+ contentClassName?: string;
+ onBlur?: () => void;
+ bordered?: boolean;
+ readOnly?: boolean;
+ onSubmit?: () => void;
+};
+
+type PluginIssuesListFilters = {
+ status?: string;
+ projectId?: string;
+ parentId?: string;
+ assigneeAgentId?: string;
+ participantAgentId?: string;
+ assigneeUserId?: string;
+ labelId?: string;
+ workspaceId?: string;
+ executionWorkspaceId?: string;
+ originKind?: string;
+ originKindPrefix?: string;
+ originId?: string;
+ descendantOf?: string;
+ includeRoutineExecutions?: boolean;
+};
+
+type PluginIssuesListProps = {
+ companyId: string | null;
+ projectId?: string | null;
+ filters?: PluginIssuesListFilters;
+ viewStateKey?: string;
+ initialSearch?: string;
+ createIssueLabel?: string;
+ searchWithinLoadedIssues?: boolean;
+};
+
+type PluginAssigneePickerSelection = {
+ assigneeAgentId: string | null;
+ assigneeUserId: string | null;
+};
+
+type PluginAssigneePickerProps = {
+ companyId?: string | null;
+ value: string;
+ onChange: (value: string, selection: PluginAssigneePickerSelection) => void;
+ placeholder?: string;
+ noneLabel?: string;
+ searchPlaceholder?: string;
+ emptyMessage?: string;
+ includeUsers?: boolean;
+ includeTerminatedAgents?: boolean;
+ className?: string;
+ onConfirm?: () => void;
+};
+
+type PluginProjectPickerProps = {
+ companyId?: string | null;
+ value: string;
+ onChange: (projectId: string) => void;
+ placeholder?: string;
+ noneLabel?: string;
+ searchPlaceholder?: string;
+ emptyMessage?: string;
+ includeArchived?: boolean;
+ className?: string;
+ onConfirm?: () => void;
+};
+
+function PluginSdkMarkdownEditor(props: PluginMarkdownEditorProps) {
+ const [Editor, setEditor] = useState<ComponentType<PluginMarkdownEditorProps> | null>(null);
+
+ useEffect(() => {
+ let cancelled = false;
+ import("@/components/MarkdownEditor").then((module) => {
+ if (!cancelled) setEditor(() => module.MarkdownEditor as ComponentType<PluginMarkdownEditorProps>);
+ });
+ return () => {
+ cancelled = true;
+ };
+ }, []);
+
+ if (Editor) return createElement(Editor, props);
+
+ return createElement("textarea", {
+ className: props.className,
+ value: props.value,
+ placeholder: props.placeholder,
+ readOnly: props.readOnly,
+ onBlur: props.onBlur,
+ onChange: (event) => props.onChange((event.currentTarget as HTMLTextAreaElement).value),
+ });
+}
+
+function compactIssueFilters(filters: PluginIssuesListFilters): PluginIssuesListFilters {
+ return Object.fromEntries(
+ Object.entries(filters).filter(([, value]) =>
+ value !== undefined && value !== null && value !== "" && value !== false,
+ ),
+ ) as PluginIssuesListFilters;
+}
+
+function PluginSdkIssuesList({
+ companyId,
+ projectId = null,
+ filters,
+ viewStateKey = "paperclip:plugin-issues-view",
+ initialSearch,
+ createIssueLabel,
+ searchWithinLoadedIssues = true,
+}: PluginIssuesListProps) {
+ const queryClient = useQueryClient();
+ const issueFilters = useMemo(
+ () => compactIssueFilters({
+ ...(filters ?? {}),
+ projectId: filters?.projectId ?? projectId ?? undefined,
+ }),
+ [filters, projectId],
+ );
+ const originKindPrefix = issueFilters.originKindPrefix ?? null;
+ const resolvedProjectId = issueFilters.projectId ?? projectId ?? null;
+ const issuesQueryKey = useMemo(
+ () => ["plugins", "sdk-ui", "issues-list", companyId ?? "__no-company__", issueFilters] as const,
+ [companyId, issueFilters],
+ );
+
+ const { data: agents } = useQuery({
+ queryKey: queryKeys.agents.list(companyId ?? "__no-company__"),
+ queryFn: () => agentsApi.list(companyId!),
+ enabled: !!companyId,
+ });
+ const { data: projects } = useQuery({
+ queryKey: queryKeys.projects.list(companyId ?? "__no-company__"),
+ queryFn: () => projectsApi.list(companyId!),
+ enabled: !!companyId,
+ });
+ const { data: liveRuns } = useQuery({
+ queryKey: queryKeys.liveRuns(companyId ?? "__no-company__"),
+ queryFn: () => heartbeatsApi.liveRunsForCompany(companyId!),
+ enabled: !!companyId,
+ refetchInterval: 5000,
+ });
+ const liveIssueIds = useMemo(() => collectLiveIssueIds(liveRuns), [liveRuns]);
+
+ const { data: issues, isLoading, error } = useQuery({
+ queryKey: issuesQueryKey,
+ queryFn: () => issuesApi.list(companyId!, issueFilters),
+ enabled: !!companyId,
+ });
+
+ const updateIssue = useMutation({
+ mutationFn: ({ id, data }: { id: string; data: Record<string, unknown> }) =>
+ issuesApi.update(id, data),
+ onSuccess: () => {
+ if (!companyId) return;
+ queryClient.invalidateQueries({ queryKey: ["plugins", "sdk-ui", "issues-list", companyId] });
+ queryClient.invalidateQueries({ queryKey: queryKeys.issues.list(companyId) });
+ if (resolvedProjectId) {
+ queryClient.invalidateQueries({ queryKey: queryKeys.issues.listByProject(companyId, resolvedProjectId) });
+ if (originKindPrefix) {
+ queryClient.invalidateQueries({
+ queryKey: queryKeys.issues.listPluginOperationsByProject(companyId, resolvedProjectId, originKindPrefix),
+ });
+ }
+ }
+ },
+ });
+
+ if (!companyId) {
+ return createElement("div", { className: "text-sm text-muted-foreground" }, "Select a company to view issues.");
+ }
+
+ return createElement(HostIssuesList, {
+ issues: issues ?? [],
+ isLoading,
+ error: error as Error | null,
+ agents,
+ projects,
+ liveIssueIds,
+ projectId: resolvedProjectId ?? undefined,
+ viewStateKey,
+ initialSearch,
+ createIssueLabel,
+ searchWithinLoadedIssues,
+ onUpdateIssue: (id: string, data: Record<string, unknown>) => updateIssue.mutate({ id, data }),
+ });
+}
+
+function PluginSdkAssigneePicker({
+ companyId,
+ value,
+ onChange,
+ placeholder = "Assignee",
+ noneLabel = "No assignee",
+ searchPlaceholder = "Search assignees...",
+ emptyMessage = "No assignees found.",
+ includeUsers = true,
+ includeTerminatedAgents = false,
+ className,
+ onConfirm,
+}: PluginAssigneePickerProps) {
+ const hostContext = useHostContext();
+ const resolvedCompanyId = companyId ?? hostContext.companyId ?? null;
+ const { data: session } = useQuery({
+ queryKey: queryKeys.auth.session,
+ queryFn: () => authApi.getSession(),
+ enabled: includeUsers,
+ });
+ const currentUserId = session?.user?.id ?? session?.session?.userId ?? null;
+ const { data: agents } = useQuery({
+ queryKey: queryKeys.agents.list(resolvedCompanyId ?? "__no-company__"),
+ queryFn: () => agentsApi.list(resolvedCompanyId!),
+ enabled: !!resolvedCompanyId,
+ });
+ const { data: companyMembers } = useQuery({
+ queryKey: queryKeys.access.companyUserDirectory(resolvedCompanyId ?? "__no-company__"),
+ queryFn: () => accessApi.listUserDirectory(resolvedCompanyId!),
+ enabled: !!resolvedCompanyId && includeUsers,
+ });
+ const recentAssigneeSelectionIds = useMemo(() => getRecentAssigneeSelectionIds(), []);
+ const recentAssigneeIds = useMemo(
+ () => recentAssigneeSelectionIds
+ .map((id) => id.startsWith("agent:") ? id.slice("agent:".length) : null)
+ .filter((id): id is string => Boolean(id)),
+ [recentAssigneeSelectionIds],
+ );
+ const sortedAgents = useMemo(
+ () => sortAgentsByRecency(
+ (agents ?? []).filter((agent) => includeTerminatedAgents || agent.status !== "terminated"),
+ recentAssigneeIds,
+ ),
+ [agents, includeTerminatedAgents, recentAssigneeIds],
+ );
+ const options = useMemo<InlineEntityOption[]>(
+ () => [
+ ...(includeUsers ? currentUserAssigneeOption(currentUserId) : []),
+ ...(includeUsers
+ ? buildCompanyUserInlineOptions(companyMembers?.users, { excludeUserIds: [currentUserId] })
+ : []),
+ ...sortedAgents.map((agent) => ({
+ id: assigneeValueFromSelection({ assigneeAgentId: agent.id }),
+ label: agent.name,
+ searchText: `${agent.name} ${agent.role} ${agent.title ?? ""}`,
+ })),
+ ],
+ [companyMembers?.users, currentUserId, includeUsers, sortedAgents],
+ );
+ const selectedAssignee = parseAssigneeValue(value);
+ const selectedAgent = selectedAssignee.assigneeAgentId
+ ? sortedAgents.find((agent) => agent.id === selectedAssignee.assigneeAgentId)
+ : null;
+
+ return createElement(InlineEntitySelector, {
+ value,
+ options,
+ recentOptionIds: recentAssigneeSelectionIds,
+ placeholder,
+ noneLabel,
+ searchPlaceholder,
+ emptyMessage,
+ className,
+ onConfirm,
+ onChange: (nextValue: string) => {
+ const selection = parseAssigneeValue(nextValue);
+ if (selection.assigneeAgentId) trackRecentAssignee(selection.assigneeAgentId);
+ if (selection.assigneeUserId) trackRecentAssigneeUser(selection.assigneeUserId);
+ onChange(nextValue, selection);
+ },
+ renderTriggerValue: (option: InlineEntityOption | null) => {
+ if (!option) return createElement("span", { className: "text-muted-foreground" }, placeholder);
+ if (selectedAgent) {
+ return createElement(
+ FragmentSafe,
+ null,
+ createElement(AgentIcon, { icon: selectedAgent.icon, className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+ createElement("span", { className: "truncate" }, option.label),
+ );
+ }
+ return createElement("span", { className: "truncate" }, option.label);
+ },
+ renderOption: (option: InlineEntityOption) => {
+ if (!option.id) return createElement("span", { className: "truncate" }, option.label);
+ const selection = parseAssigneeValue(option.id);
+ const agent = selection.assigneeAgentId
+ ? sortedAgents.find((entry) => entry.id === selection.assigneeAgentId)
+ : null;
+ return createElement(
+ FragmentSafe,
+ null,
+ agent
+ ? createElement(AgentIcon, { icon: agent.icon, className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" })
+ : createElement(User, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }),
+ createElement("span", { className: "truncate" }, option.label),
+ );
+ },
+ });
+}
+
+function PluginSdkProjectPicker({
+ companyId,
+ value,
+ onChange,
+ placeholder = "Project",
+ noneLabel = "No project",
+ searchPlaceholder = "Search projects...",
+ emptyMessage = "No projects found.",
+ includeArchived = false,
+ className,
+ onConfirm,
+}: PluginProjectPickerProps) {
+ const hostContext = useHostContext();
+ const resolvedCompanyId = companyId ?? hostContext.companyId ?? null;
+ const { data: session } = useQuery({
+ queryKey: queryKeys.auth.session,
+ queryFn: () => authApi.getSession(),
+ });
+ const currentUserId = session?.user?.id ?? session?.session?.userId ?? null;
+ const { data: projects } = useQuery({
+ queryKey: queryKeys.projects.list(resolvedCompanyId ?? "__no-company__"),
+ queryFn: () => projectsApi.list(resolvedCompanyId!),
+ enabled: !!resolvedCompanyId,
+ });
+ const visibleProjects = useMemo(
+ () => (projects ?? []).filter((project) => includeArchived || !project.archivedAt),
+ [includeArchived, projects],
+ );
+ const { orderedProjects } = useProjectOrder({
+ projects: visibleProjects,
+ companyId: resolvedCompanyId,
+ userId: currentUserId,
+ });
+ const recentProjectIds = useMemo(() => getRecentProjectIds(), []);
+ const options = useMemo<InlineEntityOption[]>(
+ () => orderedProjects.map((project) => ({
+ id: project.id,
+ label: project.name,
+ searchText: project.description ?? "",
+ })),
+ [orderedProjects],
+ );
+ const selectedProject = orderedProjects.find((project) => project.id === value) ?? null;
+
+ return createElement(InlineEntitySelector, {
+ value,
+ options,
+ recentOptionIds: recentProjectIds,
+ placeholder,
+ noneLabel,
+ searchPlaceholder,
+ emptyMessage,
+ className,
+ onConfirm,
+ onChange: (nextProjectId: string) => {
+ if (nextProjectId) trackRecentProject(nextProjectId);
+ onChange(nextProjectId);
+ },
+ renderTriggerValue: (option: InlineEntityOption | null) => {
+ if (!option || !selectedProject) {
+ return createElement("span", { className: "text-muted-foreground" }, placeholder);
+ }
+ return createElement(
+ FragmentSafe,
+ null,
+ createElement("span", {
+ className: "h-3.5 w-3.5 shrink-0 rounded-sm",
+ style: { backgroundColor: selectedProject.color ?? "#6366f1" },
+ }),
+ createElement("span", { className: "truncate" }, option.label),
+ );
+ },
+ renderOption: (option: InlineEntityOption) => {
+ if (!option.id) return createElement("span", { className: "truncate" }, option.label);
+ const project = orderedProjects.find((entry) => entry.id === option.id);
+ return createElement(
+ FragmentSafe,
+ null,
+ createElement("span", {
+ className: "h-3.5 w-3.5 shrink-0 rounded-sm",
+ style: { backgroundColor: project?.color ?? "#6366f1" },
+ }),
+ createElement("span", { className: "truncate" }, option.label),
+ );
+ },
+ });
+}
+
+function FragmentSafe({ children }: { children?: ReactNode }) {
+ return createElement("span", { className: "contents" }, children);
+}
+
/**
* Initialize the plugin bridge global registry.
*
@@ -62,8 +545,31 @@ export function initPluginBridge(
usePluginData,
usePluginAction,
useHostContext,
+ useHostLocation,
+ useHostNavigation,
usePluginStream,
usePluginToast,
+ MarkdownBlock: ({
+ content,
+ className,
+ enableWikiLinks,
+ wikiLinkRoot,
+ resolveWikiLinkHref,
+ }: PluginMarkdownBlockProps) =>
+ createElement(MarkdownBody, {
+ className,
+ softBreaks: false,
+ enableWikiLinks,
+ wikiLinkRoot,
+ resolveWikiLinkHref,
+ children: content,
+ }),
+ MarkdownEditor: PluginSdkMarkdownEditor,
+ FileTree: PluginSdkFileTree,
+ IssuesList: PluginSdkIssuesList,
+ AssigneePicker: PluginSdkAssigneePicker,
+ ProjectPicker: PluginSdkProjectPicker,
+ ManagedRoutinesList: HostManagedRoutinesList,
},
};
}
diff --git a/ui/src/plugins/bridge.test.ts b/ui/src/plugins/bridge.test.ts
new file mode 100644
index 0000000000..543cbcc91d
--- /dev/null
+++ b/ui/src/plugins/bridge.test.ts
@@ -0,0 +1,306 @@
+// @vitest-environment jsdom
+import * as React from "react";
+import * as ReactDOM from "react-dom";
+import { act } from "react";
+import { createRoot } from "react-dom/client";
+import type { MouseEvent as ReactMouseEvent } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+import { MemoryRouter } from "react-router-dom";
+import { afterEach, describe, expect, it } from "vitest";
+import {
+ FileTree as SdkFileTree,
+ ManagedRoutinesList as SdkManagedRoutinesList,
+ MarkdownBlock as SdkMarkdownBlock,
+ MarkdownEditor as SdkMarkdownEditor,
+ type FileTreeNode as SdkFileTreeNode,
+} from "../../../packages/plugins/sdk/src/ui/components";
+import { SidebarProvider, useSidebar } from "@/context/SidebarContext";
+import {
+ PluginBridgeContext,
+ resolveHostNavigationHref,
+ shouldHandleHostNavigationClick,
+ useHostNavigation,
+ type PluginBridgeContextValue,
+} from "./bridge";
+import { initPluginBridge } from "./bridge-init";
+
+function clickEvent(
+ overrides: Partial<ReactMouseEvent<HTMLAnchorElement>> = {},
+): ReactMouseEvent<HTMLAnchorElement> {
+ return {
+ defaultPrevented: false,
+ button: 0,
+ metaKey: false,
+ altKey: false,
+ ctrlKey: false,
+ shiftKey: false,
+ currentTarget: {
+ hasAttribute: () => false,
+ },
+ ...overrides,
+ } as ReactMouseEvent<HTMLAnchorElement>;
+}
+
+afterEach(() => {
+ delete globalThis.__paperclipPluginBridge__;
+});
+
+describe("plugin host navigation", () => {
+ it("resolves plugin page routes into the active company prefix", () => {
+ expect(resolveHostNavigationHref("/wiki", "PAP")).toBe("/PAP/wiki");
+ expect(resolveHostNavigationHref("/wiki?tab=browse#page", "pap")).toBe(
+ "/PAP/wiki?tab=browse#page",
+ );
+ });
+
+ it("does not double-prefix active company paths or global host paths", () => {
+ expect(resolveHostNavigationHref("/PAP/wiki", "PAP")).toBe("/PAP/wiki");
+ expect(resolveHostNavigationHref("/pap/wiki", "PAP")).toBe("/pap/wiki");
+ expect(resolveHostNavigationHref("/instance/settings/plugins", "PAP")).toBe(
+ "/instance/settings/plugins",
+ );
+ });
+
+ it("intercepts only same-origin plain left-click navigation", () => {
+ expect(shouldHandleHostNavigationClick(clickEvent(), "/PAP/wiki")).toBe(true);
+ expect(
+ shouldHandleHostNavigationClick(clickEvent({ ctrlKey: true }), "/PAP/wiki"),
+ ).toBe(false);
+ expect(
+ shouldHandleHostNavigationClick(clickEvent(), "/PAP/wiki", "_blank"),
+ ).toBe(false);
+ expect(
+ shouldHandleHostNavigationClick(clickEvent(), "https://example.com/wiki"),
+ ).toBe(false);
+ });
+});
+
+describe("useHostNavigation mobile drawer behavior", () => {
+ // React 19's `act` requires the env flag and React DOM client.
+ (globalThis as unknown as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+ function makeBridgeValue(): PluginBridgeContextValue {
+ return {
+ pluginId: "test-plugin",
+ hostContext: {
+ companyId: "co",
+ companyPrefix: "PAP",
+ projectId: null,
+ entityId: null,
+ entityType: null,
+ userId: null,
+ },
+ };
+ }
+
+ function setViewport(width: number) {
+ Object.defineProperty(window, "innerWidth", {
+ configurable: true,
+ writable: true,
+ value: width,
+ });
+ if (typeof window.matchMedia !== "function") {
+ Object.defineProperty(window, "matchMedia", {
+ configurable: true,
+ writable: true,
+ value: (query: string) => ({
+ matches: /max-width:\s*767px/.test(query) ? width < 768 : false,
+ media: query,
+ onchange: null,
+ addEventListener: () => undefined,
+ removeEventListener: () => undefined,
+ addListener: () => undefined,
+ removeListener: () => undefined,
+ dispatchEvent: () => false,
+ }),
+ });
+ }
+ }
+
+ it("closes the sidebar drawer on mobile after a same-origin navigate()", () => {
+ setViewport(390);
+
+ let nav: ReturnType<typeof useHostNavigation> | null = null;
+ let sidebar: ReturnType<typeof useSidebar> | null = null;
+ function Probe() {
+ nav = useHostNavigation();
+ sidebar = useSidebar();
+ return null;
+ }
+
+ const container = document.createElement("div");
+ document.body.appendChild(container);
+ const root = createRoot(container);
+
+ act(() => {
+ root.render(
+ React.createElement(
+ MemoryRouter,
+ { initialEntries: ["/PAP/wiki"] },
+ React.createElement(
+ SidebarProvider,
+ null,
+ React.createElement(
+ PluginBridgeContext.Provider,
+ { value: makeBridgeValue() },
+ React.createElement(Probe),
+ ),
+ ),
+ ),
+ );
+ });
+
+ expect(sidebar!.isMobile).toBe(true);
+ act(() => sidebar!.setSidebarOpen(true));
+ expect(sidebar!.sidebarOpen).toBe(true);
+
+ act(() => nav!.navigate("/wiki?section=ingest"));
+ expect(sidebar!.sidebarOpen).toBe(false);
+
+ act(() => root.unmount());
+ container.remove();
+ });
+
+ it("leaves the sidebar open on desktop after navigate()", () => {
+ setViewport(1280);
+
+ let nav: ReturnType<typeof useHostNavigation> | null = null;
+ let sidebar: ReturnType<typeof useSidebar> | null = null;
+ function Probe() {
+ nav = useHostNavigation();
+ sidebar = useSidebar();
+ return null;
+ }
+
+ const container = document.createElement("div");
+ document.body.appendChild(container);
+ const root = createRoot(container);
+
+ act(() => {
+ root.render(
+ React.createElement(
+ MemoryRouter,
+ { initialEntries: ["/PAP/wiki"] },
+ React.createElement(
+ SidebarProvider,
+ null,
+ React.createElement(
+ PluginBridgeContext.Provider,
+ { value: makeBridgeValue() },
+ React.createElement(Probe),
+ ),
+ ),
+ ),
+ );
+ });
+
+ expect(sidebar!.isMobile).toBe(false);
+ expect(sidebar!.sidebarOpen).toBe(true);
+
+ act(() => nav!.navigate("/wiki?section=ingest"));
+ expect(sidebar!.sidebarOpen).toBe(true);
+
+ act(() => root.unmount());
+ container.remove();
+ });
+});
+
+describe("plugin SDK FileTree bridge", () => {
+ const nodes: SdkFileTreeNode[] = [
+ {
+ name: "wiki",
+ path: "wiki",
+ kind: "dir",
+ children: [
+ {
+ name: "index.md",
+ path: "wiki/index.md",
+ kind: "file",
+ children: [],
+ },
+ ],
+ },
+ ];
+
+ it("injects the host FileTree implementation through the bridge runtime", () => {
+ initPluginBridge(React, ReactDOM);
+
+ const html = renderToStaticMarkup(
+ React.createElement(SdkFileTree, {
+ nodes,
+ expandedPaths: ["wiki"],
+ selectedFile: "wiki/index.md",
+ onToggleDir: () => undefined,
+ onSelectFile: () => undefined,
+ }),
+ );
+
+ expect(html).toContain('role="tree"');
+ expect(html).toContain("wiki");
+ expect(html).toContain("index.md");
+ });
+
+ it("throws a clear error when the host FileTree implementation is missing", () => {
+ globalThis.__paperclipPluginBridge__ = {
+ react: React,
+ reactDom: ReactDOM,
+ sdkUi: {},
+ };
+
+ expect(() =>
+ renderToStaticMarkup(
+ React.createElement(SdkFileTree, {
+ nodes,
+ expandedPaths: ["wiki"],
+ onToggleDir: () => undefined,
+ onSelectFile: () => undefined,
+ }),
+ ),
+ ).toThrow('Paperclip plugin UI runtime is not initialized for "FileTree"');
+ });
+});
+
+describe("plugin SDK markdown component bridge", () => {
+ it("injects markdown display and editor components through the bridge runtime", () => {
+ initPluginBridge(React, ReactDOM);
+
+ const registry = globalThis.__paperclipPluginBridge__?.sdkUi ?? {};
+ expect(registry.MarkdownBlock).toBeTypeOf("function");
+ expect(registry.MarkdownEditor).toBeTypeOf("function");
+ expect(registry.IssuesList).toBeTypeOf("function");
+ expect(registry.AssigneePicker).toBeTypeOf("function");
+ expect(registry.ProjectPicker).toBeTypeOf("function");
+ expect(registry.ManagedRoutinesList).toBeTypeOf("function");
+ });
+
+ it("renders plugin-provided markdown components when registered by the host", () => {
+ globalThis.__paperclipPluginBridge__ = {
+ react: React,
+ reactDom: ReactDOM,
+ sdkUi: {
+ MarkdownBlock: ({ content, enableWikiLinks, wikiLinkRoot }: { content: string; enableWikiLinks?: boolean; wikiLinkRoot?: string }) =>
+ React.createElement("article", {
+ "data-wiki-links": enableWikiLinks ? "true" : "false",
+ "data-wiki-root": wikiLinkRoot,
+ }, content),
+ MarkdownEditor: ({ value }: { value: string }) =>
+ React.createElement("textarea", { value, readOnly: true }),
+ ManagedRoutinesList: ({ routines }: { routines: Array<{ title: string }> }) =>
+ React.createElement("section", null, routines.map((routine) => routine.title).join(", ")),
+ },
+ };
+
+ const markdownHtml = renderToStaticMarkup(React.createElement(SdkMarkdownBlock, {
+ content: "# Wiki",
+ enableWikiLinks: true,
+ wikiLinkRoot: "/wiki/page",
+ }));
+ expect(markdownHtml).toContain("# Wiki");
+ expect(markdownHtml).toContain('data-wiki-links="true"');
+ expect(markdownHtml).toContain('data-wiki-root="/wiki/page"');
+ expect(renderToStaticMarkup(React.createElement(SdkMarkdownEditor, { value: "# Wiki", onChange: () => undefined }))).toContain("# Wiki");
+ expect(renderToStaticMarkup(React.createElement(SdkManagedRoutinesList, {
+ routines: [{ key: "lint", title: "Run lint", status: "active" }],
+ }))).toContain("Run lint");
+ });
+});
diff --git a/ui/src/plugins/bridge.ts b/ui/src/plugins/bridge.ts
index 6e7e564374..e8a9d13a07 100644
--- a/ui/src/plugins/bridge.ts
+++ b/ui/src/plugins/bridge.ts
@@ -25,7 +25,8 @@
* @see PLUGIN_SPEC.md §19.7 — Error Propagation Through The Bridge
*/
-import { createContext, useCallback, useContext, useRef, useState, useEffect } from "react";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, type MouseEvent as ReactMouseEvent } from "react";
+import { useLocation as useRouterLocation, useNavigate as useRouterNavigate, type NavigateOptions } from "react-router-dom";
import type {
PluginBridgeErrorCode,
PluginLauncherBounds,
@@ -35,6 +36,8 @@ import type {
import { pluginsApi } from "@/api/plugins";
import { ApiError } from "@/api/client";
import { useToastActions, type ToastInput } from "@/context/ToastContext";
+import { useSidebar } from "@/context/SidebarContext";
+import { isGlobalPath, normalizeCompanyPrefix } from "@/lib/company-routes";
// ---------------------------------------------------------------------------
// Bridge error type (mirrors the SDK's PluginBridgeError)
@@ -63,6 +66,36 @@ export interface PluginDataResult<T = unknown> {
export type PluginToastInput = ToastInput;
export type PluginToastFn = (input: PluginToastInput) => string | null;
+export interface HostNavigationOptions {
+ replace?: boolean;
+ state?: unknown;
+}
+
+export interface HostNavigationLinkOptions extends HostNavigationOptions {
+ target?: string;
+ rel?: string;
+}
+
+export interface HostNavigationLinkProps {
+ href: string;
+ target?: string;
+ rel?: string;
+ onClick(event: ReactMouseEvent<HTMLAnchorElement>): void;
+}
+
+export interface HostNavigation {
+ resolveHref(to: string): string;
+ navigate(to: string, options?: HostNavigationOptions): void;
+ linkProps(to: string, options?: HostNavigationLinkOptions): HostNavigationLinkProps;
+}
+
+export interface HostLocation {
+ pathname: string;
+ search: string;
+ hash: string;
+ state?: unknown;
+}
+
// ---------------------------------------------------------------------------
// Host context type (mirrors the SDK's PluginHostContext)
// ---------------------------------------------------------------------------
@@ -220,6 +253,81 @@ function serializeRenderEnvironmentSnapshot(
return snapshot ? JSON.stringify(snapshot) : "";
}
+function splitPath(path: string): { pathname: string; search: string; hash: string } {
+ const match = path.match(/^([^?#]*)(\?[^#]*)?(#.*)?$/);
+ return {
+ pathname: match?.[1] ?? path,
+ search: match?.[2] ?? "",
+ hash: match?.[3] ?? "",
+ };
+}
+
+function sameOriginPathFromHref(href: string): string | null {
+ if (!/^[a-z][a-z\d+.-]*:/i.test(href) && !href.startsWith("//")) {
+ return href;
+ }
+ if (typeof window === "undefined") return null;
+ try {
+ const url = new URL(href, window.location.origin);
+ if (url.origin !== window.location.origin) return null;
+ return `${url.pathname}${url.search}${url.hash}`;
+ } catch {
+ return null;
+ }
+}
+
+function hasCompanyPrefix(pathname: string, companyPrefix: string): boolean {
+ const [firstSegment] = pathname.split("/").filter(Boolean);
+ return firstSegment?.toUpperCase() === normalizeCompanyPrefix(companyPrefix);
+}
+
+/**
+ * Resolve a plugin-provided Paperclip path to the active company scope.
+ *
+ * This intentionally handles plugin page roots such as `/wiki`, which cannot
+ * be listed in the host router's static board-route table ahead of time.
+ */
+export function resolveHostNavigationHref(
+ to: string,
+ companyPrefix: string | null | undefined,
+): string {
+ const sameOriginPath = sameOriginPathFromHref(to);
+ if (sameOriginPath === null) return to;
+
+ const { pathname, search, hash } = splitPath(sameOriginPath);
+ if (!pathname.startsWith("/") || isGlobalPath(pathname) || !companyPrefix) {
+ return sameOriginPath;
+ }
+
+ if (hasCompanyPrefix(pathname, companyPrefix)) {
+ return sameOriginPath;
+ }
+
+ return `/${normalizeCompanyPrefix(companyPrefix)}${pathname}${search}${hash}`;
+}
+
+function isPlainLeftClick(event: ReactMouseEvent<HTMLAnchorElement>): boolean {
+ return (
+ !event.defaultPrevented &&
+ event.button === 0 &&
+ !event.metaKey &&
+ !event.altKey &&
+ !event.ctrlKey &&
+ !event.shiftKey
+ );
+}
+
+export function shouldHandleHostNavigationClick(
+ event: ReactMouseEvent<HTMLAnchorElement>,
+ href: string,
+ target?: string,
+): boolean {
+ if (!isPlainLeftClick(event)) return false;
+ if (target && target !== "_self") return false;
+ if (event.currentTarget.hasAttribute("download")) return false;
+ return sameOriginPathFromHref(href) !== null;
+}
+
/**
* Concrete implementation of `usePluginData<T>(key, params)`.
*
@@ -364,6 +472,81 @@ export function useHostContext(): PluginHostContext {
return hostContext;
}
+// ---------------------------------------------------------------------------
+// useHostNavigation — concrete implementation
+// ---------------------------------------------------------------------------
+
+export function useHostNavigation(): HostNavigation {
+ const { hostContext } = usePluginBridgeContext();
+ const routerNavigate = useRouterNavigate();
+ const { isMobile, setSidebarOpen } = useSidebar();
+ const companyPrefix = hostContext.companyPrefix;
+
+ const resolveHref = useCallback(
+ (to: string) => resolveHostNavigationHref(to, companyPrefix),
+ [companyPrefix],
+ );
+
+ const navigate = useCallback(
+ (to: string, options?: HostNavigationOptions) => {
+ const href = resolveHref(to);
+ const sameOriginPath = sameOriginPathFromHref(href);
+ if (sameOriginPath === null) {
+ window.location.assign(href);
+ return;
+ }
+ routerNavigate(sameOriginPath, options as NavigateOptions | undefined);
+ // Mirror host sidebar behavior: tapping a link inside the mobile drawer
+ // dismisses the drawer so the user can see the destination page.
+ if (isMobile) setSidebarOpen(false);
+ },
+ [isMobile, resolveHref, routerNavigate, setSidebarOpen],
+ );
+
+ const linkProps = useCallback(
+ (to: string, options?: HostNavigationLinkOptions): HostNavigationLinkProps => {
+ const href = resolveHref(to);
+ return {
+ href,
+ target: options?.target,
+ rel: options?.rel,
+ onClick: (event) => {
+ if (!shouldHandleHostNavigationClick(event, href, options?.target)) return;
+ event.preventDefault();
+ navigate(href, options);
+ },
+ };
+ },
+ [navigate, resolveHref],
+ );
+
+ return useMemo(
+ () => ({
+ resolveHref,
+ navigate,
+ linkProps,
+ }),
+ [linkProps, navigate, resolveHref],
+ );
+}
+
+// ---------------------------------------------------------------------------
+// useHostLocation — concrete implementation
+// ---------------------------------------------------------------------------
+
+export function useHostLocation(): HostLocation {
+ const location = useRouterLocation();
+ return useMemo(
+ () => ({
+ pathname: location.pathname,
+ search: location.search,
+ hash: location.hash,
+ state: location.state,
+ }),
+ [location.hash, location.pathname, location.search, location.state],
+ );
+}
+
// ---------------------------------------------------------------------------
// usePluginToast — concrete implementation
// ---------------------------------------------------------------------------
diff --git a/ui/src/plugins/slots.tsx b/ui/src/plugins/slots.tsx
index b0fb52c3ec..80d1836ab2 100644
--- a/ui/src/plugins/slots.tsx
+++ b/ui/src/plugins/slots.tsx
@@ -63,6 +63,33 @@ export type ResolvedPluginSlot = PluginUiSlotDeclaration & {
pluginVersion: string;
};
+/**
+ * Returns the unique `routeSidebar` slot that pairs with a single `page` slot
+ * for the given route, or `null` if no unambiguous pairing exists.
+ *
+ * Used to detect when a route is taken over by a plugin's full-page sidebar so
+ * host chrome (breadcrumb, in-page Back) can be suppressed.
+ */
+export function resolveRouteSidebarSlot(
+ slots: ResolvedPluginSlot[],
+ routePath: string | null,
+): ResolvedPluginSlot | null {
+ if (!routePath) return null;
+
+ const pageMatches = slots.filter((slot) => slot.type === "page" && slot.routePath === routePath);
+ if (pageMatches.length !== 1) return null;
+
+ const [pageSlot] = pageMatches;
+ const sidebarMatches = slots.filter((slot) =>
+ slot.type === "routeSidebar"
+ && slot.routePath === routePath
+ && slot.pluginId === pageSlot.pluginId,
+ );
+
+ if (sidebarMatches.length !== 1) return null;
+ return sidebarMatches[0] ?? null;
+}
+
type PluginSlotComponentProps = {
slot: ResolvedPluginSlot;
context: PluginSlotContext;
@@ -257,8 +284,30 @@ function getShimBlobUrl(specifier: "react" | "react-dom" | "react-dom/client" |
case "sdk-ui":
source = `
const SDK = globalThis.__paperclipPluginBridge__?.sdkUi ?? {};
- const { usePluginData, usePluginAction, useHostContext, usePluginStream, usePluginToast } = SDK;
- export { usePluginData, usePluginAction, useHostContext, usePluginStream, usePluginToast };
+ function missing(name) {
+ return function MissingPaperclipSdkUiComponent() {
+ throw new Error('Paperclip plugin UI runtime is not initialized for "' + name + '". Ensure the host loaded the plugin bridge before rendering this UI module.');
+ };
+ }
+ const { usePluginData, usePluginAction, useHostContext, useHostLocation, useHostNavigation, usePluginStream, usePluginToast } = SDK;
+ const MetricCard = SDK.MetricCard ?? missing("MetricCard");
+ const StatusBadge = SDK.StatusBadge ?? missing("StatusBadge");
+ const DataTable = SDK.DataTable ?? missing("DataTable");
+ const TimeseriesChart = SDK.TimeseriesChart ?? missing("TimeseriesChart");
+ const MarkdownBlock = SDK.MarkdownBlock ?? missing("MarkdownBlock");
+ const MarkdownEditor = SDK.MarkdownEditor ?? missing("MarkdownEditor");
+ const KeyValueList = SDK.KeyValueList ?? missing("KeyValueList");
+ const ActionBar = SDK.ActionBar ?? missing("ActionBar");
+ const LogView = SDK.LogView ?? missing("LogView");
+ const JsonTree = SDK.JsonTree ?? missing("JsonTree");
+ const Spinner = SDK.Spinner ?? missing("Spinner");
+ const ErrorBoundary = SDK.ErrorBoundary ?? missing("ErrorBoundary");
+ const FileTree = SDK.FileTree ?? missing("FileTree");
+ const IssuesList = SDK.IssuesList ?? missing("IssuesList");
+ const AssigneePicker = SDK.AssigneePicker ?? missing("AssigneePicker");
+ const ProjectPicker = SDK.ProjectPicker ?? missing("ProjectPicker");
+ const ManagedRoutinesList = SDK.ManagedRoutinesList ?? missing("ManagedRoutinesList");
+ export { usePluginData, usePluginAction, useHostContext, useHostLocation, useHostNavigation, usePluginStream, usePluginToast, MetricCard, StatusBadge, DataTable, TimeseriesChart, MarkdownBlock, MarkdownEditor, KeyValueList, ActionBar, LogView, JsonTree, Spinner, ErrorBoundary, FileTree, IssuesList, AssigneePicker, ProjectPicker, ManagedRoutinesList };
`;
break;
}