zigrix 0.1.0-alpha.8 → 0.1.0

package/dist/onboard.d.ts

@@ -1,3 +1,4 @@
+import { type StandardAgentRole } from './agents/roles.js';
 import type { ZigrixConfig } from './config/schema.js';
 import { type ZigrixPaths } from './state/paths.js';
 export interface OpenClawAgent {
@@ -13,7 +14,25 @@ export interface OpenClawConfig {
     agents?: {
         list?: OpenClawAgent[];
     };
+    gateway?: {
+        port?: number | string;
+        bind?: string;
+        mode?: string;
+        auth?: {
+            token?: string;
+        };
+    };
+    plugins?: {
+        entries?: {
+            'device-pair'?: {
+                config?: {
+                    publicUrl?: string;
+                };
+            };
+        };
+    };
 }
+export type AgentRoleAssignments = Record<string, StandardAgentRole>;
 export interface PathStabilizeResult {
     alreadyInPath: boolean;
     symlinkCreated: boolean;
@@ -29,10 +48,13 @@ export interface OnboardResult {
     ok: boolean;
     action: string;
     baseDir: string;
+    workspaceBaseDir: string;
     configPath: string;
     paths: ZigrixPaths;
     openclawDetected: boolean;
     openclawHome: string;
+    openclawBinPath: string | null;
+    openclawGatewayUrl: string | null;
     agentsRegistered: string[];
     agentsSkipped: string[];
     rulesCopied: string[];
@@ -41,21 +63,39 @@ export interface OnboardResult {
     skillsSkipped: string[];
     skillsFailed: string[];
     pathStabilized: PathStabilizeResult;
+    openclawPathStabilized: PathStabilizeResult;
     warnings: string[];
     checks: {
         zigrixInPath: boolean;
+        openclawInPath: boolean;
         openclawSkillsDir: boolean;
     };
 }
 export interface RunOnboardOptions {
     yes?: boolean;
     projectDir?: string;
+    projectsBaseDir?: string;
+    orchestratorId?: string;
+    gatewayUrl?: string;
     silent?: boolean;
 }
 export declare function detectOpenClawHome(): string;
 export declare function loadOpenClawConfig(openclawHome: string): OpenClawConfig | null;
+export declare function resolveOpenClawGatewayUrl(openclawConfig: OpenClawConfig | null): string | null;
+export declare function resolveOpenClawGatewayToken(openclawConfig: OpenClawConfig | null): string | null;
+/**
+ * Discover the openclaw binary path.
+ * Strategy order:
+ *   1. `which openclaw` — available in current PATH
+ *   2. Common nvm/volta/fnm managed paths
+ *   3. Well-known locations: /usr/local/bin, ~/.local/bin
+ *   4. Walk node_modules/.bin from openclaw home
+ *
+ * Returns the resolved absolute path or null.
+ */
+export declare function resolveOpenClawBin(openclawHome?: string): string | null;
 export declare function filterAgents(agents: OpenClawAgent[]): OpenClawAgent[];
-export declare function registerAgents(config: ZigrixConfig, agents: OpenClawAgent[]): {
+export declare function registerAgents(config: ZigrixConfig, agents: OpenClawAgent[], roleAssignments?: AgentRoleAssignments): {
     config: ZigrixConfig;
     registered: string[];
     skipped: string[];
@@ -64,12 +104,20 @@ export declare function registerAgents(config: ZigrixConfig, agents: OpenClawAge
  * Find the bundled default rules directory shipped with the zigrix package.
  */
 export declare function resolveBundledRulesDir(): string | null;
+export declare function resolveRuleSeedSource(projectDir?: string): {
+    sourceDir: string | null;
+    source: 'external' | 'bundled' | 'none';
+    searched: string[];
+};
 export declare function seedRules(sourceDir: string, targetDir: string): {
     copied: string[];
     skipped: string[];
     source: string;
 };
-export declare function checkZigrixInPath(): boolean;
+export declare const STABLE_SHELL_PATHS: string[];
+export declare function checkZigrixInPath(opts?: {
+    _overrideStablePaths?: string[];
+}): boolean;
 /**
  * Resolve the path to the zigrix CLI entry point (dist/index.js).
  * Works whether installed via npm link, npm install -g, or local checkout.
@@ -94,9 +142,27 @@ export declare function findUserBinDir(): string;
  *   2. ~/.local/bin   — user-local fallback; may not be in PATH, shows warning if so
  *
  * @param opts._overrideSystemBinDir - Override system bin dir selection (for testing)
+ * @param opts._overrideStablePaths  - Override stable paths list (for testing)
  */
 export declare function ensureZigrixInPath(opts?: {
     _overrideSystemBinDir?: string | null;
+    _overrideStablePaths?: string[];
+}): PathStabilizeResult;
+export declare function checkOpenClawInPath(opts?: {
+    _overrideStablePaths?: string[];
+}): boolean;
+/**
+ * Ensure openclaw is reachable from PATH.
+ * Same strategy as ensureZigrixInPath():
+ *   1. /usr/local/bin — stable path, accessible from non-login shells
+ *   2. ~/.local/bin   — user-local fallback
+ *
+ * @param opts._overrideSystemBinDir - Override system bin dir selection (for testing)
+ * @param opts._overrideStablePaths  - Override stable paths list (for testing)
+ */
+export declare function ensureOpenClawInPath(opts?: {
+    _overrideSystemBinDir?: string | null;
+    _overrideStablePaths?: string[];
 }): PathStabilizeResult;
 /**
  * Find the skills/ directory bundled with this zigrix package.
@@ -113,4 +179,12 @@ export declare function registerSkills(openclawHome: string): SkillRegistrationR
  * Space to toggle, Enter to confirm. All agents pre-selected by default.
  */
 export declare function promptAgentSelection(agents: OpenClawAgent[]): Promise<OpenClawAgent[]>;
+export declare function promptAgentRoleAssignments(agents: OpenClawAgent[]): Promise<AgentRoleAssignments>;
+export declare function promptWorkspaceBaseDir(defaultPath: string): Promise<string>;
+export declare function promptGatewayUrl(defaultValue: string): Promise<string>;
+export declare function ensureOrchestratorId(config: ZigrixConfig, preferredId?: string): {
+    config: ZigrixConfig;
+    changed: boolean;
+    warning?: string;
+};
 export declare function runOnboard(options: RunOnboardOptions): Promise<OnboardResult>;