@memberjunction/server 5.33.0 → 5.34.1

package/dist/resolvers/SearchKnowledgeStreamResolver.js

@@ -0,0 +1,342 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+/**
+ * Streaming variant of the SearchKnowledge mutation. Uses GraphQL
+ * subscriptions over the existing Apollo subscription transport (see
+ * `plans/search-scopes-rag-plus/streaming-mechanism-decision.md` for the
+ * decision rationale).
+ *
+ * Two-step protocol:
+ *
+ *   1. Caller invokes the `StreamScopedSearch` mutation with the same
+ *      arguments as `SearchKnowledge`. The mutation returns a streamID
+ *      (uuid) immediately and starts the search in the background.
+ *   2. Caller subscribes to `SearchStreamEvents(streamID: $id)`. The
+ *      server publishes events from `SearchEngine.streamSearch()` to the
+ *      pubsub topic; the subscription's filter narrows to the requested
+ *      streamID. The final event has `Phase = 'final'` (or 'error');
+ *      consumers should unsubscribe after receiving it.
+ *
+ * Permission enforcement is identical to SearchKnowledge: each requested
+ * scopeID is run through SearchScopePermissionResolver before the engine
+ * is invoked. A denial publishes a single 'error' event and ends.
+ */
+import { Resolver, Mutation, Arg, Ctx, ObjectType, Field, Float, ID, Subscription, Root, PubSub, PubSubEngine } from 'type-graphql';
+import { v4 as uuidv4 } from 'uuid';
+import { GraphQLJSON } from 'graphql-type-json';
+import { LogError, LogStatus, Metadata } from '@memberjunction/core';
+import { ResolverBase } from '../generic/ResolverBase.js';
+import { SearchEngine, SearchScopePermissionResolver, } from '@memberjunction/search-engine';
+import { UUIDsEqual } from '@memberjunction/global';
+import { SearchKnowledgeResultItem, SearchSourceCounts } from './SearchKnowledgeResolver.js';
+const SEARCH_STREAM_TOPIC = 'SEARCH_STREAM';
+/**
+ * Wire format for search stream events. We do not use a discriminated
+ * union at the GraphQL level (type-graphql doesn't have first-class
+ * support for union outputs in a clean way) — instead we use a Phase
+ * discriminator and make the data fields nullable per phase.
+ */
+let SearchStreamNotification = class SearchStreamNotification {
+};
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], SearchStreamNotification.prototype, "StreamID", void 0);
+__decorate([
+    Field(),
+    __metadata("design:type", String)
+], SearchStreamNotification.prototype, "Phase", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], SearchStreamNotification.prototype, "ProviderName", void 0);
+__decorate([
+    Field(() => Float, { nullable: true }),
+    __metadata("design:type", Number)
+], SearchStreamNotification.prototype, "DurationMs", void 0);
+__decorate([
+    Field(() => [SearchKnowledgeResultItem], { nullable: true }),
+    __metadata("design:type", Array)
+], SearchStreamNotification.prototype, "Results", void 0);
+__decorate([
+    Field(() => SearchSourceCounts, { nullable: true }),
+    __metadata("design:type", SearchSourceCounts)
+], SearchStreamNotification.prototype, "SourceCounts", void 0);
+__decorate([
+    Field(() => Float, { nullable: true }),
+    __metadata("design:type", Number)
+], SearchStreamNotification.prototype, "ElapsedMs", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], SearchStreamNotification.prototype, "ErrorMessage", void 0);
+SearchStreamNotification = __decorate([
+    ObjectType()
+], SearchStreamNotification);
+export { SearchStreamNotification };
+let SearchStreamStartResult = class SearchStreamStartResult {
+};
+__decorate([
+    Field(),
+    __metadata("design:type", Boolean)
+], SearchStreamStartResult.prototype, "Success", void 0);
+__decorate([
+    Field(() => ID),
+    __metadata("design:type", String)
+], SearchStreamStartResult.prototype, "StreamID", void 0);
+__decorate([
+    Field({ nullable: true }),
+    __metadata("design:type", String)
+], SearchStreamStartResult.prototype, "ErrorMessage", void 0);
+SearchStreamStartResult = __decorate([
+    ObjectType()
+], SearchStreamStartResult);
+export { SearchStreamStartResult };
+let SearchKnowledgeStreamResolver = class SearchKnowledgeStreamResolver extends ResolverBase {
+    /**
+     * Subscribe to events from a running streamScopedSearch. Filter by
+     * streamID so multiple in-flight streams don't interleave on the same
+     * client.
+     */
+    SearchStreamEvents(notification, _streamID) {
+        return notification;
+    }
+    /**
+     * Start a streaming search. Returns a streamID that the caller passes
+     * to the SearchStreamEvents subscription. Permission checks are
+     * performed before the stream begins; on rejection a single 'error'
+     * event is published and the stream ends.
+     */
+    async StreamScopedSearch(query, maxResults, minScore, scopeIDs, searchContext, agentID, pubSub, { userPayload } = {}) {
+        const streamID = uuidv4();
+        const startTime = Date.now();
+        try {
+            const currentUser = this.GetUserFromPayload(userPayload);
+            if (!currentUser) {
+                return { Success: false, StreamID: streamID, ErrorMessage: 'Unable to determine current user' };
+            }
+            // Phase 2A enforcement: validate every requested scope before
+            // we kick the stream off. Same predicate / message as the
+            // synchronous resolver — single source of truth.
+            if (scopeIDs && scopeIDs.length) {
+                const denial = await this.rejectForbiddenScopes(scopeIDs, currentUser, agentID);
+                if (denial) {
+                    // Mirror the synchronous resolver: surface denied attempts in
+                    // the analytics dashboard so an admin tuning permissions can
+                    // see them. Best-effort — failures are swallowed by the helper.
+                    await SearchEngine.Instance.LogForbiddenSearch({
+                        Query: query,
+                        ScopeIDs: scopeIDs,
+                        FailureReason: denial,
+                        StartTime: startTime,
+                        ContextUser: currentUser,
+                        AIAgentID: agentID ?? null,
+                    });
+                    return { Success: false, StreamID: streamID, ErrorMessage: denial };
+                }
+            }
+            // Kick off the stream in the background and return immediately.
+            // The mutation resolves before any events are published — the
+            // client must subscribe first to avoid missing the early ones.
+            // (TODO Phase 2C v2: optionally buffer until first subscriber
+            // arrives; today's contract is "subscribe before mutation
+            // returns" which the SDK can enforce.)
+            void this.runStream(streamID, {
+                query,
+                maxResults,
+                minScore,
+                scopeIDs,
+                searchContext,
+                agentID,
+            }, currentUser, pubSub).catch(err => {
+                const msg = err instanceof Error ? err.message : String(err);
+                LogError(`StreamScopedSearch background failure: ${msg}`);
+                void pubSub.publish(SEARCH_STREAM_TOPIC, {
+                    StreamID: streamID,
+                    Phase: 'error',
+                    ErrorMessage: msg,
+                });
+            });
+            return { Success: true, StreamID: streamID };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`StreamScopedSearch start failed: ${msg}`);
+            return { Success: false, StreamID: streamID, ErrorMessage: msg };
+        }
+    }
+    /**
+     * Runs the stream and publishes events. Always publishes a terminal
+     * 'final' or 'error' so clients can confidently unsubscribe.
+     */
+    async runStream(streamID, params, currentUser, pubSub) {
+        const mappedContext = params.searchContext
+            ? params.searchContext
+            : undefined;
+        try {
+            for await (const ev of SearchEngine.Instance.streamSearch({
+                Query: params.query,
+                MaxResults: params.maxResults,
+                MinScore: params.minScore,
+                ScopeIDs: params.scopeIDs && params.scopeIDs.length ? params.scopeIDs : undefined,
+                SearchContext: mappedContext,
+                AIAgentID: params.agentID ?? null,
+            }, currentUser)) {
+                const notification = this.toNotification(streamID, ev);
+                await pubSub.publish(SEARCH_STREAM_TOPIC, notification);
+            }
+            LogStatus(`StreamScopedSearch ${streamID} completed`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`StreamScopedSearch ${streamID} failed mid-stream: ${msg}`);
+            await pubSub.publish(SEARCH_STREAM_TOPIC, {
+                StreamID: streamID,
+                Phase: 'error',
+                ErrorMessage: msg,
+            });
+        }
+    }
+    toNotification(streamID, ev) {
+        // Reuse the same item shape as the synchronous resolver.
+        const mapItem = (r) => ({
+            ID: r.ID,
+            EntityName: r.EntityName,
+            RecordID: r.RecordID,
+            SourceType: r.SourceType,
+            ResultType: r.ResultType,
+            Title: r.Title,
+            Snippet: r.Snippet,
+            Score: r.Score,
+            ScoreBreakdown: r.ScoreBreakdown,
+            Tags: r.Tags ?? [],
+            EntityIcon: r.EntityIcon,
+            RecordName: r.RecordName,
+            MatchedAt: r.MatchedAt,
+            RawMetadata: r.RawMetadata,
+            ProviderId: r.ProviderId,
+            ProviderLabel: r.ProviderLabel,
+            ProviderIcon: r.ProviderIcon,
+        });
+        switch (ev.phase) {
+            case 'provider':
+                return {
+                    StreamID: streamID,
+                    Phase: 'provider',
+                    ProviderName: ev.providerName,
+                    DurationMs: ev.durationMs,
+                    Results: ev.results.map(mapItem),
+                };
+            case 'fused':
+                return {
+                    StreamID: streamID,
+                    Phase: 'fused',
+                    Results: ev.results.map(mapItem),
+                };
+            case 'reranked':
+                return {
+                    StreamID: streamID,
+                    Phase: 'reranked',
+                    ProviderName: ev.rerankerName,
+                    Results: ev.results.map(mapItem),
+                };
+            case 'final':
+                return {
+                    StreamID: streamID,
+                    Phase: 'final',
+                    Results: ev.results.map(mapItem),
+                    SourceCounts: ev.sourceCounts,
+                    ElapsedMs: ev.elapsedMs,
+                };
+            case 'error':
+                return {
+                    StreamID: streamID,
+                    Phase: 'error',
+                    ProviderName: ev.providerName,
+                    ErrorMessage: ev.error,
+                };
+        }
+    }
+    /** Mirrors the helper in SearchKnowledgeResolver — kept private to
+     * avoid an inter-resolver coupling. If a third resolver ever needs
+     * this, lift it into a shared util in `packages/SearchEngine`. */
+    async rejectForbiddenScopes(scopeIDs, user, agentID) {
+        const agent = await this.loadAgent(agentID, user);
+        const resolver = new SearchScopePermissionResolver();
+        for (const scopeID of scopeIDs) {
+            const verdict = await resolver.ResolveEffectivePermission({
+                User: user,
+                SearchScopeID: scopeID,
+                Agent: agent,
+                ContextUser: user,
+            });
+            if (!verdict.Allowed) {
+                LogStatus(`StreamScopedSearch denied: ${verdict.Reason} (scope=${scopeID}, source=${verdict.Source})`);
+                return `Forbidden: ${verdict.Reason}`;
+            }
+            // Read level grants metadata visibility but not the right to run a
+            // search. Mirror the SearchKnowledge resolver's gate so the streaming
+            // path enforces the same Read=metadata-only rule.
+            if (verdict.Level === 'Read') {
+                const reason = `User '${user.Name}' has Read-level access on this scope, which permits metadata visibility but not search execution. Search or Manage is required to run a query.`;
+                LogStatus(`StreamScopedSearch denied: ${reason} (scope=${scopeID}, source=${verdict.Source})`);
+                return `Forbidden: ${reason}`;
+            }
+        }
+        return undefined;
+    }
+    async loadAgent(agentID, contextUser) {
+        if (!agentID)
+            return null;
+        try {
+            const md = new Metadata(); // global-provider-ok: ResolverBase has no bound IMetadataProvider; contextUser is the per-request scope
+            const agent = await md.GetEntityObject('MJ: AI Agents', contextUser);
+            const loaded = await agent.Load(agentID);
+            return loaded ? agent : null;
+        }
+        catch (err) {
+            LogError(`StreamScopedSearch: failed to load agent ${agentID}: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+};
+__decorate([
+    Subscription(() => SearchStreamNotification, {
+        topics: SEARCH_STREAM_TOPIC,
+        filter: ({ payload, args }) => UUIDsEqual(payload.StreamID, args.streamID),
+    }),
+    __param(0, Root()),
+    __param(1, Arg('streamID', () => ID)),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [SearchStreamNotification, String]),
+    __metadata("design:returntype", SearchStreamNotification)
+], SearchKnowledgeStreamResolver.prototype, "SearchStreamEvents", null);
+__decorate([
+    Mutation(() => SearchStreamStartResult),
+    __param(0, Arg('query')),
+    __param(1, Arg('maxResults', () => Float, { nullable: true })),
+    __param(2, Arg('minScore', () => Float, { nullable: true })),
+    __param(3, Arg('scopeIDs', () => [ID], { nullable: true })),
+    __param(4, Arg('searchContext', () => GraphQLJSON, { nullable: true })),
+    __param(5, Arg('agentID', () => ID, { nullable: true })),
+    __param(6, PubSub()),
+    __param(7, Ctx()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Number, Number, Array, Object, String, PubSubEngine, Object]),
+    __metadata("design:returntype", Promise)
+], SearchKnowledgeStreamResolver.prototype, "StreamScopedSearch", null);
+SearchKnowledgeStreamResolver = __decorate([
+    Resolver()
+], SearchKnowledgeStreamResolver);
+export { SearchKnowledgeStreamResolver };
+//# sourceMappingURL=SearchKnowledgeStreamResolver.js.map

package/dist/resolvers/SearchKnowledgeStreamResolver.js.map

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

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { AggregateExpression, DatabaseProviderBase, UserInfo } from '@memberjunction/core';
+import { AggregateExpression, CompositeKey, DatabaseProviderBase, UserInfo } from '@memberjunction/core';
 import { MJUserViewEntityExtended } from '@memberjunction/core-entities';
 import { GraphQLSchema } from 'graphql';
 import sql from 'mssql';
@@ -79,6 +79,11 @@ export type RunViewGenericParams = {
     ignoreMaxRows?: boolean;
     maxRows?: number;
     startRow?: number;
+    /**
+     * Keyset (seek) pagination cursor — see {@link RunViewParams.AfterKey}.
+     * When set, the entity must have a single-column PK; throws AfterKeyNotSupportedError otherwise.
+     */
+    afterKey?: CompositeKey;
     excludeDataFromAllPriorViewRuns?: boolean;
     forceAuditLog?: boolean;
     auditLogDescription?: string;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA6CxE,MAAM,OAAO,YAAY;CAGxB;AAED,MAAM,OAAO,cAAc;IASzB,YAAY,IAA4J;QACtK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAAA,CAAC;AA6BF,MAAM,OAAO,aAAa;CAKzB;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;IACjB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC;IACvC,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AA6CxE,MAAM,OAAO,YAAY;CAGxB;AAED,MAAM,OAAO,cAAc;IASzB,YAAY,IAA4J;QACtK,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;CACF;AAAA,CAAC;AAkCF,MAAM,OAAO,aAAa;CAKzB;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAA2B,EAAE,WAA6B,EAAE,WAAwB,EAAE,SAAe;IACpI,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,KAAK,CAAC,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;IACjB,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,cAAc,CAAC;IACvC,GAAG,CAAC,SAAS,GAAG,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/server",
-  "version": "5.33.0",
+  "version": "5.34.1",
   "description": "MemberJunction: This project provides API access via GraphQL to the common data store.",
   "main": "./dist/index.js",
   "types": "./src/index.ts",
@@ -27,73 +27,73 @@
     "@as-integrations/express5": "^1.0.0",
     "@graphql-tools/schema": "latest",
     "@graphql-tools/utils": "^11.0.0",
-    "@memberjunction/actions": "5.33.0",
-    "@memberjunction/actions-apollo": "5.33.0",
-    "@memberjunction/actions-base": "5.33.0",
-    "@memberjunction/actions-bizapps-accounting": "5.33.0",
-    "@memberjunction/actions-bizapps-crm": "5.33.0",
-    "@memberjunction/actions-bizapps-formbuilders": "5.33.0",
-    "@memberjunction/actions-bizapps-lms": "5.33.0",
-    "@memberjunction/actions-bizapps-social": "5.33.0",
-    "@memberjunction/ai": "5.33.0",
-    "@memberjunction/ai-agent-manager": "5.33.0",
-    "@memberjunction/ai-agent-manager-actions": "5.33.0",
-    "@memberjunction/ai-agents": "5.33.0",
-    "@memberjunction/ai-core-plus": "5.33.0",
-    "@memberjunction/ai-mcp-client": "5.33.0",
-    "@memberjunction/ai-prompts": "5.33.0",
-    "@memberjunction/ai-provider-bundle": "5.33.0",
-    "@memberjunction/ai-vector-sync": "5.33.0",
-    "@memberjunction/ai-vectordb": "5.33.0",
-    "@memberjunction/ai-vectors-pinecone": "5.33.0",
-    "@memberjunction/aiengine": "5.33.0",
-    "@memberjunction/api-keys": "5.33.0",
-    "@memberjunction/auth-providers": "5.33.0",
-    "@memberjunction/codegen-lib": "5.33.0",
-    "@memberjunction/communication-ms-graph": "5.33.0",
-    "@memberjunction/communication-sendgrid": "5.33.0",
-    "@memberjunction/communication-types": "5.33.0",
-    "@memberjunction/component-registry-client-sdk": "5.33.0",
-    "@memberjunction/computer-use-engine": "5.33.0",
-    "@memberjunction/config": "5.33.0",
-    "@memberjunction/core": "5.33.0",
-    "@memberjunction/core-actions": "5.33.0",
-    "@memberjunction/core-entities": "5.33.0",
-    "@memberjunction/core-entities-server": "5.33.0",
-    "@memberjunction/data-context": "5.33.0",
-    "@memberjunction/data-context-server": "5.33.0",
-    "@memberjunction/doc-utils": "5.33.0",
-    "@memberjunction/encryption": "5.33.0",
-    "@memberjunction/entity-communications-base": "5.33.0",
-    "@memberjunction/entity-communications-server": "5.33.0",
-    "@memberjunction/external-change-detection": "5.33.0",
-    "@memberjunction/generic-database-provider": "5.33.0",
-    "@memberjunction/global": "5.33.0",
-    "@memberjunction/graphql-dataprovider": "5.33.0",
-    "@memberjunction/integration-engine": "5.33.0",
-    "@memberjunction/integration-schema-builder": "5.33.0",
-    "@memberjunction/interactive-component-types": "5.33.0",
-    "@memberjunction/notifications": "5.33.0",
-    "@memberjunction/postgresql-dataprovider": "5.33.0",
-    "@memberjunction/queue": "5.33.0",
-    "@memberjunction/redis-provider": "5.33.0",
-    "@memberjunction/scheduling-actions": "5.33.0",
-    "@memberjunction/scheduling-base-types": "5.33.0",
-    "@memberjunction/scheduling-engine": "5.33.0",
-    "@memberjunction/scheduling-engine-base": "5.33.0",
-    "@memberjunction/schema-engine": "5.33.0",
-    "@memberjunction/search-engine": "5.33.0",
-    "@memberjunction/server-extensions-core": "5.33.0",
-    "@memberjunction/skip-types": "5.33.0",
-    "@memberjunction/sql-dialect": "5.33.0",
-    "@memberjunction/sqlserver-dataprovider": "5.33.0",
-    "@memberjunction/storage": "5.33.0",
-    "@memberjunction/tag-engine": "5.33.0",
-    "@memberjunction/tag-engine-base": "5.33.0",
-    "@memberjunction/templates": "5.33.0",
-    "@memberjunction/testing-engine": "5.33.0",
-    "@memberjunction/testing-engine-base": "5.33.0",
-    "@memberjunction/version-history": "5.33.0",
+    "@memberjunction/actions": "5.34.1",
+    "@memberjunction/actions-apollo": "5.34.1",
+    "@memberjunction/actions-base": "5.34.1",
+    "@memberjunction/actions-bizapps-accounting": "5.34.1",
+    "@memberjunction/actions-bizapps-crm": "5.34.1",
+    "@memberjunction/actions-bizapps-formbuilders": "5.34.1",
+    "@memberjunction/actions-bizapps-lms": "5.34.1",
+    "@memberjunction/actions-bizapps-social": "5.34.1",
+    "@memberjunction/ai": "5.34.1",
+    "@memberjunction/ai-agent-manager": "5.34.1",
+    "@memberjunction/ai-agent-manager-actions": "5.34.1",
+    "@memberjunction/ai-agents": "5.34.1",
+    "@memberjunction/ai-core-plus": "5.34.1",
+    "@memberjunction/ai-mcp-client": "5.34.1",
+    "@memberjunction/ai-prompts": "5.34.1",
+    "@memberjunction/ai-provider-bundle": "5.34.1",
+    "@memberjunction/ai-vector-sync": "5.34.1",
+    "@memberjunction/ai-vectordb": "5.34.1",
+    "@memberjunction/ai-vectors-pinecone": "5.34.1",
+    "@memberjunction/aiengine": "5.34.1",
+    "@memberjunction/api-keys": "5.34.1",
+    "@memberjunction/auth-providers": "5.34.1",
+    "@memberjunction/codegen-lib": "5.34.1",
+    "@memberjunction/communication-ms-graph": "5.34.1",
+    "@memberjunction/communication-sendgrid": "5.34.1",
+    "@memberjunction/communication-types": "5.34.1",
+    "@memberjunction/component-registry-client-sdk": "5.34.1",
+    "@memberjunction/computer-use-engine": "5.34.1",
+    "@memberjunction/config": "5.34.1",
+    "@memberjunction/core": "5.34.1",
+    "@memberjunction/core-actions": "5.34.1",
+    "@memberjunction/core-entities": "5.34.1",
+    "@memberjunction/core-entities-server": "5.34.1",
+    "@memberjunction/data-context": "5.34.1",
+    "@memberjunction/data-context-server": "5.34.1",
+    "@memberjunction/doc-utils": "5.34.1",
+    "@memberjunction/encryption": "5.34.1",
+    "@memberjunction/entity-communications-base": "5.34.1",
+    "@memberjunction/entity-communications-server": "5.34.1",
+    "@memberjunction/external-change-detection": "5.34.1",
+    "@memberjunction/generic-database-provider": "5.34.1",
+    "@memberjunction/global": "5.34.1",
+    "@memberjunction/graphql-dataprovider": "5.34.1",
+    "@memberjunction/integration-engine": "5.34.1",
+    "@memberjunction/integration-schema-builder": "5.34.1",
+    "@memberjunction/interactive-component-types": "5.34.1",
+    "@memberjunction/notifications": "5.34.1",
+    "@memberjunction/postgresql-dataprovider": "5.34.1",
+    "@memberjunction/queue": "5.34.1",
+    "@memberjunction/redis-provider": "5.34.1",
+    "@memberjunction/scheduling-actions": "5.34.1",
+    "@memberjunction/scheduling-base-types": "5.34.1",
+    "@memberjunction/scheduling-engine": "5.34.1",
+    "@memberjunction/scheduling-engine-base": "5.34.1",
+    "@memberjunction/schema-engine": "5.34.1",
+    "@memberjunction/search-engine": "5.34.1",
+    "@memberjunction/server-extensions-core": "5.34.1",
+    "@memberjunction/skip-types": "5.34.1",
+    "@memberjunction/sql-dialect": "5.34.1",
+    "@memberjunction/sqlserver-dataprovider": "5.34.1",
+    "@memberjunction/storage": "5.34.1",
+    "@memberjunction/tag-engine": "5.34.1",
+    "@memberjunction/tag-engine-base": "5.34.1",
+    "@memberjunction/templates": "5.34.1",
+    "@memberjunction/testing-engine": "5.34.1",
+    "@memberjunction/testing-engine-base": "5.34.1",
+    "@memberjunction/version-history": "5.34.1",
     "@types/compression": "^1.8.1",
     "@types/cors": "^2.8.19",
     "@types/jsonwebtoken": "9.0.10",

package/src/agents/skip-agent.ts

@@ -347,12 +347,27 @@ export class SkipProxyAgent extends BaseAgent {
     }
 
     /**
-     * Handle analysis_complete phase — validates componentOptions before accessing
+     * Handle analysis_complete phase — supports both component-bearing responses
+     * (componentOptions populated) and analysis-only responses (markdown in `analysis`
+     * with no component, produced by Skip's Analysis Agent path).
      */
     private handleAnalysisComplete(
         response: SkipAPIAnalysisCompleteResponse
     ): BaseAgentNextStep<ComponentSpec> {
-        if (!response.componentOptions || response.componentOptions.length === 0) {
+        const hasComponentOptions = response.componentOptions && response.componentOptions.length > 0;
+        const skipMessage = response.messages?.filter(msg => msg.role === 'system').pop();
+        const analysisText = response.analysis?.trim();
+
+        if (!hasComponentOptions) {
+            if (analysisText || skipMessage?.content) {
+                return {
+                    terminate: true,
+                    step: 'Success',
+                    message: analysisText || skipMessage!.content,
+                    newPayload: undefined
+                };
+            }
+
             const msg = 'Skip completed analysis but returned no component options. '
                 + `Title: "${response.title || 'none'}". `
                 + `Result type: "${response.resultType || 'none'}"`;
@@ -366,8 +381,7 @@ export class SkipProxyAgent extends BaseAgent {
             };
         }
 
-        const componentSpec = response.componentOptions[0].option;
-        const skipMessage = response.messages?.filter(msg => msg.role === 'system').pop();
+        const componentSpec = response.componentOptions![0].option;
 
         return {
             terminate: true,