skedyul 1.7.25 → 1.7.27

package/README.md

@@ -120,6 +120,7 @@ See [Local development](./docs/cli.md#local-development) for the full workflow.
 | `skedyul/schemas/agent-schema` | Legacy multi-stage agent schema |
 | `skedyul/skills/types` | Skill YAML types |
 | `skedyul/scheduling` | Workflow-safe time windows and wait calculations |
+| `skedyul/cli` | Programmatic CLI API (CRM, workflows, apps, workplaces) |
 | `skedyul/cli/utils/auth` | CLI auth helpers (for monorepo tooling) |
 
 ## Server modes

package/dist/.build-stamp

@@ -1 +1 @@
-1786337245045
+1787542758884

package/dist/cli/api/apps.d.ts

@@ -0,0 +1,123 @@
+import { type CliContext } from './context';
+export interface LinkAppInput {
+    appHandle: string;
+    workplaceSubdomain: string;
+}
+export interface LinkAppResult {
+    appId: string;
+    appHandle: string;
+    appVersionId: string;
+    appVersionHandle: string;
+    appInstallationId: string;
+    workplaceId: string;
+    workplaceSubdomain: string;
+    isNewVersion: boolean;
+    isNewInstallation: boolean;
+}
+export interface InvokeToolInput {
+    appInstallationId: string;
+    toolName: string;
+    args?: Record<string, unknown>;
+    timeout?: number;
+}
+export interface InvokeToolResult {
+    success: boolean;
+    result: unknown;
+    error?: string;
+    availableTools?: string[];
+}
+export interface InstallationStatusResult {
+    status?: string;
+    appInstallationId?: string;
+    [key: string]: unknown;
+}
+export interface SyncResourcesResult {
+    tools?: {
+        synced: number;
+        disabled: number;
+    };
+    webhooks?: {
+        synced: number;
+        disabled: number;
+    };
+    internalModels?: {
+        modelsCreated: number;
+        modelsUpdated: number;
+        fieldsCreated: number;
+        relationshipsCreated: number;
+    };
+    pendingMigration?: {
+        migrationId: string;
+        impacts: Array<{
+            operationType: string;
+            resourceType: string;
+            resourceHandle: string;
+            affectedRecords?: number;
+            message?: string;
+            isDestructive?: boolean;
+        }>;
+        timeoutMinutes: number;
+        createdAt: string;
+    };
+    error?: string;
+}
+export interface PlatformTool {
+    id: string;
+    name: string;
+    displayName?: string;
+    description?: string;
+    kind?: string;
+    [key: string]: unknown;
+}
+export declare function linkApp(ctx: CliContext, input: LinkAppInput): Promise<LinkAppResult>;
+export declare function registerEndpoint(ctx: CliContext, input: {
+    appVersionId: string;
+    invokeEndpoint: string;
+    config?: Record<string, unknown>;
+}): Promise<unknown>;
+export declare function unregisterEndpoint(ctx: CliContext, input: {
+    appVersionId: string;
+}): Promise<unknown>;
+export declare function heartbeat(ctx: CliContext, input: {
+    appVersionId: string;
+    config?: Record<string, unknown>;
+}): Promise<unknown>;
+export declare function installApp(ctx: CliContext, input: {
+    appVersionId: string;
+    env?: Record<string, string>;
+}): Promise<unknown>;
+export declare function uninstallApp(ctx: CliContext, input: {
+    appInstallationId: string;
+    deleteFields?: boolean;
+}): Promise<unknown>;
+export declare function getInstallation(ctx: CliContext, input: {
+    appVersionId: string;
+}): Promise<InstallationStatusResult>;
+export declare function syncResources(ctx: CliContext, input: {
+    appVersionId: string;
+    workplaceSubdomain: string;
+    config: Record<string, unknown>;
+}): Promise<SyncResourcesResult>;
+export declare function listTools(ctx: CliContext, input: {
+    workplaceId: string;
+    name?: string;
+    toolId?: string;
+    kind?: string;
+}): Promise<{
+    success: boolean;
+    tools?: PlatformTool[];
+    tool?: PlatformTool;
+}>;
+export declare function invokeTool(ctx: CliContext, input: InvokeToolInput): Promise<InvokeToolResult>;
+export declare const apps: {
+    link: typeof linkApp;
+    registerEndpoint: typeof registerEndpoint;
+    unregisterEndpoint: typeof unregisterEndpoint;
+    heartbeat: typeof heartbeat;
+    install: typeof installApp;
+    uninstall: typeof uninstallApp;
+    installation: typeof getInstallation;
+    syncResources: typeof syncResources;
+    listTools: typeof listTools;
+    invokeTool: typeof invokeTool;
+};

package/dist/cli/api/context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Explicit CLI credentials. Callers (CLI, MCP stdio, hosted MCP) build this
+ * themselves — these APIs never read `~/.skedyul`.
+ */
+export interface CliContext {
+    token: string;
+    serverUrl: string;
+}
+export interface WorkplaceToken {
+    token: string;
+    expiresAt: string;
+    workplaceId: string;
+    workplaceName: string;
+    workplaceSubdomain: string;
+}
+export interface WorkplaceSummary {
+    id: string;
+    name: string;
+    subdomain: string;
+}
+export declare function cliApi(ctx: CliContext): {
+    serverUrl: string;
+    token: string;
+};
+export declare function getWorkplaceToken(ctx: CliContext, workplaceSubdomain: string): Promise<WorkplaceToken>;
+export declare function listWorkplaces(ctx: CliContext): Promise<WorkplaceSummary[]>;
+export declare const workplaces: {
+    list: typeof listWorkplaces;
+    getWorkplaceToken: typeof getWorkplaceToken;
+};

package/dist/cli/api/crm.d.ts

@@ -0,0 +1,56 @@
+import type { CRMSchema } from '../../schemas/crm-schema';
+import { type CliContext } from './context';
+export interface SchemaImpact {
+    operationType: string;
+    resourceType: string;
+    resourceHandle: string;
+    affectedRecords?: number;
+    message?: string;
+    isDestructive: boolean;
+}
+export interface SchemaPushResult {
+    success: boolean;
+    migrationId?: string;
+    requiresApproval: boolean;
+    hasChanges?: boolean;
+    impacts: SchemaImpact[];
+    error?: string;
+}
+export interface SchemaPullResult {
+    success: boolean;
+    schema: CRMSchema;
+    workplaceName: string;
+    error?: string;
+}
+export interface CrmModelSummary {
+    id: string;
+    handle: string;
+    name: string;
+    namePlural?: string;
+    fieldCount: number;
+    instanceCount: number;
+}
+export interface ModelsListResult {
+    success: boolean;
+    models: CrmModelSummary[];
+    error?: string;
+}
+export declare function listModels(ctx: CliContext, workplace: string): Promise<CrmModelSummary[]>;
+export declare function pullSchema(ctx: CliContext, workplace: string): Promise<{
+    schema: CRMSchema;
+    workplaceName: string;
+}>;
+export interface PushSchemaOptions {
+    dryRun?: boolean;
+    autoApprove?: boolean;
+}
+export declare function diffSchema(ctx: CliContext, workplace: string, schema: CRMSchema): Promise<SchemaPushResult>;
+export declare function approveMigration(ctx: CliContext, migrationId: string): Promise<void>;
+export declare function pushSchema(ctx: CliContext, workplace: string, schema: CRMSchema, options?: PushSchemaOptions): Promise<SchemaPushResult>;
+export declare const crm: {
+    listModels: typeof listModels;
+    pullSchema: typeof pullSchema;
+    diffSchema: typeof diffSchema;
+    pushSchema: typeof pushSchema;
+    approveMigration: typeof approveMigration;
+};

package/dist/cli/api/index.d.ts

@@ -0,0 +1,11 @@
+export type { CliContext, WorkplaceToken, WorkplaceSummary } from './context';
+export { getWorkplaceToken, listWorkplaces, workplaces } from './context';
+export { crm } from './crm';
+export type { SchemaImpact, SchemaPushResult, SchemaPullResult, CrmModelSummary, PushSchemaOptions, } from './crm';
+export { listModels, pullSchema, diffSchema, pushSchema, approveMigration, } from './crm';
+export { workflows } from './workflows';
+export type { WorkflowRecord, WorkflowVersion, DeployWorkflowResult, ValidateWorkflowResult, RunWorkflowResult, WorkflowRunStatus, WorkflowSchema, PublishWorkflowResult, PullWorkflowResult, DeployWorkflowOptions, } from './workflows';
+export { listWorkflows, getWorkflow, listWorkflowVersions, validateWorkflow, validateWorkflowContent, deployWorkflow, publishWorkflow, pullWorkflow, getWorkflowSchema, runWorkflow, getWorkflowRun, } from './workflows';
+export { apps } from './apps';
+export type { LinkAppInput, LinkAppResult, InvokeToolInput, InvokeToolResult, SyncResourcesResult, PlatformTool, } from './apps';
+export { linkApp, registerEndpoint, unregisterEndpoint, heartbeat, installApp, uninstallApp, getInstallation, syncResources, listTools, invokeTool, } from './apps';