@clubnet/seedclub 0.2.39 → 0.2.40

package/assets/extensions/seedclub/index.ts

@@ -32,7 +32,7 @@ import {
 } from "./recent-entities.js";
 import { getCurrentUser, getSessionContext, registerUtilityTools } from "./tools/utility.js";
 import { registerCrmTools } from "./tools/crm.js";
-import { registerDealSourcingTools } from "./tools/deal-sourcing.js";
+import { registerOpportunityResearchTools } from "./tools/opportunity-research.js";
 import { registerMeetingTools } from "./tools/meetings.js";
 import { registerMediaTools } from "./tools/media.js";
 import { registerWebTools } from "./tools/web.js";
@@ -209,7 +209,7 @@ export default function (pi: ExtensionAPI) {
 	// Tools
 	registerUtilityTools(pi);
 	registerCrmTools(pi);
-	registerDealSourcingTools(pi);
+	registerOpportunityResearchTools(pi);
 	registerMeetingTools(pi);
 	registerMediaTools(pi);
 	registerWebTools(pi);

package/assets/extensions/seedclub/memory.ts

@@ -27,6 +27,12 @@ const MEMORY_WRITE_TIMEOUT_MS = 20000;
 const MEMORY_SESSION_STRATEGY = String(process.env.SEEDCLUB_MEMORY_SESSION_STRATEGY ?? "repo").toLowerCase();
 const MEMORY_DEFAULT_ENABLED_KEY = "seedclubMemoryDefaultEnabled";
 const MEMORY_DEFAULT_APPLIED_KEY = "seedclubMemoryDefaultApplied";
+const MEMORY_COMMAND_COMPLETIONS = [
+	{ value: "status", label: "status", description: "Show memory status" },
+	{ value: "recent", label: "recent", description: "Show recent memory" },
+	{ value: "on", label: "on", description: "Turn memory on" },
+	{ value: "off", label: "off", description: "Turn memory off" },
+];
 
 type MemoryStatus = {
 	available: boolean;
@@ -318,9 +324,14 @@ export function registerMemory(pi: ExtensionAPI): MemoryController {
 
 	pi.registerCommand("memory", {
 		description: "Show Seed Club memory status, recent memory, or turn memory on/off (`status`, `recent`, `on`, `off`)",
+		getArgumentCompletions: (argumentPrefix) => {
+			const prefix = argumentPrefix.trim().toLowerCase();
+			const completions = MEMORY_COMMAND_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
+			return completions.length ? completions : null;
+		},
 		handler: async (args, ctx) => {
 			const trimmedArgs = args.trim();
-			const [rawAction = "menu", ...rest] = trimmedArgs.split(/\s+/);
+			const [rawAction = "menu", ...rest] = trimmedArgs ? trimmedArgs.split(/\s+/) : ["menu"];
 			const action = rawAction.toLowerCase();
 			const actionArgs = rest.join(" ");
 			if (action === "status") {

package/assets/extensions/seedclub/tools/{deal-sourcing.ts → opportunity-research.ts}

@@ -6,9 +6,9 @@ import { ApiError, api, NotConnectedError } from "../api-client.js";
 import { makeProgressCallRenderer, makeProgressResultRenderer } from "../tool-utils.js";
 import { getToolCallLabel, getToolSuccessLabel } from "../ui-copy.js";
 
-type DealSourcingDecision = "pushing" | "passing" | "holding";
+type OpportunityResearchDecision = "pushing" | "passing" | "holding";
 
-const DEFAULT_DEAL_SOURCING_PROGRAM_SLUG = "seed-network";
+const DEFAULT_OPPORTUNITY_RESEARCH_PROGRAM_SLUG = "seed-network";
 const MAX_DOCUMENT_PREVIEW_CHARS = 12000;
 const MAX_IMAGE_PREVIEW_BYTES = 8 * 1024 * 1024;
 
@@ -150,7 +150,7 @@ function suggestedReviewFields() {
 	return [
 		"Founder info",
 		"Company info",
-		"Deal info, including ask or explicit ask unknown",
+		"Opportunity info, including ask or explicit ask unknown",
 		"Opportunity Summary",
 		"Founder/contact path or explicit unknown",
 		"Member relationship and excitement/vouch before push",
@@ -181,14 +181,16 @@ function inferDocumentContentType(fileName: string) {
 	return "application/octet-stream";
 }
 
-function normalizeDecision(value: unknown): DealSourcingDecision | null {
+function normalizeDecision(value: unknown): OpportunityResearchDecision | null {
 	if (value === "pushing" || value === "passing" || value === "holding") return value;
 	return null;
 }
 
-async function submitDraftPosition(programSlug: string, draftId: string, args: any, decision: DealSourcingDecision) {
-	return api.post<any>(`/programs/${programSlug}/deal-sourcing/drafts/${draftId}/member-position`, {
+async function submitDraftPosition(programSlug: string, draftId: string, args: any, decision: OpportunityResearchDecision) {
+	return api.post<any>(`/programs/${programSlug}/opportunity-research/drafts/${draftId}/member-position`, {
 		ask_unknown: args.askUnknown === true,
+		company_name: normalizeOptionalString(args.companyName),
+		company_website_url: normalizeOptionalString(args.companyWebsiteUrl),
 		contact_info: normalizeOptionalString(args.contactInfo),
 		contact_unknown: args.contactUnknown === true,
 		decision,
@@ -202,7 +204,7 @@ async function submitDraftPosition(programSlug: string, draftId: string, args: a
 	});
 }
 
-async function submitDealSourcingDeck(args: {
+async function submitOpportunityResearchDocument(args: {
 	askUnknown?: boolean | null;
 	programSlug?: string | null;
 	filePath?: string | null;
@@ -212,7 +214,7 @@ async function submitDealSourcingDeck(args: {
 	contentType?: string | null;
 	contactInfo?: string | null;
 	contactUnknown?: boolean | null;
-	decision?: DealSourcingDecision | null;
+	decision?: OpportunityResearchDecision | null;
 	draftId?: string | null;
 	excitementReason?: string | null;
 	fileName?: string | null;
@@ -227,15 +229,15 @@ async function submitDealSourcingDeck(args: {
 	vouchText?: string | null;
 }, runtime?: any) {
 	try {
-		const programSlug = normalizeOptionalString(args.programSlug) ?? DEFAULT_DEAL_SOURCING_PROGRAM_SLUG;
+		const programSlug = normalizeOptionalString(args.programSlug) ?? DEFAULT_OPPORTUNITY_RESEARCH_PROGRAM_SLUG;
 		const existingDraftId = normalizeOptionalString(args.draftId);
 		const existingDecision = normalizeDecision(args.decision);
 		if (existingDraftId) {
 			if (!existingDecision) {
-				return { draft: { id: existingDraftId }, next_action: "Ask the member whether they want to push/source this draft, pass/reject it, or hold it for later." };
+				return { draft: { id: existingDraftId }, next_action: "Ask the member whether they want to push this opportunity for review, pass, or hold it for later." };
 			}
 
-			runtime?.setWorkingMessage?.("Saving deal sourcing draft position...");
+			runtime?.setWorkingMessage?.("Saving opportunity draft position...");
 			const positionResponse = await submitDraftPosition(programSlug, existingDraftId, args, existingDecision);
 			return { draft: { id: existingDraftId }, draft_position_result: positionResponse };
 		}
@@ -253,8 +255,8 @@ async function submitDealSourcingDeck(args: {
 		const fileName = normalizeOptionalString(args.fileName) ?? basename(filePath);
 		const contentType = normalizeOptionalString(args.contentType) ?? inferDocumentContentType(fileName);
 		const assetKind = normalizeOptionalString(args.assetKind) ?? "deck";
-		runtime?.setWorkingMessage?.("Requesting deal document upload target...");
-		const ingestResponse = await api.post<any>(`/programs/${programSlug}/deal-sourcing/document-ingests`, {
+		runtime?.setWorkingMessage?.("Requesting research document upload target...");
+		const ingestResponse = await api.post<any>(`/programs/${programSlug}/opportunity-research/document-ingests`, {
 			asset_kind: assetKind,
 			content_type: contentType,
 			file_name: fileName,
@@ -267,10 +269,10 @@ async function submitDealSourcingDeck(args: {
 		const uploadId = typeof ingestResponse?.upload?.id === "string" ? ingestResponse.upload.id : null;
 
 		if (!uploadUrl || !objectKey || !uploadId) {
-			return { error: "The API did not return a valid deal document upload target.", response: ingestResponse };
+			return { error: "The API did not return a valid research document upload target.", response: ingestResponse };
 		}
 
-		runtime?.setWorkingMessage?.("Uploading deal document bytes...");
+		runtime?.setWorkingMessage?.("Uploading research document...");
 		const bytes = await readFile(filePath);
 		const documentPreview = await buildDocumentPreview(fileName, contentType, bytes);
 		const uploadHeaders: Record<string, string> = {};
@@ -296,7 +298,7 @@ async function submitDealSourcingDeck(args: {
 		}
 
 		runtime?.setWorkingMessage?.("Creating private research draft...");
-		const completeResponse = await api.post<any>(`/programs/${programSlug}/deal-sourcing/document-ingests/${uploadId}/complete`, {
+		const completeResponse = await api.post<any>(`/programs/${programSlug}/opportunity-research/document-ingests/${uploadId}/complete`, {
 			asset_kind: assetKind,
 			company_name: normalizeOptionalString(args.companyName),
 			company_website_url: normalizeOptionalString(args.companyWebsiteUrl),
@@ -317,8 +319,8 @@ async function submitDealSourcingDeck(args: {
 			decision_ignored_until_review: Boolean(decision),
 			document_preview: documentPreview,
 			next_action: decision
-				? "The document is saved as a private draft. Review the material, summarize Founder info, Company info, Deal info, and Opportunity Summary, then ask missing questions before submitting the member decision."
-				: "Review the material, summarize Founder info, Company info, Deal info, and Opportunity Summary, then ask whether the member wants to push, pass, or hold after missing context is resolved.",
+				? "The document is saved as a private draft. Review the material, summarize Founder info, Company info, Opportunity info, and Opportunity Summary, then ask missing questions before submitting the member decision."
+				: "Review the material, summarize Founder info, Company info, Opportunity info, and Opportunity Summary, then ask whether the member wants to push, pass, or hold after missing context is resolved.",
 			suggested_review_fields: suggestedReviewFields(),
 			upload: {
 				...completeResponse?.upload,
@@ -331,7 +333,7 @@ async function submitDealSourcingDeck(args: {
 	}
 }
 
-function makeDealSourcingExecute(fn: typeof submitDealSourcingDeck) {
+function makeOpportunityResearchExecute(fn: typeof submitOpportunityResearchDocument) {
 	return async (_toolCallId: string, params: any, _signal: any, _onUpdate: any, ctx: any) => {
 		const runtime = {
 			ctx,
@@ -385,15 +387,15 @@ function makeDealSourcingExecute(fn: typeof submitDealSourcingDeck) {
 	};
 }
 
-export function registerDealSourcingTools(pi: ExtensionAPI) {
+export function registerOpportunityResearchTools(pi: ExtensionAPI) {
 	pi.registerTool({
-		name: "seedclub_submit_deal_sourcing_deck",
-		label: "Submit Deal Sourcing Document",
+		name: "seedclub_upload_opportunity_document",
+		label: "Upload Opportunity Document",
 		description:
-			"Upload a local deck, memo, document, or image to seedclub-api as a private/team-private deal research draft, or submit pushing/passing/holding for an existing draftId. programSlug defaults to seed-network. Initial uploads always create a private draft first and return document preview context; do not push immediately from an upload. After reviewing and confirming with the member, use draftId plus a decision. If decision is pushing, provide founderNames or founderUnknown, founderRelationship, excitementReason or vouchText, contactInfo or contactUnknown, and targetAmount or askUnknown.",
+			"Upload a local deck, memo, document, or image to seedclub-api as a private/team-private opportunity research draft, or record pushing/passing/holding for an existing draftId. programSlug defaults to seed-network. For a plain deck upload or a prompt like 'let's chat about this opportunity', create the private draft, read the preview, and discuss the opportunity without implying it has been submitted for review. Initial uploads must not push immediately. After reviewing and confirming with the member, use draftId plus a decision. If decision is pushing, provide founderNames or founderUnknown, founderRelationship, excitementReason or vouchText, contactInfo or contactUnknown, and targetAmount or askUnknown.",
 		parameters: Type.Object({
 			askUnknown: Type.Optional(Type.Union([Type.Boolean(), Type.Null()], { description: "Set true when the member explicitly says the round ask is unknown." })),
-			programSlug: Type.Optional(Type.Union([Type.String({ description: "Program slug for the investing/deal pipeline program. Defaults to seed-network." }), Type.Null()])),
+			programSlug: Type.Optional(Type.Union([Type.String({ description: "Program slug for the opportunity research program. Defaults to seed-network." }), Type.Null()])),
 			filePath: Type.Optional(Type.Union([Type.String({ description: "Local deck, memo, document, or image path. Required unless draftId is provided." }), Type.Null()])),
 			assetKind: Type.Optional(Type.Union([Type.Literal("deck"), Type.Literal("memo"), Type.Literal("supporting_material"), Type.Null()])),
 			companyName: Type.Optional(Type.Union([Type.String(), Type.Null()])),
@@ -402,7 +404,7 @@ export function registerDealSourcingTools(pi: ExtensionAPI) {
 			contactInfo: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Founder/company contact info supplied by the member if not present in the uploaded material." })),
 			contactUnknown: Type.Optional(Type.Union([Type.Boolean(), Type.Null()], { description: "Set true when the member explicitly says contact info is unknown." })),
 			decision: Type.Optional(Type.Union([Type.Literal("pushing"), Type.Literal("passing"), Type.Literal("holding"), Type.Null()])),
-			draftId: Type.Optional(Type.Union([Type.String({ description: "Existing private deal draft id to update without re-uploading the file." }), Type.Null()])),
+			draftId: Type.Optional(Type.Union([Type.String({ description: "Existing private opportunity draft id to update without re-uploading the file." }), Type.Null()])),
 			excitementReason: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: "Why the member is excited about the company/founder." })),
 			fileName: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 			flaggedTopics: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()])),
@@ -415,9 +417,9 @@ export function registerDealSourcingTools(pi: ExtensionAPI) {
 			valuation: Type.Optional(Type.Union([Type.Number(), Type.Null()])),
 			vouchText: Type.Optional(Type.Union([Type.String(), Type.Null()])),
 		}),
-		execute: makeDealSourcingExecute(submitDealSourcingDeck),
-		renderCall: makeProgressCallRenderer(getToolCallLabel("seedclub_submit_deal_sourcing_deck"), (args) => args?.companyName || args?.draftId || args?.filePath || undefined),
-		renderResult: makeProgressResultRenderer(getToolSuccessLabel("seedclub_submit_deal_sourcing_deck"), (details) => {
+		execute: makeOpportunityResearchExecute(submitOpportunityResearchDocument),
+		renderCall: makeProgressCallRenderer(getToolCallLabel("seedclub_upload_opportunity_document"), (args) => args?.companyName || args?.draftId || args?.filePath || undefined),
+		renderResult: makeProgressResultRenderer(getToolSuccessLabel("seedclub_upload_opportunity_document"), (details) => {
 			const company = details?.company?.name ?? details?.draft_position_result?.funding_round?.organization_id ?? null;
 			const state = details?.draft_position_result?.funding_round?.lifecycle_state ?? details?.draft?.status ?? details?.draft_position_result?.draft?.status ?? null;
 			const id = details?.draft_position_result?.funding_round?.id ?? details?.draft?.id ?? details?.draft_position_result?.draft?.id ?? null;

package/assets/extensions/seedclub/ui-copy.ts

@@ -11,6 +11,7 @@ export const TOOL_CALL_LABELS: Record<string, string> = {
 	seedclub_create_crm_task: "Creating CRM task",
 	seedclub_save_research: "Saving research",
 	seedclub_research_opportunity: "Researching opportunity",
+	seedclub_upload_opportunity_document: "Uploading opportunity document",
 	seedclub_get_research: "Loading research",
 	seedclub_list_program_contacts: "Loading program contacts",
 	seedclub_list_program_funnels: "Loading program funnels",
@@ -62,6 +63,7 @@ export const TOOL_SUCCESS_LABELS: Record<string, string> = {
 	seedclub_create_crm_task: "CRM task created",
 	seedclub_save_research: "Research saved",
 	seedclub_research_opportunity: "Research queued",
+	seedclub_upload_opportunity_document: "Opportunity draft ready",
 	seedclub_get_research: "Research loaded",
 	seedclub_list_program_contacts: "Program contacts loaded",
 	seedclub_list_program_funnels: "Program funnels loaded",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clubnet/seedclub",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "description": "A branded command-line agent wrapper around pi, with integrated Seed Club commands, tools, and app actions",
   "license": "MIT",
   "repository": {

package/packages/seedclub-tui/src/app/interactive-mode.mjs

@@ -959,6 +959,13 @@ function shouldShowCommandInList(name) {
 	return !name.startsWith("skill:");
 }
 
+const MEMORY_COMMAND_COMPLETIONS = [
+	{ value: "status", label: "status", description: "Show memory status" },
+	{ value: "recent", label: "recent", description: "Show recent memory" },
+	{ value: "on", label: "on", description: "Turn memory on" },
+	{ value: "off", label: "off", description: "Turn memory off" },
+];
+
 function getBuiltInSlashCommands() {
 	return [
 		{ name: "new", description: "Start a new session" },
@@ -967,13 +974,22 @@ function getBuiltInSlashCommands() {
 		{ name: "calendar", description: "Open calendar connect and availability actions" },
 		{ name: "research", description: "Open a Seed Club research prompt" },
 		{ name: "source", description: "Open a source-backed research prompt" },
-		{ name: "memory", description: "Show Seed Club memory status, recent memory, or turn memory on/off" },
+		{
+			name: "memory",
+			description: "Show Seed Club memory status, recent memory, or turn memory on/off",
+			getArgumentCompletions: (argumentPrefix) => {
+				const prefix = argumentPrefix.trim().toLowerCase();
+				const completions = MEMORY_COMMAND_COMPLETIONS.filter((item) => item.value.startsWith(prefix));
+				return completions.length ? completions : null;
+			},
+		},
 		{ name: "worldview", description: "Open an investing worldview prompt" },
 		{ name: "theses", description: "Open an investment theses prompt" },
 		{ name: "concerns", description: "Open an investment concerns prompt" },
 		{ name: "model", description: "Select the current model" },
 		{ name: "login", description: "Log into a model provider" },
 		{ name: "logout", description: "Log out of a model provider" },
+		{ name: "update", description: "Show the seedclub package update menu" },
 		{ name: "more", description: "Show everything else" },
 		{ name: "quit", description: "Exit seedclub" },
 	];
@@ -984,10 +1000,23 @@ function getAuxiliaryBuiltInSlashCommands() {
 		{ name: "commands", description: "List the primary command menu" },
 		{ name: "extensions", description: "List loaded extensions" },
 		{ name: "reload", description: "Reload keybindings, extensions, prompts, and tools" },
-		{ name: "update", description: "Show the seedclub package update menu" },
 	];
 }
 
+function getPrimaryExtensionCommandNames() {
+	return new Set([
+		"calendar",
+		"concerns",
+		"memory",
+		"research",
+		"seedclub",
+		"seedenv",
+		"source",
+		"theses",
+		"worldview",
+	]);
+}
+
 class SeedclubSurfaceEditor extends CustomEditor {
 	constructor(tui, editorTheme, keybindings, options) {
 		super(tui, editorTheme, keybindings, {
@@ -1312,7 +1341,7 @@ export class SeedclubInteractiveModeApp {
 	configureAutocomplete() {
 		const builtInCommands = getBuiltInSlashCommands();
 		const builtInCommandNames = new Set(builtInCommands.map((command) => command.name));
-		const extraAutocompleteCommands = new Set(["seedclub"]);
+		const extraAutocompleteCommands = getPrimaryExtensionCommandNames();
 		const extensionCommands = this.session.extensionRunner?.getRegisteredCommands?.()
 			.filter((command) => !builtInCommandNames.has(command.invocationName))
 			.filter((command) => extraAutocompleteCommands.has(command.invocationName))
@@ -1340,7 +1369,16 @@ export class SeedclubInteractiveModeApp {
 
 	showCommandsList() {
 		const builtInCommands = getBuiltInSlashCommands();
-		const lines = builtInCommands
+		const builtInCommandNames = new Set(builtInCommands.map((command) => command.name));
+		const primaryExtensionCommandNames = getPrimaryExtensionCommandNames();
+		const extensionCommands = this.session.extensionRunner?.getRegisteredCommands?.()
+			.filter((command) => !builtInCommandNames.has(command.invocationName))
+			.filter((command) => primaryExtensionCommandNames.has(command.invocationName))
+			.map((command) => ({
+				name: command.invocationName,
+				description: command.description || "",
+			})) ?? [];
+		const lines = [...builtInCommands, ...extensionCommands]
 			.filter((command) => shouldShowCommandInList(command.name))
 			.map((command) => `- \`/${command.name}\`${command.description ? ` ${command.description}` : ""}`)
 			.join("\n");