skedyul 1.7.29 → 1.7.31

package/README.md

@@ -10,7 +10,7 @@ The official Node.js SDK for building [Skedyul](https://skedyul.com) integration
 |------------|-------------|
 | **MCP tools** | Functions AI agents invoke via the Model Context Protocol |
 | **Webhooks** | HTTP handlers for SMS, email, OAuth callbacks, and third-party events |
-| **Lifecycle hooks** | Install, provision, uninstall, and OAuth flows |
+| **Lifecycle hooks** | Install, provision, uninstall, OAuth, and token refresh |
 | **CRM models** | App-owned (internal) and user-mapped (shared) data models |
 | **Agents (v3)** | Skills-based autonomous agents deployed per workplace |
 | **Skills & workflows** | YAML-defined capabilities and event-driven automation |
@@ -174,7 +174,7 @@ Full documentation lives in [`docs/`](./docs/README.md).
 | [Configuration](./docs/configuration.md) | `skedyul.config.ts` reference — models, channels, pages, env, queues |
 | [Tools](./docs/tools.md) | Building MCP tools with Zod schemas and handlers |
 | [Webhooks](./docs/webhooks.md) | Receiving external events and lifecycle hooks on channels |
-| [Lifecycle hooks](./docs/lifecycle-hooks.md) | Install, provision, uninstall, OAuth |
+| [Lifecycle hooks](./docs/lifecycle-hooks.md) | Install, provision, uninstall, OAuth, token refresh |
 | [Authentication](./docs/authentication.md) | Token types, scopes, and SDK configuration |
 | [Core API](./docs/core-api.md) | Platform resource client reference |
 | [Errors](./docs/errors.md) | Install and runtime error types |

package/dist/.build-stamp

@@ -1 +1 @@
-1788412919726
+1791350257292

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

@@ -6,6 +6,9 @@ export { listModels, pullSchema, diffSchema, pushSchema, approveMigration, } fro
 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 { playground } from './playground';
+export type { PlaygroundSendResult, PlaygroundInspectResult, PlaygroundCreateResult, PlaygroundTurnInput, PlaygroundScheduledMessage, PlaygroundSchedulingCheck, } from './playground';
+export { sendPlaygroundTurn, inspectPlaygroundSession, createPlaygroundSession, } from './playground';
 export { apps } from './apps';
 export type { LinkAppInput, LinkAppResult, InvokeToolInput, InvokeToolResult, SyncResourcesResult, PlatformTool, GetDeploymentInput, GetDeploymentResult, DeploymentLogEntry, } from './apps';
 export { linkApp, registerEndpoint, unregisterEndpoint, heartbeat, installApp, uninstallApp, getInstallation, syncResources, listTools, invokeTool, getDeployment, } from './apps';

package/dist/cli/api/index.js

@@ -32,6 +32,7 @@ var api_exports = {};
 __export(api_exports, {
   approveMigration: () => approveMigration,
   apps: () => apps,
+  createPlaygroundSession: () => createPlaygroundSession,
   crm: () => crm,
   deployWorkflow: () => deployWorkflow,
   diffSchema: () => diffSchema,
@@ -42,6 +43,7 @@ __export(api_exports, {
   getWorkflowSchema: () => getWorkflowSchema,
   getWorkplaceToken: () => getWorkplaceToken,
   heartbeat: () => heartbeat,
+  inspectPlaygroundSession: () => inspectPlaygroundSession,
   installApp: () => installApp,
   invokeTool: () => invokeTool,
   linkApp: () => linkApp,
@@ -50,12 +52,14 @@ __export(api_exports, {
   listWorkflowVersions: () => listWorkflowVersions,
   listWorkflows: () => listWorkflows,
   listWorkplaces: () => listWorkplaces,
+  playground: () => playground,
   publishWorkflow: () => publishWorkflow,
   pullSchema: () => pullSchema,
   pullWorkflow: () => pullWorkflow,
   pushSchema: () => pushSchema,
   registerEndpoint: () => registerEndpoint,
   runWorkflow: () => runWorkflow,
+  sendPlaygroundTurn: () => sendPlaygroundTurn,
   syncResources: () => syncResources,
   uninstallApp: () => uninstallApp,
   unregisterEndpoint: () => unregisterEndpoint,
@@ -686,6 +690,47 @@ var workflows = {
   getRun: getWorkflowRun
 };
 
+// src/cli/api/playground.ts
+async function sendPlaygroundTurn(ctx, workplace, input) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", {
+    workplaceId: workplaceToken.workplaceId,
+    action: "send",
+    handle: input.handle,
+    agentId: input.agentId,
+    threadId: input.threadId,
+    content: input.message,
+    currentTime: input.currentTime,
+    contactId: input.contactId,
+    appInstallationId: input.appInstallationId,
+    title: input.title,
+    sandbox: input.sandbox
+  });
+}
+async function inspectPlaygroundSession(ctx, workplace, threadId) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", void 0, {
+    method: "GET",
+    query: {
+      workplaceId: workplaceToken.workplaceId,
+      threadId
+    }
+  });
+}
+async function createPlaygroundSession(ctx, workplace, input) {
+  const workplaceToken = await getWorkplaceToken(ctx, workplace);
+  return callCliApi(cliApi(ctx), "/playground", {
+    workplaceId: workplaceToken.workplaceId,
+    action: "create",
+    ...input
+  });
+}
+var playground = {
+  send: sendPlaygroundTurn,
+  get: inspectPlaygroundSession,
+  create: createPlaygroundSession
+};
+
 // src/cli/api/apps.ts
 async function linkApp(ctx, input) {
   return callCliApi(cliApi(ctx), "/link", {
@@ -782,6 +827,7 @@ var apps = {
 0 && (module.exports = {
   approveMigration,
   apps,
+  createPlaygroundSession,
   crm,
   deployWorkflow,
   diffSchema,
@@ -792,6 +838,7 @@ var apps = {
   getWorkflowSchema,
   getWorkplaceToken,
   heartbeat,
+  inspectPlaygroundSession,
   installApp,
   invokeTool,
   linkApp,
@@ -800,12 +847,14 @@ var apps = {
   listWorkflowVersions,
   listWorkflows,
   listWorkplaces,
+  playground,
   publishWorkflow,
   pullSchema,
   pullWorkflow,
   pushSchema,
   registerEndpoint,
   runWorkflow,
+  sendPlaygroundTurn,
   syncResources,
   uninstallApp,
   unregisterEndpoint,

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

@@ -0,0 +1,92 @@
+import { type CliContext } from './context';
+export interface PlaygroundScheduledMessage {
+    id: string;
+    status: string;
+    scheduledAt: string;
+    content: string;
+    requiresApproval?: boolean;
+    cancelOnActivity?: boolean;
+}
+export interface PlaygroundSchedulingCheck {
+    applicable: boolean;
+    passed: boolean;
+    reason: string;
+    namedDelay: boolean;
+    verbalFollowUp: boolean;
+    scheduledSend: boolean;
+}
+export interface PlaygroundSendResult {
+    success: boolean;
+    threadId: string;
+    userMessageId?: string;
+    agentMessageId?: string;
+    agentResponse: string;
+    agentRunId?: string;
+    status: string;
+    currentTime?: string;
+    scheduledMessageIds?: string[];
+    scheduledMessages: PlaygroundScheduledMessage[];
+    schedulingCheck?: PlaygroundSchedulingCheck;
+    session?: {
+        threadId: string;
+        agentId: string;
+        agentHandle: string | null;
+        agentName: string;
+    } | null;
+    error?: string;
+}
+export interface PlaygroundInspectResult {
+    success: boolean;
+    threadId: string;
+    title: string | null;
+    agentId?: string;
+    agentHandle?: string | null;
+    agentName?: string;
+    messages: Array<{
+        id: string;
+        role: 'user' | 'assistant';
+        content: string;
+        createdAt: string;
+    }>;
+    scheduledMessages: PlaygroundScheduledMessage[];
+    sendCalls: Array<{
+        toolName: string;
+        content: string | null;
+        sendAt: unknown;
+    }>;
+    schedulingCheck?: PlaygroundSchedulingCheck;
+    error?: string;
+}
+export interface PlaygroundCreateResult {
+    success: boolean;
+    threadId: string;
+    agentId: string;
+    agentHandle: string | null;
+    agentName: string;
+    error?: string;
+}
+export interface PlaygroundTurnInput {
+    handle?: string;
+    agentId?: string;
+    threadId?: string;
+    message: string;
+    currentTime?: string;
+    contactId?: string;
+    appInstallationId?: string;
+    title?: string;
+    sandbox?: boolean;
+}
+export declare function sendPlaygroundTurn(ctx: CliContext, workplace: string, input: PlaygroundTurnInput): Promise<PlaygroundSendResult>;
+export declare function inspectPlaygroundSession(ctx: CliContext, workplace: string, threadId: string): Promise<PlaygroundInspectResult>;
+export declare function createPlaygroundSession(ctx: CliContext, workplace: string, input: {
+    handle?: string;
+    agentId?: string;
+    title?: string;
+    contactId?: string;
+    appInstallationId?: string;
+}): Promise<PlaygroundCreateResult>;
+export declare const playground: {
+    send: typeof sendPlaygroundTurn;
+    get: typeof inspectPlaygroundSession;
+    create: typeof createPlaygroundSession;
+};