@agent-native/dispatch 0.2.11 → 0.2.12

package/src/routes/pages/workspace.tsx

@@ -6,6 +6,7 @@ import {
   IconChevronDown,
   IconChevronRight,
   IconCode,
+  IconFileText,
   IconPlus,
   IconRefresh,
   IconTrash,
@@ -72,6 +73,13 @@ const KIND_CONFIG = {
     description:
       "Reusable agent profiles — specialist agents shared across apps",
   },
+  knowledge: {
+    label: "Knowledge",
+    icon: IconFileText,
+    pathPrefix: "context/",
+    description:
+      "Knowledge packs — reusable GTM, product, and domain context for apps",
+  },
 } as const;
 
 function AddResourceDialog() {
@@ -127,6 +135,7 @@ function AddResourceDialog() {
                   <SelectItem value="skill">Skill</SelectItem>
                   <SelectItem value="instruction">Instruction</SelectItem>
                   <SelectItem value="agent">Agent</SelectItem>
+                  <SelectItem value="knowledge">Knowledge pack</SelectItem>
                 </SelectContent>
               </Select>
             </div>
@@ -151,7 +160,9 @@ function AddResourceDialog() {
                   ? "Frontend Designer"
                   : kind === "agent"
                     ? "Research Specialist"
-                    : "Code Style Guide"
+                    : kind === "knowledge"
+                      ? "Core GTM Messaging"
+                      : "Code Style Guide"
               }
               value={name}
               onChange={(e) => setName(e.target.value)}
@@ -167,7 +178,7 @@ function AddResourceDialog() {
             />
             <p className="text-xs text-muted-foreground">
               Resource path in target apps. Skills go in skills/, agents in
-              agents/.
+              agents/, knowledge packs in context/.
             </p>
           </div>
           <div className="space-y-2">
@@ -186,7 +197,9 @@ function AddResourceDialog() {
                   ? "---\nname: my-skill\ndescription: What this skill teaches\n---\n\n# My Skill\n\n..."
                   : kind === "agent"
                     ? "---\nname: Research Specialist\ndescription: Handles research tasks\n---\n\n# Instructions\n\n..."
-                    : "# Instructions\n\nBehavioral rules and guidance for agents across apps..."
+                    : kind === "knowledge"
+                      ? "# Core GTM Messaging\n\n## Positioning\n\n## ICP\n\n## Proof points\n\n## Source\n\n"
+                      : "# Instructions\n\nBehavioral rules and guidance for agents across apps..."
               }
               value={content}
               onChange={(e) => setContent(e.target.value)}
@@ -199,7 +212,7 @@ function AddResourceDialog() {
           <Button
             onClick={() =>
               create.mutate({
-                kind: kind as "skill" | "instruction" | "agent",
+                kind: kind as "skill" | "instruction" | "agent" | "knowledge",
                 name,
                 description: description || undefined,
                 path:
@@ -504,6 +517,9 @@ export default function WorkspaceRoute() {
     (r: any) => r.kind === "instruction",
   );
   const agents = (resources || []).filter((r: any) => r.kind === "agent");
+  const knowledge = (resources || []).filter(
+    (r: any) => r.kind === "knowledge",
+  );
 
   function ResourceList({
     items,
@@ -535,7 +551,7 @@ export default function WorkspaceRoute() {
   return (
     <DispatchShell
       title="Workspace Resources"
-      description="Share skills, instructions, and agent profiles across workspace apps. Scope to all apps or grant per-app."
+      description="Share skills, instructions, agent profiles, and knowledge packs across workspace apps. Scope to all apps or grant per-app."
     >
       <div className="flex items-center justify-between">
         <div className="text-sm text-muted-foreground">
@@ -570,6 +586,9 @@ export default function WorkspaceRoute() {
           <TabsTrigger value="agents">
             Agents {agents.length > 0 && `(${agents.length})`}
           </TabsTrigger>
+          <TabsTrigger value="knowledge">
+            Knowledge {knowledge.length > 0 && `(${knowledge.length})`}
+          </TabsTrigger>
         </TabsList>
 
         <TabsContent value="skills" className="mt-4">
@@ -592,6 +611,13 @@ export default function WorkspaceRoute() {
             emptyText="No workspace agents yet. Add a reusable agent profile to share specialist agents across apps."
           />
         </TabsContent>
+
+        <TabsContent value="knowledge" className="mt-4">
+          <ResourceList
+            items={knowledge}
+            emptyText="No knowledge packs yet. Add GTM, product, or domain context that apps can reuse."
+          />
+        </TabsContent>
       </Tabs>
     </DispatchShell>
   );

package/src/server/lib/app-creation-store.ts

@@ -20,6 +20,11 @@ import {
 } from "./dispatch-store.js";
 import { identityKeyForIncoming } from "./dispatch-integrations.js";
 import { createRequest, listSecrets } from "./vault-store.js";
+import {
+  grantWorkspaceResourcesToApp,
+  listWorkspaceResourceOptions,
+  type WorkspaceResourceOption,
+} from "./workspace-resources-store.js";
 
 const SETTINGS_KEY = "dispatch-app-creation-settings";
 const WORKSPACE_APPS_ENV_KEY = "AGENT_NATIVE_WORKSPACE_APPS_JSON";
@@ -827,6 +832,7 @@ function buildWorkspaceAppPrompt(input: {
   appId?: string | null;
   template?: string | null;
   selectedKeys?: string[];
+  selectedResources?: WorkspaceResourceOption[];
 }): { appId: string; prompt: string } {
   const appId =
     slugify(input.appId || "") ||
@@ -835,6 +841,15 @@ function buildWorkspaceAppPrompt(input: {
     ) ||
     "new-app";
   const selectedKeys = input.selectedKeys || [];
+  const selectedResources = input.selectedResources || [];
+  const resourceList = selectedResources.length
+    ? selectedResources
+        .map(
+          (resource) =>
+            `- ${resource.name} (${resource.kind}, ${resource.path})`,
+        )
+        .join("\n")
+    : "none";
   return {
     appId,
     prompt: [
@@ -846,11 +861,15 @@ function buildWorkspaceAppPrompt(input: {
       selectedKeys.length
         ? `Dispatch vault keys selected for this app: ${selectedKeys.join(", ")}`
         : "Dispatch vault keys selected for this app: none",
+      `Dispatch workspace resources selected for this app:\n${resourceList}`,
       "",
       `Use the workspace app layout: create it under apps/${appId}, mount it at /${appId}, keep it on the shared workspace database/hosting model, and avoid table-name collisions by namespacing any new domain tables to the app.`,
       selectedKeys.length
         ? `Dispatch will create pending vault requests for the selected keys for appId "${appId}" after this app creation request is accepted. Do not grant or sync vault keys directly from the app-creation branch.`
         : "Do not grant or request any Dispatch vault keys unless the user asks later.",
+      selectedResources.length
+        ? `Dispatch will create workspace resource grants for the selected resources for appId "${appId}". After the app exists, sync workspace resources so the app receives those shared resources. Add a short note to apps/${appId}/AGENTS.md telling the app agent to read relevant shared resources under context/ or the selected resource paths before doing GTM/domain work.`
+        : "Do not grant any Dispatch workspace resources unless the user asks later.",
       "",
       "Agent-native rules (these are the framework's contract — not optional):",
       `- Persist ALL data in SQL via Drizzle. Add tables to apps/${appId}/server/db/schema.ts and migrations to apps/${appId}/server/plugins/db.ts. NEVER use localStorage, sessionStorage, IndexedDB, or in-memory state for anything the user expects to persist — agent and UI must read the same source of truth.`,
@@ -890,11 +909,29 @@ async function requestSelectedVaultKeys(input: {
   );
 }
 
+async function selectedWorkspaceResourcesForIds(
+  resourceIds: string[] | undefined,
+): Promise<WorkspaceResourceOption[]> {
+  if (!resourceIds?.length) return [];
+  const requested = new Set(resourceIds);
+  const resources = await listWorkspaceResourceOptions();
+  return resources.filter((resource) => requested.has(resource.id));
+}
+
+async function grantSelectedWorkspaceResources(input: {
+  appId: string;
+  resourceIds: string[];
+}) {
+  if (input.resourceIds.length === 0) return;
+  await grantWorkspaceResourcesToApp(input);
+}
+
 export async function startWorkspaceAppCreation(input: {
   prompt: string;
   appId?: string | null;
   template?: string | null;
   secretIds?: string[];
+  resourceIds?: string[];
 }) {
   const initial = buildWorkspaceAppPrompt({
     prompt: input.prompt,
@@ -920,11 +957,15 @@ export async function startWorkspaceAppCreation(input: {
         .filter((secret) => input.secretIds?.includes(secret.id))
         .map((secret) => secret.credentialKey)
     : [];
+  const selectedResources = await selectedWorkspaceResourcesForIds(
+    input.resourceIds,
+  );
   const built = buildWorkspaceAppPrompt({
     prompt: input.prompt,
     appId: input.appId,
     template: input.template,
     selectedKeys,
+    selectedResources,
   });
   const prompt = built.prompt;
 
@@ -933,6 +974,10 @@ export async function startWorkspaceAppCreation(input: {
       appId: built.appId,
       selectedKeys,
     });
+    await grantSelectedWorkspaceResources({
+      appId: built.appId,
+      resourceIds: selectedResources.map((resource) => resource.id),
+    });
     return {
       mode: "local-agent",
       appId: built.appId,
@@ -997,6 +1042,10 @@ export async function startWorkspaceAppCreation(input: {
     appId: built.appId,
     selectedKeys,
   });
+  await grantSelectedWorkspaceResources({
+    appId: built.appId,
+    resourceIds: selectedResources.map((resource) => resource.id),
+  });
 
   return {
     mode: "builder",

package/src/server/lib/workspace-resources-store.ts

@@ -54,7 +54,11 @@ function orgFilter<T extends { ownerEmail: any; orgId: any }>(table: T) {
 
 // ─── Workspace Resources CRUD ──────────────────────────────────
 
-export type WorkspaceResourceKind = "skill" | "instruction" | "agent";
+export type WorkspaceResourceKind =
+  | "skill"
+  | "instruction"
+  | "agent"
+  | "knowledge";
 export type WorkspaceResourceScope = "all" | "selected";
 
 export interface WorkspaceResourceInput {
@@ -66,6 +70,16 @@ export interface WorkspaceResourceInput {
   scope: WorkspaceResourceScope;
 }
 
+export interface WorkspaceResourceOption {
+  id: string;
+  kind: WorkspaceResourceKind;
+  name: string;
+  description: string | null;
+  path: string;
+  scope: WorkspaceResourceScope;
+  updatedAt: number;
+}
+
 export async function listWorkspaceResources(filter?: { kind?: string }) {
   const db = getDb();
   const conditions = [orgFilter(schema.workspaceResources)];
@@ -79,6 +93,21 @@ export async function listWorkspaceResources(filter?: { kind?: string }) {
     .orderBy(desc(schema.workspaceResources.updatedAt));
 }
 
+export async function listWorkspaceResourceOptions(filter?: {
+  kind?: string;
+}): Promise<WorkspaceResourceOption[]> {
+  const resources = await listWorkspaceResources(filter);
+  return resources.map((resource) => ({
+    id: resource.id,
+    kind: resource.kind as WorkspaceResourceKind,
+    name: resource.name,
+    description: resource.description,
+    path: resource.path,
+    scope: resource.scope as WorkspaceResourceScope,
+    updatedAt: resource.updatedAt,
+  }));
+}
+
 export async function getWorkspaceResource(
   resourceId: string,
   ctx: WorkspaceResourceCtx = requireWorkspaceResourceCtx(),
@@ -248,6 +277,13 @@ export async function createResourceGrant(resourceId: string, appId: string) {
   const resource = await getWorkspaceResource(resourceId, ctx);
   if (!resource) throw new Error("Workspace resource not found");
 
+  const activeExisting = (await listResourceGrants({ resourceId, appId })).find(
+    (grant) => grant.status === "active",
+  );
+  if (activeExisting) {
+    return activeExisting;
+  }
+
   const timestamp = now();
   const grantId = id();
   const actor = currentOwnerEmail();
@@ -274,6 +310,42 @@ export async function createResourceGrant(resourceId: string, appId: string) {
   return getResourceGrant(grantId);
 }
 
+export async function grantWorkspaceResourcesToApp(input: {
+  appId: string;
+  resourceIds: string[];
+}) {
+  const uniqueResourceIds = [...new Set(input.resourceIds.filter(Boolean))];
+  if (uniqueResourceIds.length === 0) {
+    return { appId: input.appId, granted: [], skipped: [] };
+  }
+
+  const granted: Array<{ id: string; resourceId: string; appId: string }> = [];
+  const skipped: Array<{ resourceId: string; reason: string }> = [];
+
+  for (const resourceId of uniqueResourceIds) {
+    const resource = await getWorkspaceResource(resourceId).catch(() => null);
+    if (!resource) {
+      skipped.push({ resourceId, reason: "not-found" });
+      continue;
+    }
+    if (resource.scope === "all") {
+      skipped.push({ resourceId, reason: "already-all-apps" });
+      continue;
+    }
+
+    const grant = await createResourceGrant(resourceId, input.appId);
+    if (grant) {
+      granted.push({
+        id: grant.id,
+        resourceId: grant.resourceId,
+        appId: grant.appId,
+      });
+    }
+  }
+
+  return { appId: input.appId, granted, skipped };
+}
+
 export async function revokeResourceGrant(
   grantId: string,
   ctx: WorkspaceResourceCtx = requireWorkspaceResourceCtx(),
@@ -433,12 +505,14 @@ export async function listWorkspaceResourcesOverview() {
   const skills = resources.filter((r) => r.kind === "skill");
   const instructions = resources.filter((r) => r.kind === "instruction");
   const agents = resources.filter((r) => r.kind === "agent");
+  const knowledge = resources.filter((r) => r.kind === "knowledge");
   const activeGrants = grants.filter((g) => g.status === "active");
 
   return {
     skillCount: skills.length,
     instructionCount: instructions.length,
     agentCount: agents.length,
+    knowledgeCount: knowledge.length,
     totalResources: resources.length,
     activeGrantCount: activeGrants.length,
   };