@kinotic-ai/os-api 1.9.0 → 1.11.0

package/dist/index.cjs

@@ -56,6 +56,7 @@ __export(exports_src, {
   TenantSelectionC3Type: () => TenantSelectionC3Type,
   TenantIdDecorator: () => TenantIdDecorator,
   SingleLoggerLevelsDescriptor: () => SingleLoggerLevelsDescriptor,
+  RepositoryConnectionStatus: () => RepositoryConnectionStatus,
   QueryOptionsC3Type: () => QueryOptionsC3Type,
   QueryDecorator: () => QueryDecorator,
   ProjectType: () => ProjectType,
@@ -80,6 +81,8 @@ __export(exports_src, {
   LogManager: () => LogManager,
   LogLevel: () => LogLevel,
   KinoticProjectConfig: () => KinoticProjectConfig,
+  InviteEmailTemplateService: () => InviteEmailTemplateService,
+  InviteEmailTemplate: () => InviteEmailTemplate,
   IdDecorator: () => IdDecorator,
   IamUser: () => IamUser,
   GroupLoggerLevelsDescriptor: () => GroupLoggerLevelsDescriptor,
@@ -310,8 +313,9 @@ class Project {
   sourceOfTruth = null;
   repoFullName;
   repoId;
-  defaultBranch;
+  repoDefaultBranch;
   repoPrivate = true;
+  repoConnectionStatus = null;
   updated = null;
   constructor(id, applicationId, name, description) {
     this.id = id;
@@ -325,6 +329,13 @@ var ProjectType;
 ((ProjectType2) => {
   ProjectType2["TYPESCRIPT"] = "TYPESCRIPT";
 })(ProjectType ||= {});
+// packages/os-api/src/api/model/RepositoryConnectionStatus.ts
+var RepositoryConnectionStatus;
+((RepositoryConnectionStatus2) => {
+  RepositoryConnectionStatus2["CONNECTED"] = "CONNECTED";
+  RepositoryConnectionStatus2["INITIALIZATION_FAILED"] = "INITIALIZATION_FAILED";
+  RepositoryConnectionStatus2["DISCONNECTED"] = "DISCONNECTED";
+})(RepositoryConnectionStatus ||= {});
 // packages/os-api/src/api/model/EntityDefinition.ts
 class EntityDefinition {
   id;
@@ -472,6 +483,17 @@ class PendingInviteSummary {
   created = null;
   expiresAt = null;
 }
+// packages/os-api/src/api/model/InviteEmailTemplate.ts
+class InviteEmailTemplate {
+  id = null;
+  organizationId = null;
+  applicationId = "";
+  subject = "";
+  htmlBody = "";
+  textBody = "";
+  created = null;
+  updated = null;
+}
 // packages/os-api/src/api/model/github/GitHubAppInstallation.ts
 class GitHubAppInstallation {
   id = null;
@@ -603,6 +625,9 @@ class ProjectService extends import_core3.CrudServiceProxy {
   findAllForApplicationSinglePage(applicationId, pageable) {
     return this.serviceProxy.invoke("findAllForApplication", [applicationId, pageable]);
   }
+  retryRepoInitialization(projectId) {
+    return this.serviceProxy.invoke("retryRepoInitialization", [projectId]);
+  }
   syncIndex() {
     return this.serviceProxy.invoke("syncIndex", []);
   }
@@ -784,6 +809,17 @@ class MemberService {
     };
   }
 }
+// packages/os-api/src/api/services/IInviteEmailTemplateService.ts
+var import_core9 = require("@kinotic-ai/core");
+
+class InviteEmailTemplateService extends import_core9.CrudServiceProxy {
+  constructor(kinotic) {
+    super(kinotic.serviceProxy("org.kinotic.os.api.services.InviteEmailTemplateService"));
+  }
+  findByApplication(applicationId) {
+    return this.serviceProxy.invoke("findByApplication", [applicationId]);
+  }
+}
 // packages/os-api/src/api/services/IDeviceApprovalService.ts
 class DeviceApprovalService {
   serviceProxy;
@@ -795,9 +831,9 @@ class DeviceApprovalService {
   }
 }
 // packages/os-api/src/api/services/IGitHubAppInstallationService.ts
-var import_core9 = require("@kinotic-ai/core");
+var import_core10 = require("@kinotic-ai/core");
 
-class GitHubAppInstallationService extends import_core9.CrudServiceProxy {
+class GitHubAppInstallationService extends import_core10.CrudServiceProxy {
   constructor(kinotic) {
     super(kinotic.serviceProxy("org.kinotic.github.api.services.GitHubAppInstallationService"));
   }
@@ -826,6 +862,7 @@ var OsApiPlugin = {
       vmNodes: new VmNodeServiceProxy(kinotic),
       workloads: new WorkloadServiceProxy(kinotic),
       members: new MemberService(kinotic),
+      inviteEmailTemplates: new InviteEmailTemplateService(kinotic),
       deviceApproval: new DeviceApprovalService(kinotic),
       githubAppInstallations: new GitHubAppInstallationService(kinotic)
     };

package/dist/index.d.cts

@@ -174,6 +174,25 @@ import { Identifiable as Identifiable3 } from "@kinotic-ai/core";
 declare enum ProjectType {
 	TYPESCRIPT = "TYPESCRIPT"
 }
+/**
+* Connection state between a project and its backing GitHub repository.
+* Stamped {@link RepositoryConnectionStatus.CONNECTED} when the repo is provisioned and
+* its baseline rendered; left {@link RepositoryConnectionStatus.INITIALIZATION_FAILED}
+* when the repo was created but rendering the baseline did not complete;
+* {@link RepositoryConnectionStatus.DISCONNECTED} when GitHub revokes the platform's
+* access to the repo.
+*/
+declare enum RepositoryConnectionStatus {
+	/** Backing repo is reachable through the org's GitHub installation and its baseline is rendered. */
+	CONNECTED = "CONNECTED",
+	/**
+	* Backing repo was created but its rendered baseline was not committed. Initialization
+	* can be re-run against the existing repo to reach {@link RepositoryConnectionStatus.CONNECTED}.
+	*/
+	INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+	/** Installation no longer has access to the repo; operator must re-link. */
+	DISCONNECTED = "DISCONNECTED"
+}
 declare class Project implements Identifiable3<string> {
 	/**
 	* The id of the project.
@@ -215,13 +234,19 @@ declare class Project implements Identifiable3<string> {
 	/**
 	* Default branch of the backing repository at the time it was provisioned.
 	*/
-	defaultBranch: string;
+	repoDefaultBranch: string;
 	/**
 	* Visibility chosen for the backing repository at create time. The SPA sets
 	* this before save; the platform passes it through to GitHub.
 	*/
 	repoPrivate: boolean;
 	/**
+	* Connection state of the backing repository. A project left
+	* {@link RepositoryConnectionStatus.INITIALIZATION_FAILED} by creation can have its
+	* repository initialization retried.
+	*/
+	repoConnectionStatus: RepositoryConnectionStatus | null;
+	/**
 	* The date and time the project was updated.
 	*/
 	updated: number | null;
@@ -561,7 +586,7 @@ declare class IamUser implements Identifiable8<string> {
 	updated: number | null;
 }
 /**
-* Sent to {@code POST /api/signup} to start an email/password organization sign-up.
+* Sent to {@code POST /api/auth/org/signup} to start an email/password organization sign-up.
 * Only the user's identity is collected up front; the organization name and password are
 * provided after email verification (see {@link SignUpCompleteRequest}).
 */
@@ -570,7 +595,7 @@ interface SignUpRequest {
 	displayName: string;
 }
 /**
-* Sent to {@code POST /api/signup/complete} after the user clicks the verification link.
+* Sent to {@code POST /api/auth/org/signup/complete} after the user clicks the verification link.
 * The {@link token} comes from that link; {@link orgName} (with optional {@link orgDescription})
 * names the organization to create, and {@link password} is the chosen account password.
 */
@@ -581,7 +606,7 @@ interface SignUpCompleteRequest {
 	password: string;
 }
 /**
-* Sent to {@code POST /api/signup/complete-org} to finish an OIDC sign-up by naming the
+* Sent to {@code POST /api/auth/org/signup/social/complete} to finish an OIDC sign-up by naming the
 * organization to create. The verified identity is held server-side, keyed by {@link token}.
 */
 interface CompleteOrgRequest {
@@ -591,7 +616,7 @@ interface CompleteOrgRequest {
 }
 import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 /**
-* Console view of a pending invitation. Deliberately excludes the accept token — anyone who
+* View of a pending invitation for listing in the web app. Deliberately excludes the accept token — anyone who
 * can list invitations must not be able to redeem them.
 */
 declare class PendingInviteSummary implements Identifiable9<string> {
@@ -610,12 +635,33 @@ declare class PendingInviteSummary implements Identifiable9<string> {
 }
 import { Identifiable as Identifiable10 } from "@kinotic-ai/core";
 /**
+* An application's customized invitation email — at most one per application. Subject and
+* bodies are Handlebars sources rendered with the same variables as the built-in
+* invitation template; when an application has no template, the built-in is used.
+*/
+declare class InviteEmailTemplate implements Identifiable10<string> {
+	id: string | null;
+	/** The organization that owns {@link applicationId}; set by the server on save. */
+	organizationId: string | null;
+	/** The application whose invitation email this template customizes. Always set. */
+	applicationId: string;
+	/** Handlebars source for the subject line (rendered as plain text). */
+	subject: string;
+	/** Handlebars source for the HTML body. */
+	htmlBody: string;
+	/** Handlebars source for the plain-text body. */
+	textBody: string;
+	created: number | null;
+	updated: number | null;
+}
+import { Identifiable as Identifiable11 } from "@kinotic-ai/core";
+/**
 * Persisted record of one GitHub App installation that a Kinotic Org has authorised.
 * The durable binding that says "Org X has access to GitHub install Y" — without it,
 * no installation token can be minted on behalf of the org and webhook deliveries
 * can't be matched to a project.
 */
-declare class GitHubAppInstallation implements Identifiable10<string> {
+declare class GitHubAppInstallation implements Identifiable11<string> {
 	id: string | null;
 	organizationId: string;
 	githubInstallationId: number;
@@ -902,6 +948,13 @@ interface IProjectService extends ICrudServiceProxy3<Project> {
 	*/
 	findAllForApplication(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
 	/**
+	* Re-runs repository initialization for a project left
+	* {@link RepositoryConnectionStatus.INITIALIZATION_FAILED} by creation.
+	* @param projectId the id of the project to retry
+	* @return Promise emitting the project, marked {@link RepositoryConnectionStatus.CONNECTED} on success
+	*/
+	retryRepoInitialization(projectId: string): Promise<Project>;
+	/**
 	* This operation makes all the recent writes immediately available for search.
 	* @return a Promise that resolves when the operation is complete
 	*/
@@ -913,6 +966,7 @@ declare class ProjectService extends CrudServiceProxy3<Project> implements IProj
 	createProjectIfNotExist(project: Project): Promise<Project>;
 	findAllForApplication(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
 	findAllForApplicationSinglePage(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
+	retryRepoInitialization(projectId: string): Promise<Project>;
 	syncIndex(): Promise<void>;
 }
 import { IKinotic as IKinotic4 } from "@kinotic-ai/core";
@@ -1163,6 +1217,25 @@ declare class MemberService implements IMemberService {
 	memberDataSource(applicationId: string | null): IDataSource<IamUser>;
 }
 import { IKinotic as IKinotic12 } from "@kinotic-ai/core";
+import { CrudServiceProxy as CrudServiceProxy8, ICrudServiceProxy as ICrudServiceProxy8 } from "@kinotic-ai/core";
+/**
+* CRUD service for an application's customized invitation email — at most one
+* {@link InviteEmailTemplate} per application. Saving validates the Handlebars sources, so
+* a broken template is rejected instead of breaking the next send. Deleting the template
+* reverts the application to the built-in invitation email.
+*/
+interface IInviteEmailTemplateService extends ICrudServiceProxy8<InviteEmailTemplate> {
+	/**
+	* Finds the application's invitation template, or null when the application uses the
+	* built-in email.
+	*/
+	findByApplication(applicationId: string): Promise<InviteEmailTemplate | null>;
+}
+declare class InviteEmailTemplateService extends CrudServiceProxy8<InviteEmailTemplate> implements IInviteEmailTemplateService {
+	constructor(kinotic: IKinotic12);
+	findByApplication(applicationId: string): Promise<InviteEmailTemplate | null>;
+}
+import { IKinotic as IKinotic13 } from "@kinotic-ai/core";
 /**
 * Browser-invoked service for the RFC 8628 device-authorization approve step. The signed-in
 * browser user calls {@link approve} with the user_code shown in their CLI; the gateway
@@ -1177,11 +1250,11 @@ interface IDeviceApprovalService {
 }
 declare class DeviceApprovalService implements IDeviceApprovalService {
 	private readonly serviceProxy;
-	constructor(kinotic: IKinotic12);
+	constructor(kinotic: IKinotic13);
 	approve(userCode: string): Promise<void>;
 }
-import { CrudServiceProxy as CrudServiceProxy8, IKinotic as IKinotic13, ICrudServiceProxy as ICrudServiceProxy8 } from "@kinotic-ai/core";
-interface IGitHubAppInstallationService extends ICrudServiceProxy8<GitHubAppInstallation> {
+import { CrudServiceProxy as CrudServiceProxy9, IKinotic as IKinotic14, ICrudServiceProxy as ICrudServiceProxy9 } from "@kinotic-ai/core";
+interface IGitHubAppInstallationService extends ICrudServiceProxy9<GitHubAppInstallation> {
 	/**
 	* Stages a single-use state token bound to the caller's organization plus the
 	* supplied returnTo, then returns the GitHub install URL with that state
@@ -1206,8 +1279,8 @@ interface IGitHubAppInstallationService extends ICrudServiceProxy8<GitHubAppInst
 	*/
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
-declare class GitHubAppInstallationService extends CrudServiceProxy8<GitHubAppInstallation> implements IGitHubAppInstallationService {
-	constructor(kinotic: IKinotic13);
+declare class GitHubAppInstallationService extends CrudServiceProxy9<GitHubAppInstallation> implements IGitHubAppInstallationService {
+	constructor(kinotic: IKinotic14);
 	startInstall(returnTo: string | null): Promise<string>;
 	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
@@ -1225,6 +1298,7 @@ interface IOsApiExtension {
 	vmNodes: IVmNodeService;
 	workloads: IWorkloadService;
 	members: IMemberService;
+	inviteEmailTemplates: IInviteEmailTemplateService;
 	deviceApproval: IDeviceApprovalService;
 	githubAppInstallations: IGitHubAppInstallationService;
 }
@@ -1232,4 +1306,4 @@ declare const OsApiPlugin: KinoticPlugin<IOsApiExtension>;
 declare module "@kinotic-ai/core" {
 	interface KinoticSingleton extends IOsApiExtension {}
 }
-export { isSystemParticipant, isOrganizationParticipant, isApplicationParticipant, WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PendingInviteSummary, ParticipantType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, MemberService, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUser, IWorkloadService, IVmNodeService, ISystemParticipant, IProjectService, IOsApiExtension, IOrganizationService, IOrganizationParticipant, INamedQueriesDefinitionService, IMigrationService, IMemberService, ILogManager, IGitHubAppInstallationService, IEntityDefinitionService, IDeviceApprovalService, IDataInsightsService, IApplicationService, IApplicationParticipant, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DeviceApprovalService, DataInsightsService, DataInsightsComponent, CompleteOrgRequest, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };
+export { isSystemParticipant, isOrganizationParticipant, isApplicationParticipant, WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, RepositoryConnectionStatus, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PendingInviteSummary, ParticipantType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, MemberService, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InviteEmailTemplateService, InviteEmailTemplate, InsightRequest, InsightProgress, IdDecorator, IamUser, IWorkloadService, IVmNodeService, ISystemParticipant, IProjectService, IOsApiExtension, IOrganizationService, IOrganizationParticipant, INamedQueriesDefinitionService, IMigrationService, IMemberService, ILogManager, IInviteEmailTemplateService, IGitHubAppInstallationService, IEntityDefinitionService, IDeviceApprovalService, IDataInsightsService, IApplicationService, IApplicationParticipant, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DeviceApprovalService, DataInsightsService, DataInsightsComponent, CompleteOrgRequest, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };

package/dist/index.d.ts

@@ -174,6 +174,25 @@ import { Identifiable as Identifiable3 } from "@kinotic-ai/core";
 declare enum ProjectType {
 	TYPESCRIPT = "TYPESCRIPT"
 }
+/**
+* Connection state between a project and its backing GitHub repository.
+* Stamped {@link RepositoryConnectionStatus.CONNECTED} when the repo is provisioned and
+* its baseline rendered; left {@link RepositoryConnectionStatus.INITIALIZATION_FAILED}
+* when the repo was created but rendering the baseline did not complete;
+* {@link RepositoryConnectionStatus.DISCONNECTED} when GitHub revokes the platform's
+* access to the repo.
+*/
+declare enum RepositoryConnectionStatus {
+	/** Backing repo is reachable through the org's GitHub installation and its baseline is rendered. */
+	CONNECTED = "CONNECTED",
+	/**
+	* Backing repo was created but its rendered baseline was not committed. Initialization
+	* can be re-run against the existing repo to reach {@link RepositoryConnectionStatus.CONNECTED}.
+	*/
+	INITIALIZATION_FAILED = "INITIALIZATION_FAILED",
+	/** Installation no longer has access to the repo; operator must re-link. */
+	DISCONNECTED = "DISCONNECTED"
+}
 declare class Project implements Identifiable3<string> {
 	/**
 	* The id of the project.
@@ -215,13 +234,19 @@ declare class Project implements Identifiable3<string> {
 	/**
 	* Default branch of the backing repository at the time it was provisioned.
 	*/
-	defaultBranch: string;
+	repoDefaultBranch: string;
 	/**
 	* Visibility chosen for the backing repository at create time. The SPA sets
 	* this before save; the platform passes it through to GitHub.
 	*/
 	repoPrivate: boolean;
 	/**
+	* Connection state of the backing repository. A project left
+	* {@link RepositoryConnectionStatus.INITIALIZATION_FAILED} by creation can have its
+	* repository initialization retried.
+	*/
+	repoConnectionStatus: RepositoryConnectionStatus | null;
+	/**
 	* The date and time the project was updated.
 	*/
 	updated: number | null;
@@ -561,7 +586,7 @@ declare class IamUser implements Identifiable8<string> {
 	updated: number | null;
 }
 /**
-* Sent to {@code POST /api/signup} to start an email/password organization sign-up.
+* Sent to {@code POST /api/auth/org/signup} to start an email/password organization sign-up.
 * Only the user's identity is collected up front; the organization name and password are
 * provided after email verification (see {@link SignUpCompleteRequest}).
 */
@@ -570,7 +595,7 @@ interface SignUpRequest {
 	displayName: string;
 }
 /**
-* Sent to {@code POST /api/signup/complete} after the user clicks the verification link.
+* Sent to {@code POST /api/auth/org/signup/complete} after the user clicks the verification link.
 * The {@link token} comes from that link; {@link orgName} (with optional {@link orgDescription})
 * names the organization to create, and {@link password} is the chosen account password.
 */
@@ -581,7 +606,7 @@ interface SignUpCompleteRequest {
 	password: string;
 }
 /**
-* Sent to {@code POST /api/signup/complete-org} to finish an OIDC sign-up by naming the
+* Sent to {@code POST /api/auth/org/signup/social/complete} to finish an OIDC sign-up by naming the
 * organization to create. The verified identity is held server-side, keyed by {@link token}.
 */
 interface CompleteOrgRequest {
@@ -591,7 +616,7 @@ interface CompleteOrgRequest {
 }
 import { Identifiable as Identifiable9 } from "@kinotic-ai/core";
 /**
-* Console view of a pending invitation. Deliberately excludes the accept token — anyone who
+* View of a pending invitation for listing in the web app. Deliberately excludes the accept token — anyone who
 * can list invitations must not be able to redeem them.
 */
 declare class PendingInviteSummary implements Identifiable9<string> {
@@ -610,12 +635,33 @@ declare class PendingInviteSummary implements Identifiable9<string> {
 }
 import { Identifiable as Identifiable10 } from "@kinotic-ai/core";
 /**
+* An application's customized invitation email — at most one per application. Subject and
+* bodies are Handlebars sources rendered with the same variables as the built-in
+* invitation template; when an application has no template, the built-in is used.
+*/
+declare class InviteEmailTemplate implements Identifiable10<string> {
+	id: string | null;
+	/** The organization that owns {@link applicationId}; set by the server on save. */
+	organizationId: string | null;
+	/** The application whose invitation email this template customizes. Always set. */
+	applicationId: string;
+	/** Handlebars source for the subject line (rendered as plain text). */
+	subject: string;
+	/** Handlebars source for the HTML body. */
+	htmlBody: string;
+	/** Handlebars source for the plain-text body. */
+	textBody: string;
+	created: number | null;
+	updated: number | null;
+}
+import { Identifiable as Identifiable11 } from "@kinotic-ai/core";
+/**
 * Persisted record of one GitHub App installation that a Kinotic Org has authorised.
 * The durable binding that says "Org X has access to GitHub install Y" — without it,
 * no installation token can be minted on behalf of the org and webhook deliveries
 * can't be matched to a project.
 */
-declare class GitHubAppInstallation implements Identifiable10<string> {
+declare class GitHubAppInstallation implements Identifiable11<string> {
 	id: string | null;
 	organizationId: string;
 	githubInstallationId: number;
@@ -902,6 +948,13 @@ interface IProjectService extends ICrudServiceProxy3<Project> {
 	*/
 	findAllForApplication(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
 	/**
+	* Re-runs repository initialization for a project left
+	* {@link RepositoryConnectionStatus.INITIALIZATION_FAILED} by creation.
+	* @param projectId the id of the project to retry
+	* @return Promise emitting the project, marked {@link RepositoryConnectionStatus.CONNECTED} on success
+	*/
+	retryRepoInitialization(projectId: string): Promise<Project>;
+	/**
 	* This operation makes all the recent writes immediately available for search.
 	* @return a Promise that resolves when the operation is complete
 	*/
@@ -913,6 +966,7 @@ declare class ProjectService extends CrudServiceProxy3<Project> implements IProj
 	createProjectIfNotExist(project: Project): Promise<Project>;
 	findAllForApplication(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
 	findAllForApplicationSinglePage(applicationId: string, pageable: Pageable): Promise<IterablePage<Project>>;
+	retryRepoInitialization(projectId: string): Promise<Project>;
 	syncIndex(): Promise<void>;
 }
 import { IKinotic as IKinotic4 } from "@kinotic-ai/core";
@@ -1163,6 +1217,25 @@ declare class MemberService implements IMemberService {
 	memberDataSource(applicationId: string | null): IDataSource<IamUser>;
 }
 import { IKinotic as IKinotic12 } from "@kinotic-ai/core";
+import { CrudServiceProxy as CrudServiceProxy8, ICrudServiceProxy as ICrudServiceProxy8 } from "@kinotic-ai/core";
+/**
+* CRUD service for an application's customized invitation email — at most one
+* {@link InviteEmailTemplate} per application. Saving validates the Handlebars sources, so
+* a broken template is rejected instead of breaking the next send. Deleting the template
+* reverts the application to the built-in invitation email.
+*/
+interface IInviteEmailTemplateService extends ICrudServiceProxy8<InviteEmailTemplate> {
+	/**
+	* Finds the application's invitation template, or null when the application uses the
+	* built-in email.
+	*/
+	findByApplication(applicationId: string): Promise<InviteEmailTemplate | null>;
+}
+declare class InviteEmailTemplateService extends CrudServiceProxy8<InviteEmailTemplate> implements IInviteEmailTemplateService {
+	constructor(kinotic: IKinotic12);
+	findByApplication(applicationId: string): Promise<InviteEmailTemplate | null>;
+}
+import { IKinotic as IKinotic13 } from "@kinotic-ai/core";
 /**
 * Browser-invoked service for the RFC 8628 device-authorization approve step. The signed-in
 * browser user calls {@link approve} with the user_code shown in their CLI; the gateway
@@ -1177,11 +1250,11 @@ interface IDeviceApprovalService {
 }
 declare class DeviceApprovalService implements IDeviceApprovalService {
 	private readonly serviceProxy;
-	constructor(kinotic: IKinotic12);
+	constructor(kinotic: IKinotic13);
 	approve(userCode: string): Promise<void>;
 }
-import { CrudServiceProxy as CrudServiceProxy8, IKinotic as IKinotic13, ICrudServiceProxy as ICrudServiceProxy8 } from "@kinotic-ai/core";
-interface IGitHubAppInstallationService extends ICrudServiceProxy8<GitHubAppInstallation> {
+import { CrudServiceProxy as CrudServiceProxy9, IKinotic as IKinotic14, ICrudServiceProxy as ICrudServiceProxy9 } from "@kinotic-ai/core";
+interface IGitHubAppInstallationService extends ICrudServiceProxy9<GitHubAppInstallation> {
 	/**
 	* Stages a single-use state token bound to the caller's organization plus the
 	* supplied returnTo, then returns the GitHub install URL with that state
@@ -1206,8 +1279,8 @@ interface IGitHubAppInstallationService extends ICrudServiceProxy8<GitHubAppInst
 	*/
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
 }
-declare class GitHubAppInstallationService extends CrudServiceProxy8<GitHubAppInstallation> implements IGitHubAppInstallationService {
-	constructor(kinotic: IKinotic13);
+declare class GitHubAppInstallationService extends CrudServiceProxy9<GitHubAppInstallation> implements IGitHubAppInstallationService {
+	constructor(kinotic: IKinotic14);
 	startInstall(returnTo: string | null): Promise<string>;
 	completeInstall(installationId: number, state: string): Promise<GitHubInstallCompletion>;
 	findForCurrentOrg(): Promise<GitHubAppInstallation | null>;
@@ -1225,6 +1298,7 @@ interface IOsApiExtension {
 	vmNodes: IVmNodeService;
 	workloads: IWorkloadService;
 	members: IMemberService;
+	inviteEmailTemplates: IInviteEmailTemplateService;
 	deviceApproval: IDeviceApprovalService;
 	githubAppInstallations: IGitHubAppInstallationService;
 }
@@ -1232,4 +1306,4 @@ declare const OsApiPlugin: KinoticPlugin<IOsApiExtension>;
 declare module "@kinotic-ai/core" {
 	interface KinoticSingleton extends IOsApiExtension {}
 }
-export { isSystemParticipant, isOrganizationParticipant, isApplicationParticipant, WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PendingInviteSummary, ParticipantType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, MemberService, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InsightRequest, InsightProgress, IdDecorator, IamUser, IWorkloadService, IVmNodeService, ISystemParticipant, IProjectService, IOsApiExtension, IOrganizationService, IOrganizationParticipant, INamedQueriesDefinitionService, IMigrationService, IMemberService, ILogManager, IGitHubAppInstallationService, IEntityDefinitionService, IDeviceApprovalService, IDataInsightsService, IApplicationService, IApplicationParticipant, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DeviceApprovalService, DataInsightsService, DataInsightsComponent, CompleteOrgRequest, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };
+export { isSystemParticipant, isOrganizationParticipant, isApplicationParticipant, WorkloadStatus, WorkloadServiceProxy, Workload, VmProviderType, VmNodeStatus, VmNodeServiceProxy, VmNode, VersionDecorator, TimeReferenceDecorator, TextDecorator, TenantSelectionC3Type, TenantIdDecorator, SingleLoggerLevelsDescriptor, SignUpRequest, SignUpCompleteRequest, RepositoryConnectionStatus, QueryOptionsC3Type, QueryDecorator, ProjectType, ProjectService, Project, ProgressType, PendingInviteSummary, ParticipantType, PageableC3Type, PageC3Type, OsApiPlugin, OrganizationService, Organization, NotIndexedDecorator, NestedDecorator, NamedQueriesDefinitionService, NamedQueriesDefinition, MigrationService, MigrationResult, MigrationRequest, MigrationDefinition, MemberService, LoggersDescriptor, LoggerLevelsDescriptor, LogManager, LogLevel, KinoticProjectConfig, InviteEmailTemplateService, InviteEmailTemplate, InsightRequest, InsightProgress, IdDecorator, IamUser, IWorkloadService, IVmNodeService, ISystemParticipant, IProjectService, IOsApiExtension, IOrganizationService, IOrganizationParticipant, INamedQueriesDefinitionService, IMigrationService, IMemberService, ILogManager, IInviteEmailTemplateService, IGitHubAppInstallationService, IEntityDefinitionService, IDeviceApprovalService, IDataInsightsService, IApplicationService, IApplicationParticipant, GroupLoggerLevelsDescriptor, GitHubToken, GitHubRepoToken, GitHubInstallCompletion, GitHubAppInstallationService, GitHubAppInstallation, FlattenedDecorator, EsIndexConfigurationDecorator, EntityDefinitionService, EntityDefinition, EntityDecorator, EntitiesPathConfig, DiscriminatorDecorator, DeviceApprovalService, DataInsightsService, DataInsightsComponent, CompleteOrgRequest, AutoGeneratedIdDecorator, AuthType, ApplicationService, Application };

package/dist/index.js

@@ -205,8 +205,9 @@ class Project {
   sourceOfTruth = null;
   repoFullName;
   repoId;
-  defaultBranch;
+  repoDefaultBranch;
   repoPrivate = true;
+  repoConnectionStatus = null;
   updated = null;
   constructor(id, applicationId, name, description) {
     this.id = id;
@@ -220,6 +221,13 @@ var ProjectType;
 ((ProjectType2) => {
   ProjectType2["TYPESCRIPT"] = "TYPESCRIPT";
 })(ProjectType ||= {});
+// packages/os-api/src/api/model/RepositoryConnectionStatus.ts
+var RepositoryConnectionStatus;
+((RepositoryConnectionStatus2) => {
+  RepositoryConnectionStatus2["CONNECTED"] = "CONNECTED";
+  RepositoryConnectionStatus2["INITIALIZATION_FAILED"] = "INITIALIZATION_FAILED";
+  RepositoryConnectionStatus2["DISCONNECTED"] = "DISCONNECTED";
+})(RepositoryConnectionStatus ||= {});
 // packages/os-api/src/api/model/EntityDefinition.ts
 class EntityDefinition {
   id;
@@ -367,6 +375,17 @@ class PendingInviteSummary {
   created = null;
   expiresAt = null;
 }
+// packages/os-api/src/api/model/InviteEmailTemplate.ts
+class InviteEmailTemplate {
+  id = null;
+  organizationId = null;
+  applicationId = "";
+  subject = "";
+  htmlBody = "";
+  textBody = "";
+  created = null;
+  updated = null;
+}
 // packages/os-api/src/api/model/github/GitHubAppInstallation.ts
 class GitHubAppInstallation {
   id = null;
@@ -498,6 +517,9 @@ class ProjectService extends CrudServiceProxy3 {
   findAllForApplicationSinglePage(applicationId, pageable) {
     return this.serviceProxy.invoke("findAllForApplication", [applicationId, pageable]);
   }
+  retryRepoInitialization(projectId) {
+    return this.serviceProxy.invoke("retryRepoInitialization", [projectId]);
+  }
   syncIndex() {
     return this.serviceProxy.invoke("syncIndex", []);
   }
@@ -681,6 +703,17 @@ class MemberService {
     };
   }
 }
+// packages/os-api/src/api/services/IInviteEmailTemplateService.ts
+import { CrudServiceProxy as CrudServiceProxy8 } from "@kinotic-ai/core";
+
+class InviteEmailTemplateService extends CrudServiceProxy8 {
+  constructor(kinotic) {
+    super(kinotic.serviceProxy("org.kinotic.os.api.services.InviteEmailTemplateService"));
+  }
+  findByApplication(applicationId) {
+    return this.serviceProxy.invoke("findByApplication", [applicationId]);
+  }
+}
 // packages/os-api/src/api/services/IDeviceApprovalService.ts
 class DeviceApprovalService {
   serviceProxy;
@@ -692,9 +725,9 @@ class DeviceApprovalService {
   }
 }
 // packages/os-api/src/api/services/IGitHubAppInstallationService.ts
-import { CrudServiceProxy as CrudServiceProxy8 } from "@kinotic-ai/core";
+import { CrudServiceProxy as CrudServiceProxy9 } from "@kinotic-ai/core";
 
-class GitHubAppInstallationService extends CrudServiceProxy8 {
+class GitHubAppInstallationService extends CrudServiceProxy9 {
   constructor(kinotic) {
     super(kinotic.serviceProxy("org.kinotic.github.api.services.GitHubAppInstallationService"));
   }
@@ -723,6 +756,7 @@ var OsApiPlugin = {
       vmNodes: new VmNodeServiceProxy(kinotic),
       workloads: new WorkloadServiceProxy(kinotic),
       members: new MemberService(kinotic),
+      inviteEmailTemplates: new InviteEmailTemplateService(kinotic),
       deviceApproval: new DeviceApprovalService(kinotic),
       githubAppInstallations: new GitHubAppInstallationService(kinotic)
     };
@@ -745,6 +779,7 @@ export {
   TenantSelectionC3Type,
   TenantIdDecorator,
   SingleLoggerLevelsDescriptor,
+  RepositoryConnectionStatus,
   QueryOptionsC3Type,
   QueryDecorator,
   ProjectType,
@@ -769,6 +804,8 @@ export {
   LogManager,
   LogLevel,
   KinoticProjectConfig,
+  InviteEmailTemplateService,
+  InviteEmailTemplate,
   IdDecorator,
   IamUser,
   GroupLoggerLevelsDescriptor,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinotic-ai/os-api",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "type": "module",
   "files": [
     "dist"
@@ -33,15 +33,15 @@
     "ui-test": "vitest --ui --coverage.enabled=true --mode development"
   },
   "peerDependencies": {
-    "@kinotic-ai/core": ">=1.6.0"
+    "@kinotic-ai/core": ">=1.7.0"
   },
   "dependencies": {
     "@kinotic-ai/idl": "1.0.9",
-    "@kinotic-ai/persistence": "1.3.1",
+    "@kinotic-ai/persistence": "1.4.0",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@kinotic-ai/core": "1.6.2",
+    "@kinotic-ai/core": "1.7.0",
     "@types/node": "^25.3.2",
     "@vitest/coverage-v8": "^4.0.18",
     "@vitest/runner": "^4.0.18",