@workpowers/speckle 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/config.d.ts CHANGED
@@ -14,6 +14,13 @@ export interface RouterConfig {
14
14
  allowRepoMismatch: boolean;
15
15
  /** Process cwd at startup (workspace fallback when MCP roots are absent). */
16
16
  cwd: string;
17
+ /**
18
+ * SPECKLE_PROJECT_ID — optional fallback binding for markerless contexts
19
+ * (Claude Desktop / Cowork, where the router process runs outside any
20
+ * repo). Used ONLY when no `.speckle` marker resolves; a marker always
21
+ * wins. Unset → markerless sessions stay rootless (discovery tools).
22
+ */
23
+ fallbackProjectId?: number;
17
24
  }
18
25
  export declare function loadRouterConfig(env?: NodeJS.ProcessEnv): RouterConfig;
19
26
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAsBnF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAc3C"}
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,YAAY,CAuBnF;AAsBD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAc3C"}
package/dist/config.js CHANGED
@@ -22,8 +22,24 @@ export function loadRouterConfig(env = process.env) {
22
22
  apiKey,
23
23
  allowRepoMismatch: env.SPECKLE_MCP_ALLOW_REPO_MISMATCH === "1",
24
24
  cwd: process.cwd(),
25
+ fallbackProjectId: parseFallbackProjectId(env.SPECKLE_PROJECT_ID),
25
26
  };
26
27
  }
28
+ /**
29
+ * Parse the optional SPECKLE_PROJECT_ID fallback. Empty/whitespace counts as
30
+ * unset (MCP bundle hosts pass empty strings for blank optional config), but
31
+ * a present-and-malformed value fails loud — a typo must not silently demote
32
+ * the session to rootless mode.
33
+ */
34
+ function parseFallbackProjectId(raw) {
35
+ const trimmed = (raw ?? "").trim();
36
+ if (trimmed === "")
37
+ return undefined;
38
+ if (!/^\d+$/.test(trimmed) || Number.parseInt(trimmed, 10) <= 0) {
39
+ throw new SpeckleRouterError("config_invalid", `SPECKLE_PROJECT_ID is set but not a positive integer (got ${JSON.stringify(raw)}).`, "Set SPECKLE_PROJECT_ID to the numeric Speckle project id (visible in the project URL), or unset it to run markerless sessions in rootless discovery mode.", { raw });
40
+ }
41
+ return Number.parseInt(trimmed, 10);
42
+ }
27
43
  /**
28
44
  * Pick the Speckle host this MCP call should hit. The marker's
29
45
  * `speckle_url` wins over the global `SPECKLE_MCP_BASE_URL` so a repo can
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAajD,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC7C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,mEAAmE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EACxF,4IAA4I,EAC5I,EAAE,OAAO,EAAE,CACZ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,MAAM;QACN,iBAAiB,EAAE,GAAG,CAAC,+BAA+B,KAAK,GAAG;QAC9D,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAoB,EACpB,gBAAoC;IAEpC,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,OAAO,IAAI,eAAe,CAAC,UAAU,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,kBAAkB,CAC1B,sBAAsB,EACtB,oBAAoB,UAAU,iCAAiC,MAAM,CAAC,OAAO,GAAG,EAChF,iIAAiI,EACjI,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
package/dist/errors.d.ts CHANGED
@@ -6,7 +6,7 @@
6
6
  * user-facing actionable text — exactly what an agent should surface back
7
7
  * to the developer.
8
8
  */
9
- export type SpeckleRouterErrorCode = "marker_not_found" | "marker_invalid" | "marker_remote_mismatch" | "marker_host_mismatch" | "workspace_ambiguous" | "workspace_unresolved" | "remote_unauthorized" | "remote_forbidden" | "remote_unreachable" | "remote_bad_response" | "config_missing";
9
+ export type SpeckleRouterErrorCode = "marker_not_found" | "marker_invalid" | "marker_remote_mismatch" | "marker_host_mismatch" | "workspace_ambiguous" | "workspace_unresolved" | "remote_unauthorized" | "remote_forbidden" | "remote_unreachable" | "remote_bad_response" | "config_missing" | "config_invalid";
10
10
  export declare class SpeckleRouterError extends Error {
11
11
  readonly code: SpeckleRouterErrorCode;
12
12
  readonly hint: string;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,GACxB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASnC,YAAY,IAAI,MAAM;CAGvB"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,kBAAkB,GAClB,gBAAgB,GAChB,wBAAwB,GACxB,sBAAsB,GACtB,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,IAAI,EAAE,sBAAsB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASnC,YAAY,IAAI,MAAM;CAGvB"}
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAyB;IAC7B,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C,YACE,IAA4B,EAC5B,OAAe,EACf,IAAY,EACZ,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,YAAY;QACV,OAAO,GAAG,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAyB;IAC7B,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C,YACE,IAA4B,EAC5B,OAAe,EACf,IAAY,EACZ,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,YAAY;QACV,OAAO,GAAG,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF"}
package/dist/headers.d.ts CHANGED
@@ -13,7 +13,7 @@
13
13
  */
