@forklaunch/core 3.3.0 → 3.4.0

package/bin/gateway-mock/routes/payments.mjs

@@ -7,6 +7,10 @@
  *                                   creates the instance's connected account
  *                                   on first use (acct_mock_<n>)
  *   GET  /payments/status           { chargesEnabled, payoutsEnabled, requirementsDue }
+ *   GET  /payments/payouts?limit=N  { available, pending, payouts, bank, schedule }:
+ *                                   empty before onboarding; once enabled, a
+ *                                   balance and one paid payout (read-only)
+ *   POST /payments/dashboard-link   { url } once onboarded; 409 before
  *   *    /stripe/v1/...             the Stripe API, as the real Stripe SDK
  *                                   sends it (form-encoded, signed verbatim)
  *
@@ -468,6 +472,47 @@ function status(ctx) {
   });
 }
 
+/** Mirrors the platform: 1..50, 10 when missing or not a number. */
+function payoutsLimit(raw) {
+  const n = raw === null || raw.trim() === '' ? NaN : Number(raw);
+  if (!Number.isFinite(n)) return 10;
+  return Math.min(50, Math.max(1, Math.floor(n)));
+}
+
+function payouts(ctx) {
+  const account = accountFor(ctx);
+  if (!account) {
+    return ctx.send(200, { available: [], pending: [], payouts: [], bank: null, schedule: null });
+  }
+  const limit = payoutsLimit(new URL(ctx.req.url ?? '/', 'http://mock').searchParams.get('limit'));
+  const enabled = Boolean(account.payoutsEnabled);
+  const day = 86_400_000;
+  return ctx.send(200, {
+    available: [{ amount: enabled ? 12_500 : 0, currency: 'usd' }],
+    pending: [{ amount: enabled ? 4_200 : 0, currency: 'usd' }],
+    payouts: enabled
+      ? [{
+          id: `po_mock_${account.id.slice(-4)}`,
+          amount: 9_900,
+          currency: 'usd',
+          status: 'paid',
+          arrivalDate: new Date(Date.now() - 2 * day).toISOString(),
+          automatic: true
+        }].slice(0, limit)
+      : [],
+    bank: enabled ? { bankName: 'STRIPE TEST BANK', last4: '6789' } : null,
+    schedule: enabled ? { interval: 'daily', delayDays: 2 } : null
+  });
+}
+
+function dashboardLink(ctx) {
+  const account = accountFor(ctx);
+  if (!account?.detailsSubmitted) {
+    return ctx.send(409, 'Payments are not set up yet: finish Stripe onboarding first');
+  }
+  return ctx.send(200, { url: `https://connect.stripe.com/express/${account.id}/mock_${randomBytes(6).toString('hex')}` });
+}
+
 // Dedicated context routes never widen STRIPE_ALLOWLIST. Synthetic mode is
 // test-only; configured upstream verifies its own actual account and mode.
 async function scopedRead(ctx, operation) {
@@ -574,6 +619,8 @@ export default {
   routes: [
     { method: 'POST', path: '/payments/onboarding-link', handler: onboardingLink },
     { method: 'GET', path: '/payments/status', handler: status },
+    { method: 'GET', path: '/payments/payouts', handler: payouts },
+    { method: 'POST', path: '/payments/dashboard-link', handler: dashboardLink },
     { method: 'POST', path: '/payments/context', handler: ctx => scopedRead(ctx,'issue') },
     { method: 'POST', path: '/payments/context/checkout-read', handler: ctx => scopedRead(ctx,'checkout') },
     { method: 'POST', path: '/payments/context/payment-link-read', handler: ctx => scopedRead(ctx,'paymentLink') },

package/lib/agent/agent.d.ts

@@ -0,0 +1,26 @@
+import { type ModelGatewayClient } from '../http/modelGatewayClient';
+import { type AgentEvent, type AgentLimits, type AgentTaskRequest, type AgentTaskResult, type AgentToolContext, type AgentToolListing, type ToolSource } from './types';
+export declare const DEFAULT_AGENT_LIMITS: AgentLimits;
+export interface AgentDefinition {
+    name: string;
+    instructions: string;
+    /** Catalog model alias. Default: the `AGENT_MODEL` setting. */
+    model?: string;
+    sources: ToolSource[];
+    limits?: Partial<AgentLimits>;
+    /** Key that seals approval continuations. Default: the `HMAC_SECRET_KEY` setting. */
+    continuationSecret?: string;
+    /** Stream model output. Default: the `FORKLAUNCH_MODEL_STREAMING` setting is `1`. */
+    streaming?: boolean;
+    client?: () => ModelGatewayClient;
+}
+export interface Agent {
+    name: string;
+    listTools(context: AgentToolContext): Promise<AgentToolListing>;
+    /** Runs or resumes a task, yielding stream events. */
+    stream(request: AgentTaskRequest, context: AgentToolContext): AsyncGenerator<AgentEvent>;
+    /** Runs or resumes a task to completion or to the next approval. */
+    run(request: AgentTaskRequest, context: AgentToolContext): Promise<AgentTaskResult>;
+}
+export declare function defineAgent(definition: AgentDefinition): Agent;
+//# sourceMappingURL=agent.d.ts.map

package/lib/agent/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AASpC,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAErB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,oBAAoB,EAAE,WAMlC,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,kBAAkB,CAAC;CACnC;AAID,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,sDAAsD;IACtD,MAAM,CACJ,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9B,oEAAoE;IACpE,GAAG,CACD,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AA+BD,wBAAgB,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,KAAK,CA6b9D"}

package/lib/agent/continuation.d.ts

@@ -0,0 +1,29 @@
+import type { GatewayChatMessage } from '../http/modelGatewayClient';
+export interface PendingToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+/** Everything needed to resume a run after the user decides on a tool call. */
+export interface Continuation {
+    v: 1;
+    userId: string;
+    expiresAt: number;
+    steps: number;
+    messages: GatewayChatMessage[];
+    /** The call awaiting approval first, then any later calls of the same model turn. */
+    pending: PendingToolCall[];
+    toolCalls: {
+        id: string;
+        name: string;
+        ok: boolean;
+    }[];
+}
+export declare const CONTINUATION_TTL_MS: number;
+/**
+ * Seals a continuation with AES-256-GCM: tool results inside stay confidential,
+ * and any change makes it unreadable. Nothing is stored on the server.
+ */
+export declare function sealContinuation(value: Continuation, secret: string): string;
+export declare function openContinuation(token: string, secret: string, userId: string): Continuation | null;
+//# sourceMappingURL=continuation.d.ts.map

package/lib/agent/continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.d.ts","sourceRoot":"","sources":["../../src/agent/continuation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,qFAAqF;IACrF,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACxD;AAGD,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAO/C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAa5E;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,YAAY,GAAG,IAAI,CA0BrB"}

package/lib/agent/index.d.ts

@@ -0,0 +1,8 @@
+export { defineAgent, DEFAULT_AGENT_LIMITS } from './agent';
+export type { Agent, AgentDefinition } from './agent';
+export { openContinuation, sealContinuation } from './continuation';
+export type { Continuation, PendingToolCall } from './continuation';
+export { mcpServer, serviceTools } from './sources';
+export { localTools, requiresApproval, toJsonSchema, toolFactory, toolNameSegment, TOOL_NAME } from './tools';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC5D,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AACjB,cAAc,SAAS,CAAC"}