Expose agent task assignment permissions

Co-Authored-By: Paperclip <noreply@paperclip.ing>

packages/shared/src/index.ts

@@ -123,6 +123,9 @@ export type {
   InstanceExperimentalSettings,
   InstanceSettings,
   Agent,
+  AgentAccessState,
+  AgentChainOfCommandEntry,
+  AgentDetail,
   AgentPermissions,
   AgentKeyCreated,
   AgentConfigRevision,

packages/shared/src/types/agent.ts

@@ -4,11 +4,29 @@ import type {
   AgentRole,
   AgentStatus,
 } from "../constants.js";
+import type {
+  CompanyMembership,
+  PrincipalPermissionGrant,
+} from "./access.js";
 
 export interface AgentPermissions {
   canCreateAgents: boolean;
 }
 
+export interface AgentAccessState {
+  canAssignTasks: boolean;
+  taskAssignSource: "explicit_grant" | "agent_creator" | "ceo_role" | "none";
+  membership: CompanyMembership | null;
+  grants: PrincipalPermissionGrant[];
+}
+
+export interface AgentChainOfCommandEntry {
+  id: string;
+  name: string;
+  role: AgentRole;
+  title: string | null;
+}
+
 export interface Agent {
   id: string;
   companyId: string;
@@ -34,6 +52,11 @@ export interface Agent {
   updatedAt: Date;
 }
 
+export interface AgentDetail extends Agent {
+  chainOfCommand: AgentChainOfCommandEntry[];
+  access: AgentAccessState;
+}
+
 export interface AgentKeyCreated {
   id: string;
   name: string;

packages/shared/src/types/index.ts

@@ -2,6 +2,9 @@ export type { Company } from "./company.js";
 export type { InstanceExperimentalSettings, InstanceSettings } from "./instance.js";
 export type {
   Agent,
+  AgentAccessState,
+  AgentChainOfCommandEntry,
+  AgentDetail,
   AgentPermissions,
   AgentKeyCreated,
   AgentConfigRevision,

packages/shared/src/validators/agent.ts

@@ -100,6 +100,7 @@ export type TestAdapterEnvironment = z.infer<typeof testAdapterEnvironmentSchema
 
 export const updateAgentPermissionsSchema = z.object({
   canCreateAgents: z.boolean(),
+  canAssignTasks: z.boolean(),
 });
 
 export type UpdateAgentPermissions = z.infer<typeof updateAgentPermissionsSchema>;