@signetai/connector-base 0.163.17 → 0.163.19

package/dist/index.d.ts

@@ -151,11 +151,42 @@ export declare function resolveSignetMcpCommand(): ResolvedCommand;
 export declare function resolveSignetCliCommand(): ResolvedCommand;
 export declare const MANAGED_DAEMON_URL_DEFAULT = "http://127.0.0.1:3850";
 export declare const MANAGED_AGENT_ID_DEFAULT = "default";
+/** Narrow an unknown value to a plain record (shared by connectors, #957). */
+export declare function isJsonObject(value: unknown): value is Record<string, unknown>;
+/** True when `candidate` is strictly inside `parent` on the filesystem (shared, #957). */
+export declare function isChildOf(candidate: string, parent: string): boolean;
+/**
+ * Read a non-empty, trimmed env var (shared by connectors, #957).
+ * Newlines are stripped so multi-line values cannot smuggle into single-line
+ * config surfaces (the behavior forge/opencode standardized on).
+ */
+export declare function readTrimmedEnv(name: string): string | undefined;
+/**
+ * @deprecated Use `readTrimmedEnv` (same semantics, canonical name).
+ */
 export declare function readManagedTrimmedEnv(name: string): string | undefined;
 export declare function resolveSignetWorkspacePath(home?: string): string;
 export declare function resolveSignetDaemonUrl(): string;
 export declare function resolveSignetAgentId(): string;
 export declare function resolveSignetApiKey(): string | undefined;
