@yrpri/api 9.0.108 → 9.0.109

package/active-citizen/controllers/activities.d.ts

@@ -0,0 +1,5 @@
+declare module '@yrpri/api/active-citizen/controllers/activities.cjs' {
+  import { Router } from 'express';
+  const router: Router;
+  export default router;
+}

package/active-citizen/controllers/notifications.d.ts

@@ -0,0 +1,5 @@
+declare module '@yrpri/api/active-citizen/controllers/notifications.cjs' {
+  import { Router } from 'express';
+  const router: Router;
+  export default router;
+}

package/agents/assistants/assistant.d.ts

@@ -0,0 +1,156 @@
+
+interface UnsubscribeResult {
+  success: boolean;
+  error?: string;
+  subscriptionId?: number;
+}
+
+interface SubscribeResult {
+  success: boolean;
+  error?: string;
+  plan?: YpSubscriptionPlanAttributes;
+  subscription?: YpSubscriptionAttributes;
+}
+
+interface AssistantAgent {
+  subscriptionId: number;
+  subscriptionPlanId: number;
+  name: string;
+  description: string;
+  imageUrl: string;
+  isRunning: boolean;
+}
+
+interface AssistantAgentRun {
+  runId: number;
+  agentProductId: number;
+  agentRunId: number;
+  status: string;
+  agentName: string;
+  workflow: any;
+  subscriptionId: number;
+}
+
+interface AssistantAgentSubscriptionStatus {
+  availableSubscriptions: Array<YpSubscriptionAttributes>;
+  runningAgents: Array<AssistantAgentRun>;
+  systemStatus: {
+    healthy: boolean;
+    lastUpdated: Date;
+    error?: string;
+  };
+}
+
+interface AssistantAgentBundle {
+  agentBundleId: number;
+  name: string;
+  description: string;
+  imageUrl: string;
+}
+
+interface AssistantAgentPlan {
+  subscriptionPlanId: number;
+  name: string;
+  type: YpSubscriptionPlanType;
+  description: string;
+  imageUrl: string;
+  price?: number;
+  currency?: string;
+  maxRunsPerCycle?: number;
+}
+
+interface AssistantAgentPlanStatus {
+  availablePlans: Array<AssistantAgentPlan>;
+  availableBundle: AssistantAgentBundle | string;
+  systemStatus: {
+    healthy: boolean;
+    lastUpdated: Date;
+    error?: string;
+  };
+}
+
+interface ToolClientEvent {
+  name: YpAssistantMessageType;
+  details: any;
+}
+
+interface ToolClientEventUiClick {
+  name: "ui_click";
+  details: YpAssistantUiClickTypes;
+}
+
+interface ToolExecutionResult<T = unknown> {
+  success: boolean;
+  data?: T;
+  html?: string;
+  uniqueToken?: string;
+  clientEvents?: ToolClientEvent[];
+  error?: string;
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Enhanced AssistantChatbotTool interface with result type
+ */
+interface AssistantChatbotTool {
+  name: string;
+  description: string;
+  type?: string;
+  parameters: ToolDefinition["parameters"];
+  handler: (params: any) => Promise<ToolExecutionResult>;
+  resultSchema?: ToolDefinition["parameters"];
+}
+
+/**
+ * Message format for tool results
+ */
+interface ToolResponseMessage {
+  role: "tool";
+  content: string;
+  tool_call_id: string;
+  name: string;
+}
+
+interface ToolCall {
+  id: string;
+  name: string;
+  arguments: string;
+  startTime?: number; // For timeout tracking
+}
+
+interface AssistantChatbotMode {
+  name: YpAssistantMode;
+  description: string;
+  systemPrompt: string;
+  tools: AssistantChatbotTool[];
+  routingRules?: string[];
+  allowedTransitions?: YpAssistantMode[];
+  cleanup?: () => Promise<void>;
+}
+
+interface YpBaseAssistantMemoryData extends YpBaseChatBotMemoryData {
+  redisKey: string;
+  currentMode: YpAssistantMode;
+  currentUser?: YpUserData;
+  haveShownLoginWidget?: boolean;
+  haveShownConfigurationWidget?: boolean;
+  currentAgentStatus?: {
+    subscriptionPlanId: number;
+    activeAgentRunId?: number;
+    subscriptionId: number | null;
+    subscriptionState: YpAssistantAgentSubscriptionState;
+    configurationState: YpAssistantAgentConfigurationState;
+  };
+
+  allChatLogs?: YpSimpleChatLog[];
+
+  loginState?: YpAssistantLoginState;
+
+  modeData?: AssistantModeData;
+  modeHistory?: Array<{
+    mode: YpAssistantMode;
+    timestamp: number;
+    reason?: string;
+  }>;
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yrpri/api",
-  "version": "9.0.108",
+  "version": "9.0.109",
   "license": "MIT",
   "author": "Robert Bjarnason & Citizens Foundation",
   "repository": {
@@ -133,7 +133,7 @@
   },
   "scripts": {
     "copyInLocalAgents": "cp -R ../../policy-synth/agents/ts-out/* ./node_modules/@policysynth/agents/;cp ../../policy-synth/agents/src/*.d.ts ./node_modules/@policysynth/agents/;",
-    "publish_live": "npm run build:dev;copyfiles './controllers/**/*.d.ts' 'ts-out/';npm pack && node repack && node publish.js https://registry.npmjs.org/",
+    "publish_live": "npm run build:dev;copyfiles './utils/**/*.d.ts' './controllers/**/*.d.ts' './agents/**/*.d.ts' './models/**/*.d.ts' './active-citizen/controllers/**/*.d.ts' './active-citizen/models/**/*.d.ts' 'ts-out/';npm pack && node repack && node publish.js https://registry.npmjs.org/",
     "publish_local": "npm run build;npm pack && node repack && node publish.js http://localhost:4873",
     "start": "nodemon -e ts ts-out/server.js",
     "watch-start": "DEBUG=router:* tsc --project ./ --outDir ./ts-out -w & nodemon -q ./ts-out/server.js",

package/utils/copy_utils.d.ts

@@ -0,0 +1,4 @@
+declare module "./copy_utils.cjs" {
+  export function copyGroup(): YpGroup;
+  export function copyCommunity(): YpCommunity;
+}

package/utils/manifest_generator.d.ts

@@ -0,0 +1,20 @@
+import { Request, Response } from 'express';
+
+// Define the module path based on convention from other .d.ts files
+declare module '@yrpri/api/utils/manifest_generator.cjs' {
+
+  interface YpRequest extends Request {
+    ypCommunity?: YpCommunity;
+    ypDomain?: YpDomain;
+  }
+
+  /**
+   * Generates a web app manifest.
+   * The manifest content depends on the properties found on req.ypCommunity or req.ypDomain.
+   * @param req The Express request object, expected to be augmented with ypCommunity and/or ypDomain properties.
+   * @param res The Express response object used to send the generated manifest.
+   */
+  function generateManifest(req: YpRequest, res: Response): void;
+
+  export default generateManifest;
+}