@vornrun/connector-sdk 0.5.6 → 0.5.7

package/dist/{chunk-W4GGTEUK.js → chunk-VBE6WCLN.js}

@@ -578,6 +578,11 @@ function connectorManifest(connector) {
       type: trigger.type,
       label: trigger.label,
       ...trigger.description !== void 0 && { description: trigger.description },
+      // Carried through so the app can seed a connection's status mapping and
+      // its polling workflow. Absent when the connector said nothing, which is
+      // different from saying there is nothing.
+      ...trigger.statusMapping !== void 0 && { statusMapping: trigger.statusMapping },
+      ...trigger.defaultWorkflow !== void 0 && { defaultWorkflow: trigger.defaultWorkflow },
       setup: connectionSetup(connector, trigger.type)
     })),
     actions: connector.actions.map((action) => ({

package/dist/cli.js

@@ -7,7 +7,7 @@ import {
   resolveConfig,
   runPoll,
   serveConnector
-} from "./chunk-W4GGTEUK.js";
+} from "./chunk-VBE6WCLN.js";
 
 // src/cli.ts
 import { pathToFileURL } from "url";

package/dist/index.d.ts

@@ -106,11 +106,39 @@ interface FetchContext {
     /** Injectable clock so tests are deterministic. */
     now(): string;
 }
+/**
+ * What an upstream state should become when an item is imported as a task.
+ *
+ * A suggestion, not a rule: it seeds the connection form, and the person
+ * setting it up can change it. Without any, everything a connector imports
+ * lands as `todo` regardless of whether it was closed a year ago.
+ */
+interface StatusSuggestion {
+    /** The value the connector reports in `ConnectorItem.status`. */
+    upstream: string;
+    suggestedLocal: 'todo' | 'in_progress' | 'in_review' | 'done' | 'cancelled';
+}
+/**
+ * The workflow to create when a connection is made.
+ *
+ * A connector that fires on a schedule is useless until something polls it, and
+ * expecting every person to build that workflow by hand is how a connection
+ * ends up configured and silent. Seeded workflows are ordinary, visible and
+ * editable — the schedule is a starting point, not a fixed rule.
+ */
+interface DefaultWorkflow {
+    name: string;
+    defaultCronFromMinutes: number;
+}
 interface TriggerBase {
     /** Event key, e.g. `workItemCreated`. Becomes the `poll_<type>` MCP tool. */
     type: string;
     label: string;
     description?: string;
+    /** Seeds the connection's status mapping; the person setting it up owns it. */
+    statusMapping?: StatusSuggestion[];
+    /** Seeds a polling workflow when a connection is created. */
+    defaultWorkflow?: DefaultWorkflow;
     /**
      * Representative items. `vorn-connector check` replays these through the
      * real dedupe pipeline, so a connector can be verified before anyone has
@@ -365,6 +393,10 @@ interface ConnectorManifest {
         type: string;
         label: string;
         description?: string;
+        /** Seeds a connection's status mapping; absent when the connector was silent. */
+        statusMapping?: StatusSuggestion[];
+        /** Seeds the polling workflow created with the connection. */
+        defaultWorkflow?: DefaultWorkflow;
         setup: ConnectionSetup;
     }>;
     actions: Array<{
@@ -423,4 +455,4 @@ interface ConnectorHarness {
  */
 declare function createConnectorHarness(connector: Connector, harnessOptions?: HarnessOptions): ConnectorHarness;
 
-export { type ActionContext, type ActionDefinition, type ActionInputField, type CheckFinding, type CheckOptions, type ConnectionSetup, type Connector, type ConnectorConfig, type ConnectorConfigField, type ConnectorDefinition, type ConnectorHarness, type ConnectorIcon, type ConnectorItem, type ConnectorManifest, type ConnectorServerOptions, type DedupeStrategy, type FetchContext, type HarnessOptions, MANIFEST_TOOL, MAX_POLL_PAGES, type NormalizedItem, type PollContext, type PollOutcome, type PollPage, type RunActionOptions, type RunPollOptions, type TriggerDefinition, checkConnector, connectionSetup, connectorManifest, createConnectorHarness, createConnectorServer, defineConnector, drainPoll, envNameFor, formatFindings, normalizeItem, normalizeItems, pollToolName, pollWithDedupe, resolveConfig, runAction, runPoll, serveConnector };
+export { type ActionContext, type ActionDefinition, type ActionInputField, type CheckFinding, type CheckOptions, type ConnectionSetup, type Connector, type ConnectorConfig, type ConnectorConfigField, type ConnectorDefinition, type ConnectorHarness, type ConnectorIcon, type ConnectorItem, type ConnectorManifest, type ConnectorServerOptions, type DedupeStrategy, type DefaultWorkflow, type FetchContext, type HarnessOptions, MANIFEST_TOOL, MAX_POLL_PAGES, type NormalizedItem, type PollContext, type PollOutcome, type PollPage, type RunActionOptions, type RunPollOptions, type StatusSuggestion, type TriggerDefinition, checkConnector, connectionSetup, connectorManifest, createConnectorHarness, createConnectorServer, defineConnector, drainPoll, envNameFor, formatFindings, normalizeItem, normalizeItems, pollToolName, pollWithDedupe, resolveConfig, runAction, runPoll, serveConnector };

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   runAction,
   runPoll,
   serveConnector
-} from "./chunk-W4GGTEUK.js";
+} from "./chunk-VBE6WCLN.js";
 
 // src/harness.ts
 function createConnectorHarness(connector, harnessOptions = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vornrun/connector-sdk",
-  "version": "0.5.6",
+  "version": "0.5.7",
   "description": "Build and share Vorn pull connectors as ordinary npm packages",
   "type": "module",
   "license": "MIT",