+/**
+ * Build the standard Signet runtime env map for spawned processes, preserving
+ * "only set what is present" semantics: SIGNET_PATH only when a basePath is
+ * passed, SIGNET_DAEMON_URL only when explicitly configured, and the
+ * SIGNET_API_KEY ?? SIGNET_TOKEN fallback. Shared by harness connectors
+ * (forge, opencode, codex, hermes-agent) so the API-key/token precedence
+ * contract has one owner (#955).
+ */
+export declare function buildSignetRuntimeEnv(opts?: {
+    readonly basePath?: string;
+}): Record<string, string>;
+/**
+ * Resolve the remote daemon URL for MCP/HTTP configs, or null when
+ * SIGNET_DAEMON_URL is not explicitly set. Unlike `resolveSignetDaemonUrl()`
+ * (which always returns a URL), this honors the "explicit remote only"
+ * contract connectors rely on (#955).
+ */
+export declare function resolveRemoteDaemonUrl(): string | null;
 export declare function buildManagedExtensionEnvBootstrap(env: {
     readonly signetPath: string;
     readonly daemonUrl: string;
@@ -163,6 +194,23 @@ export declare function buildManagedExtensionEnvBootstrap(env: {
     readonly apiKey?: string;
 }): string;
 export declare function managedExtensionFilePath(agentDir: string, filename: string): string;
+/**
+ * Build a managed extension file: a header naming the package/entry/marker,
+ * the Signet env bootstrap, then the embedded bundle. Shared by the pi and
+ * oh-my-pi connectors, which differ only in those constants (#957).
+ */
+export declare function buildManagedExtensionContent(params: {
+    readonly bundle: string;
+    readonly marker: string;
+    readonly packageName: string;
+    readonly entry: string;
+    readonly env: {
+        readonly signetPath: string;
+        readonly daemonUrl: string;
+        readonly agentId: string;
+        readonly apiKey?: string;
+    };
+}): string;
 export declare function isManagedExtensionFile(filePath: string, marker: string): boolean;
 export declare function removeManagedExtensionFile(filePath: string, marker: string): boolean;
 export interface ConnectorInstallerOptions {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -34,7 +34,7 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 import { randomBytes } from "node:crypto";
 import { existsSync, readFileSync, renameSync, statSync as statSync2, unlinkSync as unlinkSync2, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { dirname as dirname3, isAbsolute, join as join3, relative, sep } from "node:path";
 
 // ../../platform/core/dist/index.js
 import { createRequire } from "node:module";
@@ -11720,13 +11720,23 @@ function resolveSignetCliCommand() {
 }
 var MANAGED_DAEMON_URL_DEFAULT = "http://127.0.0.1:3850";
 var MANAGED_AGENT_ID_DEFAULT = "default";
-function readManagedTrimmedEnv(name) {
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isChildOf(candidate, parent) {
+  const rel = relative(parent, candidate);
+  return rel !== "" && rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
+}
+function readTrimmedEnv2(name) {
   const value = process.env[name];
   if (typeof value !== "string")
     return;
-  const trimmed = value.trim();
+  const trimmed = value.trim().replace(/[\r\n]+/g, "");
   return trimmed.length > 0 ? trimmed : undefined;
 }
+function readManagedTrimmedEnv(name) {
+  return readTrimmedEnv2(name);
+}
 function isExistingDirectory2(path) {
   try {
     return statSync2(path).isDirectory();
@@ -11746,6 +11756,24 @@ function resolveSignetAgentId() {
 function resolveSignetApiKey() {
   return readManagedTrimmedEnv("SIGNET_API_KEY") ?? readManagedTrimmedEnv("SIGNET_TOKEN");
 }
+function buildSignetRuntimeEnv(opts = {}) {
+  const env = {};
+  if (opts.basePath)
+    env.SIGNET_PATH = opts.basePath;
+  const daemonUrl = readManagedTrimmedEnv("SIGNET_DAEMON_URL");
+  const apiKey = resolveSignetApiKey();
+  const agentId = readManagedTrimmedEnv("SIGNET_AGENT_ID");
+  if (daemonUrl)
+    env.SIGNET_DAEMON_URL = resolveSignetDaemonUrl2();
+  if (apiKey)
+    env.SIGNET_API_KEY = apiKey;
+  if (agentId)
+    env.SIGNET_AGENT_ID = agentId;
+  return env;
+}
+function resolveRemoteDaemonUrl() {
+  return readManagedTrimmedEnv("SIGNET_DAEMON_URL") ? resolveSignetDaemonUrl2() : null;
+}
 function buildManagedExtensionEnvBootstrap(env) {
   const daemonUrl = JSON.stringify(env.daemonUrl);
   const agentId = JSON.stringify(env.agentId);
@@ -11783,6 +11811,20 @@ ${signetPathBlock}		if (!__signetReadEnv("SIGNET_DAEMON_URL")) {
 function managedExtensionFilePath(agentDir, filename) {
   return join3(agentDir, "extensions", filename);
 }
+function buildManagedExtensionContent(params) {
+  if (params.bundle.length === 0) {
+    throw new Error(`Bundled extension content is empty. Rebuild ${params.packageName} and rerun the connector build so ${params.entry} is embedded.`);
+  }
+  const bootstrap = buildManagedExtensionEnvBootstrap(params.env);
+  return `// ${params.marker}
+// Managed by Signet (${params.packageName})
+// Source: ${params.entry}
+// DO NOT EDIT - this file is overwritten by Signet setup/sync.
+
+${bootstrap}
+
+${params.bundle}`;
+}
 function isManagedExtensionFile(filePath, marker) {
   const content = readManagedExtensionFile(filePath);
   return content?.includes(marker) ?? false;
@@ -11915,12 +11957,18 @@ export {
   resolveSignetCliCommand,
   resolveSignetApiKey,
   resolveSignetAgentId,
+  resolveRemoteDaemonUrl,
   removeManagedExtensionFile,
+  readTrimmedEnv2 as readTrimmedEnv,
   readManagedTrimmedEnv,
   managedExtensionFilePath,
   isSignetGeneratedFile,
   isManagedExtensionFile,
+  isJsonObject,
+  isChildOf,
+  buildSignetRuntimeEnv,
   buildManagedExtensionEnvBootstrap,
+  buildManagedExtensionContent,
   atomicWriteText,
   atomicWriteJson,
   MANAGED_DAEMON_URL_DEFAULT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signetai/connector-base",
-  "version": "0.163.17",
+  "version": "0.163.19",
   "description": "Base class for Signet harness connectors",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@signetai/core": "0.163.17",
+    "@signetai/core": "0.163.19",
     "json5": "^2.2.3",
     "jsonc-parser": "3.3.1"
   },