@agentworkforce/deploy 0.0.0

package/dist/types.d.ts

@@ -0,0 +1,140 @@
+import type { PersonaSpec } from '@agentworkforce/persona-kit';
+export type DeployMode = 'dev' | 'sandbox' | 'cloud';
+export interface DeployOptions {
+    /** Absolute path to the persona JSON file. Required. */
+    personaPath: string;
+    /** Run mode. Defaults to `sandbox` if Daytona creds resolve, else `dev`. */
+    mode?: DeployMode;
+    /** Workforce workspace to deploy into. Defaults to the active workspace. */
+    workspace?: string;
+    /** Skip the integration-connect prompts; fail if any declared integration is missing. */
+    noConnect?: boolean;
+    /** Force BYO Daytona even when workforce-managed sandbox issuance is available. */
+    byoSandbox?: boolean;
+    /** Background the runner instead of streaming logs in the foreground. */
+    detach?: boolean;
+    /** Emit the bundle to this directory and exit (no launch). */
+    bundleOut?: string;
+    /** Validate-only: parse + lint + check connection status, no side effects. */
+    dryRun?: boolean;
+    /** Override the WORKFORCE_CLOUD_URL; defaults to env or production. */
+    cloudUrl?: string;
+    /** Override stdout writer for tests + structured outputs. */
+    io?: DeployIO;
+}
+export interface DeployIO {
+    /** User-facing progress line (clean prose, suitable for terminals). */
+    info(message: string): void;
+    /** Warning line; rendered with a marker the user reads. */
+    warn(message: string): void;
+    /** Error line; non-fatal context. */
+    error(message: string): void;
+    /** Interactive prompt; resolves to user's answer. */
+    prompt(question: string, opts?: {
+        defaultValue?: string;
+    }): Promise<string>;
+    /** Confirmation prompt; resolves to true/false. */
+    confirm(question: string, opts?: {
+        defaultValue?: boolean;
+    }): Promise<boolean>;
+}
+/** The result returned by a successful `deploy(...)` call. */
+export interface DeployResult {
+    /** Resolved deployment identifier (stable across restarts of the same persona). */
+    deploymentId: string;
+    /** Which run mode the orchestrator picked. */
+    mode: DeployMode;
+    /** Workspace the deployment is scoped to. */
+    workspace: string;
+    /** Path to the staged bundle on disk. */
+    bundleDir: string;
+    /** Integrations that were connected (or already-connected) as part of this deploy. */
+    connectedIntegrations: string[];
+    /** Schedules registered with the runtime. */
+    schedules: string[];
+    /** Run-mode-specific handle. `dev` returns a child process handle; `sandbox` a Daytona sandbox id; `cloud` a server-side deployment id. */
+    runHandle?: unknown;
+    /** Non-fatal warnings collected during deploy. */
+    warnings: string[];
+}
+/**
+ * Contract the deploy orchestrator expects from the bundle stager. The
+ * default implementation lives in `bundle.ts` (esbuild-driven); callers
+ * pass an alternative via `DeployResolvers.bundle` to swap bundlers or
+ * inject test fakes.
+ */
+export interface BundleStager {
+    stage(input: BundleStageInput): Promise<BundleResult>;
+}
+export interface BundleStageInput {
+    personaPath: string;
+    persona: PersonaSpec;
+    outDir: string;
+    bundlerOptions?: {
+        minify?: boolean;
+    };
+}
+export interface BundleResult {
+    personaCopyPath: string;
+    runnerPath: string;
+    bundlePath: string;
+    packageJsonPath: string;
+    sizeBytes: number;
+}
+/**
+ * Contract each run-mode launcher implements. The defaults live next
+ * to this file: `modes/dev.ts` (local child_process), `modes/sandbox.ts`
+ * (Daytona), and `modes/cloud.ts` (workforce-cloud hosted, opt-in once
+ * the cloud deployments endpoint ships). Callers swap individual modes
+ * via `DeployResolvers.modes` — useful for tests and custom runtimes.
+ */
+export interface ModeLauncher {
+    launch(input: ModeLaunchInput): Promise<ModeLaunchHandle>;
+}
+export interface ModeLaunchInput {
+    persona: PersonaSpec;
+    bundle: BundleResult;
+    workspace: string;
+    env?: Record<string, string>;
+    io: DeployIO;
+    detach?: boolean;
+    /**
+     * Force BYO Daytona auth even when the user is logged in to workforce
+     * cloud. Mode-specific (sandbox launcher only); other modes ignore.
+     */
+    byoSandbox?: boolean;
+}
+export interface ModeLaunchHandle {
+    /** Mode-specific identifier (pid for dev, sandboxId for sandbox, deploymentId for cloud). */
+    id: string;
+    /** Stop the runner cleanly. */
+    stop(): Promise<void>;
+    /**
+     * Resolves when the runner exits. For long-lived modes (sandbox), this
+     * resolves only when the user invokes `stop()`.
+     */
+    done: Promise<{
+        code: number;
+    }>;
+}
+export interface IntegrationConnectOutcome {
+    provider: string;
+    status: 'already-connected' | 'connected-now' | 'skipped' | 'failed';
+    message?: string;
+}
+/** Surface a parsed persona only after we know it passed the deploy preflight. */
+export interface DeployPreflight {
+    persona: PersonaSpec;
+    /** Persona JSON path resolved to absolute. */
+    personaPath: string;
+    /** Absolute path to the directory containing the persona JSON. */
+    personaDir: string;
+    /** Absolute path to the resolved `onEvent` file. */
+    onEventPath: string;
+    /** Schedules and integrations summarized. */
+    schedules: string[];
+    integrations: string[];
+    /** Non-fatal warnings (unknown triggers, etc). */
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@agentworkforce/deploy",
+  "version": "0.0.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/workforce",
+    "directory": "packages/deploy"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test dist/**/*.test.js dist/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@agentworkforce/persona-kit": "workspace:*",
+    "@agentworkforce/runtime": "workspace:*",
+    "@daytonaio/sdk": "^0.148.0",
+    "esbuild": "^0.25.0"
+  }
+}