14
14
  import type { ResolvedWorkspace } from "./workspace.js";
15
15
  export declare const ROUTER_CLIENT_NAME = "@workpowers/speckle";
16
- export declare const ROUTER_CLIENT_VERSION = "0.2.0";
16
+ export declare const ROUTER_CLIENT_VERSION = "0.3.0";
17
17
  export interface RouterRequestHeaders {
18
18
  Authorization: string;
19
19
  "X-Speckle-Client": string;
@@ -26,5 +26,12 @@ export interface RouterRequestHeaders {
26
26
  export declare function buildRouterHeaders(args: {
27
27
  apiKey: string;
28
28
  workspace?: ResolvedWorkspace;
29
+ /**
30
+ * Env-configured project binding used ONLY when no workspace/marker
31
+ * resolved (SPECKLE_PROJECT_ID — Claude Desktop / Cowork installs). Sends
32
+ * a bare `X-Speckle-Project-Id`; the marker-derived provenance headers are
33
+ * deliberately absent because there is no marker to attest.
34
+ */
35
+ fallbackProjectId?: number;
29
36
  }): RouterRequestHeaders;
30
37
  //# sourceMappingURL=headers.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,GAAG,oBAAoB,CAevB"}
1
+ {"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,GAAG,oBAAoB,CAoBvB"}
package/dist/headers.js CHANGED
@@ -12,15 +12,19 @@
12
12
  * the server then exposes a project-agnostic discovery toolset.
13
13
  */
14
14
  export const ROUTER_CLIENT_NAME = "@workpowers/speckle";
15
- export const ROUTER_CLIENT_VERSION = "0.2.0";
15
+ export const ROUTER_CLIENT_VERSION = "0.3.0";
16
16
  export function buildRouterHeaders(args) {
17
- const { apiKey, workspace } = args;
17
+ const { apiKey, workspace, fallbackProjectId } = args;
18
18
  const headers = {
19
19
  Authorization: `Bearer ${apiKey}`,
20
20
  "X-Speckle-Client": `${ROUTER_CLIENT_NAME}/${ROUTER_CLIENT_VERSION}`,
21
21
  };
22
- if (!workspace)
22
+ if (!workspace) {
23
+ if (fallbackProjectId !== undefined) {
24
+ headers["X-Speckle-Project-Id"] = String(fallbackProjectId);
25
+ }
23
26
  return headers;
27
+ }
24
28
  const m = workspace.marker.marker;
25
29
  headers["X-Speckle-Project-Id"] = String(m.projectId);
26
30
  headers["X-Speckle-Marker-Hash"] = `sha256:${workspace.marker.contentHash}`;
@@ -1 +1 @@
1
- {"version":3,"file":"headers.js","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAY7C,MAAM,UAAU,kBAAkB,CAAC,IAGlC;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACnC,MAAM,OAAO,GAAyB;QACpC,aAAa,EAAE,UAAU,MAAM,EAAE;QACjC,kBAAkB,EAAE,GAAG,kBAAkB,IAAI,qBAAqB,EAAE;KACrE,CAAC;IACF,IAAI,CAAC,SAAS;QAAE,OAAO,OAAO,CAAC;IAE/B,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,CAAC,uBAAuB,CAAC,GAAG,UAAU,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5E,OAAO,CAAC,0BAA0B,CAAC,GAAG,UAAU,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAC9E,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACrE,IAAI,SAAS,CAAC,eAAe;QAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC;IAC5F,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"headers.js","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAY7C,MAAM,UAAU,kBAAkB,CAAC,IAUlC;IACC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACtD,MAAM,OAAO,GAAyB;QACpC,aAAa,EAAE,UAAU,MAAM,EAAE;QACjC,kBAAkB,EAAE,GAAG,kBAAkB,IAAI,qBAAqB,EAAE;KACrE,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,CAAC,uBAAuB,CAAC,GAAG,UAAU,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5E,OAAO,CAAC,0BAA0B,CAAC,GAAG,UAAU,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAC9E,IAAI,CAAC,CAAC,WAAW;QAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACrE,IAAI,SAAS,CAAC,eAAe;QAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC,eAAe,CAAC;IAC5F,OAAO,OAAO,CAAC;AACjB,CAAC"}
package/dist/index.d.ts CHANGED
@@ -14,7 +14,8 @@
14
14
  * — those mean broken config, not absence.
15
15
  * 3. Pick the Speckle host (marker `speckle_url` wins over env baseUrl).
16
16
  * 4. Connect upstream MCP client over StreamableHTTP, with auth + context headers.
17
- * 5. Mirror upstream capabilities downstream and wire pass-through handlers.
17
+ * 5. Mirror upstream capabilities AND instructions downstream, then wire
18
+ * pass-through handlers.
18
19
  * 6. Connect the stdio server transport. The agent now talks to us as if
19
20
  * we were Speckle.
20
21
  *
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CA8DjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQ9C"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAYH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAwEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQ9C"}
package/dist/index.js CHANGED
@@ -14,7 +14,8 @@
14
14
  * — those mean broken config, not absence.
15
15
  * 3. Pick the Speckle host (marker `speckle_url` wins over env baseUrl).
16
16
  * 4. Connect upstream MCP client over StreamableHTTP, with auth + context headers.
17
- * 5. Mirror upstream capabilities downstream and wire pass-through handlers.
17
+ * 5. Mirror upstream capabilities AND instructions downstream, then wire
18
+ * pass-through handlers.
18
19
  * 6. Connect the stdio server transport. The agent now talks to us as if
19
20
  * we were Speckle.
20
21
  *
@@ -28,7 +29,7 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
28
29
  import { loadRouterConfig, resolveSpeckleHost } from "./config.js";
29
30
  import { resolveWorkspace } from "./workspace.js";
30
31
  import { buildRouterHeaders, ROUTER_CLIENT_NAME, ROUTER_CLIENT_VERSION } from "./headers.js";
31
- import { wireProxyHandlers } from "./proxy.js";
32
+ import { mirrorServerOptions, wireProxyHandlers } from "./proxy.js";
32
33
  import { SpeckleRouterError } from "./errors.js";
33
34
  export async function startRouter() {
34
35
  const config = loadRouterConfig();
@@ -41,23 +42,32 @@ export async function startRouter() {
41
42
  }
42
43
  catch (err) {
43
44
  if (err instanceof SpeckleRouterError && err.code === "marker_not_found") {
44
- process.stderr.write("speckle-mcp: no .speckle marker found — running in rootless mode (discovery tools only). " +
45
- "Run `speckle-mcp init --project <id>` in a repo to bind it to a project.\n");
46
45
  workspace = undefined;
46
+ if (config.fallbackProjectId !== undefined) {
47
+ process.stderr.write(`speckle-mcp: no .speckle marker found — binding to project ${config.fallbackProjectId} from SPECKLE_PROJECT_ID.\n`);
48
+ }
49
+ else {
50
+ process.stderr.write("speckle-mcp: no .speckle marker found — running in rootless mode (discovery tools only). " +
51
+ "Run `speckle-mcp init --project <id>` in a repo to bind it to a project.\n");
52
+ }
47
53
  }
48
54
  else {
49
55
  throw err;
50
56
  }
51
57
  }
52
58
  const host = resolveSpeckleHost(config, workspace?.marker.marker.speckleUrl);
53
- const headers = buildRouterHeaders({ apiKey: config.apiKey, workspace });
59
+ const headers = buildRouterHeaders({
60
+ apiKey: config.apiKey,
61
+ workspace,
62
+ fallbackProjectId: workspace ? undefined : config.fallbackProjectId,
63
+ });
54
64
  const upstream = new Client({ name: ROUTER_CLIENT_NAME, version: ROUTER_CLIENT_VERSION }, { capabilities: {} });
55
65
  const httpTransport = new StreamableHTTPClientTransport(new URL(`${host.hostUrl}/mcp`), {
56
66
  requestInit: { headers: headers },
57
67
  });
58
68
  await upstream.connect(httpTransport);
59
69
  const capabilities = upstream.getServerCapabilities() ?? {};
60
- const downstream = new Server({ name: ROUTER_CLIENT_NAME, version: ROUTER_CLIENT_VERSION }, { capabilities });
70
+ const downstream = new Server({ name: ROUTER_CLIENT_NAME, version: ROUTER_CLIENT_VERSION }, mirrorServerOptions(upstream, capabilities));
61
71
  wireProxyHandlers(downstream, upstream, capabilities);
62
72
  const stdio = new StdioServerTransport();
63
73
  await downstream.connect(stdio);
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/proxy.d.ts CHANGED
@@ -12,7 +12,25 @@
12
12
  * new spec-branch tool on the server does not require a router release.
13
13
  */
14
14
  import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
15
- import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
15
+ import type { Server, ServerOptions } from "@modelcontextprotocol/sdk/server/index.js";
16
16
  import { type ServerCapabilities } from "@modelcontextprotocol/sdk/types.js";
17
+ /**
18
+ * The options the router's downstream Server must be built with to look like
19
+ * the upstream one.
20
+ *
21
+ * Capabilities and `instructions` are alike in a way the handler wiring below
22
+ * is not: neither is a request the agent sends, so neither can be forwarded
23
+ * after the fact. Both ride on the initialize result of the server the agent
24
+ * is actually connected to — us. Anything we fail to copy here is simply
25
+ * absent, silently, for the life of the session.
26
+ *
27
+ * `instructions` is the string a client reads ABOVE any tool description.
28
+ * Speckle's says a speckle is what is TRUE and an issue is what we INTEND
29
+ * (see server/mcp/mcp-server-instructions.ts); an agent that never receives
30
+ * it files open questions as speckles, which is exactly what happened before
31
+ * I-4319. Omit the key entirely when upstream has no text, rather than
32
+ * passing `undefined` — the SDK stores what it is handed.
33
+ */
34
+ export declare function mirrorServerOptions(client: Client, capabilities: ServerCapabilities): ServerOptions;
17
35
  export declare function wireProxyHandlers(server: Server, client: Client, capabilities: ServerCapabilities): void;
18
36
  //# sourceMappingURL=proxy.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,EASL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAE5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAoCxG"}
1
+ {"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,EASL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,aAAa,CAGnG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAoCxG"}
package/dist/proxy.js CHANGED
@@ -12,6 +12,27 @@
12
12
  * new spec-branch tool on the server does not require a router release.
13
13
  */
14
14
  import { CallToolRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, PingRequestSchema, ReadResourceRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
15
+ /**
16
+ * The options the router's downstream Server must be built with to look like
17
+ * the upstream one.
18
+ *
19
+ * Capabilities and `instructions` are alike in a way the handler wiring below
20
+ * is not: neither is a request the agent sends, so neither can be forwarded
21
+ * after the fact. Both ride on the initialize result of the server the agent
22
+ * is actually connected to — us. Anything we fail to copy here is simply
23
+ * absent, silently, for the life of the session.
24
+ *
25
+ * `instructions` is the string a client reads ABOVE any tool description.
26
+ * Speckle's says a speckle is what is TRUE and an issue is what we INTEND
27
+ * (see server/mcp/mcp-server-instructions.ts); an agent that never receives
28
+ * it files open questions as speckles, which is exactly what happened before
29
+ * I-4319. Omit the key entirely when upstream has no text, rather than
30
+ * passing `undefined` — the SDK stores what it is handed.
31
+ */
32
+ export function mirrorServerOptions(client, capabilities) {
33
+ const instructions = client.getInstructions();
34
+ return { capabilities, ...(instructions === undefined ? {} : { instructions }) };
35
+ }
15
36
  export function wireProxyHandlers(server, client, capabilities) {
16
37
  // Ping is always available — agents use it to keep the link alive.
17
38
  server.setRequestHandler(PingRequestSchema, async () => {
package/dist/proxy.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,kCAAkC,EAClC,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,MAAc,EAAE,YAAgC;IAChG,mEAAmE;IACnE,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7D,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5D,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC/D,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7D,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjE,OAAO,MAAM,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzE,OAAO,MAAM,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChE,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,kCAAkC,EAClC,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,YAAgC;IAClF,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;IAC9C,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc,EAAE,MAAc,EAAE,YAAgC;IAChG,mEAAmE;IACnE,MAAM,CAAC,iBAAiB,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7D,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5D,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvC,MAAM,CAAC,iBAAiB,CAAC,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC/D,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7D,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,YAAY,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACjE,OAAO,MAAM,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACzE,OAAO,MAAM,MAAM,CAAC,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAChE,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@workpowers/speckle",
3
- "version": "0.2.0",
3
+ "version": "0.3.0",
4
4
  "description": "Local MCP router for Speckle — resolves project context from a committed .speckle marker and forwards calls to the remote Speckle MCP endpoint.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",